Facturation électronique - Italie

API Invoice permet de gérer les documents fiscaux de manière automatisée, en simplifiant les flux opérationnels et en réduisant les interventions manuelles. Le résultat est une efficacité accrue des processus et une optimisation des coûts.

Avec Openapi, vous pouvez gérer l’ensemble du cycle de vie des documents fiscaux italiens via une seule API : de la configuration de l’entreprise à l’envoi des factures, jusqu’au suivi des statuts via webhook. La plateforme s’intègre directement avec le SDI et l’Agence des Impôts italienne, garantissant une intégration rapide, des standards de sécurité élevés et des performances en temps réel, même avec de grands volumes.

L’API Invoice ne se limite pas à l’envoi des factures : elle permet de gérer les factures émises, les factures reçues et les reçus électroniques, avec signature numérique automatique, validation préalable des données et suivi complet de l’état des documents.

La solution est robuste, évolutive et entièrement personnalisable pour chaque numéro de TVA. Grâce à la configuration de l’entreprise, vous pouvez choisir quels services activer et comment gérer chaque flux :

Toutes les opérations sont effectuées en mode asynchrone : après l’envoi, vous recevez automatiquement des mises à jour sur l’état des documents (comme DONE, RECEIVED ou ERROR) directement dans votre logiciel de gestion, sans avoir besoin de polling manuel.

Configuration de l’entreprise et services

POST /IT-configurations

La configuration de l’entreprise est la première étape obligatoire pour utiliser Invoice. Grâce à cet endpoint, vous pouvez enregistrer l’entreprise, activer les services souhaités (factures émises, factures reçues et reçus électroniques) et configurer des webhooks afin de recevoir des notifications en temps réel sur l’état des documents.

Au cours de cette phase, vous pouvez également activer la signature numérique automatique et fournir les identifiants fiscaux nécessaires pour les services actifs. Une fois la configuration terminée, l’entreprise est prête à envoyer des factures via Invoice, générer des reçus via IT-receipts et recevoir les factures fournisseurs via webhook.

Pour recevoir les factures des fournisseurs, il est nécessaire de registrer notre Code Destinataire sur le site de l’Agence des Impôts italienne. Suivez le guide étape par étape disponible dans la documentation et saisissez le code suivant lorsque cela est demandé : PIC7CPS

EXEMPLE DE REQUÊTE

Pour configurer l’entreprise, vous devez envoyer une requête à POST /IT-configurations. Dans l’exemple suivant, nous avons activé les reçus numériques (receipts), l’envoi de factures (customer invoice) et la réception de factures (supplier invoice).

De plus, une callback a été configurée pour chaque événement spécifique.

{
  "fiscal_id": "YourCompanyFiscal_id",
  "name": "nameCompany",
  "email": "[email protected]",
  "receipts": true,
  "customer_invoice": true,
  "supplier_invoice": true,
  "receipts_authentication": {
    "taxCode": "FHHWMF96L52D111B",
    "password": "1234567891****d",
    "pin": "1********4"
  },
  "api_configurations": [
    {
      "event": "receipt",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "customer_invoice",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "supplier_invoice",
      "callback": {
        "url": "https://your-server.site/123232"
      }
    },
    {
      "event": "receipt-error",
      "callback": {
        "url": "https://your-server.site/error"
      }
    }
  ]
}

Envoi de facture électronique

POST /IT/invoices

Grâce à cet endpoint, vous pouvez envoyer une facture électronique au Système d’Échange. L’endpoint POST /IT/invoices gère automatiquement la validation, l’éventuelle signature numérique et la transmission vers le SDI.

Le traitement s’effectue de manière asynchrone. Après l’envoi, vous recevrez une réponse technique immédiate, tandis que les mises à jour de statut (envoyée, livrée, rejetée, complétée) seront notifiées via les webhooks configurés lors de l’onboarding.

Cette approche permet de gérer de grands volumes de documents sans bloquer les flux applicatifs.

{
  "data": {
    "id": "string",
    "state": "NEW",
    "direction": "incoming",
    "fiscal_id": "string",
    "type": "string",
    "document_number": "string",
    "issue_date": "2026-02-09",
    "total_gross_amount": 0,
    "sender": {
      "name": "string",
      "vat_id": "string",
      "tax_code": "string",
      "street": "string",
      "city": "string",
      "zip": "string",
      "province": "string",
      "country_code": "string",
      "phone": "string",
      "email": "string"
    },
    "recipient": {
      "name": "string",
      "vat_id": "string",
      "tax_code": "string",
      "street": "string",
      "city": "string",
      "zip": "string",
      "province": "string",
      "country_code": "string",
      "phone": "string",
      "email": "string"
    },
    "details": {
      "sdi_id": "string",
      "sdi_filename": "string",
      "sdi_status": "Delivered",
      "sdi_message": "string",
      "sdi_update_date": "string",
      "invoice_date": "string"
    }
  }
}

