Solución de problemas de EDI

Esta guía cubre errores y problemas comunes al usar Jitterbit EDI. Comienza con los pasos de diagnóstico a continuación, luego encuentra tu problema específico en la sección correspondiente.

Para una referencia unificada que cubra problemas de integración, automatización, gestión de API, EDI y desarrollo de aplicaciones en un solo lugar, consulta la guía de solución de problemas de Harmony.

Para problemas con una operación de Studio que se integra con Jitterbit EDI (por ejemplo, una que usa el conector EDI for Cloud v2), consulta la solución de problemas de operaciones, o la solución de problemas del agente privado si la operación se ejecuta en un agente privado.

Pasos de diagnóstico

Verificar el estado de la transacción

Abre la página Transacciones y filtra por transacciones fallidas o rechazadas. El estado y cualquier mensaje de error asociado que se muestre para la transacción son los indicadores principales de qué salió mal.

Verificar la página de Mensajería

La página Mensajería muestra mensajes del registro del sistema de EDI. Para encontrar mensajes relacionados con una transmisión fallida o documento, filtra por estado de Error, socio comercial, nivel de gravedad (Alto, Medio, Bajo o Información), y categoría de mensaje. Para problemas de transmisión, filtra por la categoría Comunicación (canales AS2, FTP y VAN); para problemas de procesamiento de documentos, filtra por la categoría Transacción (Procesador y Validación).

Verificar la página de Archivo

La página Archivo contiene los documentos EDI sin procesar entrantes y salientes para transacciones archivadas. Revisar un documento archivado puede confirmar si un fallo está en el contenido del documento en sí o en la lógica de procesamiento.

Verificar los registros de operación y agente

Si la integración usa el conector EDI for Cloud v2 en una operación de Studio, primero revisa los registros de operación para detectar errores de la ejecución de la operación. Si la operación se ejecuta en un agente privado y necesitas detalles de nivel inferior, como errores de conectividad, también revisa los registros del agente.

Fallos de comunicación EDI

Fallo de conexión AS2 o certificado

• Síntoma: Las transmisiones AS2 salientes fallan o no se reciben los reconocimientos del socio comercial.
• Posibles causas:
  • El certificado AS2 ha expirado o ya no es de confianza para el socio comercial.
  • El algoritmo del certificado no coincide con lo que requiere el socio comercial (por ejemplo, SHA-1 vs. SHA-256).
  • La URL del punto de conexión AS2, el ID del socio u otros parámetros de conexión son incorrectos.
  • Un firewall o restricción de red está bloqueando el tráfico AS2 saliente en el puerto 443 o en el puerto AS2 configurado.
• Resolución:
  • Revisa la configuración de comunicación AS2 del socio comercial afectado y confirma que la URL del punto de conexión, los IDs de socio y la configuración del certificado sean correctos.
  • Verifica la fecha de vencimiento del certificado y renuévalo si ha expirado. Intercambia el certificado actualizado con el socio comercial.
  • Confirma que el algoritmo del certificado coincida con los requisitos del socio comercial. Actualiza el algoritmo en la configuración de AS2 si es necesario.
  • Verifica que el firewall de red permita el tráfico saliente hacia el punto de conexión AS2 del socio comercial.

AS2: El firewall del socio comercial debe permitir las direcciones IP de Jitterbit

• Síntoma: Un socio comercial reporta que no puede recibir tus transmisiones AS2, o sus reconocimientos AS2 nunca llegan, aunque la configuración de AS2 saliente parezca correcta.
• Posible causa: El firewall del socio comercial requiere una lista de permitidos explícita para el tráfico entrante y no ha agregado las direcciones IP de Jitterbit EDI.

• Resolución:

  • Proporciona las siguientes direcciones IP de Jitterbit EDI a tu socio comercial y solicita que las agregue a la lista de permitidos para el tráfico AS2 entrante y saliente:

    • América del Norte: 40.71.22.62
    • EMEA y APAC: 20.166.31.85

  • Para tu URL de recepción AS2 entrante y la dirección IP correspondiente que debes proporcionar a los socios comerciales, consulta la página de configuración de comunicación AS2 de tu región.

