Referencia de código de error de flujo de nube

Use este artículo para solucionar los errores más comunes en Power Automate flujos de nube. Cada entrada explica qué significa el error, por qué ocurre y cómo corregirlo.

Errores en tiempo de diseño

Estos errores se producen al guardar, validar o publicar un flujo.

Plantilla Inválida

Lo que significa: la definición del flujo contiene un error de sintaxis en una configuración de expresión o acción.

Causas comunes:

• Paréntesis o comillas no coincidentes en una expresión
• Hacer referencia a una salida de acción que no existe (tipográfico en nombre de acción)
• Usar una función con el número incorrecto de argumentos (por ejemplo, createArray() sin argumentos)
• Error de coincidencia de tipos en una expresión constante (por ejemplo, int('abc') o div(100, 0)) : el motor los valida en tiempo de ahorro.
• Copiar expresiones de pegado de la documentación que incluye caracteres Unicode invisibles

Cómo corregir:

1. Abra la acción resaltada en rojo en el diseñador.
2. Compruebe la expresión en la barra de fórmulas. Busque caracteres o ( no coincidentes.)'
3. Compruebe que los nombres de acción de las expresiones coinciden exactamente (distingue mayúsculas de minúsculas): outputs('Get_item') no outputs('Get Item').
4. Si la expresión es correcta, elimínela y vuelva a escribirla manualmente para quitar caracteres ocultos.

Información relacionada: ExpressionEvaluationFailed, FlowCheckerError

FlowCheckerError

Lo que significa: el comprobador de flujo encontró uno o varios problemas de validación que impiden guardar.

Causas comunes:

• Un campo obligatorio está vacío en una o varias acciones
• No se selecciona una conexión para una acción del conector
• Una expresión hace referencia a un valor de contenido dinámico de una rama paralela (no se garantiza que exista).
• Las entradas del desencadenador están incompletas

Cómo corregir:

1. Seleccione el banner de error en la parte superior del diseñador para mostrar la lista completa de problemas.
2. Seleccione cada error para ir a la acción afectada.
3. Rellene los campos obligatorios, corrija las expresiones rotas y seleccione conexiones.
4. Vuelva a guardar. El comprobador se ejecuta automáticamente al guardar.

Información relacionada: InvalidTemplate, MissingRequiredProperty

DuplicateActionName

Lo que significa: dos o más acciones en el flujo tienen el mismo nombre interno.

Causas comunes:

• Copiar pegado de una acción sin cambiar su nombre
• Importación de una definición de flujo que se editó manualmente con claves duplicadas
• Cambiar el nombre de una acción a un nombre que ya ha usado otra acción en el mismo ámbito

Cómo corregir:

1. Busque el flujo de acciones con nombres idénticos (compruebe también dentro Apply to Each y Scope contenedores).
2. Cambie el nombre de uno de los duplicados. Seleccione el menú ... de la acción y, a continuación, seleccione Cambiar nombre.
3. Actualice las expresiones que hagan referencia a la acción cuyo nombre ha cambiado: outputs('Old_Name') a outputs('New_Name').

Información relacionada: InvalidTemplate

MissingRequiredProperty

Lo que significa: un campo de entrada obligatorio en una acción o desencadenador está vacío.

Causas comunes:

• Agregar una acción del conector pero no completar la configuración
• El token de contenido dinámico que se resolvió en vacío se usó en un campo obligatorio
• Flujo importado desde una solución en la que no se establecen variables de entorno

Cómo corregir:

1. Abra la acción marcada con el error.
2. Busque los campos marcados con un asterisco rojo (*) que están en blanco.
3. Rellene el valor necesario, ya sea con texto estático o un token de contenido dinámico.
4. En el caso de los flujos de solución, compruebe que todas las variables de entorno tienen valores en el entorno de destino.

Información relacionada: FlowCheckerError

Errores de expresiones en tiempo de ejecución

Estos errores se producen cuando se ejecuta un flujo y no se puede evaluar una expresión.

ExpressionEvaluationFailed

Lo que significa:

No se pudo evaluar una expresión en tiempo de ejecución porque los datos reales no coincidieron con lo que esperaba la expresión. Este error solo se produce cuando la expresión usa valores dinámicos (variables, cuerpo del desencadenador, salidas de acción) que no se pueden comprobar en tiempo de ahorro.

