Navigazione Docs

Integrazione OpenAPI

Come configurare e usare OpenAPI per inviare fatture al SDI.

Cos'è OpenAPI?

OpenAPI è un service provider che accetta fatture XML da clienti, le trasmette al SDI, traccia stati di consegna, fornisce API semplice per integrazioni.

Non è la stessa cosa di Agenzia delle Entrate. È una piattaforma privata, affidabile, molto usata in Italia.

Registrarsi su OpenAPI

Passo 1: Crea Account

  1. Vai su openapi.it
  2. Registrati
  3. Inserisci email e crea password
  4. Verifica email
  5. Compila profilo aziendale (P.IVA, ragione sociale)

Passo 2: Acquista Credito

OpenAPI funziona a credito prepagato. Costi tipici:

  • Invio fattura: €0.05 – 0.10 per invio
  • Pacchetto 100 invii: ~€5
  • Pacchetto 1000 invii: ~€50

Scegli il pacchetto, paga (carta, bonifico), credito disponibile subito.

Passo 3: Genera Credenziali API

In OpenAPI:

  1. Account → Impostazioni
  2. Credenziali API (o Integrazione)
  3. Nota Username API e Password API

Usa questi in Fatturino (non la password di login!).

Configurare OpenAPI in Fatturino

Configurazione → Impostazioni FE

  1. Vai su Configurazione → Impostazioni FE (dalla barra laterale)
  2. Inserisci:
    • Username API: il tuo username OpenAPI
    • Password API: la tua password API
    • Modalità Sandbox (opzionale): accendi per testare
  3. Salva

Fatturino testerà la connessione subito.

Modalità Sandbox

OpenAPI offre un ambiente di test dove:

  • Invi fatture senza consumare credito
  • Le fatture non arrivano veramente al SDI
  • Puoi verificare che i dati sono corretti

Attivare Sandbox

In Fatturino: Configurazione → Impostazioni FE

Attiva Modalità Sandbox

Quando sei pronto, disattiva la Modalità Sandbox e gli invii andranno al SDI reale.

Costi e Gestione Budget

Tracciare Spese

In openapi.it:

  1. Vedi cronologia invii e credito consumato
  2. Esporta se serve per contabilità

Stimare Budget Mensile

Se fai 50 fatture al mese, @0.10€/fattura:

50 invii × €0.10 = €5 al mese

Pianifica budget di conseguenza.

Troubleshooting

"Errore: Credenziali non valide"

  • Verifica Username API e Password API su OpenAPI
  • Non usare password di login, usa Password API
  • Copia/incolla (evita spazi accidentali)

"Credito insufficiente"

Vai su openapi.it, vedi credito rimanente, acquista se necessario.

"Timeout connessione"

  • Controlla che OpenAPI sia online
  • Riprova dopo qualche minuto
  • Contatta OpenAPI se persiste

Prossimi Passi