Votre caisse, votre borne de commande et Scan & Order utilisent un seul catalogue et un seul stock dans le tableau de bord. Avec l’API Narrow.TV, vous reliez ces données aux systèmes que vous utilisez déjà. Connectez vos propres systèmes, ou confiez la connexion à votre développeur ou partenaire.
Voir la documentation de l’API
À quoi sert l’API ?
- Comptabilité : récupérez le chiffre d’affaires du jour par taux de TVA et par moyen de paiement, ou consultez les rapports Z et les tickets de caisse.
- Boutique en ligne ou ERP : gardez produits, prix et stock synchronisés entre votre propre système et Narrow.TV.
- Reporting et BI : utilisez vos ventes et commandes dans vos propres tableaux de bord et analyses.
- Traitement des commandes : transmettez les commandes de la borne et de Scan & Order à vos propres systèmes.
Pour commencer
- Ouvrez Accès API dans le menu du compte du tableau de bord. Seul le propriétaire du compte voit cette page.
- Créez un jeton avec un nom et, si vous le souhaitez, une date d’expiration.
- Choisissez les droits par établissement : lire les données de caisse, lire ou gérer le catalogue, lire ou gérer le stock, et lire les commandes.
- Copiez le jeton. Il n’est affiché qu’une seule fois. Ensuite, la liste indique quand il a été utilisé pour la dernière fois, et vous pouvez le révoquer à tout moment.
Ce que propose l’API
Données de caisse
Consultez les tickets d’un établissement, avec lignes, remises, TVA et paiements. Récupérez les rapports Z, ou un récapitulatif journalier avec le chiffre d’affaires par taux de TVA et par moyen de paiement : exactement ce dont votre comptabilité a besoin. Le journal de la caisse est en lecture seule via l’API ; il ne peut pas être modifié.
Catalogue
Consultez et gérez catégories, produits et options de produit. En une seule requête, vous mettez à jour jusqu’à 500 produits à la fois, associés à votre propre code article. Les catégories peuvent être indiquées par leur nom, et les photos de produit par un lien : Narrow.TV les télécharge en arrière-plan.
Stock
Consultez les niveaux de stock et les mouvements de stock. Enregistrez inventaires, livraisons et corrections, par produit ou en masse.
Commandes
Consultez les commandes de votre borne de commande et de Scan & Order, avec lignes, montants, moyen de paiement et statut.
Webhooks : informé immédiatement
Avec les webhooks, Narrow.TV envoie un message à votre propre système dès qu’il se passe quelque chose : une vente, une clôture journalière, une variation de stock, une commande nouvelle ou modifiée, ou une modification des produits et des options. Chaque message est signé (HMAC), pour que vous puissiez vérifier qu’il vient bien de Narrow.TV. Si une livraison échoue, Narrow.TV réessaie automatiquement.
Sûr et fiable
- Tout le trafic passe par HTTPS, en JSON.
- Chaque jeton n’a que les droits par établissement que vous lui donnez, et peut avoir une date d’expiration.
- Avec une clé d’idempotence, une modification peut être renvoyée sans risque d’être traitée deux fois.
- Des limites de requêtes par jeton gardent l’API rapide et stable pour tous.
Pour les développeurs
La documentation sur connect.narrow.tv décrit tous les endpoints avec des exemples, les droits, la pagination, les codes d’erreur et la vérification des signatures de webhook. Une spécification OpenAPI 3.1 permet de générer des clients, et un sandbox est disponible à côté de l’environnement de production.
Voir la documentation de l’API
Ce dont vous avez besoin
- Un compte Narrow.TV avec une caisse, une borne de commande ou Scan & Order. L’API est incluse. Les prix actuels figurent dans nos tarifs.
- Quelqu’un pour construire la connexion : vous-même, votre développeur ou un partenaire.
Vous souhaitez discuter de ce que vous voulez connecter ? Contactez-nous, nous vous conseillons volontiers.
Questions fréquentes
Combien coûte l’API ?
L’API est incluse avec la caisse, la borne de commande et Scan & Order. Si vous avez au moins l’un de ces produits, vous pouvez créer des jetons d’API. Les prix de ces produits figurent dans nos tarifs.
Existe-t-il des connexions prêtes à l’emploi avec des logiciels comptables ?
Pas encore. L’API sert à connecter vos propres systèmes, ou à faire construire une connexion par votre développeur ou partenaire. Le chiffre d’affaires du jour par taux de TVA et par moyen de paiement est directement disponible pour cela.
Puis-je modifier des ventes de la caisse via l’API ?
Non. Le journal de caisse est en lecture seule via l’API. Chaque vente reste enregistrée de façon inaltérable, comme dans la caisse elle-même.
Qui peut créer des jetons d’API ?
Uniquement le propriétaire du compte, dans le tableau de bord, via le menu du compte, sous Accès API. C’est aussi là que vous gérez les webhooks.
De quoi un développeur a-t-il besoin ?
D’un jeton avec les bons droits et de la documentation sur connect.narrow.tv/docs. Elle présente tous les endpoints avec des exemples, explique les webhooks et donne accès à la spécification OpenAPI.