Saltar al contenido

Solución de problemas de EDI

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

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 operación, o la solución de problemas del agente privado si la operación se ejecuta en un agente privado.

Todas las entradas de solución de problemas en esta página

Pasos de diagnóstico

Verifica 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.

Verifica la página Mensajería

La página Mensajería muestra los mensajes del registro del sistema de EDI. Para encontrar mensajes relacionados con una transmisión fallida o un documento, filtra por estado de Error, socio comercial, nivel de severidad (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 y FTP); para problemas de procesamiento de documentos, filtra por la categoría Transacción.

Verifica la página Archivo

La página Archivo contiene los documentos EDI sin procesar entrantes y salientes para las transacciones archivadas. Revisar un documento archivado puede confirmar si una falla 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 utiliza 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.


Fallas de comunicación EDI

Falla 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 caducado 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 final AS2, el ID del socio u otros parámetros de conexión son incorrectos.
    • Un cortafuegos o restricción de red está bloqueando el tráfico AS2 saliente en el puerto 443 o el puerto AS2 configurado.
  • Resolución:
    • Revisa la configuración de conexión AS2 para el socio comercial afectado y confirma que la URL del punto final, los ID de socios y la configuración de certificados sean correctos.
    • Verifica la fecha de caducidad del certificado y renuévalo si ha caducado. Intercambia el certificado actualizado con el socio comercial.
    • Confirma que el algoritmo del certificado coincide con los requisitos del socio comercial. Actualiza el algoritmo en la configuración AS2 si es necesario.
    • Verifica que el tráfico saliente hacia el punto final AS2 del socio comercial esté permitido por el cortafuegos de red.

AS2: El cortafuegos del socio comercial debe incluir en la lista blanca las direcciones IP de Jitterbit

  • Síntoma: Un socio comercial informa que no puede recibir tus transmisiones AS2, o sus reconocimientos AS2 nunca llegan, a pesar de que la configuración AS2 saliente parece correcta.
  • Posible causa: El cortafuegos del socio comercial requiere una lista blanca explícita para tráfico entrante y no ha añadido las direcciones IP de Jitterbit EDI.
  • Resolución:

    • Proporciona las siguientes direcciones IP de Jitterbit EDI a tu socio comercial y solicita que las incluya en la lista blanca para 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 conexión AS2 para tu región.

Falla 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, puerto, credenciales o método de autenticación (contraseña vs. clave SSH) son incorrectos u obsoletos.
    • Un cortafuegos 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 no tiene 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 conexión FTP para el 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 cortafuegos relevantes.
    • Verifica que la cuenta de servicio tenga los permisos requeridos en el directorio de destino.
    • Si utilizas autenticación de clave SSH, confirma que la clave es actual y 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 al formato EDIXml o XCBL

  • Síntoma: Los documentos entrantes duplicados se están procesando varias veces aunque la configuración de Verificación de transacciones duplicadas está habilitada en la conexión AS2 del socio comercial.
  • Posible causa: La Verificación de transacciones duplicadas 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 entrantes (por ejemplo, verificando un ID de transacción contra un registro de base de datos o Cloud Datastore antes de procesar).

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).
  • Posible causa: Una conexión VAN es una conexión administrada que Jitterbit configura; no puedes crearla ni configurarla por tu cuenta. Los errores de entrega generalmente involucran la interconexión VAN, el enrutamiento de buzón 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 gerente de éxito del cliente 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 de EDI for Cloud v2 falla en un agente privado detrás de un firewall o proxy

  • Síntoma: En un agente privado, una actividad de EDI for Cloud v2 como Obtener documento no recupera 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.
  • Posible causa: 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. Añade a la lista blanca eicloudservice.com y sus subdominios para acceso saliente en la red, firewall y proxy del agente privado. Para otros dominios de Jitterbit y direcciones IP que un agente privado necesita para acceso saliente, consulta Información de lista blanca.
    2. Si se está utilizando un proxy, confirma que esté configurado correctamente en el agente privado y no esté interfiriendo con la conexión.

El token de acceso a EDI desactivado causa el 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
    
  • Posible causa: El token de acceso utilizado por la conexión de EDI for Cloud v2 ha sido configurado como Inactivo en la página Tokens de acceso de la Consola de administración.

  • Resolución: En la página Tokens de acceso, localiza el token y cambia su Estado a Activo.

Errores de procesamiento de documentos

Documento rechazado: Datos inválidos o faltantes

  • Síntoma: Un documento EDI de salida es rechazado por el socio comercial o falla la validación, o un documento de entrada genera un acuse de recibo negativo.
  • Posibles causas:
    • Falta un segmento requerido o un elemento de datos 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 de intercambio (ISA15) se establece 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 generar una salida conforme.
    • Para un documento de entrada enviado por el socio comercial, comparte el error de validación con ellos para que corrijan su formato de salida.

Error de asignación o esquema EDI

  • Síntoma: Se generan documentos EDI con contenido incorrecto, campos faltantes o una estructura inesperada, o los documentos de entrada 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 erróneos 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 de EDI del socio comercial afectado en Configuración de 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. Revisa los datos de origen en busca de 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 ejemplo 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 loops EDI repetidos mapean solo la última iteración

  • Síntoma: En una transformación de Studio, un segmento o loop 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 loop 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 loop 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 lanzado 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 reimporte como XSD personalizado.