Causas comunes:

• Llamada a int() en una variable que contiene una cadena no numérica en tiempo de ejecución
• Acceso a una propiedad en un objeto NULL (outputs('Get_item')?['body/title'] cuando Get_item no devolvió nada)
• Error de coincidencia de formato de fecha en formatDateTime() o parseDateTime() cuando el formato procede de una variable
• División por cero cuando el divisor es un valor dinámico que tiene lugar en 0

Cómo corregir:

1. Abra la ejecución con errores y seleccione la acción con errores para mostrar los valores de expresión y entrada.
2. Ajuste de expresiones de riesgo con comprobaciones nulas: if(empty(triggerBody()?['value']), 'default', triggerBody()?['value']).
3. Use coalesce() para proporcionar valores de reserva: coalesce(outputs('Get_item')?['body/title'], 'Untitled').
4. Valide los tipos de datos antes de la conversión: if(isInt(variables('input')), int(variables('input')), 0).

Información relacionada: InvalidTemplate, ContentConversionFailed

ContentConversionFailed

Lo que significa: el flujo no pudo convertir datos de un tipo a otro entre acciones.

Causas comunes:

• Pasar una cadena donde se espera un entero o un valor booleano
• Envío de una matriz a una acción que espera un único objeto
• Cadena de fecha en un formato inesperado (por ejemplo, DD/MM/YYYY cuando MM/DD/YYYY se espera)
• Contenido binario (archivo) pasado a una entrada de texto

Cómo corregir:

1. Compruebe las entradas de la acción con error en el historial de ejecución. Compare el tipo de valor real con el que espera la acción.
2. Use funciones de conversión explícitas: int(), float(), string(), bool(), . json()
3. Para las fechas, use parseDateTime() con una configuración regional explícita o formatDateTime() para normalizar antes de pasar.
4. En el caso de las matrices, use first() para extraer un solo elemento si la acción de bajada espera un valor.

Información relacionada: ExpressionEvaluationFailed

Errores de conexión y autenticación

Estos errores se producen cuando el flujo no se puede autenticar en un servicio conectado.

InvalidConnection

Lo que significa: una referencia de conexión en el flujo apunta a una conexión interrumpida, eliminada o expirada.

Causas comunes:

• El usuario que creó la conexión cambió su contraseña o tenía el restablecimiento de MFA.
• La conexión se eliminó de la página Conexiones.
• Un administrador quitó la conexión a través del Centro de administración de Power Platform
• El flujo se importó en un entorno en el que la conexión no existe.

Cómo corregir:

1. Abra el flujo en modo de edición. Las acciones con conexiones interrumpidas muestran un icono de advertencia.
2. Seleccione la acción y seleccione Cambiar conexión o Agregar nueva conexión.
3. Inicie sesión con las credenciales adecuadas para crear una conexión nueva.
4. Guarde y pruebe el flujo.

Información relacionada: ConnectionNotConfigured, ConnectionAuthorizationFailed

ConnectionNotConfigured

Lo que significa: una acción requiere una conexión, pero no se seleccionó ninguna.

Causas comunes:

• El flujo se importó desde una solución y las referencias de conexión no se asignaron
• Se agregó una nueva acción, pero se omitió el paso de conexión.
• La referencia de conexión apunta a una variable de entorno sin ningún valor

Cómo corregir:

1. Abra el flujo en modo de edición y busque la acción con la advertencia de conexión.
2. Seleccione una conexión existente en la lista desplegable o cree una nueva.
3. Para los flujos de solución, vaya a Soluciones>referencias de conexión de solución >predeterminadas.
4. Establezca la conexión para cada referencia.

Información relacionada: InvalidConnection

No autorizado (401)

Lo que significa: la API rechazó la solicitud porque el token de autenticación no es válido o ha expirado.

Causas comunes:

• El token de OAuth expiró y la conexión no pudo actualizarse automáticamente
• La cuenta del usuario se deshabilitó o cambió la contraseña.
• Secreto de entidad de servicio o certificado expirado
• La directiva de acceso condicional bloqueó el inicio de sesión (geo, cumplimiento de dispositivos)

Cómo corregir:

