Clase 02 · Módulo 13
Reintentos y manejo de errores por nodo
Reintentos y manejo de errores por nodo
Qué logras en esta clase
Configuras cada nodo para que reintente cuando conviene y para que su falla no bote el flujo completo cuando no debe.
- Activas reintentos solo donde sirven.
- Eliges entre detener, continuar o desviar el error.
- Haces fallar un flujo a propósito con un mensaje claro.
02
Dos decisiones por nodo
Cada nodo responde dos preguntas: si vuelve a intentarlo y qué hace cuando igual falla. Ambas se ajustan en el mismo lugar.
03
Dónde están los ajustes
- Abre el nodo con doble clic.
- Pasa de la pestaña de parámetros a la pestaña Settings.
- Ahí encuentras el reintento (Retry On Fail) y el comportamiento ante error (On Error).
04
Retry On Fail: el reintento
Lo viste en el módulo 5, clase 4. Al activarlo defines dos valores:
- Max Tries: cuántas veces intenta en total.
- Wait Between Tries (ms): cuánto espera entre intentos.
Tiene topes: 5 intentos y 5.000 milisegundos de espera. Cubre un tropiezo de segundos, no una caída de diez minutos.
05
Cuándo reintentar y cuándo no
| Situación | ¿Reintentar? |
|---|---|
| Código 5xx o tiempo agotado | Sí |
| Código 429 con límite por segundo | Sí, con espera |
| Código 400: petición mal armada | No, falla igual |
| Código 401 o 403: credencial o permiso | No, hay que reconectar |
| Código 404: dirección equivocada | No |
Reintentar una falla permanente solo retrasa el aviso.
06
El reintento que duplica
En esos nodos, primero asegúrate de que repetir no cause daño.
07
La regla del reintento
Reintenta sin dudar solo lo que puedes repetir sin daño: leer, consultar, actualizar a un valor fijo.
08
Qué operaciones se repiten sin daño
| Operación | ¿Repetir es seguro? |
|---|---|
| Leer filas o consultar una API | Sí |
| Actualizar una fila a «enviado» | Sí: queda igual |
| Insertar o actualizar por un identificador | Sí |
| Agregar una fila nueva | No: duplica |
| Enviar un mensaje o un correo | No: llega dos veces |
Para las últimas dos, la defensa está en el diseño de datos (módulo 7, clase 5).
09
On Error: tres comportamientos
| Opción | Qué hace el flujo |
|---|---|
| Detener el flujo | Se corta ahí y la ejecución queda como fallida. Es el valor por defecto |
| Continuar | Sigue al nodo siguiente como si nada |
| Continuar por la salida de error | El nodo gana una segunda salida y lo fallido sale por ahí |
Comprueba el texto exacto de cada opción en el selector de tu versión.
10
Detener: para lo que no puede faltar
Déjalo así en los pasos sin los cuales lo demás no tiene sentido: leer los pedidos, obtener el precio, guardar el pago.
- La ejecución queda en rojo en el historial.
- Se activa el flujo de errores, si asignaste uno (clase 3).
- Nada posterior se ejecuta con datos incompletos.
Es el comportamiento más seguro. Por eso viene por defecto.
11
Continuar: para lo accesorio
Sirve cuando el paso es un extra: sumar un contador, dejar una nota interna, avisar a un canal secundario.
12
Salida de error: una rama para lo fallido
Los ítems que funcionaron siguen por la salida normal. Los que fallaron salen por la segunda, con el detalle del error, y tú decides qué hacer con ellos.
13
Un ítem malo no bota a los demás
Para trabajo por lotes, la salida de error suele ser la mejor opción.
14
Cuál elegir
- ¿El resto del flujo depende de este paso? Detener.
- ¿Procesa muchos ítems independientes entre sí? Salida de error.
- ¿Es un extra cuyo fallo no afecta al resultado? Continuar.
15
Fallar a propósito con Stop and Error
A veces nada falla técnicamente, pero el dato no sirve: falta el correo, el total es cero, la lista llegó vacía.
El nodo Stop and Error detiene la ejecución con el mensaje que tú escribas y la marca como fallida. Eso activa el flujo de errores igual que una falla real.
16
Validar antes de actuar
- Pon un IF con las condiciones mínimas.
- Conecta la rama falsa a Stop and Error.
- Escribe un mensaje que diga qué faltó.
17
El mensaje importa
Un error que dice qué faltó y en qué pedido se arregla en minutos. Uno que dice «algo salió mal» cuesta una tarde.
18
Cero ítems no es un error
Si un nodo devuelve cero ítems, los nodos siguientes no se ejecutan y la ejecución termina sin error.
A veces es correcto: no había pedidos nuevos. A veces es la falla: la búsqueda está mal escrita.
19
Continuar en todo
Usa «continuar» como excepción, y anota en el nombre del nodo por qué.
20
Probar cada ajuste con un error forzado
- Duplica el flujo para no tocar el publicado.
- Rompe un nodo a propósito: una dirección que no existe o un campo obligatorio vacío.
- Ejecuta y observa: ¿reintentó?, ¿por qué salida siguió?, ¿qué recibió el nodo siguiente?
- Repite con cada opción de On Error.
Diez minutos de esto enseñan más que cualquier tabla.
21
Lo que te llevas
- Reintento y manejo de error se ajustan en Settings de cada nodo.
- Reintenta fallas pasajeras y solo en pasos que se repiten sin daño.
- Detener para lo crítico, salida de error para lotes, continuar para lo accesorio.
- Stop and Error convierte un dato inservible en una falla visible.
- Cero ítems termina sin error: decide si eso es normal.
22
Hazlo ahora
En 15 minutos:
- Arma un flujo con Manual Trigger, un Edit Fields que cree tres ítems y un HTTP Request.
- Haz que uno de los tres use una dirección inexistente.
- Ejecuta con «detener» y anota cuántos ítems pasaron.
- Cambia a salida de error y ejecuta de nuevo.
- Agrega un IF con Stop and Error que rechace un ítem sin nombre.
Compara las tres ejecuciones en el historial.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026