Comment Gatebold transmet vos factures Magento à votre Plateforme Agréée

L’essentiel à retenir

• Le flux Gatebold suit cinq étapes : extraction depuis Magento, normalisation EN 16931, validation des données, transmission à votre Plateforme Agréée, puis suivi du cycle de vie DGFiP en retour.
• Gatebold ne produit aucun format réglementaire : le Factur-X, l’UBL ou le CII sont produits par votre PA, à partir de données déjà normalisées et validées.
• Les statuts DGFiP (déposée, refusée, encaissée, etc.) reviennent en temps réel par webhooks signés, jusque dans la grille Sales de Magento.
• Une facture rejetée se corrige et se rejoue manuellement depuis l’interface, avec le motif de rejet sous les yeux.
• L’intégration avec une Plateforme Agréée immatriculée par l’État est validée de bout en bout.

Vue d’ensemble du flux

Magento (Sales / Invoice)
   │  1. extraction (connecteur Gatebold)
   ▼
Plateforme Gatebold
   │  2. normalisation EN 16931 (JSON canonique)
   │  3. validation des données (SIREN/SIRET, TVA, totaux, etc.)
   ▼
Plateforme Agréée (immatriculée DGFiP)
   │  4. production du format réglementaire (Factur-X, UBL ou CII)
   │     transmission légale : PA destinataire + administration
   ▼
Cycle de vie DGFiP
   │  5. webhooks signés : déposée → ... → encaissée
   ▼
Plateforme Gatebold + grille Sales Magento

Chaque étape a un rôle précis et une frontière claire : Gatebold prépare et transporte des données conformes, la Plateforme Agréée porte les actes réglementaires. Voici ce qui se passe réellement à chaque étage.

Étape 1 - l’extraction depuis Magento

Le point de départ est la facture que Magento émet nativement (Sales / Invoice). Le connecteur Gatebold - un module Magento standard installé via Composer - détecte l’émission et extrait l’intégralité des données : en-tête, lignes, taux de TVA, identités acheteur et vendeur, conditions de paiement, etc.

Aucune logique métier n’est codée dans la boutique : le connecteur extrait, la plateforme Gatebold décide. C’est ce qui permet aux mises à jour Magento de rester indolores - le connecteur est maintenu par Gatebold, et votre configuration vit côté SaaS, pas dans le code de la boutique.

Étape 2 - la normalisation EN 16931

Les données extraites sont canonicalisées en un JSON aligné sur le modèle sémantique européen EN 16931 - le socle commun de tous les formats de la réforme. C’est l’étape qui absorbe les particularités de votre Magento : noms de champs custom, attributs spécifiques, conventions d’arrondis, etc.

Pourquoi c’est important : votre Plateforme Agréée attend des données sémantiquement propres pour produire le format réglementaire. Une normalisation rigoureuse en amont, c’est moins de rejets en aval - et un changement de PA qui ne remet pas en cause votre intégration, puisque le modèle canonique reste le même.

Étape 3 - la validation des données

Avant toute transmission, chaque facture passe un contrôle de conformité aligné sur les règles du standard AFNOR XP Z12-013 : validité des SIREN/SIRET, cohérence des numéros de TVA français, équilibre des totaux (HT, TVA par taux, TTC), présence des mentions obligatoires, etc.

Une facture qui échoue est bloquée avant la PA, avec un diagnostic précis du champ en cause. Vous corrigez à la source - souvent une donnée client dans Magento - et vous rejouez. Ce filtre en amont épargne des allers-retours avec le circuit réglementaire et garde votre taux de rejet PA au plancher.

Étape 4 - la transmission à votre Plateforme Agréée

Les données validées sont transmises à votre Plateforme Agréée via une API alignée sur le standard AFNOR XP Z12-013 - le contrat d’interface que les PA françaises implémentent. C’est ici que la frontière des rôles joue à plein :

• Gatebold livre à la PA des données normalisées, validées, tracées ;
• la PA, immatriculée par la DGFiP, produit le format réglementaire (Factur-X, UBL ou CII), transmet la facture à la PA du destinataire et alimente l’administration fiscale.

Étape 5 - le cycle de vie DGFiP, en temps réel

Une fois la facture dans le circuit, son histoire ne fait que commencer : la réforme définit un cycle de vie normalisé - déposée, refusée, approuvée, encaissée, etc. Ces statuts sont émis par votre PA et reçus par Gatebold via des webhooks signés : chaque notification est vérifiée cryptographiquement avant d’être acceptée, puis historisée.

Le résultat, côté marchand : le statut de chaque facture est visible dans la grille Sales de Magento et dans la plateforme Gatebold, sans interroger quoi que ce soit. Une facture refusée apparaît avec son motif ; vous corrigez, vous rejouez manuellement, et le nouveau statut remonte par le même canal. Pour un service comptable, cela remplace le trio email + tableur + relance par une source unique de vérité.

Ce que ce découpage change pour vous

• Pas de dépendance à un format : si votre PA passe de Factur-X à UBL, ou si une version évolue, vos données canoniques EN 16931 restent valides - c’est la PA qui adapte sa production.
• Pas de dépendance à une PA : l’architecture est conçue multi-PA. Vous changez de Plateforme Agréée sans toucher à votre Magento ni à votre mapping.
• Pas de conformité silencieusement cassée : entre la validation en amont et les statuts en temps réel en aval, une anomalie se voit tout de suite - pas au contrôle fiscal.

Vous facturez depuis Magento et vous voulez voir ce flux appliqué à votre propre cas - vos données, votre PA, votre calendrier ? Découvrez E-Invoice Gateway ou parlons de votre projet.