Integraciones · TPV de hostelería (Windows, API local)
Numiqa + Ágora TPV
Disponible
Numiqa se conecta a Ágora TPV mediante un agente para Windows instalado en el equipo del TPV. Importa ventas ticket a ticket, catálogo y costes, fichajes de empleados, cierres de caja y albaranes de compra, y los convierte en stock, escandallos, cuadrantes, rentabilidad y datos fiscales. Ágora sigue siendo el TPV; Numiqa es el back office.
¿Sustituye o complementa? Complemento: Numiqa no sustituye a Ágora, añade compras, inventario, RRHH, fiscalidad, gestoría y CEO Virtual sobre sus datos. Si algún día cambias de TPV, Numiqa importa el catálogo y los escandallos desde el Excel de Ágora.
Última revisión: 2026-09-15. Sitio del partner: www.agorapos.com.
Qué datos fluyen y en qué dirección
| Dato | Dirección | Detalle |
|---|---|---|
| Ventas y tickets | Sistema → Numiqa | Facturas de cada jornada con líneas, familias, IVA, medios de pago y empleado; sincronización periódica y recuperación nocturna de días que no llegaron. |
| Catálogo y costes | Sistema → Numiqa | Maestro de artículos, familias, precios, IVA y costes para inventario y rentabilidad. |
| Fichajes | Sistema → Numiqa | Entradas y salidas registradas en Ágora se convierten en fichajes de RRHH, con arbitraje anti doble jornada si el empleado también ficha en la app. |
| Cierres de caja | Sistema → Numiqa | Cierres nativos de Ágora para el resumen diario y la conciliación de cobros; si un día no cabe entero, se guarda el resumen y se marca como tal. |
| Albaranes de compra | Sistema → Numiqa | Albaranes registrados en Ágora, en solo lectura, para conciliar con las facturas de proveedor. |
| Escandallos | Sistema → Numiqa | No hay endpoint: se importan desde el Excel de escandallos y el datos.xlsx de Ágora con previsualización. |
Cómo se conecta
Agente Numiqa para Windows con túnel cifrado de salida hacia la API local de Ágora; no hace falta abrir puertos en el local.
- 1Crea la conexión Ágora en el panel de Numiqa e introduce el API Token generado en la administración de Ágora.
- 2Descarga el instalador del agente y ejecútalo en el PC donde está Ágora; el agente detecta la instalación.
- 3Comprueba en el panel el estado de la conexión, los registros y las primeras jornadas importadas.
- 4Activa, si quieres, los fichajes desde el TPV y la importación de escandallos desde Excel.
Requisitos
- Ágora TPV con API local activa y token de API.
- Windows 10 o superior en el equipo del TPV, con salida a Internet.
- Una conexión por local; varios locales y varios TPV distintos pueden convivir en la misma organización.
Qué no sincroniza
- Numiqa no escribe en Ágora: la integración es de solo lectura.
- Las recetas y fabricaciones de Ágora no se leen por API; se importan desde su exportación a Excel.
- En bases de datos muy grandes la primera sincronización histórica puede tardar horas.
Preguntas frecuentes
- ¿Necesito abrir puertos en el router del local?
- No. El agente abre un túnel cifrado de salida hacia Numiqa y el servidor habla con la API local de Ágora a través de él.
- ¿Qué pasa si el TPV deja de enviar ventas?
- Un vigía revisa cada 30 minutos el estado de la conexión y te indica la causa real en el panel; por la noche un recuperador vuelve a pedir los días que faltan.
- ¿Puedo tener Ágora en un local y otro TPV en otro?
- Sí. Cada conexión se asigna a un centro y las ventas se consolidan sin pisarse.
- ¿Numiqa sustituye a Ágora?
- No es necesario. Numiqa aporta lo que Ágora no hace: compras a proveedor, escandallos con coste real, RRHH con convenio, fiscalidad con banco, portal para la gestoría y un CEO Virtual. Numiqa también tiene un TPV propio para locales sin TPV.