Ejecutar
Resolución de problemas
Empieza por lo que ves: el workflow no se ejecutó, una ejecución falló o una ejecución no avanza. Cada sección enumera las causas probables en el orden en que conviene comprobarlas.
El workflow no se ejecutó
Enlace a esta sección: El workflow no se ejecutóUn trigger que se dispara y un trigger que se filtró o se ignoró se ven igual desde fuera: no hay ejecución. Comprueba, en este orden:
- ¿Está publicado y está «Live»? Un borrador, un workflow pausado y uno archivado no disparan nada. Si el panel dice «Cambios sin publicar», el workflow está ejecutando la versión antigua.
- ¿Publicaste después de cambiar el trigger o su filtro? Los triggers y los filtros surten efecto al publicar, no al autoguardar.
- Trigger de evento: ¿el cambio es uno de los eventos del catálogo? Las etiquetas, la disponibilidad, la mayoría de las importaciones y la mayoría de las operaciones sobre unidades serializadas (preparar, entregar, devolver) no son eventos. Crear una unidad serializada sí lo es. ¿Es el «Solo cuando» filtro? Un filtro que falla en cerrado, como una variable ausente, un null o una fecha comparada con un instante, no deja ninguna ejecución, en silencio. Quita el filtro para probar.
- Trigger de evento de una cuenta conectada: ¿está conectada la cuenta y es el propio buzón del creador? Los triggers de email y calendario solo se disparan para workflows creados por el propietario del buzón y requieren el add-on de email y calendario.
- Evento causado por otro workflow: Filmo nunca inicia un workflow que ya está en la cadena que causó el evento, y corta una cadena a los diez saltos.
- Agenda: comprobar «Zona horaria», y ten presente que una ejecución empieza con hasta aproximadamente un minuto de retraso, que las ocurrencias perdidas no se recuperan y que las ocurrencias que pasan mientras el workflow está pausado se pierden.
- Señal: ¿está archivada la señal? ¿Está en Live y publicado el workflow que escucha? ¿Has vuelto a publicar el workflow que escucha después de cambiar la señal?
- Un webhook: consulta más abajo.
Un webhook responde 401, 404 o 202 y no pasa nada
Enlace a esta sección: Un webhook responde 401, 404 o 202 y no pasa nada| Obtienes | Causa probable |
|---|---|
404 not_found | El workflow no está publicado, en Live ni pausado; el token es incorrecto; o el trigger ya no es un webhook. |
401 unauthorized | Falta el secreto o es incorrecto. Envía X-Webhook-Secret o Authorization: Bearer. |
409 no_version | El workflow nunca se publicó. |
400 invalid_json | El cuerpo está vacío o no es JSON. |
| 429 | Unas 60 peticiones por minuto a esta dirección (contadas por instancia de servidor). |
200 con duplicate: true | Repetiste un Idempotency-Key: no hay ejecución nueva, el mismo id de ejecución. |
413 body_too_large | El cuerpo supera los 256 KiB. |
400 idempotency_key_too_long | La clave tiene más de 255 caracteres. |
| 202, y después la ejecución falla | El cuerpo no coincidía con el tipo que declaraste. El 202 significa que se puso en cola; abre la ejecución para ver por qué. |
| 202, pero dos ejecuciones | No enviaste un Idempotency-Key. |
Un run falló
Enlace a esta sección: Un run falló- Abre la ejecución y haz clic en el paso con el borde rojo. Lee el «Error» pestaña: el estado HTTP y el cuerpo, los campos que fallaron, los detalles y el código. Los mensajes del motor están en español.
- "No tienes permiso para ejecutar …": el creador del workflow no tiene el permiso, o la acción está bloqueada por un add-on, un proveedor que no está conectado o los créditos de IA. Cuenta el rol actual del creador, no el que tenía cuando lo construyó.
- "El campo … no tiene valor": una variable que lee el paso no existía en esta ejecución, o un texto hacía referencia a un valor que no existe. Consulta datos y expresiones, valores vacíos.
- "… esperaba un texto y recibió un número": los datos no coinciden con su tipo declarado. Declara el campo con el tipo que realmente tiene, o como Desconocido.
- "El bucle superó … vueltas": el límite del bucle cuenta comprobaciones de la condición, así que el cuerpo puede ejecutarse una vez menos que el máximo. Súbelo, o corrige la condición.
- "… resolvió más de 500 elementos": acota lo que iteras.
- "La ejecución superó el presupuesto de 1000 pasos": un bucle o una iteración está haciendo demasiado. Divídelo.
- Un paso HTTP falló con un estado: la respuesta está en el error del paso. Filmo no reintenta. Arregla tu endpoint y pulsa Reintentar.
- El run está completado pero un paso no hizo su trabajo: busca una tarjeta marcada como error capturado. Un paso Intentar capturó el fallo y el run siguió; abre el Intentar para leer el mensaje. Consulta el paso Intentar.
- Email o Slack: el buzón del creador está desconectado, la cuenta remitente pertenece a otra persona, o el canal de Slack se indica por nombre en lugar de por id.
- Contabilidad: "Asignar el impuesto en <provider>" abre el mapa de impuestos. Guárdalo y reintenta las ejecuciones bloqueadas.
Un run no avanza
Enlace a esta sección: Un run no avanza| Estado | Qué hacer |
|---|---|
| «En cola» | Dale un minuto: si se pierde un kick, el tick del minuto siguiente lo recoge. Si persiste, avisa a soporte. |
| «Ejecutándose» | Un worker la mantiene como máximo cinco minutos; después se retoma. |
| «En espera» | Abre la ejecución: la tarjeta indica cuándo se reanuda. Un paso de espera se despierta con un retraso de hasta un minuto aproximadamente. Aquí también aparece una ejecución que está reintentando tras un error del motor. |
| «Pausado» | Sin crédito o un problema de pago. Soluciónalo y pulsa «Reanudar»: nada despierta por sí solo una ejecución pausada. |
No puedo publicar, poner en Live ni cambiar la visibilidad
Enlace a esta sección: No puedo publicar, poner en Live ni cambiar la visibilidad| Mensaje | Causa |
|---|---|
| Un campo obligatorio está en blanco (422): "<step> → <field>" | Rellena los campos, tal como los dejó en blanco la plantilla. |
| "<Integration> necesita configuración: …" (422) | A un proveedor de contabilidad conectado le faltan cuentas, mapas de impuestos o una cuenta de pago. |
| Un paso está vinculado a un proveedor al que su cuenta no pertenece (422) | Elige una cuenta de ese proveedor o desvincula el paso. |
| "Publica el workflow antes de activarlo" (409) | Un borrador de plantilla: usa Publicar y activar. |
| "Un workflow con pasos privados (email) no se puede hacer público" (409) | Elimina los pasos de email y calendario, también en el borrador y en la versión publicada. |
| "El workflow se modificó desde otro sitio al mismo tiempo" (409) | Alguien publicó en el mismo momento. Inténtalo de nuevo. |
| "La definición del workflow no es válida" (422) | El mensaje enumera los tres primeros campos incorrectos. |
| "La expresión cron no es válida" (422) | Corrige la expresión del trigger programado. |
Mis cambios han desaparecido
Si no eres administrador, tus ediciones no se guardan y el editor no te lo indica. Consulta con un administrador.
Otras cosas que se preguntan
Enlace a esta sección: Otras cosas que se preguntan- Un workflow se ha desactivado solo: lo publicaste estando en Live con campos obligatorios vacíos. Rellénalos y actívalo.
- Avisos o tareas duplicados: la misma plantilla se instaló dos veces, o un trigger de evento y una programación hacen el mismo trabajo.
- Una condición fue por el camino equivocado: fechas comparadas con instantes; texto comparado con otra capitalización; una variable que no existe.
- Un run muestra solo la primera ejecución de un paso dentro de un bucle: así funciona el panel del paso.
- El historial de runs termina en 100 ejecuciones: es lo máximo que muestra el visor. Las ejecuciones se eliminan 90 días después de acabar.
- Sin aviso por email: solo uno por hora y por workflow. Revisa las notificaciones internas.
Si te quedas atascado, la lista completa de estados, errores y límites está en Runs, Errores y reintentos y Límites y créditos.
Páginas relacionadas
Enlace a esta sección: Páginas relacionadasEjecutar
Runs
Un run es una ejecución de un workflow. Cada run guarda lo que hizo, paso a paso, para que puedas ver dónde se detuvo y por qué.
Ejecutar
Errores y reintentos
En un run pueden ir mal dos cosas distintas: un paso informa de un problema, o el propio motor falla. Se tratan de forma diferente, y la diferencia es lo más importante de esta página.
Ejecutar
Límites y créditos
El motor aplica cada uno de los límites siguientes. La última columna dice qué ocurre cuando lo alcanzas, porque esa suele ser la pregunta.
¿Te ha resultado útil esta página?