Integración de Logirest con Ágora: pedidos de compra en EDI

La integración de Logirest con Ágora envía a Logirest, el operador logístico para restauración del grupo STEF, los pedidos de compra que los locales confirman en el TPV, sin pasarlos a mano. Connect Manager revisa Ágora cada dos horas, genera el fichero de cada pedido en el formato de Logirest y lo deja en su servidor por SFTP o FTP, con copia por correo. Este manual es para el técnico que la configura en un cliente.

Qué hace la integración#

• Cada dos horas lee de la API de Ágora los pedidos de compra del día y, una vez más de madrugada, los del día anterior.
• Selecciona los pedidos en estado Confirmado cuyo proveedor tiene un CIF de los configurados.
• Genera un fichero .Edi por pedido con el código del almacén que lo recibe, la fecha de entrega y, por línea, el código de artículo de Logirest, la cantidad, las unidades por caja, el precio y la cantidad en unidades.
• Identifica cada artículo por su código de barras de Ágora: toma el que empieza por uno de los prefijos configurados.
• Pone la fecha de entrega del pedido o, si no la tiene, la de dentro de tres días.
• Sube el fichero por SFTP o FTP y envía una copia por correo con el fichero adjunto.
• Quita del pedido las líneas cuyo artículo no tiene código válido y avisa por correo con la lista de productos.
• Reintenta solo los pedidos que fallan al subirse y permite reenviar un pedido desde Pedidos → Historial de pedidos.

Qué no hace#

• No envía pedidos en borrador ni pedidos de proveedores que no estén en la lista de CIF.
• No vuelve a enviar un pedido que se modifica en Ágora después de haberse enviado: se lee una sola vez.
• No envía líneas sin código de barras válido: se quitan del pedido y se avisa.
• No recibe nada de Logirest (confirmaciones, albaranes ni facturas): solo envía pedidos.
• No permite SFTP con clave privada desde el panel: Clave privada y Frase de contraseña aparecen pero no se guardan. Usa usuario y contraseña.
• No permite cambiar desde el panel los tres días de margen para la fecha de entrega.

Requisitos#

• Una cuenta en el servidor SFTP o FTP de Logirest, con la carpeta donde dejar los pedidos. Si el servidor filtra por IP, autoriza las direcciones IP salientes de Connect Manager.
• En Ágora, los pedidos de compra a Logirest gestionados en el TPV: proveedor con su CIF, almacén de destino, unidades de compra con su factor y artículos con el código de Logirest guardado como código de barras.
• Dos informes personalizados instalados en Ágora: el de unidades de medida y el de códigos de barras de productos (se descargan desde la propia integración).
• La API de Ágora (puerto 8984) accesible desde fuera, directamente o con Zero Connect, y su API key.
• Reparto de tareas: FOS da de alta el local y la integración; el técnico instala los informes, configura proveedores, almacenes y prefijos y revisa los artículos; Logirest facilita el servidor y sus códigos.

Datos que necesitamos#

Configuración paso a paso#

Con Logirest#

1. Pide la cuenta del servidor de ficheros y la carpeta de entrada de pedidos.
2. Pide el código de cliente de cada punto de entrega (almacén de Ágora) y los códigos de artículo, con el prefijo que usan.

En Ágora#

1. Abre la integración en Connect Manager (paso siguiente) y, en la tarjeta Informes personalizados, descarga el Informe de unidades de medida (Units_Of_Measurement.xml) y el Informe de códigos de barras de productos (Product_Barcodes.xml).
2. Cópialos en la carpeta custom-queries del servidor de Ágora (en el ACMS si lo hay), por ejemplo C:\Program Files (x86)\IGT Microelectronics\Agora\custom-queries.
3. Añade a cada artículo que se pide a Logirest un código de barras con su código de Logirest (por ejemplo EMBC001234).
4. Revisa que el proveedor Logirest tenga su CIF y que las unidades de compra (caja, pack…) tengan bien su factor de conversión.

[!WARNING] Copia los informes tal cual los descargas. Un informe personalizado mal formado puede impedir que arranque el servicio de Ágora del cliente.

En Connect Manager#

