Navigazione Docs

OpenAPI Integration

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

Step 1: Crea Account

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

Step 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.

Step 3: Genera Credenziali API

In OpenAPI:

  1. Account → Settings (o Impostazioni)
  2. API Credentials (o Integration)
  3. Nota Username API e Password API

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

Configurare OpenAPI in Fatturino

Settings → Integrations

  1. Vai a Settings (⚙️ in alto a destra)
  2. Clicca Integrations
  3. Seleziona OpenAPI
  4. Inserisci:
    • Username API: il tuo username OpenAPI
    • Password API: la tua password API
    • Sandbox Mode (opzionale): accendi per testare
  5. Save

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: Settings → Integrations → OpenAPI

Toggle Sandbox Mode ON (attivo)

Quando sei pronto, spegni Sandbox Mode e invii andranno a 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