Fallo de conexión FTP o SFTP

• Síntoma: Las transmisiones FTP o SFTP hacia o desde un socio comercial fallan, o las transferencias de archivos se cuelgan y agotan el tiempo de espera.
• Posibles causas:
  • La dirección del servidor, el puerto, las credenciales o el método de autenticación (contraseña vs. clave SSH) son incorrectos u obsoletos.
  • Un firewall o restricción de red está bloqueando el puerto requerido entre Jitterbit EDI y el servidor FTP/SFTP.
  • El directorio de destino no existe o la cuenta de servicio carece de permisos de lectura/escritura en él.
  • La clave de host ha cambiado en el servidor SFTP, causando una falta de coincidencia.
• Resolución:
  • Revisa la configuración de comunicación FTP del socio comercial afectado y verifica todos los parámetros de conexión.
  • Confirma que la conectividad a la dirección y puerto del servidor FTP/SFTP está permitida a través de los firewalls relevantes.
  • Verifica que la cuenta de servicio tenga los permisos requeridos en el directorio de destino.
  • Si usas autenticación de clave SSH, confirma que la clave es actual y es aceptada por el servidor. Si la clave de host ha cambiado, actualiza la entrada de hosts conocidos.

La verificación de transacciones duplicadas no se aplica a los formatos EDIXml o XCBL

• Síntoma: Se están procesando múltiples veces documentos inbound duplicados aunque la configuración Duplicate Transaction Check esté habilitada en la conexión AS2 del socio comercial.
• Causa posible: La Duplicate Transaction Check se aplica solo a documentos en formato EDI. No filtra duplicados para los formatos de intercambio EDIXml o XCBL.
• Resolución: Si se requiere filtrado de duplicados para flujos de trabajo EDIXml o XCBL, implementa lógica de deduplicación en la operación de Studio que procesa los documentos inbound (por ejemplo, verificando un ID de transacción contra un registro de base de datos o Cloud Datastore antes de procesarlo).

Problemas de conectividad de VAN

• Síntoma: Los documentos EDI no se están entregando ni recibiendo a través de una Red de Valor Agregado (VAN).
• Causa posible: Una conexión VAN es una conexión administrada que Jitterbit configura; no puedes crearla ni configurarla por tu cuenta. Los fallos de entrega generalmente involucran la interconexión VAN, el enrutamiento de buzones o la configuración del socio en el lado del proveedor, en lugar de una configuración de autoservicio en Jitterbit EDI.
• Resolución:
  • Confirma que la conexión VAN correcta esté asignada al socio comercial afectado.
  • Dado que la conexión VAN no se puede configurar directamente desde Jitterbit EDI, contacta al soporte de Jitterbit o a tu Customer Success Manager para verificar la interconexión VAN y el enrutamiento de documentos.
  • Coordina con el proveedor de VAN para confirmar que los identificadores de buzón y el enrutamiento del socio comercial sean correctos en el lado de VAN.

La actividad EDI for Cloud v2 falla en un agente privado detrás de un firewall o proxy

• Síntoma: En un agente privado, una actividad EDI for Cloud v2 como Get Document no puede recuperar datos (por ejemplo, con un error "Unable to fetch data"), aunque la prueba de conexión sea exitosa y el mismo proyecto funcione en un grupo de agentes en la nube.
• Causa posible: El agente privado está detrás de un firewall o proxy que bloquea el acceso saliente al servicio Jitterbit eiCloud EDI en eicloudservice.com. El conector EDI for Cloud v2 llama a este servicio (por ejemplo, en *.transactionapi.eicloudservice.com) para recuperar datos, por lo que bloquearlo causa que la actividad falle. Los agentes en la nube no se ven afectados.
• Resolución:
  1. Agrega a la lista de permitidos eicloudservice.com y sus subdominios para acceso saliente en la red, firewall y proxy del agente privado. Para los otros dominios de Jitterbit e direcciones IP que un agente privado necesita para acceso saliente, consulta Información de lista de permitidos.
  2. Si se está utilizando un proxy, confirma que esté configurado correctamente en el agente privado y que no esté interfiriendo con la conexión.

