Facturino / Documentation / B2Brouter

Connecter B2Brouter

B2Brouter est une Plateforme Agréée multi-pays (FR, ES, IT), membre du réseau Peppol BIS Billing 3.0 et conforme ISO 27001. L'environnement de staging gratuit est particulièrement adapté pour les développeurs qui veulent tester l'intégration sans facturer leur compte.

Couverture
FR · ES · IT
+ réseau Peppol
Certification
ISO 27001
Peppol BIS Billing 3.0
Authentification
API Key + accountId
Header + path

1. Créer un compte B2Brouter

  1. Inscrivez-vous sur app.b2brouter.net.
  2. Complétez la KYC (SIRET, IBAN de facturation si vous activez le paiement en ligne).
  3. Dans Settings → API keys, générez une clé API.
  4. Notez votre accountId — il apparaît dans l'URL du dashboard et dans Settings → Account.

L'accountId est obligatoire. B2Brouter route les appels par compte ; sans accountId, l'API retourne 404 silencieusement. Facturino refuse la connexion si ce champ est vide pour éviter des erreurs muettes en production.

2. Connecter Facturino

La connexion d'une PA se gère depuis l'interface Facturino — les identifiants sensibles ne transitent jamais par l'API publique.

  1. Ouvrez Paramètres → Facturation électronique et choisissez B2Brouter.
  2. Collez la clé API dans le champ Clé API.
  3. Renseignez votre accountId dans le champ Account ID.
  4. Cliquez sur Connecter — Facturino ping l'API et valide l'authentification.

3. Suivi des statuts (polling)

B2Brouter n'émet pas de webhook entrant vers Facturino : le suivi du cycle de vie se fait par interrogation périodique. Après un dépôt, Facturino interroge B2Brouter et met à jour le statut de la facture automatiquement — vous n'avez aucun webhook à configurer côté B2Brouter.

4. Tester votre première facture

curl -X POST https://facturino.com/api/v1/invoices/inv_xxx/send \
  -H "Authorization: Bearer fac_test_..."

Si votre destinataire est référencé dans Peppol, B2Brouter route automatiquement la facture via le réseau Peppol. Sinon, elle est déposée par les canaux PA classiques. Le statut suit la machine d'états DGFiP standard (depositedreceivedapproved).

Ressources