Tu TPV, tu quiosco de pedidos y Scan & Order trabajan con un único catálogo y un único stock en el panel. Con la API de Narrow.TV conectas esos datos con los sistemas que ya usas. Conecta tus propios sistemas, o deja que tu desarrollador o partner construya la integración.

Ver la documentación de la API

¿Para qué sirve la API?

  • Contabilidad: consulta la facturación diaria por tipo de IVA y por método de pago, o lee los informes Z y los tickets.
  • Tienda online o ERP: mantén productos, precios y stock sincronizados entre tu propio sistema y Narrow.TV.
  • Informes y BI: usa tus ventas y pedidos en tus propios paneles y análisis.
  • Gestión propia de pedidos: envía los pedidos del quiosco y de Scan & Order a tus propios sistemas.

Cómo empezar

  1. Abre Acceso API en el menú de la cuenta del panel. Solo el propietario de la cuenta ve esta página.
  2. Crea un token con un nombre y, si quieres, una fecha de caducidad.
  3. Elige los permisos por establecimiento: leer datos del TPV, leer o gestionar el catálogo, leer o gestionar el stock y leer pedidos.
  4. Copia el token. Solo se muestra una vez. Después, en la lista ves cuándo se usó por última vez, y puedes revocarlo cuando quieras.

Qué ofrece la API

Datos del TPV

Lee los tickets de un establecimiento, con líneas, descuentos, IVA y pagos. Consulta los informes Z, o un resumen diario con la facturación por tipo de IVA y por método de pago: justo lo que necesita tu contabilidad. El diario del TPV es de solo lectura en la API; no se puede modificar.

Catálogo

Lee y gestiona categorías, productos y opciones de producto. En una sola petición actualizas hasta 500 productos a la vez, vinculados a tu propio código de artículo. Las categorías se pueden indicar por nombre, y las fotos de producto con un enlace: Narrow.TV las descarga en segundo plano.

Stock

Lee los niveles de stock y los movimientos de stock. Registra recuentos, entregas y correcciones, por producto o en bloque.

Pedidos

Lee los pedidos de tu quiosco de pedidos y de Scan & Order, con líneas, importes, método de pago y estado.

Webhooks: al instante

Con los webhooks, Narrow.TV envía un mensaje a tu propio sistema en cuanto ocurre algo: una venta, un cierre de día, un cambio de stock, un pedido nuevo o modificado, o un cambio en productos y opciones de producto. Cada mensaje va firmado (HMAC), para que puedas comprobar que realmente viene de Narrow.TV. Si una entrega falla, Narrow.TV lo vuelve a intentar automáticamente.

Seguro y fiable

  • Todo el tráfico va por HTTPS, en JSON.
  • Cada token solo tiene los permisos por establecimiento que le das, y puede tener una fecha de caducidad.
  • Con una clave de idempotencia, un cambio se puede reenviar con seguridad sin que se procese dos veces.
  • Los límites de peticiones por token mantienen la API rápida y estable para todos.

Para desarrolladores

La documentación en connect.narrow.tv describe todos los endpoints con ejemplos, los permisos, la paginación, los códigos de error y cómo verificar las firmas de los webhooks. Hay una especificación OpenAPI 3.1 para generar clientes, y un sandbox además del entorno de producción.

Ver la documentación de la API

Qué necesitas

¿Quieres hablar de lo que quieres conectar? Ponte en contacto y te ayudamos a pensarlo.

Preguntas frecuentes

¿Cuánto cuesta la API?

La API está incluida con el TPV, el quiosco de pedidos y Scan & Order. Si tienes al menos uno de ellos, puedes crear tokens de API. Los precios de esos productos están en nuestra sección de precios.

¿Hay integraciones listas para usar con programas de contabilidad?

Todavía no. La API sirve para conectar tus propios sistemas, o para que tu desarrollador o partner construya una integración. Para ello, la facturación diaria por tipo de IVA y por método de pago se puede consultar directamente.

¿Puedo modificar ventas del TPV a través de la API?

No. El diario del TPV es de solo lectura en la API. Cada venta queda registrada de forma inalterable, igual que en el propio TPV.

¿Quién puede crear tokens de API?

Solo el propietario de la cuenta, en el panel, desde el menú de la cuenta en Acceso API. Ahí también gestionas los webhooks.

¿Qué necesita un desarrollador?

Un token con los permisos adecuados y la documentación en connect.narrow.tv/docs. Allí están todos los endpoints con ejemplos, la explicación de los webhooks y la especificación OpenAPI.