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

Esta guía te lleva a través de las siguientes tareas:

1. Recopilar información
2. Generar un ID de EDI y agregar un socio
3. Crear uno o más flujos de trabajo
4. Configurar ajustes de EDI
5. Preparar un archivo EDI
6. Configurar comunicaciones
7. Verificar
8. 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.

Estas son las cosas 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 Configuración de comunicaciones, o contacta al soporte de Jitterbit o a tu Gerente de Éxito del Cliente (CSM).)

• Un documento de prueba EDI.

2. Generar un ID de EDI y agregar un socio

De forma predeterminada, no hay socios configurados en Jitterbit EDI. La primera vez que agregues uno, se te pedirá que generes un ID de EDI.

Para agregar tu primer socio y generar tu ID de EDI, sigue estos pasos:

1. Selecciona EDI > Socios comerciales del menú del portal Harmony. Se abre la página Socios comerciales:

   

2. Haz clic en Nuevo > Socio. Se abre el panel Agregar socio comercial:

   

3. 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.)

4. Cuando encuentres el socio que deseas, pasa el cursor sobre él y luego haz clic en su botón Agregar:

   

5. Como esta es tu primera vez configurando 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 de nuevo a menos que configures Jitterbit EDI en un nuevo entorno.

   Importante

   No uses tu ID de producción en un entorno de control de calidad o prueba.

6. Cuando estés seguro de tus códigos, haz clic en el botón Guardar.

7. Para cerrar el panel Agregar socio comercial, haz clic en el icono Cerrar.

8. Selecciona el nuevo socio 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, se pueden definir (al menos uno, pero generalmente muchos) flujos de trabajo para el socio.

Para crear un flujo de trabajo, sigue estos pasos:

1. Con el nuevo socio seleccionado, haz clic en New > Workflow. Se agrega una fila vacía a la lista de flujos de trabajo, con Map processing establecido en EDIXml de forma predeterminada:

   

2. Establece los siguientes campos:

   • Direction: Inbound. (Confirma esto con la guía de implementación o con tu socio comercial.)

     Consejo

     Cuando la dirección es Outbound, también hay un interruptor Validation. Si lo activas, se verifica el formato del documento antes de enviarlo.

   • EDI Standard: X12

   • Document type: 850 (Nota: Para esta configuración, usa X12 como tu estándar EDI y consulta la guía de implementación o pregunta a tu socio comercial por el calificador e ID de EDI.)

   • Version: 4010

   • Active: On

   

3. Haz clic en el botón Save.

4. Configurar ajustes de EDI

Cuando agregas un flujo de trabajo, la pestaña EDI settings muestra campos aplicables a cualquier configuración que hayas usado 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 ajustes de envolvente de EDI, utilizados para procesar documentos EDI salientes.

Para configurar los ajustes de envolvente EDI, sigue estos pasos (consulta la guía de implementación de tu socio para obtener orientación sobre los valores y la sección de referencia de envolventes EDI para obtener detalles de cada campo):

1. Con el nuevo socio seleccionado, selecciona la pestaña EDI settings y luego haz clic en el icono Expand para expandir el cajón.

2. Abre cada sección en el cajón expandido y luego verifica o cambia los valores de acuerdo con los detalles en la guía de implementación EDI del socio:

   

3. Haz clic en el botón Save.

5. Preparar un archivo EDI

Para este paso, necesitarás obtener un archivo de prueba de tu socio comercial. Si no puedes obtener uno, usa el 850 4010 de ejemplo, pero asegúrate de cambiar los IDs del archivo para que coincidan con tus ajustes de EDI.

Este ejemplo explica cómo crear el encabezado adecuado 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 debe describir cómo enviar y recibir archivos con el socio. Jitterbit EDI admite comunicaciones con FTP (Protocolo de transferencia de archivos), AS2 (Declaración de aplicabilidad 2) o usando la propia VAN (Red de valor agregado) de Jitterbit.

Sigue estos pasos para configurar una conexión FTP:

1. Con el nuevo socio seleccionado, selecciona la pestaña Configuración de comunicaciones:

   

2. Haz clic en el icono Expandir para expandir el cajón.

3. Haz clic en el botón Crear y luego selecciona Conexión FTP. Aparece el panel Crear una nueva conexión FTP:

   

4. Ingresa valores para los siguientes campos:

   

   • Nombre: Un nombre para la conexión.
   • Usuario: El nombre de usuario del servidor FTP.
   • Contraseña: La contraseña del servidor FTP. Déjalo en blanco si no se ha establecido contraseña.
   • Dirección: La dirección IP o nombre de host del servidor FTP.
   • Puerto: El número de puerto. (Tu firewall debe permitir tráfico en el puerto).
   • Protocolo: Selecciona FTP.
   • Seguridad: Selecciona el tipo de seguridad: Explícito, Implícito o Ninguno.
   • Modo: Selecciona el modo FTP: Activo o Pasivo.

5. Activa el interruptor Activo.

6. Expande la pestaña Opciones adicionales y luego activa el interruptor Descarga activa.

7. Expande la pestaña Automatización.

8. En la pestaña Automatización, abre el menú Frecuencia y luego selecciona 15 minutos.

9. En la pestaña Automatización, haz clic en el icono de calendario en el campo Próxima ejecución y luego selecciona una fecha y hora para que se ejecute la conexión.

10. En la carpeta raíz de tu servidor FTP, crea dos subcarpetas: Download y Upload. Si utilizas el archivo de prueba en esta guía de configuración o un archivo de prueba de tu socio comercial, colócalo en la carpeta Download.

7. Verificar

Para verificar que tu documento fue enviado y la transacción de prueba se procesó correctamente, búscalo en la página Transacciones:

Si no lo ves, abre la página Mensajería, donde deberías ver la transacción y el motivo de su fallo:

8. Integrar

Una vez que Jitterbit EDI se comunique correctamente con los socios y procese documentos, puedes usar Studio para automatizar otros procesos que puedas necesitar hacer después de enviar o recibir un documento EDI.

Para crear un proyecto de integración EDI, sigue estos pasos:

1. Crea un token de acceso para EDI, seleccionando el mismo entorno utilizado para tus configuraciones de Jitterbit EDI.

2. Selecciona Studio > Proyectos del menú del portal Harmony.

3. Haz clic en el botón Nuevo proyecto.

4. Ingresa un nombre de proyecto, selecciona el mismo entorno utilizado para tus configuraciones de Jitterbit EDI y luego haz clic en el botón Comenzar a diseñar.

5. En la barra de búsqueda de la paleta de componentes de diseño del proyecto abierto, ingresa EDI for Cloud v2 y luego selecciona el conector encontrado.

6. En la configuración del endpoint EDI for Cloud v2, ingresa el token de acceso y luego haz clic en el botón Guardar cambios.

7. En la paleta de componentes de diseño bajo Endpoints disponibles, haz clic en el endpoint Jitterbit EDI V2 y luego arrastra y suelta la actividad Obtener documento a una operación en el lienzo de diseño.

8. Configura la actividad Get Document:

   1. En el paso 1, selecciona el socio comercial y luego haz clic en el botón Next.

   2. En el paso 2, selecciona el documento y luego haz clic en el botón Next.

   3. En el paso 3, verifica el esquema de datos y luego haz clic en el botón Finished.

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:

• El token de acceso de EDI desactivado causa el error INVALID_TOKEN

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