Aller au contenu principal

Guide de raccordement à Invox-IA

Vue d'ensemble

Le raccordement à Invox-IA comprend cinq phases, de la signature du contrat à la mise en production. La durée typique est de 4 à 8 semaines selon la complexité de votre SI.

Prérequis

Avant de démarrer :

  • Identifier les SIREN à raccorder à l'annuaire PPF
  • Identifier votre mode d'intégration (API REST, EDI SFTP, ou portail web)
  • Préparer vos certificats ou identifiants OAuth2 (fournis par Doxallia)
  • Définir les flux nécessaires (émission seule, réception seule, ou les deux)

Phase 1 — Contractualisation

Signature du contrat de service avec Doxallia. À l'issue de cette phase, vous recevez :

  • Votre identifiant client (clientId)
  • Votre accès à la sandbox de test
  • La documentation API (disponible sur ce portail)

Phase 2 — Enregistrement à l'annuaire PPF

Doxallia enregistre vos SIREN dans l'annuaire PPF via le Flux 13 (AnnuaireActualisation). Ce raccordement indique à la DGFIP que vos factures transitent par Invox-IA.

  • Délai : 24 à 48 heures après soumission
  • Périmètre : un ou plusieurs SIREN, avec ou sans suffixe de routage
  • Mise à jour possible à tout moment (ajout, modification, suppression)

Phase 3 — Intégration technique

Deux modes d'intégration sont disponibles :

API REST (recommandé)

  • Authentification OAuth2 Client Credentials (Keycloak)
  • Endpoints : POST /api/v1/factures/emission, GET /api/v1/factures/{id}/cdv
  • Sandbox disponible avec JDD de test (disponibles dans le portail développeur)
  • Documentation OpenAPI complète sur ce portail

EDI SFTP

  • Dépôt de fichiers UBL/CII/Factur-X sur un répertoire SFTP dédié
  • Récupération des accusés de réception et statuts CDV en retour
  • Adapté aux systèmes legacy ou batch

Phase 4 — Tests et recette

Validation en environnement de recette :

  • Envoi de factures de test (JDD fournis par Doxallia)
  • Vérification des statuts CDV retournés
  • Test des cas d'erreur (format invalide, SIREN inconnu, schématron non conforme)
  • Validation de l'interopérabilité avec le PPF de recette DGFIP

Phase 5 — Mise en production

  • Bascule des credentials sandbox → production
  • Premier flux réel supervisé par l'équipe Doxallia
  • Accès au tableau de bord CDV et aux alertes en temps réel

Contacts

Pour démarrer un raccordement, utilisez le formulaire de contact ou demandez une démo.