El token de acceso EDI desactivado causa error INVALID_TOKEN

• Síntoma: Las operaciones que utilizan el conector EDI for Cloud v2 fallan con:

  Error opening connection. Exception is: Error code: INVALID_TOKEN
  

• Causa posible: El token de acceso utilizado por la conexión EDI for Cloud v2 ha sido configurado como Inactive en la página Access Tokens de la Management Console.

• Resolución: En la página Access Tokens, localiza el token y establece su Status en Active.

Errores en el procesamiento de documentos

Documento rechazado: Datos inválidos o faltantes

• Síntoma: Un documento EDI saliente es rechazado por el socio comercial o falla la validación, o un documento entrante genera un acuse de recibo negativo.
• Posibles causas:
  • Falta un segmento o elemento de datos requerido en el documento.
  • Un valor de campo excede la longitud permitida, utiliza un tipo de datos incorrecto o contiene caracteres inválidos.
  • El indicador de uso del intercambio (ISA15) está configurado en T (prueba) en lugar de P (producción), por lo que el socio comercial rechaza el documento.
  • El documento no se ajusta a la guía de implementación del socio comercial.
• Resolución: Revisa la transacción rechazada en la página Transacciones para el segmento o elemento específico citado en el error, luego:
  • Para un documento que enviaste, compáralo con la guía de implementación del socio comercial para identificar campos faltantes o no conformes, luego actualiza la asignación EDI y la configuración del tipo de documento afectado para producir resultados conformes.
  • Para un documento entrante enviado por el socio comercial, comparte el error de validación con ellos para que corrijan su formato saliente.

Error de asignación o esquema EDI

• Síntoma: Los documentos EDI se generan con contenido incorrecto, campos faltantes o una estructura inesperada, o los documentos entrantes no se procesan correctamente.
• Posibles causas:
  • La asignación o esquema EDI está desactualizado y no refleja la guía de implementación actual o los requisitos del socio comercial.
  • Los campos de datos de origen se asignan incorrectamente, produciendo valores incorrectos en el documento de salida.
  • Las discrepancias de tipos de datos, caracteres especiales o problemas de codificación en los datos de origen causan fallos en la transformación.
• Resolución:
  1. Revisa la configuración EDI del socio comercial afectado en Configuración EDI y verifica que la asignación refleje con precisión la guía de implementación actual.
  2. Valida que los campos de datos de origen se asignen a los segmentos y elementos EDI correctos.
  3. Verifica los datos de origen para detectar caracteres especiales, problemas de codificación o valores inesperados que puedan estar causando fallos en la transformación y añade pasos de limpieza de datos si es necesario.
  4. Prueba con un documento de muestra representativo y utiliza el archivo para comparar la salida generada con la estructura esperada.

Error de transformación: Campo no reconocido en la actividad EDI for Cloud v2

• Síntoma: Una transformación que utiliza una actividad EDI for Cloud v2 (como List Transactions) falla con un error de análisis JSON que hace referencia a un nombre de campo no reconocido, por ejemplo:

  Unrecognized field "user_defined_field_1"
  

• Posible causa: La versión del conector EDI for Cloud v2 instalado en el agente está desactualizada. El servicio EDI de backend devuelve un campo (como user_defined_field_1) que la versión anterior del conector no reconoce, por lo que el conector no puede analizar la respuesta.

• Resolución: Actualiza el conector EDI for Cloud v2 en el agente a la versión más reciente, siguiendo Confirmar disponibilidad del conector y mantenerlo actualizado en la guía de solución de problemas del conector. Al hacer clic en Test Connection en la conexión EDI for Cloud v2, se descarga la versión más reciente del conector al agente; si la política de organización Disable Auto Connector Update está habilitada, actualiza el conector del grupo de agentes desde la página Agentes de la Consola de administración.

Los segmentos o bucles EDI repetidos mapean solo la última iteración

