Su TPV, su 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 conecta esos datos con los sistemas que ya usa. Conecte sus propios sistemas, o deje que su desarrollador o partner construya la integración.

Ver la documentación de la API

¿Para qué sirve la API?

  • Contabilidad: consulte 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: mantenga productos, precios y stock sincronizados entre su propio sistema y Narrow.TV.
  • Informes y BI: use sus ventas y pedidos en sus propios paneles y análisis.
  • Gestión propia de pedidos: envíe los pedidos del quiosco y de Scan & Order a sus propios sistemas.

Cómo empezar

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

Qué ofrece la API

Datos del TPV

Lea los tickets de un establecimiento, con líneas, descuentos, IVA y pagos. Consulte 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 su contabilidad. El diario del TPV es de solo lectura en la API; no se puede modificar.

Catálogo

Lea y gestione categorías, productos y opciones de producto. En una sola petición actualiza hasta 500 productos a la vez, vinculados a su 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

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

Pedidos

Lea los pedidos de su 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 su 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 pueda 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 usted le da, 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é necesita

¿Quiere hablar de lo que quiere conectar? Póngase en contacto y le 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 tiene al menos uno de ellos, puede 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 sus propios sistemas, o para que su 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 gestiona 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.