Forum Discussion
SébastienArtyty
Première note
Première noteAPI v2 customer_invoices : ajout des scheme ID 0088 et correction du 0225 dans le Factur-X (CII)
Bonjour,
Je génère des factures clients via l'API v2 (POST https://app.pennylane.com/api/external/v2/customer_invoices) et j'ai envoyé les fichiers Factur-X (PDF + XML CII) à un client pour test, en vue de la réforme de la facturation électronique.
Le retour bloquant de ce client (Leclerc via leur PA Logilec) sur la facture porte sur les identifiants des parties dans le XML CII :
1. Ajouter le scheme ID 0088 (GLN) dans le vendeur (SellerTradeParty) et dans l'acheteur (BuyerTradeParty), au niveau de GlobalID.
2. Corriger le scheme ID 0225 de l'acheteur, dont la valeur doit être au format SIREN_GLN.
D'après la documentation de l'API, ni l'endpoint customer_invoices ni la création de client (company_customers) n'exposent de champ pour le GLN, le scheme ID ou l'adresse de facturation électronique. Je ne peux donc pas corriger ces éléments de mon côté.
Pouvez-vous m'indiquer :
- s'il est possible d'ajouter le GLN (0088) du vendeur et de l'acheteur dans le CII généré, et par quel moyen (champ API, fiche client, paramètres de l'entreprise dans l'interface) ;
- comment faire générer l'adresse électronique de l'acheteur (0225) au format SIREN_GLN ;
Merci d'avance pour votre aide.
Bonjour SébastienArtyty
Sur la base du code de génération du Factur-X (XML CII) utilisé par l'API customer_invoices, le schéma GLN (0088) n'est pas supporté aujourd'hui pour le GlobalID du vendeur (SellerTradeParty) ni de l'acheteur (BuyerTradeParty). Le générateur n'implémente que trois identifiants ISO 6523 : SIREN (schéma 0002), SIRET (schéma 0009) et un « routing code » (schéma 0224). Le GlobalID (schéma SIRET 0009) n'est même renseigné que dans un cas précis : lorsque l'acheteur est identifié comme une entité publique (B2G) ; dans ce cas la valeur injectée est le SIRET (14 chiffres), jamais un GLN. Il n'existe donc aucun champ — ni sur l'API customer_invoices, ni sur company_customers, ni dans l'interface (fiche client ou paramètres entreprise) — permettant de faire apparaître un GLN (0088) dans le CII généré par Pennylane : ce schéma n'apparaît dans le code que côté parseur de factures entrantes, pas côté génération des factures de vente.
Concernant le schéma 0225 (adresse électronique de l'acheteur, bloc URIUniversalCommunication/URIID) : le code fixe toujours le schemeID à « 0225 », mais la valeur insérée correspond soit à une adresse de routage spécifique configurée pour ce client (fonctionnalité de routage granulaire, activable par flag produit, aujourd'hui limitée à certains cas d'usage), soit, à défaut, simplement au SIREN brut (9 chiffres) du client. Le générateur ne construit jamais automatiquement une valeur combinée « SIREN_GLN » : si la plateforme du client attend ce format précis, il faut que l'adresse électronique renseignée pour ce client corresponde déjà exactement à cette valeur. La documentation publique confirme que les adresses électroniques gérées par Pennylane suivent uniquement les formats SIREN, SIREN_SIRET ou SIREN_suffixe/code de routage — aucun format SIREN_GLN n'est documenté ni généré nativement.
En résumé : il n'est pas possible en l'état d'ajouter un GLN (0088) dans le CII généré par Pennylane (ni via l'API, ni via la fiche client, ni via les paramètres entreprise) ; et le format « SIREN_GLN » attendu pour le schéma 0225 ne peut pas être généré automatiquement — seule une adresse de routage explicitement définie à ce format exact pour ce client permettrait d'obtenir cette valeur
2 Réponses
SébastienArtytyBonjour Angélique,
Merci pour votre réponse.
Toutefois, notre client (Leclerc) de la grande distribution exige d'avoir ces évolutions :
- Ajouter le scheme ID 0088 (GLN) dans le vendeur (SellerTradeParty) et dans l'acheteur (BuyerTradeParty), au niveau de GlobalID.
- Corriger le scheme ID 0225 de l'acheteur, dont la valeur doit être au format SIREN_GLN.
Il nous faut donc avoir ces champs avec ces valeurs. Je ne pense pas que nous soyons le seul dans ce cas.
Dans l'attente d'une évolution dans ce sens.
Merci d'avance.
Cordialement
- Angélique_
Pennylaneur
Bonjour SébastienArtyty
Sur la base du code de génération du Factur-X (XML CII) utilisé par l'API customer_invoices, le schéma GLN (0088) n'est pas supporté aujourd'hui pour le GlobalID du vendeur (SellerTradeParty) ni de l'acheteur (BuyerTradeParty). Le générateur n'implémente que trois identifiants ISO 6523 : SIREN (schéma 0002), SIRET (schéma 0009) et un « routing code » (schéma 0224). Le GlobalID (schéma SIRET 0009) n'est même renseigné que dans un cas précis : lorsque l'acheteur est identifié comme une entité publique (B2G) ; dans ce cas la valeur injectée est le SIRET (14 chiffres), jamais un GLN. Il n'existe donc aucun champ — ni sur l'API customer_invoices, ni sur company_customers, ni dans l'interface (fiche client ou paramètres entreprise) — permettant de faire apparaître un GLN (0088) dans le CII généré par Pennylane : ce schéma n'apparaît dans le code que côté parseur de factures entrantes, pas côté génération des factures de vente.
Concernant le schéma 0225 (adresse électronique de l'acheteur, bloc URIUniversalCommunication/URIID) : le code fixe toujours le schemeID à « 0225 », mais la valeur insérée correspond soit à une adresse de routage spécifique configurée pour ce client (fonctionnalité de routage granulaire, activable par flag produit, aujourd'hui limitée à certains cas d'usage), soit, à défaut, simplement au SIREN brut (9 chiffres) du client. Le générateur ne construit jamais automatiquement une valeur combinée « SIREN_GLN » : si la plateforme du client attend ce format précis, il faut que l'adresse électronique renseignée pour ce client corresponde déjà exactement à cette valeur. La documentation publique confirme que les adresses électroniques gérées par Pennylane suivent uniquement les formats SIREN, SIREN_SIRET ou SIREN_suffixe/code de routage — aucun format SIREN_GLN n'est documenté ni généré nativement.
En résumé : il n'est pas possible en l'état d'ajouter un GLN (0088) dans le CII généré par Pennylane (ni via l'API, ni via la fiche client, ni via les paramètres entreprise) ; et le format « SIREN_GLN » attendu pour le schéma 0225 ne peut pas être généré automatiquement — seule une adresse de routage explicitement définie à ce format exact pour ce client permettrait d'obtenir cette valeur
