API Scontrino Elettronico: guida completa, esempi, prezzi e integrazione

Effatta ti permette di emettere, annullare e gestire scontrini elettronici senza registratore telematico, via web, app o API — in modo conforme e cloud-native.

Prova subito le API o richiedi le credenziali di sandbox.

Vedi prezzi • Vai agli esempi di codice • FAQ

Indice

Cosa sono le API per lo scontrino elettronico

Le API per lo scontrino elettronico sono servizi che permettono di emettere, annullare e gestire documenti commerciali (scontrini) in modo digitale e automatizzato, inviandoli direttamente al portale Fatture e Corrispettivi dell’Agenzia delle Entrate. Eliminano la necessità di registratori di cassa telematici e si integrano con gestionali, e-commerce e app tramite semplici chiamate HTTP.

Come funzionano (flusso tecnico)

  • Integrazione con i tuoi sistemi (gestionali, e-commerce, app, POS software).
  • Autenticazione e ottenimento del token (login sicuro).
  • Invio in tempo reale del documento commerciale all’Agenzia delle Entrate.
  • Gestione avanzata: annullamenti, PDF, elenco scontrini, statistiche.
  • Monitoraggio tramite dashboard e webhook per le notifiche asincrone.

Vantaggi principali

  • Risparmio: niente RT, niente manutenzioni hardware.
  • Flessibilità: si integra con qualsiasi linguaggio / piattaforma.
  • Scalabilità cloud: multi-azienda, multi-esercente, multi-punto cassa.
  • Tempo di mercato: vai live rapidamente con le nostre API pronte.
  • Conformità: processo conforme e allineato ai chiarimenti AdE.

Conformità normativa (Interpello 413/2020)

L’Agenzia delle Entrate ha chiarito la possibilità di automatizzare la procedura web per l’emissione dei documenti commerciali online tramite altri software nella Risposta all’Interpello n. 413 del 25/09/2020.

Puoi leggere il documento ufficiale qui: Risposta 413/2020.

Funzionalità principali delle API Effatta

  • Invio documenti commerciali (scontrini) in tempo reale
  • Annullamento e gestione resi
  • Download PDF del documento commerciale
  • Elenco e ricerca scontrini emessi (per date, stato, importi)
  • Dashboard di monitoraggio & statistiche
  • Webhook per integrazioni asincrone con i tuoi sistemi
  • Supporto multi-azienda, multi-esercente
  • Gestione codice lotteria e diverse modalità di pagamento

Documentazione completa OpenAPI / Swagger: consulta la documentazione.

Esempi di codice API (login, invio, annullo, lista)

1) Autenticazione (login)

POST https://scontrino.effatta.it/api/v1/ade/login
Content-Type: application/json

{
  "fiscalId": "YOUR_FISCAL_ID",
  "username": "USERNAME_ADE",
  "password": "PASSWORD_ADE",
  "pin":      "PIN_ADE"
}

Risposta:

{
  "token": "eyJ0eXA..."
}

2) Invio scontrino

POST https://scontrino.effatta.it/api/v1/ade/smartsale
Authorization: Bearer <TOKEN>
Content-Type: application/json

{
  "items": [
    {
      "quantity": 2,
      "description": "Crema viso",
      "unit_price": 15.00,
      "vat_rate_code": "22",
      "discount": 0,
      "complimentary": false
    }
  ],
  "invoice_issuing": false,
  "electronic_payment_amount": 30.00,
  "ticket_restaurant_payment_amount": 0
}

Risposta:

{
  "protocolNumber": "2025-0001234",
  "status": "accepted"
}

3) Annullamento

POST https://scontrino.effatta.it/api/v1/ade/cancelsmartsale
Authorization: Bearer <TOKEN>
Content-Type: application/json

{
  "protocolNumber": "2025-0001234",
  "reason": "Errore inserimento articoli"
}

Risposta:

{
  "protocolNumber": "2025-0001235",
  "status": "cancelled"
}

4) Lista scontrini

POST https://scontrino.effatta.it/api/v1/ade/listsmartsales
Authorization: Bearer <TOKEN>
Content-Type: application/json

{
  "startDate": "2025-07-01",
  "endDate":   "2025-07-27"
}

Risposta:

{
  "documents": [
    {
      "protocolNumber": "2025-0001234",
      "status": "accepted",
      "totalAmount": 30.00,
      "date": "2025-07-25"
    }
  ]
}

Confronto: Effatta API vs Registratore Telematico

Caratteristica Effatta API Registratore Telematico
Investimento iniziale Basso / Zero hardware Alto (acquisto RT)
Manutenzione Cloud, inclusa nel servizio Hardware, canoni e verifiche periodiche
Scalabilità Alta (multi-azienda / multi-cassa) Limitata dall’hardware
Integrazione con software API REST, webhook, documentazione Limitata / connettori specifici
Time-to-market Immediato Lento (acquisto, configurazione, installazione)

Prezzi trasparenti

Modello consigliato (esempio — aggiorna con i tuoi valori reali):

  • Canone mensile piattaforma: € 8 / mese
  • Costo per invio scontrino via API: da € 0,009 / documento (scalare a volumi dopo i 6000 compresi nell’abbonamento)
  • Piani enterprise con SLA dedicati, supporto prioritario e ambienti di test avanzati

Richiedi un preventivo personalizzato o chiedi l’accesso alla sandbox.

Domande frequenti (FAQ)

Come funzionano le API per lo scontrino elettronico?

Le API Effatta si integrano con gestionali, e-commerce o app e inviano i documenti commerciali direttamente al portale dell’Agenzia delle Entrate in tempo reale, in modo conforme.

Posso annullare uno scontrino elettronico via API?

Sì. È disponibile l’endpoint di annullamento con tracciatura del protocollo e motivazione.

Serve un registratore telematico?

No. Automatizziamo la procedura web prevista dall’Agenzia delle Entrate, come chiarito nella Risposta all’Interpello 413/2020.

Avete una dashboard e webhook?

Sì. Puoi monitorare flussi, volumi, errori e ricevere notifiche asincrone via webhook.

Quanto costa ogni invio?

Modello a consumo a partire da € 0,009 a scontrino (aggiorna con il tuo prezzo reale) + canone piattaforma. Piani a volume disponibili.

Contattaci

Vuoi provare subito le API o hai bisogno di una demo tecnica?

FATTURA ELETTRONICA GRATIS