Integración de QBS con Ágora: pedidos de compra al obrador

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

[!NOTE] En Connect Manager, QBS es la misma integración que Logirest con la casilla Los pedidos son para QBS marcada: cambian el nombre del fichero, algunos campos y los prefijos por defecto. Todo lo demás funciona igual.

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 (el obrador).
• Genera el fichero de cada pedido con el código del local que lo recibe, la fecha de entrega y, por línea, el código de QBS del artículo, la cantidad, las unidades por caja y la cantidad en unidades.
• Identifica cada artículo por su código de QBS, guardado como código de barras en Ágora: toma el primero 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 de QBS 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 envía líneas de productos sin código de QBS: se quitan del pedido y se avisa.
• No vuelve a enviar un pedido que se modifica en Ágora después de enviarse: se lee una sola vez.
• No envía precios: en el fichero de QBS van cantidades.
• No recibe nada de QBS (confirmaciones, albaranes ni facturas).
• No permite SFTP con clave privada desde el panel: Clave privada y Frase de contraseña no se guardan. Usa usuario y contraseña.

Requisitos#

• Una cuenta en el servidor SFTP o FTP donde QBS recoge los pedidos. Si filtra por IP, autoriza las direcciones IP salientes de Connect Manager.
• En Ágora: el obrador como proveedor, con su CIF y su código contable (da nombre al fichero); los almacenes de destino; unidades de compra con su factor; y los artículos con su código de QBS como código de barras.
• Los informes personalizados de unidades de medida y de códigos de barras instalados en Ágora.
• 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 y configura proveedores, almacenes y prefijos; el obrador facilita el servidor y sus códigos.

Datos que necesitamos#

Configuración paso a paso#

Con el obrador#

1. Pide la cuenta del servidor de ficheros y la carpeta de pedidos.
2. Pide el código de cada local de destino y los códigos de QBS de los artículos, con los prefijos que usan.

En Ágora#

1. Descarga desde la integración en Connect Manager (tarjeta Informes personalizados) 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 al obrador un código de barras con su código de QBS.
4. En la ficha del proveedor (el obrador), revisa el CIF y rellena el código contable: con él empieza el nombre de cada fichero.
5. Revisa el factor de conversión de las unidades de compra.

[!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. Marca Los pedidos son para QBS.
4. Rellena Usuario, Password y URL (S)FTP (solo el nombre del servidor, sin sftp://).
5. En CIFs de proveedores, añade el CIF del obrador (o su principio). Sin ningún CIF no se envía nada.
6. Prefijo de código de barras: los prefijos de los códigos de QBS. Vacío equivale a C, P y Z. El Prefijo de cliente no se usa en QBS.
7. Email de receptor de notificaciones: reciben la copia de cada pedido, el aviso de códigos y los errores; vacío, la copia llega solo a FOS.
8. En Configuración de subida de ficheros: Método de subida de ficheros (FTP o SFTP), Root, Puerto, Timeout y, para FTP, Pasivo y SSL. Pulsa Guardar.
9. Pestaña Almacenes: añade cada almacén de Ágora que recibe pedidos del obrador con su Código de almacén en QBS. Un almacén sin configurar sale 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 al obrador y registra los nuevos. Lanza los informes personalizados para obtener el factor de cada unidad de compra y el código de QBS de cada artículo, genera el fichero del pedido, lo sube al servidor y envía la copia «Pedido QBS» por correo. De madrugada repasa los pedidos del día anterior.

sequenceDiagram
    participant CM as Connect Manager
    participant AG as API de Ágora
    participant QB as SFTP del obrador
    participant M as Correo
    loop Cada dos horas
        CM->>AG: Pedidos de compra del día
        AG-->>CM: Pedidos
        CM->>CM: Confirmados al CIF del obrador
        CM->>AG: Informes de unidades y de códigos
        AG-->>CM: Factores y códigos de QBS
        CM->>CM: Fichero de cada pedido nuevo
        CM->>QB: Sube el fichero
        CM->>M: Copia Pedido QBS 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 contable del obrador, el número de pedido y la fecha y hora: OBR01-PC-000123-20261003101500.Edi.

Estados, reintentos y reenvío#

• Cada pedido aparece en Pedidos → Historial de pedidos como Creado, Enviado o Error.
• Si la subida falla, queda en Error con el motivo, llega un aviso «Error en aplicación» y se reintenta solo en las pasadas siguientes (hasta cuatro veces con la configuración por defecto).
• Para reenviar, selecciona hasta diez pedidos y pulsa Exportar: los que están en Creado o Error se suben; los Enviado se regeneran y se mandan por correo, sin volver a subirse.
• Si ninguna línea tiene código de QBS, no se genera fichero, el pedido queda como Enviado y llega el aviso de códigos.

Comprobar que funciona#

1. En Ágora, crea un pedido de compra al obrador con dos artículos con código de QBS y confírmalo.
2. Espera a la siguiente pasada (como mucho dos horas).
3. En Pedidos → Historial de pedidos debe aparecer como Enviado.
4. Comprueba el correo «Pedido QBS» con el fichero y que el fichero está en la carpeta del servidor, con el código contable del obrador al principio del nombre.
5. Abre el fichero y revisa el código del local, los códigos de QBS, las cantidades y la fecha de entrega.
6. Pide al obrador que confirme que QBS lo ha importado.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo envío los pedidos de Ágora al obrador con QBS?#

Con la integración de pedidos de Connect Manager en modo QBS: configuras el servidor del obrador, su CIF, los códigos de los locales y los prefijos, instalas dos informes en Ágora y cada pedido confirmado al obrador sale solo en las dos horas siguientes.

¿Dónde se guarda el código de QBS de cada artículo?#

Como código de barras del artículo en Ágora, con uno de los prefijos configurados (por defecto C, P o Z).

¿Qué pasa si un artículo no tiene código de QBS?#

Se quita del pedido y llega un correo con la lista de artículos. Añade el código y reenvía el pedido desde el historial.

¿Cada cuánto llegan los pedidos al obrador?#

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

¿En qué se diferencia de Logirest?#

Es la misma integración: en modo QBS el fichero se nombra con el código contable del obrador, el local va sin prefijo, la columna de precio pasa a ser cantidad en unidades y los prefijos de artículo por defecto son C, P y Z.

Referencias#

• Ficha de la integración en el catálogo: QBS.
• Integración de Logirest con Ágora.
• Direcciones IP salientes de Connect Manager.
• Web de QBS: obradoresqbs.com.