1. Vaya a Power Automate>Connections y busque la conexión usada por la acción con error.
2. Si la conexión muestra una advertencia, seleccione Corregir conexión y volver a autenticarse.
3. Para las conexiones de entidad de servicio, gire el secreto en Microsoft Entra ID y actualice la conexión.
4. Compruebe Microsoft Entra ID registros de inicio de sesión para los bloques de acceso condicional: Azure portal>Microsoft Entra ID> Registros de inicio de sesión, filtre por el nombre de la aplicación.

Información relacionada: Prohibido (403), ConnectionAuthorizationFailed

Prohibido (403)

Lo que significa: el usuario o la aplicación autenticados no tiene permiso para realizar la operación solicitada.

Causas comunes:

• Una directiva DLP (prevención de pérdida de datos) bloquea la acción del conector o del conector en este entorno.
• El usuario carece de permisos en el recurso de destino (por ejemplo, sin acceso de escritura a un SharePoint list)
• Un administrador ha restringido el conector a través de la configuración de nivel de inquilino.
• El conector requiere una licencia Premium y el usuario está en un plan de inicialización

Cómo corregir:

1. Compruebe las directivas DLP: Directivasde datos del Centro > de administración de Power Platform. Busque directivas que bloqueen el conector en el grupo del entorno.
2. Compruebe que el usuario de conexión tiene los permisos adecuados en el servicio de destino (SharePoint permisos de sitio, roles de seguridad de Dataverse y similares).
3. Si se trata de un problema del conector Premium, compruebe que el propietario del flujo o el autor de la llamada tengan una licencia Power Automate Premium.
4. Póngase en contacto con el administrador si es necesario modificar una directiva DLP.

Información relacionada: No autorizado (401), DirectApiAuthorizationRequired

ConnectionAuthorizationFailed

Lo que significa: la conexión existe, pero sus credenciales almacenadas ya no son válidas.

Causas comunes:

• Se ha cambiado la contraseña del usuario o se ha restablecido el método MFA
• El token de actualización de OAuth ha expirado (común con conexiones sin usar durante más de 90 días)
• El administrador revoca el consentimiento de la aplicación en Microsoft Entra ID
• El propietario no ha compartido la conexión compartida

Cómo corregir:

1. Abra Power Automate>Connections.
2. Busque la conexión afectada.
3. Seleccione la conexión y, a continuación, seleccione Corregir conexión para volver a autenticarse.
4. Si usa una conexión compartida, pida al propietario de la conexión que vuelva a compartirla.
5. En el caso de las cuentas de servicio, establezca un aviso de calendario para rotar las credenciales antes de que expiren.

Información relacionada: InvalidConnection, Unauthorized (401)

Errores de conector y API

Estos errores proceden del servicio de bajada al que llama el flujo.

ActionFailed

Lo que significa: una acción devolvió un estado de error. Se trata de un contenedor genérico. Los detalles reales del error se encuentran en el cuerpo de salida de la acción.

Causas comunes:

• La API de bajada devolvió un error 4xx o 5xx
• Error en un flujo secundario (llamado a través de "Ejecutar un flujo secundario")
• Un conector personalizado devolvió un formato de respuesta inesperado
• La configuración de configuración de ejecución después de la acción hizo que se ejecutara después de un error anterior

Cómo corregir:

1. Abra la ejecución con errores y seleccione la acción con errores.
2. Expanda Salidas para mostrar el mensaje de error real y el código de estado de la API.
3. Corrija el problema subyacente en función del error de API específico (revise las entradas 400, 401, 403 y 404 de esta referencia).
4. Si la acción debe ejecutarse incluso cuando se produzca un error en las acciones anteriores, compruebe la opción Configurar ejecución después de la configuración.

Información relacionada: BadRequest (400), NotFound (404)

BadRequest (400)

Lo que significa: la API del conector rechazó la solicitud porque los datos de entrada tienen un formato incorrecto o no son válidos.

Causas comunes:

• Envío de un campo con el tipo de datos incorrecto (cadena en lugar de número, o viceversa)
• Campos obligatorios que faltan en el cuerpo de la solicitud
• Caracteres no válidos en nombres de archivo o títulos de elementos de lista
• Superación de un límite de longitud de campo (por ejemplo, SharePoint texto de una sola línea = 255 caracteres)

