Uw kassa, bestelkiosk en Scan & Order werken met één assortiment en één voorraad in het dashboard. Met de Narrow.TV API koppelt u die gegevens aan de systemen die u al gebruikt. Koppel uw eigen systemen, of laat uw ontwikkelaar of partner de koppeling bouwen.
Waarvoor gebruikt u 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 uw eigen systeem en Narrow.TV.
- Rapportages en BI: gebruik uw verkopen en bestellingen in uw eigen dashboards en analyses.
- Eigen orderverwerking: stuur bestellingen van de kiosk en Scan & Order door naar uw eigen systemen.
Zo start u
- 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 ziet u in de lijst wanneer het voor het laatst is gebruikt, en trekt u het in wanneer u 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 uw boekhouding nodig heeft. Het journaal van de kassa kunt u via de API alleen lezen, niet wijzigen.
Assortiment
Lees en beheer categorieën, producten en productopties. Met één verzoek werkt u tot 500 producten tegelijk bij, gekoppeld aan uw eigen artikelcode. Categorieën kunt u op naam meegeven, en productfoto's geeft u 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 uw bestelkiosk en Scan & Order, met regels, bedragen, betaalmethode en status.
Webhooks: direct op de hoogte
Met webhooks stuurt Narrow.TV een bericht naar uw 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 u 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 u 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 u nodig heeft
- Een Narrow.TV-account met een kassa, bestelkiosk of Scan & Order. De API is daarbij inbegrepen. De actuele prijzen vindt u bij onze prijzen.
- Iemand die de koppeling bouwt: uzelf, uw ontwikkelaar of een partner.
Wilt u overleggen wat u 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. Heeft u minstens één daarvan, dan kunt u API-tokens aanmaken. De prijzen van die producten vindt u bij onze prijzen.
Zijn er kant-en-klare koppelingen met boekhoudpakketten?
Nog niet. De API is er om uw eigen systemen te koppelen, of om uw 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 beheert u 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.