Clase 05 · Módulo 13
Probar, versionar y documentar
Probar, versionar y documentar
Qué logras en esta clase
Cambias un flujo publicado sin romperlo y lo dejas entendible para otra persona, o para ti en seis meses.
- Pruebas con datos fijos y casos difíciles.
- Guardas versiones y sabes volver atrás.
- Documentas el flujo dentro y fuera de n8n.
02
La falla que tú mismo publicas
Muchas caídas no vienen de afuera: vienen de un cambio que nadie probó antes de publicarlo.
03
Borrador y publicado
Desde n8n 2.0, lo que editas queda como borrador. La versión publicada sigue corriendo igual hasta que pulsas Publish.
- Puedes editar y probar sin afectar a producción.
- Guardar no es publicar.
- Unpublish detiene el flujo.
Lo viste en el módulo 2, clase 5. Aquí lo usas como red de seguridad.
04
El ciclo de un cambio
Seis pasos. Los dos que más se saltan son el primero y el último.
05
Probar con datos fijos
n8n permite fijar la salida de un nodo: en las pruebas siguientes, ese nodo entrega siempre los mismos datos sin llamar al servicio real.
- No gastas cuota ni esperas respuestas.
- Repites el mismo caso las veces que haga falta.
- Puedes editar el dato fijado para inventar casos.
En la documentación de n8n, busca «data pinning» para ver cómo se hace en tu versión.
06
Fijado no es producción
Una prueba con datos fijos confirma tu lógica. No confirma que la credencial funcione ni que el servicio responda igual.
07
Los casos que hay que probar
| Caso | Ejemplo |
|---|---|
| Normal | Un pedido completo |
| Vacío | Cero pedidos nuevos |
| Incompleto | Pedido sin correo |
| Repetido | El mismo pedido dos veces |
| Raro | Nombre con tildes, monto con punto y coma |
| Volumen | 300 pedidos de una vez |
Si el flujo pasa los seis, pocas sorpresas le quedan.
08
Armar el juego de datos
- Toma un dato real y bórrale lo que identifique a una persona.
- Pídele a Claude variantes: una vacía, una incompleta, una con formato extraño.
- Fija ese conjunto en el primer nodo.
- Guarda el conjunto en un archivo junto al flujo exportado.
09
Un bug, un caso de prueba
Si un dato hizo fallar el flujo una vez, guárdalo como caso de prueba. Sin eso, el mismo error vuelve con el siguiente cambio.
10
Probar sin tocar a nadie
Mientras pruebas, apunta los nodos de salida a destinos tuyos:
- Tu propio correo o un chat de prueba.
- Una copia de la planilla.
- Un proyecto de base de datos aparte.
Vuelve a los destinos reales como último paso antes de publicar.
11
Tres formas de guardar versiones
| Forma | Ventaja | Límite |
|---|---|---|
| Historial de versiones de n8n | Está dentro del editor | La retención depende del plan |
| Exportar a un repositorio privado | Queda fuera de n8n y con fechas | Hay que hacerlo |
| Duplicar el flujo antes de editar | Inmediato | Desordena si no borras copias |
En n8n Cloud Starter el historial de versiones guarda 1 día. Revisa cuánto guarda tu plan o tu instalación.
12
Exportar los flujos
n8n export:workflow --backup --output=backups/latest/Genera un archivo por flujo. En Docker, antepón docker exec -u node -it <nombre-del-contenedor>.
- Sube esa carpeta a un repositorio privado de GitHub.
- El control de versiones con Git integrado en n8n es de planes con licencia; en la edición comunitaria se hace así.
El respaldo completo, con credenciales y base, es del módulo 14, clase 5.
13
Volver atrás
| Camino | Cómo |
|---|---|
| Desde el editor | Abrir el historial de versiones y restaurar una anterior |
| Por comando | n8n publish:workflow --id=<ID> --versionId=<versión> |
| Desde el archivo | n8n import:workflow con el archivo exportado |
14
Publicar un cambio
- Elige un momento de poco uso, con tiempo para mirar.
- Publica.
- Espera la primera ejecución real y ábrela en Executions.
- Revisa la bitácora: ¿las cantidades son las de siempre?
- Si algo se ve mal, vuelve a la versión anterior y recién entonces investiga.
15
Documentar es parte de construir
Un flujo que solo entiende quien lo armó se rompe el día que esa persona no está. A veces esa persona eres tú, seis meses después.
16
Nombres que explican
| Nombre por defecto | Nombre útil |
|---|---|
| HTTP Request1 | Consultar stock en la API |
| IF | ¿El pedido está pagado? |
| Edit Fields2 | Dejar solo nombre, correo y total |
| Mi flujo 7 | Recordatorios de citas por correo |
Con buenos nombres, el aviso de error de la clase 3 ya dice qué paso falló.
17
Notas en el lienzo
n8n permite pegar notas de texto sobre el lienzo, junto a los nodos. Úsalas para lo que el nombre no alcanza a decir:
- Por qué existe una rama rara.
- Qué límite del servicio obligó a poner una espera.
- Por qué un nodo tiene «continuar» ante error.
18
La ficha del flujo
Una nota al inicio del lienzo, o un documento aparte, que responda cinco preguntas:
- ¿Qué hace y para quién?
- ¿Qué lo dispara y cada cuánto?
- ¿Qué servicios y credenciales usa?
- ¿Qué hay que hacer si falla?
- ¿Quién es responsable y cuál fue el último cambio?
La cuarta es la más valiosa a las tres de la mañana.
19
Claude como ayudante de documentación
Claude lee bien el archivo exportado de un flujo. Puedes pedirle que explique qué hace cada rama o que redacte un borrador de la ficha.
20
Lo que te llevas
- Edita en borrador y publica solo lo probado.
- Datos fijos y seis casos: normal, vacío, incompleto, repetido, raro y volumen.
- Guarda una versión fuera de n8n antes de cada cambio grande.
- Tras publicar, mira la primera ejecución real.
- Nombres claros, notas con el porqué y una ficha por flujo.
21
Hazlo ahora
En 15 minutos, con un flujo publicado:
- Expórtalo o duplícalo.
- Renombra todos los nodos que conserven el nombre por defecto.
- Fija en el primer nodo un dato normal y uno incompleto, y ejecuta.
- Agrega una nota al inicio con las cinco respuestas de la ficha.
- Publica y revisa la primera ejecución.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026