Cómo corregir:

1. Abra la acción con errores en el historial de ejecución y examine la sección Entradas para mostrar exactamente lo que se envió.
2. Compare las entradas con el esquema esperado de la API (consulte la documentación del conector).
3. Sanear la entrada del usuario con replace() para quitar caracteres no válidos antes de pasar a la acción.
4. Use substring() o take() para truncar valores largos a la longitud máxima del campo.

Información relacionada: ActionFailed, ContentConversionFailed

NotFound (404)

Lo que significa: el recurso al que la acción intenta acceder no existe.

Causas comunes:

• Se ha cambiado o eliminado un SharePoint list, una biblioteca o un sitio
• Se quitó una carpeta de Outlook o un canal de Teams
• El flujo hace referencia a un identificador codificado de forma codificada para un recurso que ya no existe.
• Otro proceso eliminó la tabla o fila de Dataverse.

Cómo corregir:

1. Compruebe que el recurso todavía existe en el servicio de destino.
2. Si se ha cambiado el nombre, actualice la acción para usar el nuevo nombre o identificador.
3. Reemplace los identificadores codificados de forma dura por búsquedas dinámicas siempre que sea posible (por ejemplo, "Obtener elementos" por un filtro en lugar de "Obtener elemento" por un identificador estático).
4. Agregar control de errores: configure la siguiente acción en Ejecutar después> deque se haya producido un error y controle correctamente el 404.

Información relacionada: ActionFailed

Errores de desencadenador

Estos errores se relacionan con los desencadenadores de flujo que no se activan o producen errores.

TriggerConditionNotMet

Lo que significa: el desencadenador evaluó su condición y determinó que el evento no debe iniciar una ejecución de flujo.

Causas comunes:

• Una expresión de condición de desencadenador siempre se evalúa como false (error lógico)
• La condición del desencadenador hace referencia a un campo que no existe en la carga del desencadenador.
• El evento se produjo, pero los datos no coincidieron con el filtro (por ejemplo, "Cuando se crea un elemento" con una condición en Status, pero Status estaba en blanco)

Cómo corregir:

1. Vaya a configuración del desencadenador y revise la expresión de condición del desencadenador.
2. Pruebe la condición con una carga de eventos conocida. Use Peek code en el desencadenador para mostrar el esquema sin formato.
3. Quite temporalmente la condición, desencadene el flujo manualmente e inspeccione la salida del desencadenador para comprobar los nombres y valores de los campos.
4. Corrija la expresión y vuelva a habilitar la condición.

Información relacionada: ExpressionEvaluationFailed

Errores de tiempo de espera y limitación

Estos errores se producen cuando el flujo o una acción supera los límites de tiempo o velocidad.

ActionTimedOut

Lo que significa: una sola acción superó el tiempo de espera configurado y se canceló.

Causas comunes:

• Acción HTTP que llama a una API externa lenta con un tiempo de espera predeterminado de 100 segundos
• "Esperar una aprobación" con una expiración que pasó
• Carga o descarga de archivos grandes a través de una conexión lenta
• Consulta de Dataverse que devuelve demasiadas filas sin paginación

Cómo corregir:

1. Abra la configuración de la acción y aumente el valor de tiempo de espera (duración ISO 8601, por ejemplo, PT5M durante 5 minutos).
2. Para las acciones HTTP, compruebe si la API externa tiene un patrón de operación de ejecución prolongada (sondee con reintento posterior).
3. Para Dataverse, agregue $filter y $top reduzca el conjunto de resultados.
4. En el caso de las aprobaciones, establezca una expiración razonable y agregue una rama de tiempo de espera para controlar las no respuestas.

Información relacionada: OperationTimedOut

OperationTimedOut

Lo que significa: una operación de ejecución prolongada (espera de webhook, aprobación, sondeo HTTP) superó el tiempo de espera máximo.

Causas comunes:

• Acción de webhook HTTP esperando una devolución de llamada que nunca llegó
• Acción de aprobación sin expiración, alcanzando el límite de ejecución de flujo de 30 días
• Acción "Retrasar hasta" establecida en una fecha superior al límite de duración de la ejecución de 30 días
• El servicio externo se ha inactivo y nunca ha enviado la respuesta esperada.

Cómo corregir:

