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_..."

Avec une clé fac_test_, Facturino simule les échanges sans dépôt auprès d'Iopole. En mode réel, Facturino suit automatiquement les statuts retournés par la plateforme après le dépôt.

Limites connues

E-reporting : verdict lu par dossier. Facturino prépare et transmet les transactions et encaissements via les quatre routes de l'API native Iopole, en conservant le reçu de chaque partie. Un reçu d'ingestion ne vaut pas acceptation par l'administration : le suivi recherche les dossiers de déclaration de l'entreprise sur la période, retrouve les reçus dans leur contenu et pose accusé (SUBMITTED), accepté (ACCEPTED) ou refusé (REJECTED). Le contenu d'un dossier est encore publié sans schéma par Iopole : un contenu illisible, un dossier annulé ou un état non documenté reste à qualifier par Facturino, sans relance demandée au client.

  • 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