Guía para comenzar con 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 llevará a través de las siguientes tareas:

1. Reunir información
2. Generar un ID ISA 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. Reunir 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 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 Ajustes de comunicación, o contacta a soporte de Jitterbit o a tu Gerente de Éxito del Cliente (CSM).)

• Un documento de prueba EDI.

2. Generar un ID ISA y agregar un socio

Fuera de la caja, no hay socios configurados en Jitterbit EDI. La primera vez que agregas uno, se te solicita generar un ID ISA.

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

1. Selecciona EDI > Admin en el menú del portal Harmony. Se abre la página Admin (con un panel de Socios Comerciales vacío):

   

2. Haz clic en el ícono Agregar en el panel de Socios Comerciales (izquierda), o en el botón Agregar Socio Comercial (centro). Se abre el panel Agregar un Socio Comercial:

   

3. Esta página lista más de 1000 socios listos para ser agregados 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 haz clic en su botón Agregar:

   

5. Como esta es tu primera vez configurando Jitterbit EDI en el entorno seleccionado, se abre la siguiente pantalla:

   

   Consejo

   No volverás a ver esto a menos que configures Jitterbit EDI en un nuevo entorno.

6. Selecciona el código de calificador de tu organización e ingresa tu ID ISA de la empresa.

   Importante

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

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

8. Para cerrar la pantalla Agregar un Socio Comercial, haz clic en el ícono Cerrar.

9. Selecciona el nuevo socio en el panel de Socios Comerciales (izquierda). En el área principal, se selecciona la pestaña Gestionar flujos de trabajo:

   

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 el botón Agregar nuevo flujo de trabajo. Se agrega una fila vacía a la lista de flujos de trabajo:

   

2. Haz clic en el menú Mapear procesamiento, luego selecciona EDIXml. Esto revela más campos. Configúralos de la siguiente manera:

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

     Consejo

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

   • Estándar EDI: X12

   • Tipo de documento: 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 y el ID ISA.)

   • Versión: 4010

   • Activo: Habilitado

   

3. Haz clic en el botón Guardar.

4. Configurar ajustes de EDI

Cuando agregas un flujo de trabajo, la pestaña Ajustes de EDI muestra campos aplicables a cualquier configuración que hayas utilizado para Estándar EDI (X12 en este caso) para el primer flujo de trabajo listado en la pestaña Gestionar flujos de trabajo. (Hasta que crees tu primer flujo de trabajo, la pestaña de ajustes de EDI está vacía.) Estos campos son los ajustes de sobre EDI, utilizados para procesar documentos EDI salientes.

Para configurar los ajustes del sobre 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 sobres EDI para detalles de cada campo):

1. Con el nuevo socio seleccionado en el panel Admin > Socios Comerciales, selecciona la pestaña Ajustes EDI:

   

2. Expande todas las secciones, 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 Guardar.

5. Preparar un archivo EDI

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

Este ejemplo explica cómo crear el encabezado adecuado para tu archivo de prueba. El ID del Socio y el ID de la Empresa están en la sección de IDs Preferidos de la pestaña Ajustes EDI:

6. Configurar comunicaciones

La guía de implementación de tu socio debería 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 utilizando la propia VAN (Red de Valor Añadido) de Jitterbit.

Sigue estos pasos para configurar una conexión FTP:

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

   

2. Haz clic en el botón Crear , luego selecciona Conexión FTP. Aparece el panel de Crear una nueva conexión FTP:

   

3. Ingresa valores para los siguientes campos:

   

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

4. Activa el interruptor de Activo.

5. Expande la pestaña de Opciones adicionales, luego activa el interruptor de Descarga activa.

6. Expande la pestaña de Automatización.

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

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

9. En la carpeta raíz de tu servidor FTP, crea dos subcarpetas, Descargar y Subir. Si estás utilizando 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 Descargar.

7. Verificar

Para verificar que tu documento fue enviado y que la transacción de prueba fue procesada con éxito, búscalo en la página de Transacciones:

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

8. Integrar

Una vez que Jitterbit EDI esté comunicándose con éxito con los socios y procesando documentos, puedes usar Integration Studio para automatizar los otros procesos que puedas necesitar realizar 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 Integration Studio > Proyectos en el menú del portal Harmony.

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

4. Ingresa un nombre para el 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 para Cloud v2, y luego selecciona el conector encontrado.

6. En la configuración del endpoint de EDI para Cloud v2, ingresa el token de acceso, 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, luego arrastra y suelta la actividad Obtener Documento en una operación en el lienzo de diseño.

8. Configura la actividad Obtener Documento:

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

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

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