1. Establezca siempre tiempos de espera explícitos en el webhook y las acciones de aprobación.
2. En el caso de las acciones de webhook HTTP, implemente una rama de tiempo de espera con Configurar ejecución después> deque se agote el tiempo de espera.
3. Interrumpir esperas largas en segmentos más cortos mediante un bucle con comprobaciones diarias.
4. Para el límite de ejecución de 30 días, rediseñe los procesos de ejecución prolongada para usar un patrón de "retransmisión": finalice la ejecución actual e inicie uno nuevo con el estado pasado a través de Dataverse o un archivo.

Información relacionada: ActionTimedOut

WorkflowRunActionRepetitionQuotaExceeded

Lo que significa: un bucle Apply to Each superó el número máximo de iteraciones (valor predeterminado: 100 000 para premium, 5000 para perfiles de rendimiento).

Causas comunes:

• Procesamiento de una tabla de SharePoint list o Dataverse grande sin filtrar primero
• Bucles anidados Apply to Each multiplicando recuentos de iteración (100 x 100 = 10 000)
• Acción Get items que devuelve todas las filas en lugar de un subconjunto filtrado

Cómo corregir:

1. Agregue filtros a la acción del origen de datos para reducir el número de elementos antes del bucle.
2. Use OData $filter y $top en las acciones Obtener elementos en lugar de filtrar dentro del bucle.
3. En el caso de conjuntos de datos de gran tamaño, realice un lote del trabajo entre varias ejecuciones de flujo mediante tokens de paginación o intervalos de fechas.
4. Considere la posibilidad de usar Select o Filter array acciones en lugar de Apply to Each cuando solo necesite transformar o filtrar datos.

Información relacionada: FlowRunQuotaExceeded

FlowRunQuotaExceededed

Lo que significa: el flujo o el inquilino superaron su límite de ejecución de acciones diarias.

Causas comunes:

• Licencia de inicialización o gratuita: 6000 acciones al día por usuario
• Licencia Premium: 40 000 acciones al día por usuario
• Licencia de proceso: 250 000 acciones al día por flujo
• Un flujo con gran cantidad de bucles que consume miles de acciones por ejecución

Cómo corregir:

1. Compruebe el uso actual en Power Platform admin center>Analytics>Power Automate.
2. Optimice los flujos para usar menos acciones: reemplace Aplicar a cada con Select/Filter, operaciones por lotes, reducir la frecuencia de sondeo.
3. Actualice el nivel de licencia si la carga de trabajo necesita legítimamente más capacidad.
4. Distribuir cargas de trabajo entre varios flujos o programar ejecuciones de gran volumen durante las horas de poca actividad.

Información relacionada: WorkflowRunActionRepetitionQuotaExceeded, DirectApiAuthorizationRequired

Errores de licencia

DirectApiAuthorizationRequired

Lo que significa: el flujo usa un conector Premium, pero el autor de la llamada no tiene una licencia Premium.

Causas comunes:

• Un flujo con conectores premium (HTTP, SQL Server, Dataverse, conectores personalizados) lo ejecuta un usuario en una licencia de Microsoft 365 inicializado.
• El propietario del flujo tiene premium, pero el usuario desencadenador no (la licencia del autor de la llamada es importante, no la del propietario).
• El propietario de un flujo programado perdió su licencia Premium
• Un flujo en contexto se desasoció de su aplicación power, lo que lo convierte en fuera del contexto.

Cómo corregir:

1. Identifique qué conector requiere Premium. El mensaje de error suele denominarlo.
2. Asigne una licencia Power Automate Premium al usuario que desencadena o ejecuta el flujo.
3. Para los flujos programados o automatizados, asegúrese de que el propietario del flujo tiene una licencia Premium.
4. Considere si una licencia de proceso (por flujo) es más rentable para los flujos compartidos de gran volumen.

Información relacionada: Prohibido (403), FlowRunQuotaExceeded

Tabla de referencia rápida

Información relacionada

• Manual de expresiones para flujos en la nube
• Corrección de errores de conexión en flujos de nube
• Solución de problemas de errores de flujo en la nube
• Power Automate límites y configuración
• guía de licencias Power Automate

Nota: El autor creó este artículo con ayuda de la inteligencia artificial. Aprende más