Je kassa, bestelkiosk en Scan & Order werken met één assortiment en één voorraad in het dashboard. Met de Narrow.TV API koppel je die gegevens aan de systemen die je al gebruikt. Koppel je eigen systemen, of laat je ontwikkelaar of partner de koppeling bouwen.
Waarvoor gebruik je de API?
- Boekhouding: haal per dag de omzet op per btw-tarief en per betaalmethode, of lees de Z-rapporten en losse kassabonnen.
- Webshop of ERP: houd producten, prijzen en voorraad gelijk tussen je eigen systeem en Narrow.TV.
- Rapportages en BI: gebruik je verkopen en bestellingen in je eigen dashboards en analyses.
- Eigen orderverwerking: stuur bestellingen van de kiosk en Scan & Order door naar je eigen systemen.
Zo start je
- Open API-toegang in het accountmenu van het dashboard. Alleen de eigenaar van het account ziet deze pagina.
- Maak een token aan met een naam en eventueel een vervaldatum.
- Kies per locatie de rechten: kassagegevens lezen, assortiment lezen of beheren, voorraad lezen of beheren, en bestellingen lezen.
- Kopieer het token. Het wordt maar één keer getoond. Daarna zie je in de lijst wanneer het voor het laatst is gebruikt, en trek je het in wanneer je wilt.
Wat de API biedt
Kassagegevens
Lees de kassabonnen van een locatie, met regels, kortingen, btw en betalingen. Vraag de Z-rapporten op, of een dagoverzicht met de omzet per btw-tarief en per betaalmethode: precies wat je boekhouding nodig heeft. Het journaal van de kassa kun je via de API alleen lezen, niet wijzigen.
Assortiment
Lees en beheer categorieën, producten en productopties. Met één verzoek werk je tot 500 producten tegelijk bij, gekoppeld aan je eigen artikelcode. Categorieën kun je op naam meegeven, en productfoto's geef je als link mee: Narrow.TV downloadt ze op de achtergrond.
Voorraad
Lees de voorraadstanden en de voorraadmutaties. Boek tellingen, leveringen en correcties, per product of in bulk.
Bestellingen
Lees de bestellingen van je bestelkiosk en Scan & Order, met regels, bedragen, betaalmethode en status.
Webhooks: direct op de hoogte
Met webhooks stuurt Narrow.TV een bericht naar je eigen systeem zodra er iets gebeurt: een verkoop, een dagafsluiting, een voorraadwijziging, een nieuwe of gewijzigde bestelling, of een wijziging in producten en productopties. Elk bericht is ondertekend (HMAC), zodat je kunt controleren dat het echt van Narrow.TV komt. Lukt de levering niet, dan probeert Narrow.TV het automatisch opnieuw.
Veilig en betrouwbaar
- Alle verkeer loopt via HTTPS, met JSON.
- Elk token heeft alleen de rechten per locatie die je het geeft, en kan een vervaldatum hebben.
- Met een idempotency key kan een wijziging veilig opnieuw worden verstuurd, zonder dat hij dubbel wordt verwerkt.
- Limieten per token houden de API snel en stabiel voor iedereen.
Voor ontwikkelaars
De documentatie op connect.narrow.tv beschrijft alle endpoints met voorbeelden, de rechten, paginering, foutcodes en het controleren van webhook-handtekeningen. Er is een OpenAPI 3.1-specificatie om clients mee te genereren, en naast de productieomgeving een sandbox.
Wat je nodig hebt
- Een Narrow.TV-account met een kassa, bestelkiosk of Scan & Order. De API is daarbij inbegrepen. De actuele prijzen vind je bij onze prijzen.
- Iemand die de koppeling bouwt: jijzelf, je ontwikkelaar of een partner.
Wil je overleggen wat je wilt koppelen? Neem contact op, dan denken we mee.
Veelgestelde vragen
Wat kost de API?
De API is inbegrepen bij de kassa, de bestelkiosk en Scan & Order. Heb je minstens één daarvan, dan kun je API-tokens aanmaken. De prijzen van die producten vind je bij onze prijzen.
Zijn er kant-en-klare koppelingen met boekhoudpakketten?
Nog niet. De API is er om je eigen systemen te koppelen, of om je ontwikkelaar of partner een koppeling te laten bouwen. De dagomzet per btw-tarief en per betaalmethode is daarvoor direct op te vragen.
Kan ik verkopen van de kassa aanpassen via de API?
Nee. Het kassajournaal is via de API alleen te lezen. Elke verkoop blijft onveranderbaar vastgelegd, net als in de kassa zelf.
Wie kan API-tokens aanmaken?
Alleen de eigenaar van het account, in het dashboard onder het accountmenu bij API-toegang. Daar beheer je ook de webhooks.
Wat heeft een ontwikkelaar nodig?
Een token met de juiste rechten en de documentatie op connect.narrow.tv/docs. Daar staan alle endpoints met voorbeelden, uitleg over webhooks en de OpenAPI-specificatie.