Ihre Kasse, Ihr Bestellkiosk und Scan & Order arbeiten mit einem Sortiment und einem Bestand im Dashboard. Mit der Narrow.TV API verbinden Sie diese Daten mit den Systemen, die Sie bereits nutzen. Binden Sie Ihre eigenen Systeme an, oder lassen Sie Ihren Entwickler oder Partner die Anbindung bauen.

API-Dokumentation ansehen

Wofür nutzen Sie die API?

  • Buchhaltung: Rufen Sie den Tagesumsatz je Steuersatz und je Zahlungsart ab, oder lesen Sie die Z-Berichte und einzelne Kassenbons.
  • Webshop oder ERP: Halten Sie Produkte, Preise und Bestand zwischen Ihrem eigenen System und Narrow.TV synchron.
  • Berichte und BI: Nutzen Sie Ihre Verkäufe und Bestellungen in Ihren eigenen Dashboards und Auswertungen.
  • Eigene Bestellabwicklung: Leiten Sie Bestellungen vom Kiosk und von Scan & Order an Ihre eigenen Systeme weiter.

So starten Sie

  1. Öffnen Sie den API-Zugang im Kontomenü des Dashboards. Nur der Inhaber des Kontos sieht diese Seite.
  2. Erstellen Sie ein Token mit einem Namen und optional einem Ablaufdatum.
  3. Wählen Sie die Rechte je Standort: Kassendaten lesen, Sortiment lesen oder verwalten, Bestand lesen oder verwalten und Bestellungen lesen.
  4. Kopieren Sie das Token. Es wird nur einmal angezeigt. Danach sehen Sie in der Liste, wann es zuletzt verwendet wurde, und können es jederzeit widerrufen.

Was die API bietet

Kassendaten

Lesen Sie die Kassenbons eines Standorts, mit Positionen, Rabatten, Mehrwertsteuer und Zahlungen. Rufen Sie die Z-Berichte ab, oder eine Tagesübersicht mit dem Umsatz je Steuersatz und je Zahlungsart: genau das, was Ihre Buchhaltung braucht. Das Journal der Kasse ist über die API nur lesbar, nicht änderbar.

Sortiment

Lesen und verwalten Sie Kategorien, Produkte und Produktoptionen. Mit einer einzigen Anfrage aktualisieren Sie bis zu 500 Produkte auf einmal, zugeordnet über Ihre eigene Artikelnummer. Kategorien können Sie per Name angeben und Produktfotos als Link: Narrow.TV lädt sie im Hintergrund herunter.

Bestand

Lesen Sie Bestände und Bestandsbewegungen. Buchen Sie Zählungen, Lieferungen und Korrekturen, je Produkt oder gesammelt.

Bestellungen

Lesen Sie die Bestellungen Ihres Bestellkiosks und von Scan & Order, mit Positionen, Beträgen, Zahlungsart und Status.

Webhooks: sofort informiert

Mit Webhooks sendet Narrow.TV eine Nachricht an Ihr eigenes System, sobald etwas passiert: ein Verkauf, ein Tagesabschluss, eine Bestandsänderung, eine neue oder geänderte Bestellung oder eine Änderung an Produkten und Produktoptionen. Jede Nachricht ist signiert (HMAC), sodass Sie prüfen können, dass sie wirklich von Narrow.TV kommt. Schlägt eine Zustellung fehl, versucht Narrow.TV es automatisch erneut.

Sicher und zuverlässig

  • Der gesamte Verkehr läuft über HTTPS, mit JSON.
  • Jedes Token hat nur die Rechte je Standort, die Sie ihm geben, und kann ein Ablaufdatum haben.
  • Mit einem Idempotency-Key kann eine Änderung sicher erneut gesendet werden, ohne doppelt verarbeitet zu werden.
  • Limits je Token halten die API schnell und stabil für alle.

Für Entwickler

Die Dokumentation auf connect.narrow.tv beschreibt alle Endpunkte mit Beispielen, die Rechte, Paginierung, Fehlercodes und die Prüfung von Webhook-Signaturen. Es gibt eine OpenAPI-3.1-Spezifikation, um Clients zu generieren, und neben der Produktionsumgebung eine Sandbox.

API-Dokumentation ansehen

Was Sie brauchen

  • Ein Narrow.TV-Konto mit einer Kasse, einem Bestellkiosk oder Scan & Order. Die API ist dabei inklusive. Die aktuellen Preise finden Sie bei unseren Preisen.
  • Jemanden, der die Anbindung baut: Sie selbst, Ihr Entwickler oder ein Partner.

Möchten Sie besprechen, was Sie anbinden möchten? Nehmen Sie Kontakt auf, wir denken gerne mit.

Häufig gestellte Fragen

Was kostet die API?

Die API ist bei der Kasse, dem Bestellkiosk und Scan & Order inklusive. Haben Sie mindestens eines davon, können Sie API-Tokens erstellen. Die Preise dieser Produkte finden Sie bei unseren Preisen.

Gibt es fertige Anbindungen an Buchhaltungsprogramme?

Noch nicht. Die API ist dafür da, Ihre eigenen Systeme anzubinden oder Ihren Entwickler oder Partner eine Anbindung bauen zu lassen. Den Tagesumsatz je Steuersatz und Zahlungsart können Sie dafür direkt abrufen.

Kann ich Kassenverkäufe über die API ändern?

Nein. Das Kassenjournal ist über die API nur lesbar. Jeder Verkauf bleibt unveränderbar gespeichert, genau wie in der Kasse selbst.

Wer kann API-Tokens erstellen?

Nur der Inhaber des Kontos, im Dashboard im Kontomenü unter API-Zugang. Dort verwalten Sie auch die Webhooks.

Was braucht ein Entwickler?

Ein Token mit den passenden Rechten und die Dokumentation unter connect.narrow.tv/docs. Dort stehen alle Endpunkte mit Beispielen, die Erklärung der Webhooks und die OpenAPI-Spezifikation.