Quelles informations une XRechnung doit-elle contenir au minimum ?

Le format xrechnung génère via l'API faktoora une facture conforme à la norme européenne EN 16931, au choix sous forme de simple fichier XML ou de profil ZUGFeRD. Pour que la facture puisse être créée, certaines informations doivent figurer dans la requête.

Champs obligatoires au niveau de la facture

Pour l'objet Invoice lui-même, les champs suivants sont obligatoires selon le schéma de l'API :

• format (ici : xrechnung)
• issueDate : date de facture
• invoiceNumber : numéro de facture
• invoiceTypeCode : type de facture, par ex. 380 pour une facture commerciale standard
• invoiceItems : au moins une ligne de facture
• buyer : l'acheteur

Champs obligatoires pour le vendeur

Si vous transmettez un bloc seller, les champs suivants y sont obligatoires :

• name : nom de l'entreprise
• street : rue
• postcode : code postal
• city : ville
• country : pays sous forme de code ISO 3166-1 alpha-2 (par ex. DE)

Champs obligatoires pour l'acheteur

Le bloc buyer est de toute façon obligatoire au niveau de la facture ; à l'intérieur, les champs suivants sont obligatoires :

• name : nom de l'acheteur
• street : rue
• postcode : code postal
• city : ville
• country : pays sous forme de code ISO 3166-1 alpha-2

Champs obligatoires pour chaque ligne de facture

Chaque ligne dans invoiceItems nécessite un id et un objet product. Dans product, les champs suivants sont obligatoires :

• name : désignation du bien ou de la prestation
• quantity : quantité
• unitCode : unité de mesure (par ex. HUR pour les heures, C62 pour les pièces, KGM pour les kilogrammes)
• price : prix unitaire
• taxes : au moins une entrée de taxe avec typeCode, categoryCode et rate

Leitweg-ID pour les acheteurs publics

Les factures adressées à des acheteurs publics comportent en plus une Leitweg-ID (identifiant d'acheminement de l'administration allemande). Dans l'API, celle-ci est transmise dans le champ buyerReference.buyerReferenceId. Vous obtenez la Leitweg-ID auprès du destinataire de la facture. Si vos factures s'adressent à des entreprises plutôt qu'à des acheteurs publics, il n'y a généralement pas de Leitweg-ID.

Une XRechnung créée via l'interface faktoora demande les mêmes informations étape par étape ; vous trouverez le guide correspondant dans l'article Création d'une XRechnung/ZUGFeRD ou d'une facture PDF.