Aller au contenu

Traitement des documents XML (XRechnung & ZUGFeRD)

Dernière mise à jour : 04.09.2025 • Temps de lecture : ~5 minutes

Smart Processing prend en charge le traitement des formats de factures XML standardisés – actuellement XRechnung et ZUGFeRD. Le processus global correspond largement au déroulement standard (Classer → Traiter → Clôturer/Archiver). Cependant, il existe des règles spécifiques pour la classification et l'extraction de données (Capture), qui constituent cet article.

Conditions préalables

  • Des workflows XML sont créés (Type de fichier Workflow XML).
  • Dans Smart Processing Setup, le XML Classification Mapping est configuré.
  • Un Process Template existe ; Smart Matching dans le template est recommandé (voir ci-dessous).

Fonctionnement en bref

  1. Classification via TypeCode

    • XRechnung/ZUGFeRD ne sont pas classifiés par des modèles d'IA, mais de manière déterministe via le TypeCode dans le XML.
    • L'association TypeCode → Classification est gérée de manière centralisée dans le XML Classification Mapping.

  2. Capture sans configuration séparée

    • Pour XML, aucune configuration de capture distincte n'est prévue.
    • Smart Processing lit les chemins/éléments du XML, génère des noms de champs logiques à partir de ceux-ci et les met à disposition en tant que champs extraits.
    • Aucun chemin XPath complexe n'est affiché comme nom de champ – à la place, des identifiants parlants et consolidés (par exemple, InvoiceNumber, BuyerVATId, Line.Amount).

  3. Matching dans le Template

    • Les champs logiquement nommés sont associés au Process Template dans le processus de matching.
    • Recommandation : Activer Smart Field Matching dans le template pour que l'association se fasse automatiquement.

Classification : XML TypeCode → Classification

La classification se fait exclusivement via le TypeCode dans le XML (par exemple, 380 = Invoice, 381 = Credit Note).

Procédure :

  1. Ouvrez Smart Processing Setup.
  2. Section Classifications → XML Classification Mapping.
  3. Ajoutez/modifiez les entrées de mapping (Classification ↔ TypeCodes, séparées par des virgules).

Capture pour XML : Noms de champs logiques au lieu de XPath

Pour les factures XML, Smart Processing effectue un parsing structuré et génère des champs logiquement nommés :

  • Champs d'en-tête (par exemple, InvoiceNumber, InvoiceDate, BuyerName, SellerVATId).
  • Champs de ligne (par exemple, Line.No, Line.ItemId, Line.Quantity, Line.Amount, Line.VATRate).
  • Contexte du document (par exemple, DocumentCurrency, PaymentTerms, ReferenceDocument).

Avantages :

  • Meilleure lisibilité et association plus simple dans le matching.
  • Robuste face à de petites variantes de schéma/profil, tant que des correspondances sémantiques sont présentes.

Remarque

Étant donné qu'une configuration de capture séparée est omise, le Process Template (y compris Smart Matching) contrôle principalement l'association dans les tables et champs cibles.

Paramètres de template recommandés

  • Utiliser Smart Field Matching : Activer

  • Permet l'association automatique des champs XML logiquement nommés aux champs du template.

  • Validation de recherche (optionnel) :

  • Pour les champs de données de base (Client/Fournisseur/Article), utilisez Yes ou Custom Codeunit pour garantir des références propres.

  • Options numériques (par exemple, décimales, gestion des valeurs négatives) :

  • Utile pour les montants/quantités afin de traiter de manière stable les variantes de format.

Étape par étape (exemple de flux)

  1. Importer XML → Le fichier apparaît dans la liste d'entrée (Type de fichier XML).
  2. Classification → se fait automatiquement via le TypeCode selon le mapping.
  3. Traiter le document → avec Smart Field Matching, les champs d'en-tête et de ligne sont automatiquement associés au template.
  4. Validation & Clôture → Vérifiez les remarques, apportez des corrections si nécessaire ; exécutez Complete Process.
  5. Optionnel → Archivage dans Document Central selon les options de template/processus.

Dépannage

Document non classifié

  • TypeCode manquant/différent → Vérifiez/complétez le XML Classification Mapping.

Champs manquants ou paraissant "imprécis"

  • Vérifiez si les noms de champs logiques sont présents/associés dans le template.
  • Activez Smart Field Matching ; alternativement, gérez les Alternative Search Names dans les champs du template.

Résumé

  • Formats pris en charge : XRechnung et ZUGFeRD.
  • Classification se fait via TypeCode (mapping dans les paramètres).
  • Capture n'est pas configurée séparément : Smart Processing génère des noms de champs logiques à partir du XML, pas de chemins XPath.
  • Recommandation : Activer Smart Field Matching dans le Process Template pour une association automatique.
  • Le processus (Brouillon → Matching → Validation → Clôture/Archivage) correspond à la norme – seule la classification et la capture sont résolues de manière spécifique à XML.

Aide à la configuration