Integración de Prologic con Ágora: envío de facturas al ERP

La integración de Prologic con Ágora envía al ERP Prologic, por su API, las ventas del TPV: una factura resumen por local y serie con los tickets del día, y una a una las facturas con cliente y los abonos. También permite cargar en Ágora los maestros de Prologic (tarifas, familias, artículos y clientes). No es una integración de hotel (PMS): es un envío de facturas a un ERP, y este manual cuenta qué hay que configurar en cada cliente.

[!WARNING] Esta integración se hizo para un cliente concreto y lleva valores suyos en el código: la empresa de Prologic va fija como 01 y el año de las facturas resumen va fijo como 2026. Además, el envío no está programado: lo lanza FOS por fecha. Antes de ofrecerla a otro cliente, FOS tiene que adaptarla.

Qué hace la integración#

• Lee de la API de Ágora las facturas de un día: tickets, facturas con cliente y sus devoluciones.
• Crea en Prologic una factura resumen por local y serie con los tickets del día. Sus líneas son los artículos vendidos, agrupados por formato de venta y descuento, con la cantidad total y el precio unitario neto (sin IVA y con los descuentos aplicados).
• Envía una a una las facturas con cliente, los abonos de factura y las devoluciones de tickets. Cada abono lleva el año, la serie y el número que Prologic dio a la factura original, también cuando el ticket devuelto iba dentro de una factura resumen.
• Usa la serie de Prologic que configures por local y tipo de documento.
• Guarda la serie y el número que devuelve Prologic, y en cada ejecución vuelve a intentar lo pendiente y lo que dio error.
• Si se vuelve a lanzar el mismo día, solo crea un resumen nuevo con los tickets que no estaban en el anterior.
• Avisa por correo y por Telegram (a FOS) de las facturas que Prologic rechaza.
• Carga en Ágora, desde Prologic, tarifas, familias, artículos y clientes. Esta carga la lanza FOS y su progreso se ve en Migraciones → Migraciones Prologic.

Qué no hace#

• No se ejecuta sola: no hay tarea programada ni botón en el panel. FOS lanza el envío de la fecha que haga falta.
• No envía las formas de pago ni el desglose de IVA: Prologic deduce el IVA de cada artículo.
• De cada factura solo toma las líneas del primer documento que contiene; si una factura agrupa varios tickets, el resto de líneas no se envía.
• No envía las líneas sin importe ni los componentes de los menús: el importe del menú va en su línea de cabecera.
• No tiene pantalla con las facturas enviadas, ni permite configurar correos o Telegram del cliente para los avisos: los avisos llegan a FOS.
• No adapta la empresa (01) ni el año de las facturas resumen (2026), que van fijos en el código.

Requisitos#

• Acceso a la API REST de Prologic desde internet, con el nombre de la cabecera de autenticación y su token.
• Los artículos de Ágora con el PLU igual al código de artículo de Prologic, y los clientes de Ágora con el código contable igual a su código de cliente en Prologic. La carga de maestros desde Prologic los deja así.
• Por cada local de Ágora, un cliente de Ágora para las facturas resumen cuyo Id. coincida con el código de ese cliente en Prologic, y las series de Prologic que se van a usar.
• 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, lanza la carga de maestros y los envíos; el técnico configura los locales y revisa artículos y clientes en Ágora.

Datos que necesitamos#

Configuración paso a paso#

En Prologic#

1. Pide a Prologic el acceso a su API: la dirección base, el nombre de la cabecera con la que espera el token y el token.
2. Con la contabilidad del cliente, decide qué serie de Prologic recibirá cada tipo de documento de cada local y qué cliente recibirá las facturas resumen de cada local (siempre con centro 0).

En Connect Manager: la integración#

1. En app.connectmanager.es, ve a Administración → Locales, abre el local y revisa URL de API y API key.
2. En Otras integraciones, FOS crea la integración con el proveedor Prologic. Ábrela.
3. Rellena Api Key: con el nombre de la cabecera de autenticación que usa Prologic, Access Token: con el token y URL Api: con la dirección base terminada en / (la integración le añade api/Ventas/Facturas sin poner barra).
4. Pulsa Guardar.

En Connect Manager: los locales#

1. En la pestaña Locales de la integración, pulsa Añadir por cada local de Ágora que vende.
2. Elige el Local y, en Cliente, el cliente de Ágora que recibirá las facturas resumen de ese local. Se envía su Id. de Ágora, así que debe coincidir con el código del cliente en Prologic.
3. Rellena las series de Prologic: Basic invoice serie (facturas resumen de tickets), Basic refund serie (devoluciones de tickets), Standard invoice serie (facturas con cliente) y Standard refund serie (abonos de factura). Las que dejes vacías usan la serie de Ágora.
4. Guarda cada local.

