Quels champs BT l'API faktoora prend-elle en charge ?
Vue d'ensemble des Business Terms EN 16931 (champs BT) représentés par l'API de facturation faktoora, avec le champ API et le caractère obligatoire.
L'API faktoora génère des factures électroniques (XRechnung, ZUGFeRD, Peppol) selon la norme européenne EN 16931. Cette norme décrit chaque information possible d'une facture sous forme de « Business Term », en abrégé BT, avec un numéro fixe, par exemple BT-1 pour le numéro de facture. Dans la référence de l'API faktoora, le numéro BT correspondant est indiqué dans la description de chaque champ qui correspond à un tel Business Term.
Où se trouvent les champs BT dans l'API
Lors de la création d'une facture via POST /invoices, vous envoyez un objet Invoice. Les champs BT y sont répartis dans plusieurs zones :
- En-tête de facture : directement sur l'objet
Invoice(numéro de facture, date, type de facture, devise, références) seller: informations sur le vendeur (nom, adresse, numéro de TVA intracommunautaire)buyer: informations sur l'acheteur (nom, adresse, numéro de TVA intracommunautaire, références)invoiceItems: lignes de facture, chacune avec un objetproduct(désignation, quantité, prix unitaire, taux de TVA)
Champs BT fréquemment nécessaires
Cette sélection couvre les champs généralement nécessaires pour une facture complète. « Obligatoire » se rapporte à l'objet API concerné, si vous le transmettez : pour l'objet Invoice lui-même, seuls format, issueDate, invoiceNumber, invoiceTypeCode, invoiceItems et buyer sont obligatoires par principe selon le schéma.
| Numéro BT | Signification | Champ API | Obligatoire |
|---|---|---|---|
| BT-1 | Numéro de facture | invoiceNumber | Oui |
| BT-2 | Date de facture | issueDate | Oui |
| BT-3 | Type de facture (par ex. 380 = facture commerciale) | invoiceTypeCode | Oui |
| BT-5 | Devise | currency | Non |
| BT-9 | Date d'échéance | dueDateTime (dans specifiedTradePaymentTerms) | Non |
| BT-10 | Référence de l'acheteur / Leitweg-ID | buyerReference.buyerReferenceId | Non |
| BT-13 | Référence de commande de l'acheteur | buyerReference.IssuerAssignedID | Non |
| BT-14 | Référence à la commande | orderNumber | Non |
| BT-27 | Nom du vendeur | seller.name | Oui, dans seller |
| BT-31 | Numéro de TVA intracommunautaire du vendeur | seller.vatId | Non |
| BT-35 / BT-37 / BT-38 / BT-40 | Rue, ville, code postal, pays du vendeur | seller.street / seller.city / seller.postcode / seller.country | Oui, dans seller |
| BT-46 | Numéro client chez le vendeur | buyer.id | Non |
| BT-47 | Nom de l'acheteur | buyer.name | Oui, dans buyer |
| BT-48 | Numéro de TVA intracommunautaire de l'acheteur | buyer.vatId | Non |
| BT-50 / BT-52 / BT-53 / BT-55 | Rue, ville, code postal, pays de l'acheteur | buyer.street / buyer.city / buyer.postcode / buyer.country | Oui, dans buyer |
| BT-72 | Date de livraison | deliveryDate | Non |
| BT-126 | Numéro de ligne | invoiceItems[].id | Oui, dans la ligne |
| BT-129 | Quantité | invoiceItems[].product.quantity | Oui, dans product |
| BT-130 | Unité de mesure (par ex. HUR, C62, KGM) | invoiceItems[].product.unitCode | Oui, dans product |
| BT-146 | Prix unitaire | invoiceItems[].product.price | Oui, dans product |
| BT-153 | Désignation de la ligne | invoiceItems[].product.name | Oui, dans product |
| BT-155 | Référence article (attribuée par le vendeur) | invoiceItems[].product.productId | Non |
Chaque ligne de facture nécessite en outre une indication fiscale (taxes) avec le type de taxe, la catégorie de taxe (par ex. S pour le taux standard ou Z pour le taux zéro) et le taux de TVA ; ces trois informations sont obligatoires pour chaque ligne.
Référence complète
Le tableau ci-dessus présente une sélection des champs les plus fréquemment nécessaires. Au total, la documentation de l'API répertorie nettement plus de champs BT, notamment pour les conditions de paiement, les remises/majorations, les adresses de livraison, les références de contrat et de projet ainsi que les identifiants uniques au niveau mondial (GLN/GTIN). Vous trouverez la liste complète et faisant foi, avec toutes les descriptions de champs et des exemples, dans la référence de l'API de votre compte faktoora.
Cela vous a-t-il été utile ?