Guía de introducción a Jitterbit EDI
Introducción
Esta guía te muestra cómo configurar Jitterbit EDI para procesar una transacción X12 850 4010. (Puedes usar otro documento o estándar, pero la configuración es diferente.)
Consejo
Si no estás familiarizado con EDI, esta guía debe ayudarte con algunos de los matices asociados con EDI y la solución Jitterbit EDI. Sin embargo, si ya has trabajado con EDI anteriormente, es posible que desees ir directamente a la sección Configuración, que se enfoca en la configuración de la solución Jitterbit EDI, o prueba el Asistente de IA para EDI.
Esta guía te lleva a través de las siguientes tareas:
- Recopilar información
- Generar un ID de EDI y agregar un socio
- Crear uno o más flujos de trabajo
- Configurar ajustes de EDI
- Preparar un archivo EDI
- Configurar comunicaciones
- Verificar
- Integrar EDI
1. Recopilar información
Debes coordinarte con cada uno de tus socios comerciales para programar pruebas y obtener sus guías de implementación, preferencias de comunicación y archivos de prueba.
Consejo
No siempre es posible obtener todo lo que necesitas. Está dispuesto a adaptarse e improvisar.
Estos son los elementos más importantes que necesitarás:
-
La guía de implementación de EDI de tu socio comercial.
-
La información de conexión FTP de tu socio comercial. (Las conexiones AS2 y VAN no se cubren en esta guía. Si necesitas usar estas, consulta Comunicaciones, o contacta al soporte de Jitterbit o a tu Gerente de Éxito del Cliente (CSM).)
¿Qué es una guía de implementación de EDI?
Una guía de implementación de EDI es un documento que proporciona instrucciones detalladas sobre cómo configurar y usar el Intercambio Electrónico de Datos (EDI) para intercambiar documentos comerciales entre socios comerciales. Especifica el formato, la estructura y los protocolos a utilizar, y proporciona las reglas comerciales, directrices y especificaciones técnicas que deben cumplirse. Estas guías son críticas para garantizar que ambas partes puedan comunicarse e intercambiar datos electrónicamente de manera estandarizada y eficiente.
2. Generar un ID de EDI y agregar un socio
De forma predeterminada, no hay socios configurados en Jitterbit EDI. La primera vez que agregas uno, se te solicita que generes un ID de EDI.
¿Qué es un ID de EDI?
Un ID de EDI sirve para identificar al remitente o receptor de una transacción EDI. Cada transacción incluye un ID de EDI tanto para el remitente como para el receptor, acompañado de un código calificador, que proporciona información adicional.
Para agregar tu primer socio y generar tu ID de EDI, sigue estos pasos:
-
Selecciona EDI > Socios comerciales del menú del portal Harmony. Se abre la página Socios comerciales:
-
Haz clic en Nuevo > Socio. Se abre el cajón Agregar socio comercial:
-
Esta página enumera más de 1000 socios listos para agregarse a tu entorno. Para buscar el que deseas, ingresa el nombre o ID del socio en la barra de búsqueda. (Si el socio que deseas no existe en el sistema, debes crearlo tú mismo.)
-
Cuando encuentres el socio que deseas, pasa el mouse sobre él y luego haz clic en su botón Agregar:
-
Como es la primera vez que configuras Jitterbit EDI en el entorno seleccionado, se abre el diálogo Generando tu ID de EDI. Ingresa el código calificador y el ID de EDI de tu organización.
Consejo
No verás esto nuevamente a menos que configures Jitterbit EDI en un nuevo entorno.
Importante
No utilices tu ID de producción en un entorno de QA o prueba.
-
Cuando estés seguro de tus códigos, haz clic en el botón Guardar.
-
Para cerrar el cajón Agregar socio comercial, haz clic en el icono Cerrar.
-
Selecciona el nuevo socio comercial para abrir el cajón con la pestaña Manage workflows seleccionada:
3. Crear uno o más flujos de trabajo
Una vez que se agrega un socio comercial, puedes definir (al menos uno, pero generalmente muchos) flujos de trabajo para el socio comercial.
¿Qué es un flujo de trabajo?
Un flujo de trabajo define el tipo de documento que se envía o se recibe de un socio comercial y cómo se procesa. Necesitarás un flujo de trabajo para cada tipo de documento y dirección distintos (hacia o desde el socio comercial, denotado como Inbound u Outbound).
Para crear un flujo de trabajo, sigue estos pasos:
-
Con el nuevo socio comercial seleccionado, haz clic en New > Workflow. Se añade una fila vacía a la lista de flujos de trabajo, con Map processing configurado en EDIXml de forma predeterminada:
-
Establece los siguientes campos:
-
Direction: Inbound. (Confirma esto con la guía de implementación o con tu socio comercial.)
Tip
Cuando la dirección es Outbound, también hay un botón de alternancia Validation. Si lo activas, se verifica el formato del documento antes de enviarlo.
-
EDI Standard: X12
-
Document type: 850 (Nota: Para esta configuración, utiliza X12 como tu estándar EDI y consulta la guía de implementación o pregunta a tu socio comercial por el calificador e identificador EDI.)
-
Version: 4010
-
Active: On
-
-
Haz clic en el botón Save.
4. Configurar los parámetros EDI
Cuando se agrega un flujo de trabajo, la pestaña EDI settings muestra campos aplicables a cualquier parámetro que hayas utilizado para EDI Standard (X12 en este caso) para el primer flujo de trabajo listado en la pestaña Manage workflows. (Hasta que crees tu primer flujo de trabajo, la pestaña EDI settings está vacía.) Estos campos son los parámetros envelope de EDI, utilizados para procesar documentos EDI salientes.
¿Qué son los parámetros EDI envelope?
Los parámetros envelope se utilizan para estructurar y transmitir documentos electrónicos entre socios comerciales. Estos parámetros definen cómo se empaquetan, direccionan y enrutan los datos en una transmisión EDI, asegurando que los documentos se identifiquen y procesen correctamente por el sistema del destinatario. El envelope EDI generalmente incluye información sobre el remitente, destinatario, tipo de mensaje e instrucciones de enrutamiento.
Para configurar los parámetros envelope EDI, sigue estos pasos (consulta la guía de implementación de tu socio comercial para obtener orientación sobre los valores, y la sección de referencia de envelopes EDI para detalles de cada campo):
-
Con el nuevo socio comercial seleccionado, selecciona la pestaña EDI settings, después haz clic en el icono Expand para expandir el cajón.
-
Abre cada sección en el cajón expandido, después verifica o cambia los valores de acuerdo con los detalles en la guía de implementación EDI del socio comercial:
-
Haz clic en el botón Save.
Bueno saberlo
Estos parámetros hacen innecesario proporcionar esta información directamente en las transformaciones de Studio que involucren transacciones EDI salientes.
5. Preparar un archivo EDI
Para este paso, necesitarás obtener un archivo de prueba de tu socio comercial. Si no puedes obtener uno, utiliza el 850 4010 de muestra, pero asegúrate de cambiar los identificadores del archivo para que coincidan con tus parámetros EDI.
Este ejemplo explica cómo crear el encabezado apropiado para tu archivo de prueba. El Partner ID y el EDI ID están en la sección Preferred ID (ISA ID's) de la pestaña EDI settings:

6. Configurar comunicaciones
La guía de implementación de tu socio comercial debe describir cómo enviar y recibir archivos con el socio comercial. Jitterbit EDI admite comunicaciones con FTP (Protocolo de Transferencia de Archivos), AS2 (Declaración de Aplicabilidad 2), o mediante la propia VAN (Red de Valor Agregado) de Jitterbit.
Consejo
Solo puedes usar un método de comunicación con un socio, pero es posible reutilizar las conexiones con otros socios.
Sigue estos pasos para configurar una conexión FTP:
-
Usa el menú del portal Harmony para seleccionar EDI > Communications:
-
Haz clic en el botón New, luego selecciona FTP connection. Se abre el panel New connection FTP:
-
Ingresa valores para los siguientes campos:
- Name: Un nombre para la conexión.
- Login: El nombre de usuario del servidor FTP.
- Password: La contraseña del servidor FTP. Déjalo en blanco si no se ha establecido contraseña.
- Address: La dirección IP o el nombre de host del servidor FTP.
- Port: El número de puerto. (Tu firewall debe permitir el tráfico en el puerto).
- Protocol: Selecciona FTP.
- Security: Selecciona el tipo de seguridad, uno de Explicit, Implicit o None.
- Mode: Selecciona el modo FTP, Active o Passive.
-
En la sección Additional options, selecciona la casilla Download active.
-
En la sección Automation, abre el menú Frequency, luego selecciona 15 minutes.
-
En la sección Automation, haz clic en el ícono de calendario en el campo Next run, luego selecciona una fecha y hora para que se ejecute la conexión.
-
Haz clic en el botón Save.
-
Selecciona la nueva conexión. En el panel, en la pestaña Trading partners, activa el toggle Assign para el nuevo socio, luego haz clic en Save.
-
En la carpeta raíz de tu servidor FTP, crea dos subcarpetas,
DownloadyUpload. Si estás usando el archivo de prueba de esta guía de configuración o un archivo de prueba de tu socio comercial, colócalo en la carpetaDownload.
Consejo
El servidor FTP que se está configurando generalmente está alojado por el socio comercial. Si tiene datos de prueba listos, puedes configurar una conexión FTP directa con él, fuera de Jitterbit EDI.
7. Verificar
Para verificar que tu documento fue enviado y la transacción de prueba se procesó correctamente, búscala en la página Transactions:
Si no la ves, abre la página Messaging, donde deberías ver la transacción y la razón de su fallo:
8. Integrar
Una vez que Jitterbit EDI se comunique exitosamente con los socios y procese documentos, puedes usar Studio para automatizar los otros procesos que es posible que necesites hacer después de enviar o recibir un documento EDI.
Para crear un proyecto de integración EDI, sigue estos pasos:
-
Crea un token de acceso para EDI, seleccionando el mismo entorno usado para tus configuraciones de Jitterbit EDI.
-
Selecciona Studio > Projects del menú del portal Harmony.
-
Haz clic en el botón New Project.
-
Ingresa un nombre de proyecto, selecciona el mismo entorno usado para tus configuraciones de Jitterbit EDI, luego haz clic en el botón Start designing.
-
En la barra de búsqueda de la paleta de componentes de diseño del proyecto abierto, ingresa EDI for Cloud v2, luego selecciona el conector encontrado.
-
En la configuración del endpoint EDI for Cloud v2, ingresa el token de acceso, luego haz clic en el botón Save Changes.
-
En la paleta de componentes de diseño bajo Available endpoints, haz clic en el endpoint Jitterbit EDI V2, luego arrastra y suelta la actividad Get Document a una operación en el lienzo de diseño.
-
Configura la actividad Get Document:
-
En el paso 1, selecciona el socio comercial y luego haz clic en el botón Siguiente.
-
En el paso 2, selecciona el documento y luego haz clic en el botón Siguiente.
-
En el paso 3, verifica el esquema de datos y luego haz clic en el botón Finalizado.
Solución de problemas
Para la solución de problemas relacionada, consulta lo siguiente en la guía de solución de problemas de EDI:










