Saltearse al contenido
Nappai Documentation

EDI Writer

El componente EDI Writer (Escritor EDI) es una herramienta esencial en Nappai para la automatización de procesos comerciales. Su función principal es tomar la información de tus datos internos (como pedidos de clientes, notas de envío o facturas) y convertirla en un formato estándar internacional llamado EDIFACT.

Este formato es el “lenguaje universal” que utilizan las grandes empresas para comunicarse entre sí de forma segura y automática. Gracias a este componente, no necesitas crear archivos de texto manualmente; Nappai genera el documento estructurado correctamente para que puedas enviarlo a tus socios comerciales o guardarlo en tu sistema de gestión.

¿Cómo funciona?

Imagina que este componente es un traductor y redactor automático especializado.

  1. Recibe Datos: El componente toma información de tu sistema (por ejemplo, una lista de productos comprados por un cliente).
  2. Estructura el Mensaje: Utiliza reglas estrictas para organizar esa información en un formato que cualquier socio comercial (ya sea un proveedor o un cliente mayorista) pueda leer e interpretar automáticamente.
  3. Valida y Genera: Verifica que no falten datos importantes (como fechas o direcciones) y crea el archivo final.

Puedes elegir qué tipo de documento quieres generar:

  • Pedidos (ORDERS): Para automatizar la recepción de compras.
  • Advertencias de Envío (DESADV): Para informar a los clientes cuándo ha salido su paquete.
  • Facturas (INVOIC): Para generar facturas electrónicas precisas.

El resultado es un archivo de texto plano que cumple con las normas internacionales, listo para ser descargado o enviado automáticamente por tu sistema.

Conexión y Credenciales

Este componente no requiere credenciales externas (como contraseñas de API de terceros) en su configuración directa. Sin embargo, para que funcione correctamente, necesitarás conectarlo a otros componentes de Nappai que provean los datos necesarios (como una base de datos de productos o un CRM), tal como se explica en la sección de “Entradas”.

Entradas

A continuación, se detallan los campos disponibles para configurar este componente. Todos los campos son obligatorios para garantizar la generación correcta del archivo.

  • Message Type: Selecciona el tipo de documento comercial que deseas generar. Las opciones disponibles son:
    • ORDERS: Para crear un Pedido de Compra.
    • DESADV: Para crear una Nota de Envío (Albarán/Despatch Advice).
    • INVOIC: Para crear una Factura Electrónica.
    • Custom: Para construir mensajes personalizados desde cero.
  • Message Data: Es el campo más importante. Aquí debes conectar la salida de otros componentes (como un nodo “Database Reader” o “Data Mapper”) que contengan la información real del negocio. Dependiendo del Message Type que elijas, necesitarás proporcionar diferentes tipos de información:
    • Para Pedidos: Necesitarás la referencia del pedido, fecha, datos del comprador y vendedor, y una lista de líneas (productos, cantidades, precios).
    • Para Envíos: Necesitarás la referencia del pedido original, fecha, datos de envío (quién envía y quién recibe), datos del transportista y líneas de productos con cantidades enviadas.
    • Para Facturas: Necesitarás datos de comprador y vendedor, moneda, totales (monto total, impuestos, neto) y líneas de productos con totales por línea.
    • Para Custom: Deberás proporcionar la estructura completa de segmentos EDIFACT.
  • EDIFACT Version: Elige la versión del estándar EDIFACT que requiere tu socio comercial (ej. D96A, D99A). Esto asegura compatibilidad con su sistema.
  • Sender ID: Identificación única de tu empresa. Esto se usa para crear el “sobre” del mensaje y asegurar que el receptor sepa de quién viene la información.
  • Recipient ID: Identificación del socio comercial que recibirá el archivo.
  • File Name: El nombre que tendrá el archivo generado. Si lo dejas vacío, el sistema generará un nombre automático basado en el tipo de mensaje.
  • Include Interchange Envelope: Activa esta opción (SÍ/NO) si necesitas que el archivo esté envuelto en un protocolo de transmisión estándar (sintaxis UNA/UNB/UNZ). Esto es común en la mayoría de los intercambios B2B formales.

Salidas

El componente produce dos tipos de resultados que puedes usar en pasos posteriores de tu flujo de automatización:

  • EDI File: El archivo físico generado (generalmente con extensión .edi o .txt). Útil si necesitas descargar el archivo o subirlo a un servidor de archivos.
  • EDI Text: El contenido del archivo como texto plano. Útil si necesitas analizar el contenido, guardarlo en una base de datos o enviarlo por email.

Ejemplo de Respuesta JSON

Al ejecutar el componente, el sistema procesa los datos. Aunque la salida principal es un archivo, aquí tienes un ejemplo de cómo se estructuran los datos internos que el componente utiliza internamente para generar el archivo (esto te ayuda a entender qué variables debes mapear en las entradas): json { “messageType”: “INVOIC”, “version”: “D96A”, “header”: { “senderID”: “MYCOMPANY01”, “recipientID”: “CLIENT001”, “documentReference”: “INV-2023-001”, “date”: “2023-10-27” }, “items”: [ { “ean”: “1234567890”, “description”: “Laptop Model X”, “quantity”: 2, “unitPrice”: 999.00, “lineTotal”: 1998.00 } ], “totals”: { “netAmount”: 1998.00, “taxAmount”: 339.66, “totalAmount”: 2337.66, “currency”: “USD” } }

Conectividad

Para que EDI Writer sea útil, debe conectarse a componentes que le den vida a los datos. Las conexiones más lógicas son:

  1. Entrada de Datos (Message Data): Conéctalo a la salida de componentes como Database Reader (para leer pedidos de tu base de datos), API Caller (para obtener datos de clientes externos), o Code Interpreter (si necesitas calcular totales o formatos específicos).
  2. Salida de Archivos (EDI File): Conecta la salida a un componente File Writer si necesitas guardar el archivo en una carpeta local, o a un Email Sender si quieres que Nappai te envíe el archivo por correo.
  3. Salida de Texto (EDI Text): Conéctalo a un Log Viewer para depurar errores, o a un Database Writer para guardar el mensaje procesado en un historial.

Ejemplo de Uso

Escenario: Automatización de Facturación Electrónica

  1. Obtención de Datos: Un usuario crea un pedido en una tienda online.
  2. Transformación: Nappai toma los detalles del pedido (productos, precios, cliente).
  3. Configuración EDI: El flujo llega al nodo EDI Writer.
    • Se selecciona Message Type: INVOIC.
    • Se conecta el nodo de “Detalles del Pedido” a Message Data.
    • Se ingresa el ID del cliente en Recipient ID.
  4. Resultado: El componente genera un archivo .edi válido.
  5. Acción Final: Este archivo se envía automáticamente al ERP del cliente a través de un componente de transporte de archivos, cumpliendo con la normativa de facturación electrónica sin intervención manual.

Consejos y Mejores Prácticas

  • Valida tus datos antes: Asegúrate de que los componentes que alimentan a EDI Writer tengan toda la información necesaria (como IDs de vendedor y comprador). Si faltan estos datos, la generación del archivo fallará.
  • Usa versiones estándar: Salvo que tu socio comercial te lo solicite específicamente, utiliza la versión D96A o D99A del estándar EDIFACT, ya que son las más compatibles.
  • Maneja excepciones: Configura tu flujo para capturar errores si la validación de datos falla, especialmente en campos críticos como las fechas y los IDs de los interlocutores.
  • Prueba con el modo Custom primero: Si necesitas un formato muy específico, usa el modo Custom en un entorno de prueba para entender la estructura de segmentos antes de automatizar flujos complejos.

Consideraciones de Seguridad

  • Protección de Datos: Al generar facturas o datos de clientes en formato EDIFACT, asegúrate de que solo los usuarios autorizados tengan acceso a los nodos que procesan información sensible (como números de cuenta o direcciones completas).
  • Integridad de la Información: El formato EDIFACT es robusto, pero depende de la precisión de los datos de entrada. Verifica que tu fuente de datos esté limpia para evitar errores en facturas o envíos.