Fatturazione Elettronica - Italia

API Invoice permette di gestire i documenti fiscali in modo automatizzato, semplificando i flussi operativi e riducendo gli interventi manuali. Il risultato è una maggiore efficienza dei processi e un’ottimizzazione dei costi.

Con Openapi gestisci l’intero ciclo di vita dei documenti fiscali italiani tramite un’unica API: dalla configurazione dell’azienda all’invio delle fatture, fino al monitoraggio degli stati tramite webhook. La piattaforma si integra direttamente con SDI e Agenzia delle Entrate, garantendo velocità di integrazione, alti standard di sicurezza e prestazioni in tempo reale, anche su grandi volumi.

L’API Invoice non si limita all’invio delle fatture: permette di gestire fatture attive, fatture passive e scontrini elettronici, con firma digitale automatica, validazione preventiva dei dati e tracciamento completo dello stato dei documenti.

La soluzione è solida, scalabile e completamente personalizzabile per ogni partita IVA. Tramite la configurazione azienda puoi scegliere quali servizi attivare e come gestire ogni flusso:

Tutte le operazioni avvengono in modalità asincrona: dopo l’invio, ricevi aggiornamenti automatici sullo stato dei documenti (come DONE, RECEIVED o ERROR) direttamente nel tuo gestionale, senza bisogno di polling manuale.

Configurazione azienda e servizi

POST /IT-configurations

La configurazione azienda è il primo passo obbligatorio per utilizzare Invoice. Tramite questo endpoint puoi registrare l’azienda, attivare i servizi desiderati (fatture attive, fatture passive e scontrini elettronici) e configurare i webhook per ricevere notifiche in tempo reale sullo stato dei documenti.

Durante questa fase puoi inoltre abilitare la firma digitale automatica, oltre a fornire le credenziali fiscali necessarie per i servizi attivi. Una volta completata la configurazione, l’azienda è pronta per inviare fatture tramite Invoice, generare scontrini tramite IT-receipts e ricevere le fatture passive tramite webhook.

Per ricevere le fatture dei fornitori, è necessario registrare il nostro Codice Destinatario sul sito dell’Agenzia delle Entrate. Segui la guida passo passo disponibile nella documentazione e inserisci il seguente codice quando richiesto: PIC7CPS

ESEMPIO RICHIESTA

Per configurare l'azienda è necessario effettuare una richiesta a POST /IT-configurations. Nell'esempio che segue abbiamo impostato i servizi di scontrini digitali (receipts), invio fatture (customer invoice) e ricezione fatture (supplier invoice).

Inoltre per ogni evento specifico abbiamo impostato una callback.

{
  "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"
      }
    }
  ]
}

Invio fattura elettronica

POST /IT/invoices

Tramite questo endpoint puoi inviare una fattura elettronica al Sistema di Interscambio. L’endpoint POST /IT/invoices si occupa automaticamente della validazione, dell’eventuale firma digitale e dell’inoltro verso SDI.

L’elaborazione avviene in modalità asincrona. Dopo l’invio riceverai una risposta tecnica immediata, mentre gli aggiornamenti sullo stato della fattura (inviata, consegnata, scartata, completata) verranno notificati tramite webhook configurati in fase di onboarding.

Questo approccio permette di gestire anche grandi volumi di documenti senza bloccare i flussi applicativi.

{
  "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"
    }
  }
}

Una volta inviata la fattura, puoi monitorare lo stato tramite webhook o recuperare i dettagli usando gli endpoint di consultazione. GET IT-Invoice mantiene lo storico completo dei documenti, inclusi gli esiti SDI.

Monitoraggio stato fatture

Dopo l’invio, Invoice gestisce automaticamente l’intero processo di comunicazione con SDI.

Lo stato delle fatture viene aggiornato in modo asincrono e notificato automaticamente tramite webhook, permettendo di conoscere in tempo reale l’esito dei documenti senza dover interrogare manualmente le API.

Grazie ai webhook configurati in fase di onboarding, puoi ricevere direttamente nel tuo gestionale gli aggiornamenti di stato delle fatture attive e passive.

Consultazione dei documenti

GET /IT-invoices

Questo endpoint consente di recuperare l’elenco delle fatture gestite dal sistema, sia attive che passive.

Puoi utilizzare questo servizio per ottenere una panoramica completa dei documenti, filtrare le fatture per stato o data e consultare rapidamente le informazioni principali senza dover richiedere il dettaglio completo di ogni documento.

È ideale per creare dashboard, liste documenti o sincronizzare periodicamente lo stato generale delle fatture con il tuo gestionale.

È possibile consultare in qualsiasi momento l’elenco dei documenti inviati e ricevuti oppure recuperare il dettaglio di una singola fattura tramite API.

Ogni fattura mantiene uno storico completo, comprensivo degli esiti SDI, permettendo una gestione centralizzata di fatture attive e passive.

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

Grazie ai webhook configurati in fase di onboarding, puoi ricevere automaticamente gli aggiornamenti di stato nel tuo gestionale, senza necessità di interrogare continuamente le API.

Dettaglio fattura

GET /IT-invoices/{id}

Questo endpoint restituisce tutte le informazioni di una singola fattura identificata tramite ID.

Il dettaglio include lo stato corrente del documento, la direzione (attiva o passiva), i dati principali della fattura e gli esiti tecnici SDI disponibili nel campo details.sdi_status.

È il servizio da utilizzare quando hai bisogno di verificare lo stato preciso di una fattura o visualizzare informazioni complete su un documento specifico.

Import di fatture esterne

POST /IT-invoice_import

IT-Invoice permette di importare nel sistema anche fatture generate o trasmesse tramite altri canali, così da mantenere uno storico unificato di tutti i documenti fiscali.

Questa funzionalità è utile per centralizzare la gestione delle fatture provenienti da software esterni o da integrazioni precedenti, consentendo di visualizzare stati, dettagli e metadati tramite una chiamata API.

Una volta importata, la fattura viene trattata come qualsiasi altro documento: può essere consultata tramite API e inclusa nei flussi di monitoraggio.

{
  "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"
  }
}

In questo modo puoi gestire fatture inviate tramite Invoice e fatture provenienti da sistemi esterni all’interno di un unico flusso operativo.

Webhook e notifiche in tempo reale

Invoice utilizza un sistema di webhook per notificare automaticamente ogni aggiornamento sullo stato dei documenti fiscali.

Durante la configurazione azienda puoi definire uno o più endpoint di callback per ricevere eventi relativi a fatture attive, fatture passive e scontrini elettronici. In questo modo il tuo gestionale viene aggiornato in tempo reale.

I webhook permettono di intercettare eventi come:

Questo approccio asincrono rende l’integrazione più efficiente e scalabile, soprattutto in presenza di volumi elevati.

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

A chi si rivolge Invoice

Invoice è pensata per tutte le realtà che vogliono integrare e automatizzare la gestione dei documenti fiscali direttamente nei propri sistemi, dalle software house e dagli sviluppatori che desiderano inserire la fatturazione elettronica nei propri gestionali tramite API, alle piattaforme e-commerce che hanno bisogno di emettere automaticamente fatture o scontrini elettronici per ogni transazione senza passaggi manuali, fino alle aziende che vogliono automatizzare i flussi contabili, centralizzare la gestione dei documenti fiscali e ridurre gli errori operativi. Grazie alla struttura modulare e all’integrazione diretta con SDI e Agenzia delle Entrate, Invoice si adatta sia a piccoli volumi sia a progetti enterprise con elevati carichi di traffico.