Plateforme InvoiceIQ - Validation et génération de factures électroniques Factur-X conformes

Spécifications JSON Payloads

Formats et exemples complets pour l'intégration de l'API Factur-X

Dernière mise à jour : 23 Février 2026

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 Spec

Validation Schema

Tous nos payloads sont validés en amont. Assurez-vous que vos montants calculés (HT/TVA/TTC) sont cohérents.

Guide technique complet

Postman Collection

Téléchargez notre collection Postman pour tester les endpoints de l'API rapidement dans votre environnement.

Télécharger la Collection

Des questions sur nos politiques ?

Notre équipe juridique est là pour vous éclairer.

Nous contacter