1. En app.connectmanager.es, ve a Administración → Locales, abre el local y revisa URL de API y API key.
2. En Integraciones de pedidos, FOS crea la integración con el proveedor Logirest. Ábrela por la pestaña Configuración.
3. Rellena Usuario, Password y URL (S)FTP: solo el nombre del servidor, sin sftp://.
4. En CIFs de proveedores, añade el CIF (o su principio) de cada proveedor cuyos pedidos van a Logirest. Sin ningún CIF no se envía nada.
5. Deja sin marcar Los pedidos son para QBS (esa casilla convierte la integración en la de QBS).
6. Prefijo de cliente: se antepone al código del almacén en el fichero (si el código ya empieza por él, no se repite). Vacío equivale a EMB.
7. Prefijo de código de barras: uno o varios prefijos; de cada artículo se toma el primer código de barras que empieza por uno de ellos. Vacío equivale a EMBC.
8. Email de receptor de notificaciones: uno o varios correos. Reciben la copia de cada pedido, el aviso de códigos de barras y los errores; si lo dejas vacío, la copia llega solo a FOS.
9. En Configuración de subida de ficheros: Método de subida de ficheros (FTP o SFTP), Root (carpeta de destino), Puerto, Timeout y, para FTP, Pasivo y SSL.
10. Pulsa Guardar.
11. Pestaña Almacenes: añade cada almacén de Ágora que recibe pedidos con su Código de almacén (el código de cliente que da Logirest). Un almacén sin configurar sale en el fichero con su nombre de Ágora.

Cómo funciona#

Cada dos horas Connect Manager pide a Ágora los pedidos de compra del día, se queda con los confirmados de los proveedores configurados y registra los que no conocía. Después lanza los informes personalizados para saber el factor de cada unidad de compra y el código de barras de cada artículo, genera el fichero de cada pedido nuevo, lo sube al servidor de Logirest y envía la copia por correo. Una pasada de madrugada repite la lectura con los pedidos del día anterior.

sequenceDiagram
    participant CM as Connect Manager
    participant AG as API de Ágora
    participant LG as SFTP de Logirest
    participant M as Correo
    loop Cada dos horas
        CM->>AG: Pedidos de compra del día
        AG-->>CM: Pedidos
        CM->>CM: Confirmados y de los CIF configurados
        CM->>AG: Informes de unidades y de códigos de barras
        AG-->>CM: Factores y códigos
        CM->>CM: Fichero Edi de cada pedido nuevo
        CM->>LG: Sube el fichero
        CM->>M: Copia del pedido con el fichero
    end

El fichero#

Un fichero por pedido, en UTF-8 con BOM, una línea por artículo y campos separados por |. El nombre es el código de cliente, el número de pedido y la fecha y hora: EMBMAD01-PC-000123-20261003101500.Edi.

Estados, reintentos y reenvío#

• Cada pedido aparece en Pedidos → Historial de pedidos como Creado, Enviado o Error, con su fecha, local, serie y número de Ágora.
• Si la subida falla, el pedido queda en Error con el motivo y se reintenta solo en las pasadas siguientes (hasta cuatro veces con la configuración por defecto). Llega un aviso «Error en aplicación» con el mensaje.
• Para reenviar, selecciona hasta diez pedidos en el historial y pulsa Exportar. Los que están en Creado o Error se generan y se suben; los que ya están en Enviado se regeneran y se envían por correo, pero no se vuelven a subir.
• Si ninguna línea del pedido tiene código válido, no se genera fichero, el pedido queda como Enviado y llega el aviso de códigos de barras.

Comprobar que funciona#

1. En Ágora, crea un pedido de compra al proveedor Logirest con dos artículos con código de Logirest y confírmalo.
2. Espera a la siguiente pasada (como mucho dos horas).
3. En Pedidos → Historial de pedidos, el pedido debe aparecer como Enviado.
4. Comprueba que ha llegado el correo «Pedido Logirest» con el fichero y que el fichero está en la carpeta del servidor.
5. Abre el fichero: código de cliente con prefijo, códigos de artículo, cantidades y fecha de entrega deben ser los esperados.
6. Pide a Logirest que confirme que lo ha procesado.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo envío los pedidos de compra de Ágora a Logirest?#

Con la integración Logirest de Connect Manager: configuras el servidor de Logirest, los CIF de proveedor, los códigos de almacén y los prefijos, instalas dos informes en Ágora y, desde entonces, cada pedido confirmado sale solo en las dos horas siguientes.

¿Cada cuánto se envían los pedidos?#

Connect Manager revisa Ágora cada dos horas y, una vez más de madrugada, repasa los pedidos del día anterior.

¿Qué pasa con un artículo sin código de Logirest?#

Se quita del pedido y llega un correo con la lista de artículos sin código válido. Añade el código como código de barras en Ágora y reenvía el pedido desde el historial.

¿Puedo reenviar un pedido a Logirest?#

Sí, desde Pedidos → Historial de pedidos con Exportar. Si el pedido ya estaba enviado, se regenera y se manda por correo, pero no se vuelve a subir al servidor.

¿Es la misma integración que QBS?#

Sí, con la casilla Los pedidos son para QBS marcada cambia el formato y el nombre del fichero. Si el cliente trabaja con un obrador QBS, sigue el manual de QBS.

Referencias#

• Ficha de la integración en el catálogo: Logirest.
• Integración de QBS con Ágora, el mismo envío de pedidos con el formato de QBS.
• Direcciones IP salientes de Connect Manager.