Guía para comenzar a utilizar Jitterbit EDI
Introducción
Esta guía le 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á familiarizado con EDI, esta guía le ayudará con algunos de los matices asociados con EDI y la solución Jiterbit EDI. Sin embargo, si ya ha trabajado con EDI, le recomendamos ir directamente a la sección Configuración, que se centra en la configuración de la solución EDI Jitterbit.
Esta guía le guiará a través de las siguientes tareas:
- Recopilar información
- Generar un ID de ISA y agregar un socio
- Crear uno o más flujos de trabajo
- Configurar los ajustes de EDI
- Preparar un archivo EDI
- Configurar las comunicaciones
- Verificar
- Integrar EDI
1. Recopilar información
Debe coordinarse con cada uno de sus socios comerciales para programar las pruebas y obtener sus guías de despliegue, preferencias de comunicación y archivos de prueba.
Consejo
No siempre es posible conseguir todo lo necesario. Esté dispuesto a adaptarse e improvisar.
Estos son los elementos más importantes que necesitará:
-
La guía de despliegue de EDI de su socio comercial.
-
La información de la conexión FTP de su socio comercial. (Esta guía no cubre las conexiones AS2 ni VAN. Si necesita usarlas, consulte Configuración de comunicación, o póngase en contacto con soporte de Jitterbit o su Gerente de éxito del cliente (CSM).)
What is an EDI implementation guide?" Información "¿Qué es una Guía de Despliegue EDI?
Una guía de despliegue EDI es un documento que proporciona instrucciones detalladas sobre cómo configurar y utilizar el Intercambio Electrónico de Datos (EDI) para el intercambio de documentos comerciales entre socios comerciales. Especifica el formato, la estructura y los protocolos que se deben utilizar, y proporciona las normas, directrices y especificaciones técnicas que deben seguirse. Estas guías son fundamentales para garantizar que ambas partes puedan comunicarse e intercambiar datos electrónicamente de forma eficaz, estandarizada y eficiente.
2. Genere un ID de ISA y agregue un socio
De fábrica, no hay socios configurados en Jitterbit EDI. La primera vez que agregue uno, se le solicitará que genere un ISA ID.
What is an ISA ID?" Información "¿Qué es un ISA ID?
Un ID ISA sirve para identificar al emisor o al receptor de una transacción EDI. Cada transacción incluye un ID ISA tanto para el emisor como para el receptor, acompañado de un código calificador que proporciona información adicional.
Para agregar a su primer socio y generar su ID ISA, siga estos pasos:
-
Seleccione EDI > Administrador en el menú del portal de Harmony. Se abrirá la página Administrador (con el panel Socios Comerciales vacío).
-
Haga clic en Icono "Añadir" en el panel "Socios Comerciales" (izquierda) o el botón "Añadir Socio Comercial" (centro). Se abrirá el panel "Añadir un Socio Comercial":
-
Esta página muestra más de 1000 socios listos para agregarse a su ambiente. Para buscar al socio que desea, ingrese su nombre o ID en la barra de búsqueda. (Si el socio que desea no existe en el sistema, debe crearlo usted mismo.)
-
Cuando encuentres al socio que buscas, pasa el cursor sobre él y haz clic en el botón Añadir:
-
Como esta es la primera vez que configura Jitterbit EDI en el ambiente seleccionado, se abre la siguiente pantalla:
Consejo
No volverá a ver esto a menos que configure Jitterbit EDI en un nuevo ambiente.
-
Seleccione el código calificador de su organización e ingrese el ID ISA de su empresa.
Importante
No utilice su ID de producción en un ambiente de prueba o control de calidad.
-
Cuando esté seguro de sus códigos, haga clic en el botón Guardar.
-
Para cerrar la pantalla Agregar un socio comercial, haga clic en el botón Icono de cerrar.
-
Seleccione el nuevo socio en el panel Socios Comerciales (izquierda). En el área principal, la pestaña Administrar flujos de trabajo está seleccionada:
3. Crea uno o más flujos de trabajo
Una vez añadido un socio, puedes definir (al menos uno, pero normalmente varios) flujos de trabajo para él.
info "What is a _workflow_?"
"Información "¿Qué es un flujo de trabajo?"" Un flujo de trabajo define el tipo de documento enviado o recibido de un socio y cómo se procesa. Necesitará un flujo de trabajo para cada tipo de documento y dirección (hacia o desde el socio, denominado Entrante o Saliente).
Para crear un flujo de trabajo, siga estos pasos:
-
Con el nuevo socio seleccionado, haga clic en el botón Agregar nuevo Flujo de trabajo. Se agregará una fila vacía a la lista de flujos de trabajo:
-
Haga clic en el menú Procesamiento de mapas y seleccione EDIXml. Se mostrarán más campos. Configúrelos de la siguiente manera:
-
Dirección: Entrada. (Confirme esto con la guía de despliegue o con su socio comercial).
Consejo
Cuando la dirección es Saliente, también hay una opción de Validación. Al activarla, se verifica el formato del documento antes de enviarlo.
-
Estándar EDI: X12
-
Tipo de documento: 850 (Nota: para esta configuración, utilice X12 como su estándar EDI y consulte su guía de despliegue o solicite a su socio comercial el calificador y el ID de ISA).
-
Versión: 4010
-
Activo: Habilitado
-
-
Haga clic en el botón Guardar.
4. Configurar los ajustes de EDI
Al agregar un flujo de trabajo, la pestaña Configuración EDI muestra los campos aplicables a la configuración que haya usado para Estándar EDI (X12 en este caso) para el primer flujo de trabajo que aparece en la pestaña Administrar Flujos de trabajo. (Hasta que cree su primer flujo de trabajo, la pestaña Configuración EDI estará vacía). Estos campos son la configuración de sobre EDI, que se usa para procesar documentos EDI salientes.
What are EDI envelope settings?" Información "¿Qué son los ajustes de sobre EDI?
Los ajustes de sobre se utilizan para estructurar y transmitir documentos electrónicos entre socios comerciales. Estos ajustes definen cómo se empaquetan, se direccionan y se enrutan los datos en una transmisión EDI, garantizando que el sistema del destinatario los identifique y procese correctamente. El sobre EDI suele incluir información sobre el remitente, el destinatario, el tipo de mensaje y las instrucciones de enrutamiento.
Para configurar los ajustes de sobre EDI, siga estos pasos (consulte la guía de despliegue de su socio para obtener información sobre los valores y la sección de referencia de sobres EDI para más detalles de cada campo):
-
Con el nuevo socio seleccionado en el panel Administrador > Socios comerciales, seleccione la pestaña Configuración EDI:
-
Expanda todas las secciones y luego verifique o modifique los valores según los detalles de la guía de despliegue EDI del socio:
-
Haz clic en el botón Guardar.
Good to know" Información "Bueno saber
Estas configuraciones hacen que no sea necesario proporcionar esta información directamente en las transformaciones de Integration Studio que involucran transacciones EDI salientes.
5. Preparar un archivo EDI
Para este paso, necesitará obtener un archivo de prueba de su socio comercial. Si no puede conseguirlo, utilice el sample 850 4010, pero asegúrese de cambiar los ID del archivo para que coincidan con su configuración EDI.
Este ejemplo explica cómo crear el encabezado correcto para su archivo de prueba. El ID de socio y el ID de empresa se encuentran en la sección ID preferidos de la pestaña Configuración EDI.
6. Configurar las comunicaciones
La guía de despliegue de su socio debe describir cómo enviar y recibir archivos con él. 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 Agregado) de Jitterbit.
Consejo
Solo puedes usar un método de comunicación con un socio, pero las conexiones se pueden reutilizar con otros socios.
Siga estos pasos para configurar una conexión FTP:
-
Con el nuevo socio seleccionado, seleccione la pestaña Configuración de comunicaciones:
-
Haga clic en Crear y, a continuación, seleccione Conexión FTP. Aparecerá el panel Crear una nueva conexión FTP.
-
Introduzca valores en 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 del servidor FTP. Déjela en blanco si no se ha establecido ninguna contraseña.
- Dirección: La dirección IP o el nombre de alojar del servidor FTP.
- Puerto: El número de puerto. (Su firewall debe permitir el tráfico en el puerto).
- Protocolo: Seleccionar FTP.
- Seguridad: Seleccione el tipo de seguridad, uno de los siguientes: Explícita, Imlícita o Ninguna.
- Modo: Seleccione el modo FTP, Activo o Pasivo.
-
Encienda el interruptor Activo.
-
Expande la pestaña Opciones adicionales y luego activa el interruptor Descargar activo.
-
Expanda la pestaña Automatización.
-
En la pestaña Automatización, abra el menú Frecuencia y luego seleccione 15 minutos.
-
En la pestaña Automatización, haga clic en el botón icono de calendario en el campo Próxima ejecución, luego seleccione una fecha y hora para que se ejecute la conexión.
-
En la carpeta raíz de su servidor FTP, cree dos subcarpetas,
Download
yUpload
Si está utilizando el archivo de prueba en esta guía de configuración, o un archivo de prueba de su socio comercial, colóquelo en elDownload
carpeta.
Consejo
El servidor FTP que se configura normalmente lo aloja el socio comercial. Si ya tiene datos de prueba, puede establecer una conexión FTP directa con él, fuera de Jitterbit EDI.
7. Verificar
Para comprobar que su documento se envió y que la transacción de prueba se procesó correctamente, búsquelo en la página Transacciones:
Si no lo ves, abre la Página de Mensajes, donde deberías ver la transacción y el motivo del fallo:
8. Integrar
Una vez que Jitterbit EDI se comunique exitosamente con los socios y procese documentos, puede usar Integration Studio para automatizar los demás procesos que pueda necesitar después de enviar o recibir un documento EDI.
Para crear un proyecto de integración EDI, siga estos pasos:
-
Cree un token de acceso para EDI, seleccionando el mismo ambiente utilizado para sus configuraciones EDI de Jitterbit.
-
Seleccione Integration Studio > Proyectos en el menú del portal Harmony.
-
Haga clic en el botón Nuevo proyecto.
-
Ingrese un nombre de proyecto, seleccione el mismo ambiente utilizado para sus configuraciones EDI de Jitterbit y luego haga clic en el botón Comenzar a diseñar.
-
En la paleta de componentes de diseño del proyecto abierto En la barra de búsqueda, ingrese EDI for Cloud v2, luego seleccione el conector encontrado.
-
En la configuración del extremo de EDI for Cloud v2, ingrese el token de acceso y haga clic en el botón Guardar cambios.
-
En la paleta de componentes de diseño, en extremos disponibles, haga clic en el extremo Jitterbit EDI V2 y, a continuación, arrastre y suelte la actividad Obtener documento en una operación en el tela de diseño.
-
Configurar la actividad Obtener documento:
-
En el paso 1, seleccione el socio comercial y luego haga clic en el botón Siguiente.
-
En el paso 2, seleccione el documento y haga clic en el botón Siguiente.
-
En el paso 3, verifique el esquema de datos y luego haga clic en el botón Finalizado.
-