Émettre des fapiao directement depuis Odoo : une passerelle vers la facturation électronique numérique en Chine
Toute entreprise opérant en Chine continentale doit émettre une fapiao (发票), la facture fiscale officielle réglementée par l'État. Ce n'est pas une formalité que l'on peut sauter. Une vente n'est pas correctement documentée, sur le plan fiscal, tant qu'une fapiao conforme n'existe pas pour elle.
La Chine est également en pleine transition vers la e-fapiao entièrement numérique, appelée 数电票, et les règles qui l'accompagnent sont réellement complexes. Chaque ligne d'article a besoin d'un code de classification fiscale national. Le compte fiscal numérique du vendeur doit disposer d'une session active avec l'administration fiscale, sinon l'émission échoue silencieusement. Annuler une facture n'est pas une suppression ; c'est une contre-passation en rouge (红冲) qui peut exiger une confirmation de l'acheteur sous 72 heures.
Les entreprises qui utilisent Odoo ont déjà toutes leurs ventes et leur facturation directement dans l'ERP. Odoo, en revanche, ne dispose d'aucune passerelle native vers le système de facturation électronique chinois. Le résultat courant est une double saisie manuelle entre Odoo et la plateforme de fapiao, ce qui est lent, source d'erreurs, et un véritable risque de conformité : une erreur de code ou de taux de taxe, et l'administration fiscale rejette purement et simplement la facture.
Ce que nous avons construit, et ce qui est nouveau
Majorbird a construit une intégration qui connecte Odoo directement à Baiwang (百望云), l'une des principales plateformes de facturation électronique en Chine, afin qu'une fapiao puisse être émise, puis annulée, directement depuis une facture Odoo, sans aucune ressaisie manuelle. C'était la conception d'origine. Ce qui est passé depuis de "construit" à démontré de bout en bout : un utilisateur prend une facture Odoo existante, et la fapiao, le numéro de facture et le PDF officiel reviennent tous se poser directement sur ce même enregistrement de facture Odoo. Il n'y a pas de portail Baiwang séparé où se connecter. La personne qui effectue le travail ne quitte jamais Odoo.
Un service connecteur porte toute la complexité spécifique à la Chine, authentification, signature des requêtes, le modèle d'émission asynchrone, le flux de contre-passation en rouge, la gestion des codes fiscaux, de sorte qu'Odoo lui-même n'a jamais à parler le dialecte technique de Baiwang. Odoo dialogue avec une interface propre et neutre, et le connecteur se charge de la partie difficile.
Comment cela fonctionne, et où cela se trouve dans Odoo
Un utilisateur clique sur Générer la Fapiao sur une facture client. Comme l'émission est asynchrone, Baiwang accepte d'abord la demande et produit la fapiao réelle quelques instants plus tard, si bien que le connecteur interroge le système jusqu'à confirmation, puis réécrit le numéro de fapiao et le PDF dans Odoo. L'annulation fonctionne de la même façon, via un avoir Odoo standard, qui déclenche en coulisses le processus conforme de contre-passation en rouge.
Deux détails donnent l'impression d'un dispositif natif plutôt que rapporté. D'abord, le préremplissage de l'en-tête de facture de l'acheteur : on saisit le nom d'un client et son en-tête de facture officiel, raison sociale enregistrée, numéro fiscal, adresse, banque, est récupéré directement depuis la plateforme fiscale, de sorte que personne ne saisit à la main le 抬头 d'une entreprise en risquant une faute de caractère. Ensuite, le connecteur héberge sa propre liste de codes de classification fiscale, avec un mécanisme de mise à jour, de sorte que les produits soient associés au bon code national sans que quiconque ait à tenir une table de correspondance à la main.
Un enregistrement dédié suit le cycle de vie complet de chaque fapiao, de la soumission jusqu'à l'émission ou l'échec, en passant par les états de contre-passation, avec le numéro de fapiao, le statut et le PDF directement sur la facture. Et côté Odoo, tout est construit avec des champs propres et neutres vis-à-vis du fournisseur plutôt que de coder "Baiwang" en dur dans le modèle de données, ce qui garde la solution portable si cela devait un jour changer.
Robuste par conception, pas seulement en démonstration
La plupart des premières tentatives de ce genre font fonctionner le chemin nominal, puis s'arrêtent là. Le véritable travail d'ingénierie se joue dans ce qui se passe en dehors de ce chemin. L'émission est idempotente et confirmée par le fournisseur, si bien qu'une nouvelle tentative ne produit jamais de document fiscal en double. La gestion des erreurs est délibérément intelligente plutôt que réflexe : le système distingue une défaillance transitoire qui mérite une nouvelle tentative d'un problème de données qui nécessite une correction humaine, de sorte qu'il ne martèle jamais aveuglément l'administration fiscale avec la même requête erronée. La session du compte numérique avec l'administration fiscale est surveillée de façon proactive, car si elle expire, chaque émission échoue silencieusement jusqu'à ce que quelqu'un le remarque, ce qui est l'un des points les plus délicats de la facturation électronique chinoise en pratique. La contre-passation en rouge est prise en charge comme le véritable processus, en plusieurs étapes, exigé par le droit fiscal chinois, et non comme un simple bouton d'annulation fictif. Des rappels push en temps réel depuis la plateforme fiscale, plutôt qu'un simple interrogation périodique, constituent une prochaine étape déjà documentée.
Notre avis
L'objectif n'est pas simplement de connecter Odoo à une plateforme fiscale. C'est de faire en sorte que la conformité fapiao chinoise se ressente comme une partie native de l'ERP, robuste par conception, plutôt que comme un portail rapporté que quelqu'un doit penser à ouvrir. C'est l'expertise Odoo et de localisation chinoise de Majorbird rendue concrète, et elle a été prouvée de bout en bout dans un environnement de test. Si la conformité à la facturation électronique chinoise se situe quelque part entre "au programme" et "nous empêche de dormir", c'est une conversation qui vaut la peine d'être eue avec l'équipe Majorbird à odoo@majorbird.com ou sur www.majorbird.com.
Sources & Links
- Baiwang : plateforme chinoise de facturation électronique / fapiao (prestataire de services de facturation électronique pour l'Administration fiscale d'État).