Intégration de l'API Billit : connectez-vous une fois, synchronisez vos factures automatiquement

Billit est une plateforme de facturation cloud utilisée pour créer, envoyer et gérer les factures de vente et d'achat (fournisseurs), populaire auprès des entreprises et des comptables en Belgique et au-delà. Connecter votre produit à Billit vous permet de :

• Échanger les factures de vente et d'achat de façon programmatique, dans les deux sens
• Automatiser la création, l'envoi et le rapprochement des factures
• Synchroniser les données de facturation vers des outils de comptabilité, d'ERP ou de gestion financière
• Supprimer la saisie manuelle et les erreurs qui vont avec

Ce guide couvre tout ce qu'il faut savoir sur l'API Billit, comment la configurer, les bonnes pratiques à suivre, et comment l'API de facturation unifiée de Chift vous évite le gros du travail.

Qu'est-ce que l'API Billit ?

L'API Billit est une API REST qui utilise le format JSON pour l'échange de données et OAuth 2.0 pour l'authentification. Tout le trafic passe par HTTPS, avec les verbes HTTP standards (GET, POST, PUT, DELETE) pour lire et écrire les données.

Billit expose en réalité deux API :

• API Standard, factures de vente et d'achat, exposées sous forme d'API REST JSON. C'est celle à laquelle Chift s'intègre.
• API Peppol / Access Point, facturation électronique XML/UBL via le réseau Peppol. C'est une API distincte, qui n'est pas utilisée par ce connecteur.

Nous utilisons l'API JSON standard. Elle dispose de deux environnements, chacun avec sa propre URL de base :

• Production : https://api.billit.be
• Sandbox : https://api.sandbox.billit.be

Via l'API, vous accédez aux données dont une intégration de facturation a besoin : factures de vente, factures d'achat, et les détails qui alimentent l'automatisation de la pré-comptabilité, les flux de comptes fournisseurs et le reporting financier en aval.

Vous trouverez la référence technique complète dans notre documentation du connecteur Billit.

Exemples de cas d'usage de l'intégration API Billit

Intégrer Billit ouvre des opportunités concrètes pour enrichir votre produit avec des données de facturation réelles. Voici comment des éditeurs de logiciels les exploitent via l'API de facturation unifiée de Chift.

Synchroniser les factures dans les logiciels de comptabilité et d'ERP

Les plateformes de comptabilité et d'ERP peuvent récupérer automatiquement les factures de vente et d'achat depuis Billit, gardant la comptabilité à jour sans exports manuels. Les factures arrivent directement dans les bons journaux, ce qui supprime la double saisie et garde des écritures justes.

Automatiser les comptes fournisseurs

Les outils de finance et de gestion des dépenses peuvent récupérer les factures fournisseurs depuis Billit pour alimenter les flux de validation et de paiement. Les équipes savent ce qui est dû et quand, valident plus vite et évitent les pénalités de retard liées aux documents égarés.

Alimenter les tableaux de bord de trésorerie et de gestion financière

Les produits de trésorerie et de gestion financière peuvent utiliser les données de facturation de Billit pour donner aux entreprises une vision en temps réel des entrées et des sorties d'argent. Avec des données de facturation à jour, les dirigeants prévoient plus juste et décident sur des chiffres réels.

Configurer votre intégration API Billit

Billit utilise OAuth 2.0, et les identifiants sont délivrés par leur équipe support : la configuration passe donc par une courte procédure d'approbation avant la mise en production.

1. Demandez vos identifiants OAuth au support Billit. Envoyez-leur le nom de votre application et l'URL de redirection. Les identifiants sandbox sont délivrés en premier ; les identifiants de production nécessitent une approbation de l'intégration.
2. Recevez votre client_id et votre client_secret.
3. Implémentez le flux OAuth 2.0. Échangez le code d'autorisation contre des jetons d'accès et de rafraîchissement.
4. Authentifiez vos requêtes. Passez le jeton d'accès dans l'en-tête Authorization: Bearer.
5. Définissez votre environnement. Basculez environment entre sandbox et production. Cela change à la fois l'endpoint du jeton et l'URL de base de l'API.
6. Gérez le rafraîchissement des jetons automatiquement. Rafraîchissez les jetons d'accès avant leur expiration. À noter : le rafraîchissement des jetons de Billit utilise l'authentification HTTP Basic avec votre client_id et votre client_secret, une approche un peu inhabituelle à prendre en compte dans votre implémentation.

Les endpoints des jetons sont :

