---
title: "Guides"
description: "Guides pas à pas pour intégrer l'API publique Billabex."
canonical: https://developer.billabex.com/fr/guides/
lang: fr
alternate: https://developer.billabex.com/en/guides/
last-updated: 2026-09-12
---

# Guides

> Guides pas à pas pour intégrer l'API publique Billabex.

Source: https://developer.billabex.com/fr/guides/
Langue: Français (fr)
Version anglaise: https://developer.billabex.com/en/guides/

- [Démarrage](https://developer.billabex.com/fr/guides/demarrage/): Introduction rapide à l'API Billabex : s'authentifier et faire son premier appel.
- [Authentification OAuth Billabex](https://developer.billabex.com/fr/guides/oauth/): Flux d'autorisation OAuth 2.1 par code avec PKCE, et OpenID Connect en option.
- [Scopes OAuth](https://developer.billabex.com/fr/guides/scopes/): Comprendre les scopes disponibles, comment l'accès est contrôlé, et comment demander les bonnes permissions pour votre intégration.
- [Erreurs JSON](https://developer.billabex.com/fr/guides/erreurs/): Interpréter les erreurs de l'API Billabex par leur code, suivre la piste de résolution, et ne réessayer que lorsque la réponse l'autorise.
- [Idempotence](https://developer.billabex.com/fr/guides/idempotence/): Rendre une écriture rejouable sans risque : envoyez un Idempotency-Key et la seconde tentative rejoue la première réponse au lieu de créer un second enregistrement.
- [Serveur MCP Billabex](https://developer.billabex.com/fr/guides/mcp/): Connecter un outil IA à Billabex par le Model Context Protocol (MCP), avec OAuth 2.1.
- [Préférences de notification](https://developer.billabex.com/fr/guides/preferences-de-notification/): Lire et modifier les préférences de notification de l'utilisateur authentifié.
- [Limites de débit](https://developer.billabex.com/fr/guides/limites-de-debit/): Comprendre le modèle de limitation par jeton OAuth, pourquoi il est conçu ainsi, et ce que votre intégration doit implémenter.
- [Journal d'audit](https://developer.billabex.com/fr/guides/journal-d-audit/): Lire qui a fait quoi dans une organisation : une entrée par commande réussie, filtrable par compte, par acteur et par texte libre.
- [Pagination et filtres](https://developer.billabex.com/fr/guides/pagination/): Comprendre la pagination par curseur de Billabex et le paramètre filters, et ce que votre intégration doit implémenter.
- [Sources de compte](https://developer.billabex.com/fr/guides/sources-de-compte/): Relier et délier une source de données externe à un compte, par API.
- [Facture d’origine d’un avoir](https://developer.billabex.com/fr/guides/facture-d-origine-d-un-avoir/): Relier un avoir à sa facture d’origine sans créer d’allocation ni modifier les soldes.
- [Opérations upsert](https://developer.billabex.com/fr/guides/upsert/): Créer ou mettre à jour une ressource en une seule requête idempotente.
- [Contacts](https://developer.billabex.com/fr/guides/contacts/): Gérer les contacts clients rattachés à un compte.
- [Envoi de fichiers](https://developer.billabex.com/fr/guides/televersement-de-fichiers/): Envoyer les fichiers de factures, d'avoirs et de pièces jointes d'email, en binaire ou en base64.
- [Tâches de compte et interactions](https://developer.billabex.com/fr/guides/taches-de-compte/): Répondre aux tâches ouvertes par l'agent Billabex : rechercher, lister, consulter, annuler, mettre de côté, et ajouter une interaction.
- [Envoyer un SMS ou un courrier](https://developer.billabex.com/fr/guides/messages-sortants/): Prévisualiser, chiffrer et envoyer une relance payante sans créer de doublon.
- [Lire la balance âgée](https://developer.billabex.com/fr/guides/balance-agee/): Analyser les encours nets par ancienneté, devise et compte client.
- [Lien du portail client](https://developer.billabex.com/fr/guides/portail-client/): Donner à un client un lien pour consulter et télécharger les factures et avoirs suivis.

---

Billabex developer portal. OpenAPI specification: https://developer.billabex.com/openapi.json.
Agent instructions: https://developer.billabex.com/llms.txt. Complete documentation: https://developer.billabex.com/llms-full.txt.