• Síntoma: En una transformación de Studio, un segmento o bucle repetido en un documento EDI manejado a través del conector EDI for Cloud v2 mapea solo su última ocurrencia (las iteraciones anteriores se descartan), porque la cardinalidad del nodo en el esquema de actividad del conector es de ocurrencia única (por ejemplo, (0,1)) en lugar de repetida ((1,many)). Esto afecta tanto a X12 (por ejemplo, un segmento N9 anidado dentro de un bucle LX en un 945) como a EDIFACT (por ejemplo, un grupo CNI repetido en un IFCSUM).
• Posible causa: El esquema generado automáticamente proporcionado por el conector EDI for Cloud v2 no refleja la cardinalidad correcta para el segmento o bucle afectado. El documento sin procesar en el almacén de EDI Transactions contiene todas las iteraciones, y un esquema construido manualmente a partir de ese XML sin procesar las mapea correctamente, lo que confirma el esquema de respuesta del conector (no los datos) como la causa.
• Resolución:
  1. Abre la conexión EDI for Cloud v2 en Studio y actualiza los metadatos para verificar si se ha publicado una corrección de esquema.
  2. Si la cardinalidad sigue siendo incorrecta después de actualizar, exporta el esquema, actualiza manualmente el atributo maxOccurs en el segmento afectado en un editor XML externo y vuelve a importarlo como un XSD personalizado.

Agregar niveles de bucle jerárquico (HL) anidados a una transformación EDI

• Síntoma: Al construir una transformación de Studio para un conjunto de transacciones EDI que utiliza bucles jerárquicos (por ejemplo, X12 870 4010VICS, que tiene una estructura similar a la del 856), el esquema de la actividad Send Document del conector EDI for Cloud v2 muestra un único nivel HL, pero el documento que necesitas producir requiere niveles HL anidados (por ejemplo, un nivel de orden HL-O con un nivel de artículo secundario HL-I).
• Posible causa: Los documentos jerárquicos pueden anidar niveles HL a profundidades variables, por lo que el esquema del conector expone un único nivel HL que replicas en la transformación para construir los niveles adicionales que tu documento requiere.
• Resolución:
  1. En el árbol de esquema de destino de la transformación, haz clic derecho en el nodo HL existente y selecciona Duplicate node para agregar el nivel HL anidado (por ejemplo, un nivel secundario HL-I bajo HL-O).
  2. Mapea el nodo duplicado a tus datos de origen. Agrega una condición en el nodo duplicado si debe crearse en la salida solo bajo circunstancias específicas.

Configuración del socio comercial

Identificadores de socio comercial incorrectos

• Síntoma: Los documentos se enrutan incorrectamente, se rechazan a nivel de sobre o no son reconocidos por el socio comercial.
• Posibles causas:
  • El ID de EDI del remitente o destinatario, el código calificador u otros identificadores a nivel de sobre no coinciden con lo que espera el socio comercial.
  • La configuración del socio comercial se actualizó recientemente pero el cambio no se aplicó en Jitterbit EDI.
• Resolución:
  1. Revisa la configuración del socio comercial y confirma que el ID de EDI y los códigos calificadores coincidan con los valores especificados en la documentación de configuración del socio comercial.
  2. Compara los identificadores de sobre en un documento rechazado (visible en el archivo) con los valores esperados.
  3. Actualiza la configuración del socio comercial si algún identificador es incorrecto, luego reprocesa o reenvía los documentos afectados.

Los valores de anulación de ID de EDI no se aplican a las transacciones salientes

• Síntoma: Las transacciones salientes utilizan los ID de EDI del remitente o receptor predeterminados de la configuración del socio comercial en lugar de los ID de anulación preferidos configurados en la configuración de ID de EDI.
• Causa posible: Las anulaciones de ID de EDI no se aplican automáticamente. Los ID preferidos deben asignarse explícitamente en la transformación de solicitud de la operación de Studio que envía el documento saliente mediante el conector EDI for Cloud v2.
• Resolución: En esa transformación de solicitud, asigna valores a estos campos para aplicar los ID preferidos (consulta la página Configuración de ID de EDI para conocer los valores exactos a utilizar):
  • ISA05_ID_Qualifier: calificador de ID del remitente
  • ISA06_Sender_ID: ID de EDI del remitente
  • ISA07_ID_Qualifier: calificador de ID del receptor
  • ISA08_Receiver_ID: ID de EDI del receptor

