Facturino / Documentation / Iopole

Connecter Iopole

Iopole est une Plateforme Agréée française SecNumCloud, immatriculée DGFiP sous le n°0018. L'authentification passe par un tenant Keycloak dédié, avec un flux OAuth 2.0 client_credentials.

Immatriculation
PA n°0018
Registre DGFiP
Certification
SecNumCloud
Hébergement souverain
Authentification
Keycloak
OAuth 2.0 client_credentials

1. Ouvrir un accès Iopole

  1. Démarrez une évaluation gratuite sur labs.iopole.io.
  2. Iopole vous confirme votre accès et provisionne un tenant Keycloak dédié.
  3. Dans Settings → API, générez un client_id et un client_secret.
  4. Relevez votre Identifiant client (CustomerId) — il figure sur votre espace Iopole et identifie votre organisation auprès de la plateforme.

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 Iopole.
  2. Renseignez les trois champs requis : Client ID, Client Secret et Identifiant client (CustomerId), puis cliquez sur Connecter.
  3. Facturino négocie un bearer token Keycloak et bascule en statut connecté dès la première réponse 200 OK.

3. Suivi des statuts (polling)

Iopole 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 Iopole et met à jour le statut de la facture automatiquement — vous n'avez aucun webhook à configurer côté Iopole.

Pour être notifié de ces changements dans votre système, abonnez votre propre endpoint aux webhooks Facturino (événements de cycle de vie invoice.deposited, invoice.available, invoice.approved…).

4. Tester votre première facture

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

Iopole accuse réception et le statut progresse (deposited → transmitted → available) au fil des interrogations.

Limites connues

E-reporting non disponible. L'API e-reporting Iopole n'est pas encore exposée publiquement. Facturino détecte la PA et ignore silencieusement les soumissions e-reporting pour les clients connectés à Iopole, jusqu'à la mise à disposition de l'API par Iopole. En attendant, vos données de facturation restent exportables via le FEC et les exports comptables (endpoints /v1/exports/*).

  • L'annuaire français (PPF) interrogé via Iopole retourne un businessEntityId que Facturino expose dans le champ id du lookup.
  • Les statuts du cycle de vie received et approved sont pris en charge par Facturino en émission (POST du statut vers Iopole) en plus de la réception.

Ressources

Toutes les Plateformes Agréées Tester l'API