
Spécifications JSON Payloads
Formats et exemples complets pour l'intégration de l'API Factur-X
Introduction
L'API InvoiceIQ utilise des structures JSON optimisées pour la conformité avec la norme européenne EN 16931 et le standard Factur-X. Que vous utilisiez le service de Transformation (ajout de données à un PDF existant) ou de Génération (création de PDF de A à Z), la structure des données reste cohérente.
Nouveauté : Exonération de TVA
Pour les cas d'exonération (ex: Micro-entreprises, Export), vous devez désormais spécifier "taxCategoryCode": "E"ainsi qu'une mention légale dans "taxExemptionReason".
Exemples de Payloads
Services SaaS & API
Exemple typique pour une entreprise de services numériques (ESN) ou un éditeur de logiciel avec abonnements et consulting.
{
"invoiceNumber": "F-2024-00125",
"issueDate": "2024-02-15",
"currency": "EUR",
"typeCode": "380",
"purchaseOrderReference": "BC-2024-1025",
"seller": {
"name": "CloudLabs Infrastructure SAS",
"registrationId": "98765432100012",
"vatId": "FR987654321",
"countryCode": "FR",
"address": {
"line1": "12 Avenue de l'Innovation",
"line2": "Immeuble Le Delta",
"city": "Paris",
"postCode": "75013",
"countryCode": "FR"
}
},
"buyer": {
"name": "Global Soft Corp",
"registrationId": "12345678900056",
"vatId": "FR123456789",
"countryCode": "FR",
"address": {
"line1": "500 Boulevard de la Croisette",
"city": "Cannes",
"postCode": "06400",
"countryCode": "FR"
}
},
"lines": [
{
"id": "1",
"name": "Abonnement Premium SaaS - Annuel",
"description": "Accès plateforme CloudLabs pour 25 utilisateurs (Période: Mars 2024 - Février 2025)",
"quantity": 1,
"unitCode": "C62",
"netPrice": 4500,
"taxRate": 20,
"taxCategoryCode": "S",
"totalAmount": 4500
},
{
"id": "2",
"name": "Crédits API Supplémentaires",
"description": "Pack de 10 000 appels API valables 1 an",
"quantity": 2,
"unitCode": "C62",
"netPrice": 250,
"taxRate": 20,
"taxCategoryCode": "S",
"totalAmount": 500
},
{
"id": "3",
"name": "Consulting Architecture Cloud",
"description": "Audit de performance infrastructure (3 jours)",
"quantity": 3,
"unitCode": "DAY",
"netPrice": 950,
"taxRate": 20,
"taxCategoryCode": "S",
"totalAmount": 2850
}
],
"totalTaxExclusiveAmount": 7850,
"taxTotalAmount": 1570,
"totalTaxInclusiveAmount": 9420,
"taxes": [
{
"taxRate": 20,
"basisAmount": 7850,
"taxAmount": 1570,
"taxCategoryCode": "S"
}
]
}Documentation API
Consultez nos spécifications OpenAPI pour une vue exhaustive de tous les paramètres et schémas.
Voir OpenAPI SpecValidation Schema
Tous nos payloads sont validés en amont. Assurez-vous que vos montants calculés (HT/TVA/TTC) sont cohérents.
Guide technique completPostman Collection
Téléchargez notre collection Postman pour tester les endpoints de l'API rapidement dans votre environnement.
Télécharger la CollectionDes questions sur nos politiques ?
Notre équipe juridique est là pour vous éclairer.