Confirmaciones no configuradas o no recibidas

• Síntoma: Las confirmaciones funcionales esperadas 997 (X12) o CONTRL (EDIFACT) no se están enviando ni recibiendo, o el procesamiento de confirmaciones no funciona como se esperaba.
• Causas posibles:
  • La generación o el procesamiento de confirmaciones está deshabilitado en la configuración de EDI del socio comercial.
  • El tipo de documento de confirmación no está incluido en la configuración del flujo de trabajo del socio comercial.
  • El socio comercial no está enviando confirmaciones, o sus confirmaciones se están enrutando incorrectamente.
• Resolución:
  • En la configuración de EDI del socio comercial, confirma que la generación y el procesamiento de confirmaciones estén habilitados para los tipos de documento relevantes.
  • Revisa la configuración de administrar flujos de trabajo para confirmar que el tipo de documento de confirmación esté incluido en el flujo de trabajo.
  • Consulta el archivo para determinar si las confirmaciones del socio comercial se están recibiendo pero no se están procesando, o si no están llegando en absoluto.
  • Si las confirmaciones no están llegando, coordina con el socio comercial para confirmar que las está enviando al punto de conexión correcto.

No se puede eliminar una conexión de comunicación asignada

• Síntoma: El intento de eliminar una conexión AS2 o FTP en la Configuración de comunicaciones falla o la opción de eliminar no está disponible.
• Causa posible: No se pueden eliminar las conexiones asignadas. Una conexión que está actualmente asignada a un socio comercial debe desasignarse antes de poder eliminarse.
• Resolución:
  1. En Configuración de comunicaciones, selecciona el socio comercial que utiliza la conexión y asigna una conexión diferente a ese socio.
  2. Una vez que ningún socio esté utilizando la conexión, la opción de eliminar estará disponible.

La "Hora de la próxima ejecución" de FTP no se actualiza sin actualizar la página

• Síntoma: La Hora de la próxima ejecución que se muestra en la configuración de comunicaciones FTP de un socio comercial permanece obsoleta después de que se haya ejecutado el trabajo FTP programado, aunque el cronograma funcione correctamente.
• Causa posible: La interfaz de usuario actualiza el estado de los trabajos programados solo cuando se carga la página o cuando una acción manual activa una recarga de datos. No consulta el motor en tiempo real.
• Resolución:
  • Actualiza la página del navegador para actualizar la visualización de Hora de la próxima ejecución.
  • Alternativamente, navega fuera de la configuración de FTP y vuelve para forzar una recarga.

La adición de ID de EDI o ID preferido falla: ID ya en uso

• Síntoma: La adición de un ID de EDI o un ID preferido a un socio comercial falla, incluso cuando el ID no parece estar en uso en el entorno actual. Se muestra uno de los siguientes mensajes:

No se puede agregar el ID de EDI [ID] porque está actualmente en uso; confirme y proporcione un ID único.

No se puede agregar el ID preferido [ID] porque está actualmente en uso; confirme y proporcione un ID único.

• Posibles causas:

  • Cada ID de EDI debe ser único en todos los entornos de Harmony donde esté habilitado Jitterbit EDI. Si el mismo ID ya está asignado a un socio comercial en un entorno diferente, la adición falla.
  • Un ID preferido debe ser único dentro del entorno. Se rechaza si ya está asignado al mismo socio comercial o a otro socio comercial en el mismo entorno.

• Resolución:

  • Para un ID de EDI duplicado, verifique todos los demás entornos de Harmony donde esté habilitado EDI para confirmar si el ID ya está asignado allí. Trabaje con su socio comercial para establecer un ID de EDI único para cada entorno donde intercambie documentos, y use un ID distinto para entornos que no sean de producción que difiera de su ID de EDI de producción.
  • Para un ID preferido duplicado, consulte la lista de ID preferido (ID de ISA) del socio comercial actual y de otros socios comerciales en el mismo entorno, luego elija un ID único.