Une fois la facture envoyée, vous pouvez suivre son statut via webhook ou récupérer les détails en utilisant les endpoints de consultation. GET IT-Invoice conserve l’historique complet des documents, y compris les résultats SDI.

Suivi du statut des factures

Après l’envoi, Invoice gère automatiquement l’ensemble du processus de communication avec le SDI.

Le statut des factures est mis à jour de manière asynchrone et notifié automatiquement via webhook, permettant de connaître en temps réel le résultat des documents sans interroger manuellement les API.

Grâce aux webhooks configurés lors de l’onboarding, vous pouvez recevoir directement dans votre logiciel de gestion les mises à jour de statut des factures émises et reçues.

Consultation des documents

GET /IT-invoices

Cet endpoint permet de récupérer la liste des factures gérées par le système, qu’elles soient émises ou reçues.

Vous pouvez utiliser ce service pour obtenir une vue d’ensemble des documents, filtrer les factures par statut ou par date et consulter rapidement les informations principales sans devoir demander le détail complet de chaque document.

Il est idéal pour créer des dashboards, des listes de documents ou synchroniser périodiquement l’état général des factures avec votre logiciel de gestion.

Il est possible de consulter à tout moment la liste des documents envoyés et reçus ou de récupérer le détail d’une seule facture via API.

Chaque facture conserve un historique complet, incluant les résultats SDI, permettant une gestion centralisée des factures émises et reçues.

{
  "id": "679ca42e016df7",
  "state": "DONE",
  "direction": "outgoing",
  "document_number": "123",
  "issue_date": "2026-01-15",
  "total_gross_amount": 250.00,
  "details": {
    "sdi_status": "Delivered"
  }
}

Grâce aux webhooks configurés lors de l’onboarding, vous pouvez recevoir automatiquement les mises à jour de statut dans votre logiciel de gestion sans interroger continuellement les API.

Détail de la facture

GET /IT-invoices/{id}

Cet endpoint renvoie toutes les informations d’une facture spécifique identifiée par son ID.

Le détail inclut le statut actuel du document, la direction (émise ou reçue), les principales données de la facture et les résultats techniques SDI disponibles dans le champ details.sdi_status.

C’est le service à utiliser lorsque vous devez vérifier le statut précis d’une facture ou afficher les informations complètes d’un document spécifique.

Importation de factures externes

POST /IT-invoice_import

IT-Invoice permet également d’importer dans le système des factures générées ou transmises via d’autres canaux, afin de maintenir un historique unifié de tous les documents fiscaux.

Cette fonctionnalité est utile pour centraliser la gestion des factures provenant de logiciels externes ou d’intégrations précédentes, permettant de visualiser statuts, détails et métadonnées via un appel API.

Une fois importée, la facture est traitée comme n’importe quel autre document : elle peut être consultée via API et incluse dans les flux de suivi.

{
  "invoice": "PD94bWwgdmVyc2lvbj0iMS4wIi...",
  "details": {
    "sdi_id": "1234567",
    "sdi_filename": "IT01234567890_00001.xml",
    "sdi_status": "Delivered",
    "sdi_message": "string",
    "sdi_update_date": "2026-02-04T14:15:20.413Z",
    "invoice_date": "2026-02-04"
  }
}

De cette manière, vous pouvez gérer les factures envoyées via Invoice et celles provenant de systèmes externes au sein d’un seul flux opérationnel.

Webhooks et notifications en temps réel

Invoice utilise un système de webhooks pour notifier automatiquement chaque mise à jour du statut des documents fiscaux.

Lors de la configuration de l’entreprise, vous pouvez définir un ou plusieurs endpoints de callback pour recevoir des événements liés aux factures émises, factures reçues et reçus électroniques. Ainsi, votre logiciel de gestion est mis à jour en temps réel.

Les webhooks permettent d’intercepter des événements tels que :

Cette approche asynchrone rend l’intégration plus efficace et évolutive, surtout avec des volumes élevés.

{
  "event": "customer_invoice",
  "data": {
    "id": "679ca42e016df7",
    "state": "DONE",
    "sdi_status": "Delivered"
  }
}

À qui s’adresse Invoice

Invoice est conçue pour toutes les organisations qui souhaitent intégrer et automatiser la gestion des documents fiscaux directement dans leurs systèmes, des éditeurs de logiciels et développeurs qui veulent intégrer la facturation électronique via API, aux plateformes e-commerce qui doivent émettre automatiquement des factures ou des reçus électroniques pour chaque transaction sans intervention manuelle, jusqu’aux entreprises qui souhaitent automatiser les flux comptables, centraliser la gestion des documents fiscaux et réduire les erreurs opérationnelles. Grâce à sa structure modulaire et à son intégration directe avec le SDI et l’Agence des Impôts italienne, Invoice s’adapte aussi bien aux petits volumes qu’aux projets enterprise à fort trafic.