Aller au contenu principal

Post-transformation

Une post-transformation convertit l'UBL validé d'un document dans une autre syntaxe au moyen d'une feuille XSL : Cross Industry Invoice (CII) avec la feuille livrée avec NomaUBL, ou le format propre à un pays avec votre propre feuille. L'UBL reste le pivot : la base, les statuts, la validation et le routage continuent de s'appuyer sur l'UBL ; le fichier converti est une sortie supplémentaire, écrite à côté de l'UBL, téléchargeable depuis la fenêtre de la facture et, quand la plateforme l'attend, envoyée à sa place.

La post-transformation se règle par document et s'exécute dans les deux chaînes de traitement, quelle que soit la source — un spool JD Edwards, un extrait SAP ou NetSuite, un ERP personnalisé ou un fichier UBL.

Vue d'ensemble​

Post-transformation : l'UBL reste le pivotL'UBL validé est converti dans une autre syntaxe ; base, statuts et routage restent sur l'UBL.Sourcespool · UBL · APIUBL 2.1XSLT UBLValidationselon le jeu de règlesPost-transformationubl-to-cii.xslFichier CII…-cii.xmlBasearchive · cycle de vieConnecteur plateforme{{content}} · {{derivedContent}}Fenêtre de la factureTélécharger CII — depuis l'archiveÉchec = avertissementL'UBL d'abordgénération et validation inchangéesPivotbase et statuts gardent l'UBLNe bloque jamaisavertissement POST_TRANSFORMÀ côté de l'UBLle suffixe remplace .xmlÀ la demanderecalculé depuis l'UBL archivé

Réglages​

Dans l'onglet UBL du document :

ChampDéfautDescription
Post-transform(vide = aucune)Feuille appliquée à l'UBL validé. Les variables de chemin sont acceptées (%APP_HOME%, %ENV%) et le bouton des variables les insère. Exemple : %APP_HOME%/%ENV%/xsl/ubl-to-cii.xsl.
Post-transform output-cii.xmlSuffixe qui remplace le .xml du nom du fichier UBL : F2026-1203.xml donne F2026-1203-cii.xml. Le téléchargement reprend ce nom.
Post-transform name(vide)Nom court de la syntaxe produite, affiché sur les boutons de téléchargement : CII donne Télécharger CII ; vide donne Télécharger fichier converti.

Déroulement​

  1. La source est transformée en UBL puis validée selon le jeu de règles du document, comme sans post-transformation.
  2. Si la validation ne signale aucune anomalie bloquante, l'UBL passe par la feuille et le résultat est écrit à côté du fichier UBL, avec le suffixe de sortie.
  3. Si la feuille échoue, l'échec est enregistré comme anomalie de niveau avertissement POST_TRANSFORM sur la facture, visible dans ses erreurs de validation et dans les Erreurs d'intégration. L'UBL poursuit son chemin : une facture n'est jamais bloquée par sa post-transformation.

Une facture qui présente une anomalie bloquante n'a pas de fichier converti ; il est produit au traitement suivant, une fois la facture corrigée et traitée de nouveau.

Télécharger le fichier converti​

La fenêtre de la facture (E-Invoicing) et celle du document (E-Documents) affichent un bouton Télécharger CII (ou Télécharger fichier converti) quand le document a une post-transformation. Le fichier est calculé à la demande à partir de l'UBL archivé : il est donc disponible pour toute facture archivée, y compris celles traitées avant la mise en place de la post-transformation. Une erreur de conversion s'affiche dans la fenêtre (Échec de la conversion : …).

Envoyer le fichier converti à la plateforme​

Le corps du connecteur API de la plateforme peut transmettre le fichier converti à la place de l'UBL, au moyen de deux variables :

VariableValeur
{{derivedContent}}Base64 du fichier converti, comme {{content}} pour l'UBL. Vide quand le document n'a pas de post-transformation.
{{derivedFilePath}}Chemin du fichier converti sur le disque. Vide quand le document n'a pas de post-transformation.

{{content}} et {{filePath}} désignent toujours l'UBL. Lors d'un renvoi, le fichier converti est recalculé à partir de l'UBL archivé. Le routage de la facture — destinataire, type de document, statuts — continue de lire l'UBL.

La feuille livrée : UBL vers CII​

ubl-to-cii.xsl convertit une Invoice ou une CreditNote UBL 2.1 en Cross Industry Invoice D16B selon le modèle de base EN 16931 : parties et identifiants, notes avec leurs codes de sujet, références, livraison, moyens de paiement avec l'IBAN ou un compte propriétaire, remises et charges, ventilation de TVA, lignes et pièces jointes. Elle a été contrôlée sur le corpus de démonstration avec les règles officielles EN 16931 pour CII. Le document UBL de démonstration l'utilise.

Autres formats​

Un pays dont le format n'est pas UBL — une syntaxe nationale imposée par une plateforme ou une administration fiscale — se traite avec une feuille du même type : l'UBL en entrée, la syntaxe nationale en sortie. Les normes fondées sur UBL se traitent autrement, par un jeu de règles qui leur est propre. Chaque circuit d'envoi national (connecteur, statuts) fait l'objet d'un paramétrage dédié.

Conseils & bonnes pratiques​

  • Valider d'abord l'UBL. La post-transformation ne s'exécute que sur une facture sans anomalie bloquante : un UBL correct conditionne une conversion correcte.
  • Nommer la syntaxe. Post-transform name remplace le bouton générique par Télécharger CII, plus parlant pour les utilisateurs.
  • Surveiller les avertissements POST_TRANSFORM après la mise en place d'une nouvelle feuille : ils désignent les factures que la feuille ne sait pas traiter.
  • Placer ses propres feuilles dans l'environnement, à côté des autres fichiers XSL, et écrire le chemin avec %APP_HOME% / %ENV% : le même réglage vaut alors pour tous les environnements.