Configuración del flujo de trabajo

Los documentos salientes pasan la validación local pero fallan en las pruebas del socio comercial

• Síntoma: Los documentos EDI salientes pasan la verificación de validación local en Jitterbit EDI pero se rechazan durante las pruebas o certificación del socio comercial, a menudo con errores sobre elementos faltantes o no conformes.
• Posibles causas:
  • La validación saliente está deshabilitada en la configuración del flujo de trabajo. Jitterbit EDI permite que se generen documentos sin validación, pero sin ella, los documentos pueden carecer de elementos requeridos por la guía de implementación del socio comercial.
  • La configuración de EDI cubre los elementos esenciales del estándar, pero la guía de implementación del socio comercial puede requerir elementos obligatorios adicionales que no se aplican en la configuración predeterminada.
• Resolución:
  • En la configuración de administrar flujos de trabajo, habilite la validación para el flujo de trabajo saliente.
  • Revise la guía de implementación del socio comercial para identificar elementos obligatorios más allá de la configuración estándar de EDI y agréguelos al mapeo.
  • A menos que tenga un conocimiento profundo de la transacción EDI específica y los requisitos del socio comercial, siempre habilite la validación antes de realizar pruebas con un socio comercial.

Archivo y transacciones

Transacción archivada antes o después de lo esperado

• Síntoma: Una transacción se archiva antes de que finalice el período de retención esperado, o permanece disponible más tiempo del esperado.
• Posible causa: Las transacciones se archivan según la fecha posterior de dos fechas: la fecha de la transacción y la fecha del documento. Si la fecha del documento es más reciente que la fecha de la transacción, el archivo se calcula a partir de la fecha del documento, lo que puede extender el período de retención.
• Resolución:
  • Al investigar el tiempo de archivo inesperado, verifique tanto la fecha de la transacción como la fecha del documento de la transacción afectada.
  • Revise la configuración del período de retención para confirmar el número de días configurado (30, 60 o 90).

Permisos y acceso

No se puede acceder a las funciones de EDI

• Síntoma: Un usuario no puede ver o interactuar con páginas de EDI, o ciertas acciones de EDI no están disponibles.
• Posibles causas:
  • El acceso a EDI requiere tanto un permiso de rol específico de EDI (Admin, EDI User o EDI Viewer) como un rol de acceso al entorno de nivel Write. La falta de cualquiera de los dos impide el acceso.
  • Los roles EDI User y EDI Viewer difieren en lo que permiten. EDI Viewer puede reprocesar transacciones, reenviar confirmaciones y leer páginas, pero no puede crear o actualizar configuraciones ni cargar archivos. Crear o actualizar configuraciones y cargar archivos para procesamiento requiere el rol EDI User. Las acciones administrativas, como archivar transacciones, habilitar PII y cambiar la configuración de purga, requieren el rol Admin.
• Resolución:
  • En la Consola de administración, verifique que el usuario tenga un rol que incluya el permiso Admin, EDI User o EDI Viewer.
  • Confirme que el nivel de acceso del entorno del usuario incluya acceso Write para el entorno donde esté configurado EDI.
  • Si el usuario necesita realizar operaciones de escritura (como crear socios comerciales o cargar documentos), asigne el rol EDI User en lugar de EDI Viewer. Consulte Permisos de EDI para la matriz de permisos completa.

No se pueden habilitar los ajustes de PII

• Síntoma: La opción para habilitar los ajustes de PII (información de identificación personal) para un socio comercial no está disponible o aparece deshabilitada.
• Causa posible: Habilitar los ajustes de PII requiere el permiso de Admin permission. Ni el rol de EDI User ni el de EDI Viewer pueden habilitar los ajustes de PII.
• Resolución:
  • Confirma que el rol del usuario incluya el permiso de Admin, no solo EDI User o EDI Viewer.
  • Si el usuario necesita administrar los ajustes de PII regularmente, actualiza su asignación de rol en consecuencia.