• Production : https://api.billit.be/OAuth2/token
• Sandbox : https://api.sandbox.billit.be/OAuth2/token

L'API en elle-même est bien structurée, mais une intégration de niveau production, c'est bien plus que quelques appels. Vous devrez gérer le cycle de vie OAuth, normaliser les données de Billit dans un modèle interne cohérent, gérer les limites de débit et la pagination, et maintenir le tout au fil des évolutions du logiciel. C'est la partie que la plupart des équipes sous-estiment, et celle dont Chift s'occupe pour vous.

Bonnes pratiques pour l'intégration API Billit

• Stockez vos identifiants en sécurité. Gardez votre client_secret et vos jetons dans des variables d'environnement ou un coffre-fort sécurisé, jamais dans le code source. Billit ne vous demandera jamais votre secret.
• Gérez les limites de débit avec un backoff exponentiel. La limite est de 60 requêtes par minute et il est facile de l'atteindre lors de synchronisations en masse. Interceptez les réponses 429 et réessayez avec un backoff exponentiel plutôt que de saturer l'API.
• Rafraîchissez les jetons de façon proactive. Stockez la valeur expires_at et rafraîchissez les jetons d'accès avant leur expiration, via l'appel de rafraîchissement en Basic Auth. N'attendez pas qu'une requête échoue pour déclencher un rafraîchissement.
• Suivez NextPageLink pour la pagination. Utilisez le champ NextPageLink de la réponse JSON pour parcourir les résultats plutôt que de calculer les offsets vous-même.
• Développez et testez d'abord dans la sandbox. Travaillez sur api.sandbox.billit.be (connexion sur my.sandbox.billit.be) avant de demander l'approbation en production. Cela vous évite les mauvaises surprises au lancement.

Connectez-vous à Billit, Pennylane, Odoo et bien d'autres avec une seule intégration

Construire une connexion directe à Billit demande du temps, des efforts et une maintenance continue, surtout lorsque vous devez aussi intégrer d'autres outils de facturation et de comptabilité dans différents pays.

Avec l'API de facturation unifiée de Chift, vous vous connectez une seule fois et accédez à Billit, Pennylane, Odoo et bien d'autres outils européens de facturation et de comptabilité via un modèle de données cohérent.

• Une seule intégration pour des dizaines d'outils de facturation et de comptabilité
• Gestion intégrée d'OAuth, du rafraîchissement des jetons, des limites de débit et des spécificités de chaque système
• Des données unifiées et standardisées, quelle que soit la source
• Synchronisation en temps réel et monitoring avancé
• Une expérience fluide pour vos utilisateurs

Les intégrations, c'est notre métier. Vous, concentrez-vous sur le vôtre.

Réserver une démo pour en savoir plus!

FAQ API Billit

Quels endpoints sont inclus dans l'API Billit ?

Le connecteur Billit de Chift expose un ensemble standardisé d'endpoints de facturation, incluant (mais sans s'y limiter) :

• Factures de vente
• Factures d'achat

Consultez notre documentation de l'API Billit pour la liste complète des routes disponibles.

Quelle est la limite de débit de l'API Billit ?

L'API Billit autorise 60 requêtes par minute. Au-delà, l'API renvoie un code de statut 429. Mettez en place un backoff exponentiel et rythmez les synchronisations en masse pour rester sous la limite.

Comment s'authentifier auprès de l'API Billit ?

Billit utilise OAuth 2.0. Vous demandez un client_id et un client_secret au support Billit, implémentez le flux par code d'autorisation pour obtenir des jetons d'accès et de rafraîchissement, et passez le jeton d'accès dans l'en-tête Authorization: Bearer. Le rafraîchissement des jetons utilise l'authentification HTTP Basic avec vos identifiants client.

Billit propose-t-il un environnement sandbox ?

Oui. Vous pouvez développer et tester sur la sandbox à l'adresse api.sandbox.billit.be (connexion sur my.sandbox.billit.be). Les identifiants sandbox sont délivrés en premier ; les identifiants de production nécessitent une approbation de l'intégration.

Billit est-il basé dans le cloud ?

Oui. Billit est une plateforme cloud, il n'y a donc aucune installation sur site à gérer.

Le connecteur Billit prend-il en charge la facturation électronique Peppol ?

Non. Billit propose une API Peppol / Access Point distincte pour la facturation électronique XML/UBL via le réseau Peppol, mais ce connecteur utilise l'API JSON standard de Billit pour les factures de vente et d'achat.

‍