Saltearse al contenido
Nappai Documentation

EDI Reader

El componente EDI Reader es la herramienta que utiliza Nappai para “hablar” el idioma del comercio electrónico (EDIFACT).

Imagina que recibes facturas, órdenes de compra o avisos de envío en archivos de texto complejos y rígidos. Este componente actúa como un traductor: toma esos archivos crudos, los lee, entiende su estructura y los convierte en una lista de información clara y organizada (como una tabla de Excel o un diccionario) que tu flujo de automatización puede entender, guardar y procesar fácilmente.

Es ideal para automatizar la lectura de documentos de proveedores o clientes sin tener que abrirlos uno por uno manualmente.

¿Cómo funciona?

El proceso es automático y requiere muy poca intervención manual:

  1. Lectura del Archivo: El componente toma el archivo EDIFACT que tú le proporcionas (ya sea un archivo .edi binario o texto).
  2. Análisis Inteligente: “Lee” el contenido del archivo. Detecta automáticamente qué tipo de documento es (por ejemplo, una Orden de Compra llamada ORDERS o una Factura llamada INVOIC).
  3. Estructuración: Rompe el bloque de texto en partes lógicas (quién envía, qué pide, fechas, montos, etc.) y los organiza en una estructura de datos fácil de usar.

No necesitas configurar reglas complejas para que detecte el tipo de mensaje; el componente lo hace por ti.

Conexión y Credenciales

Este componente no requiere la configuración de credenciales externas (como contraseñas de API o tokens de acceso) en este paso. Asume que ya tienes el archivo disponible para ser leído.

Entradas

Para usar este componente, necesitas proporcionarle los siguientes datos:

Campos de Entrada

  • EDI File: Este es el archivo que deseas leer. Puede ser un archivo binario con extensión .edi o simplemente texto con el contenido del mensaje EDIFACT. Sin este archivo, el componente no tiene nada que leer.
  • Include Raw Segments: Una opción con interruptor (booleano). Si marcas esta casilla, el componente te entregará también la versión “cruda” de los datos (el texto exacto tal como llegó). Esto es útil si necesitas acceder a un dato específico que quizás se haya perdido en el proceso de estructuración, pero para la mayoría de los casos de automatización estándar, no es necesario.

Salidas

Una vez procesado el archivo, el componente te entregará el resultado en el campo:

  • Messages: Este es el resultado principal. Es una lista estructurada con todos los datos extraídos del archivo EDIFACT. Aquí encontrarás campos como fechas, identificadores de partes (remitente/receptor), líneas de productos, precios, etc., organizados de manera que puedas conectarlos fácilmente a otros pasos (como guardar en una base de datos o enviar un email).

Ejemplo de Respuesta JSON

Este es un ejemplo simplificado de cómo se ve la información que obtendrás en la salida Messages después de que el componente analice una Orden de Compra (ORDERS): json [ { “message_type”: “ORDERS”, “header”: { “sender_id”: “SUPPLIER_01”, “receiver_id”: “BUYER_CORP”, “date”: “20231025”, “reference”: “PO-998877” }, “lines”: [ { “item_code”: “SKU-123”, “description”: “Laptop Gamer Modelo X”, “quantity”: 2, “unit_price”: 1200.00 }, { “item_code”: “SKU-456”, “description”: “Mouse Inalámbrico”, “quantity”: 5, “unit_price”: 25.00 } ], “totals”: { “currency”: “USD”, “subtotal”: 2525.00, “tax”: 252.50, “grand_total”: 2777.50 } } ]

Nota: La estructura exacta puede variar ligeramente dependiendo del tipo de mensaje (Factura vs. Pedido), pero siempre contendrá la información organizada.

Conectividad

Este componente es un punto de partida ideal para flujos de gestión de datos. Lógicamente, deberías conectar su salida Messages a componentes que puedan:

  1. Transformar o Mapear Datos: Para ajustar la información extraída a los campos específicos de tu sistema de gestión (ERP o CRM).
  2. Base de Datos: Para guardar la orden o factura en tu sistema de registros.
  3. Gmail/Email: Para notificar a un usuario de que una nueva factura ha sido procesada exitosamente.
  4. Webhooks: Para enviar la información a otra aplicación que necesite esa orden.

Ejemplo de Uso

Escenario: Automatización de recepción de facturas.

  1. Recibes un correo electrónico con una factura en formato EDIFACT adjunta.
  2. Un componente anterior extrae el archivo y lo pasa al EDI Reader.
  3. El EDI Reader lee el archivo y produce el campo Messages con la estructura: {"amount": 1500, "due_date": "2023-11-01"}.
  4. Conectas este resultado a un componente de Base de Datos para guardar esa factura como “Pendiente de Pago” en tu sistema de contabilidad.

Consejos y Mejores Prácticas

  • Verifica el Archivo: Asegúrate de que el archivo EDIFACT esté completo y no esté dañado antes de enviarlo al lector; de lo contrario, el proceso podría fallar.
  • Uso de “Raw Segments”: Solo activa la opción Include Raw Segments si necesitas hacer depuración avanzada o si un dato específico no aparece en la estructura principal. De lo contrario, mantenerlo desactivado hará que el resultado sea más limpio y fácil de usar.
  • Identificación Automática: No te preocupes por configurar manualmente si es un ORDERS o un INVOIC; el componente detectará el tipo automáticamente basándose en los encabezados del archivo.

Consideraciones de Seguridad

Asegúrate de que los archivos EDIFACT que procesas provengan de fuentes confiables, ya que el procesamiento de texto de sistemas externos siempre conlleva riesgos si los datos están malintencionados. Nappai maneja las operaciones de lectura internamente, pero se recomienda validar los datos resultantes antes de utilizarlos en procesos críticos.