Agregar niveles de loop jerárquico anidado (HL) a una transformación EDI

  • Síntoma: Al crear una transformación de Studio para un conjunto de transacciones EDI que usa loops jerárquicos (por ejemplo, X12 870 4010VICS, que tiene una estructura similar al 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 hijo HL-I).
  • Posible causa: Los documentos jerárquicos pueden anidar niveles HL a profundidades variadas, 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 con el botón derecho en el nodo HL existente y selecciona Duplicate node para agregar el nivel HL anidado (por ejemplo, un nivel hijo HL-I bajo HL-O).
    2. Mapea el nodo duplicado a tus datos de origen. Agrega una condición en el nodo duplicado si se debe crear en la salida solo bajo circunstancias específicas.

Configuración de 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, código calificador u otros identificadores a nivel de sobre no coinciden con lo que el socio comercial espera.
    • 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 del 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 predeterminados del remitente o destinatario de la configuración del socio comercial en lugar de los ID de anulación preferidos configurados en los ajustes de ID de EDI.
  • Posible causa: 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 Ajustes 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 destinatario
    • ISA08_Receiver_ID: ID de EDI del destinatario

Confirmaciones no configuradas o no recibidas

  • Síntoma: Las confirmaciones funcionales 997 (X12) o CONTRL (EDIFACT) esperadas no se envían o reciben, o el procesamiento de confirmaciones no funciona como se espera.
  • Posibles causas:
    • La generación o el procesamiento de confirmaciones está deshabilitado en los ajustes de EDI del socio comercial.
    • El tipo de documento de confirmación no se incluye en la configuración del flujo de trabajo del socio comercial.
    • El socio comercial no envía confirmaciones, o sus confirmaciones se enrutan incorrectamente.
  • Resolución:
    • En los Ajustes 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.
    • Comprueba el archivo para determinar si las confirmaciones del socio comercial se están recibiendo pero no procesando, o si no llegan en absoluto.
    • Si las confirmaciones no llegan, coordina con el socio comercial para confirmar que las envía al punto de conexión correcto.

FTP "Próxima ejecución" no se actualiza sin actualizar la página

  • Síntoma: La Próxima ejecución mostrada en los ajustes de una conexión FTP permanece obsoleta después de que se haya ejecutado el trabajo FTP programado, aunque el cronograma funcione correctamente.
  • Posible causa: Este campo refleja el estado del cronograma solo cuando se carga la página o cuando una acción manual desencadena una recarga de datos. No sondea el motor en tiempo real.
  • Resolución:
    • Actualiza la página del navegador para actualizar la visualización de Próxima ejecución.
    • Alternativamente, navega fuera de los ajustes de FTP y vuelve para forzar una recarga.

Error al agregar ID de EDI o ID preferido: 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:

    Cannot add EDI ID [ID] as it is currently in use; please confirm and provide a unique ID.
    
    Cannot add Preferred ID [ID] as it is currently in use; please confirm and provide a unique ID.
    
  • 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, verifica todos los demás entornos de Harmony donde EDI está habilitado para confirmar si el ID ya está asignado allí. Trabaja con tu socio comercial para establecer un ID de EDI único para cada entorno donde intercambien documentos, y usa un ID distinto para entornos que no son de producción, diferente de tu ID de EDI de producción.
    • Para un ID preferido duplicado, verifica la lista de ID preferido (ID's de ISA) del socio comercial actual y de otros socios comerciales en el mismo entorno, luego elige un ID único.

Configuración del flujo de trabajo

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

  • Síntoma: Los documentos EDI salientes pasan la verificación de validación local en Jitterbit EDI pero se rechazan durante la prueba o certificación del socio comercial, frecuentemente 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 generar 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 no aplicados por la configuración predeterminada.
  • Resolución:
    • En la configuración de administrar flujos de trabajo, habilita la validación para el flujo de trabajo saliente.
    • Revisa la guía de implementación del socio comercial para identificar cualquier elemento obligatorio más allá de la configuración estándar de EDI y agrégalos al mapeo.
    • A menos que tengas un conocimiento profundo de la transacción EDI específica y los requisitos del socio comercial, siempre habilita la validación antes de probar 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 termine 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 transacción y la fecha del documento. Si la fecha del documento es más reciente que la fecha de transacción, el archivado se calcula a partir de la fecha del documento, lo que puede extender el período de retención.
  • Resolución:
    • Al investigar el momento de archivado inesperado, verifica tanto la fecha de transacción como la fecha del documento de la transacción afectada.
    • Revisa 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 ni 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 a nivel de 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 reconocimientos de recepción y leer páginas, pero no puede crear o actualizar configuraciones ni cargar archivos. Crear o actualizar configuraciones y cargar archivos para procesamiento requieren 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, verifica que el usuario tenga un rol que incluya el permiso Admin, EDI User o EDI Viewer.
    • Confirma que el nivel de acceso del entorno del usuario incluya acceso de Write para el entorno donde EDI está configurado.
    • Si el usuario necesita realizar operaciones de escritura (como crear socios comerciales o cargar documentos), asigna el rol EDI User en lugar de EDI Viewer. Consulta Permisos de EDI para ver la matriz de permisos completa.

No se pueden habilitar los parámetros de PII

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