En Ágora#

• Cada artículo vendido necesita su PLU con el código de Prologic; sin PLU, el código de artículo va vacío o con el Id. del formato de venta y Prologic rechazará la factura.
• Los clientes de las facturas necesitan el código contable con su código de Prologic.
• Si los maestros se cargaron desde Prologic, artículos y clientes ya vienen con esos códigos.

Carga inicial de maestros (opcional)#

Si el cliente parte de Prologic, FOS puede cargar en Ágora sus tarifas, familias, artículos y clientes. La carga trae los datos de Prologic y después los da de alta en Ágora por su API de importación. Puedes seguir el avance en Migraciones → Migraciones Prologic: la ficha muestra la Importación de Prologic (tarifas, familias, productos y clientes) y la Exportación a Ágora, con su estado. Revisa en Ágora el resultado antes de empezar a vender.

Cómo funciona#

FOS lanza el envío de una fecha. Connect Manager pide a Ágora las facturas de ese día, agrupa los tickets de cada local y serie en una factura resumen, prepara las facturas con cliente y los abonos uno a uno, y los guarda como pendientes. Después envía a Prologic todo lo pendiente o en error de esa integración, uno a uno. Si Prologic acepta, guarda la serie y el número que devuelve y lo marca como enviado; si contesta con un mensaje, lo marca en error, guarda el mensaje y avisa.

sequenceDiagram
    participant FOS as FOS
    participant CM as Connect Manager
    participant AG as API de Ágora
    participant PR as API de Prologic
    FOS->>CM: Lanza el envío de una fecha
    CM->>AG: Facturas del día
    AG-->>CM: Tickets, facturas y devoluciones
    CM->>CM: Factura resumen por local y serie
    CM->>CM: Facturas y abonos uno a uno
    CM->>PR: Envía cada documento pendiente o en error
    PR-->>CM: Serie y número de Prologic o mensaje de error
    CM->>CM: Enviado o Error con aviso

Qué tipo de documento llega a Prologic#

Qué se envía#

• Cabecera: empresa 01, borrador nuevo, año (fijo 2026 en los resúmenes; el de la fecha en el resto), serie, tipo de factura, fecha de factura y de recepción (el día exportado), cliente con centro 0 (por ejemplo 123(0)) y observaciones con el primer y el último ticket del resumen o el número de la factura.
• Abonos: además, el año, la serie y el número de Prologic de la factura original, si ya se envió.
• Líneas: código de artículo (el PLU), embalaje 1, cantidad y precio unitario neto con tres decimales.

Reenviar#

• Cada vez que FOS lanza un envío se reintentan todos los documentos pendientes o en error de esa integración, sean del día que sean.
• Lanzar de nuevo una fecha ya enviada no duplica los resúmenes: solo agrupa los tickets que no estaban en ninguno.
• Si un documento falló por configuración (cliente, serie o artículo), corrige el dato y pide a FOS que lance un envío.

Comprobar que funciona#

1. Con un local configurado, haz dos tickets de prueba, una factura a un cliente con código contable y un abono de esa factura.
2. Pide a FOS que lance el envío de ese día.
3. En Prologic, comprueba la factura resumen del local con la serie configurada y las observaciones «primer ticket hasta último ticket», la factura con cliente y el abono enlazado con ella.
4. Revisa que las cantidades y los precios netos de las líneas cuadran con Ágora.
5. Pide a FOS que confirme que no han llegado avisos de error y que los documentos constan como enviados.

Errores frecuentes y solución#

Preguntas frecuentes#

¿Cómo conecto Prologic con Ágora?#

FOS crea en el local la integración Prologic en Otras integraciones; tú pones la URL, la cabecera y el token de la API de Prologic y configuras en cada local su cliente y sus series. Los envíos los lanza FOS por fecha.

¿Prologic es un PMS?#

No en esta integración: no hay huéspedes ni habitaciones. Es un envío de las facturas del TPV al ERP Prologic, más una carga opcional de maestros.

¿Se envían las ventas a Prologic cada noche?#

No. No hay tarea programada: FOS lanza el envío del día que haga falta, y en cada envío se reintenta lo que quedó pendiente o en error.

¿Llegan a Prologic las formas de pago o el IVA?#

No. Llegan los artículos con su cantidad y su precio neto; el IVA lo calcula Prologic a partir del artículo.

¿Puedo cargar en Ágora los artículos y clientes de Prologic?#

Sí: FOS puede cargar tarifas, familias, artículos y clientes, que quedan en Ágora con el código de Prologic en el PLU y en el código contable. El avance se ve en Migraciones Prologic.

Referencias#

• Ficha de la integración en el catálogo: Prologic.
• Glosario de Connect Manager.