Ambiente:
Skip to main content
Questa documentazione è in versione BETA, per qualsiasi informazione contattaci alla mail api@sibill.it

Casi d’uso supportati

Questa pagina raccoglie i principali scenari in cui puoi integrare le API di Sibill all’interno del tuo gestionale, ERP, e-commerce o prodotto SaaS.

✅ Cosa puoi fare con le API di Sibill​

Di seguito trovi i casi d’uso principali organizzati per area funzionale.

🧾 GESTIONE DELLA FATTURAZIONE

1. Invia automaticamente fatture elettroniche​

📌 Caso d’uso​

Generi molte fatture ogni mese e vuoi evitare operazioni manuali dalla WebApp?

Puoi creare e inviare fatture elettroniche direttamente dal tuo sistema, utilizzando JSON o XML compatibile con la fatturazione elettronica.

💡 Automazioni possibili​

  • Generazione automatica delle fatture a partire dal tuo database
  • Invio diretto allo SDI (Sistema di Interscambio)
  • Creazione di bozze per revisione interna prima dell’invio
  • Integrazione con flussi e-commerce o abbonamenti ricorrenti

2. Traccia lo stato delle fatture inviate allo SDI​

📌 Caso d’uso​

Vuoi sapere se una fattura è:

  • Consegnata
  • Rifiutata
  • In attesa
  • Scartata

💡 Tramite API puoi​

  • Ricevere notifiche via webhook a ogni cambio di stato
  • Mostrare lo stato in tempo reale nella tua UI
  • Sincronizzare ERP o CRM con lo stato ufficiale dello SDI
  • Attivare workflow automatici (es. riemissione in caso di errore)

3. Recupera e visualizza fatture e documenti correlati​

📌 Caso d’uso​

Stai costruendo un gestionale o un portale clienti con elenco documenti, filtri e ricerca avanzata?

💡 Tramite API puoi​

  • Elencare tutti i documenti (emessi e ricevuti)
  • Filtrare per:
    • creation_date
    • delivery_date
    • status
  • Recuperare dettagli completi:
    • created_at
    • creation_date
    • delivery_date
    • delivery_status
    • direction
    • flows
    • format
    • gross_amount
    • vat_amount
    • number
    • status
    • updated_at

Oltre alle fatture, puoi accedere anche a:

  • Note di credito
  • Note di debito
  • Autofatture
  • DDT
  • Preventivi

Ogni documento disponibile nella WebApp è accessibile via API.

4. Collega fatture e pagamenti per riconciliazione automatica​

📌 Caso d’uso​

Ricevi pagamenti automatici (es. bonifici, Stripe, PayPal) e vuoi evitare controlli manuali.

💡 Tramite API puoi​

  • Inserire un reconciliation_identifier in fase di emissione
  • Associare automaticamente il pagamento quando arriva
  • Segnare la fattura come pagata nel tuo sistema
  • Costruire dashboard di riconciliazione in tempo reale

🏦 CONTI & TRANSAZIONI

5. Visualizza conti bancari e saldi aziendali​

📌 Caso d’uso​

Vuoi sapere su quale conto è arrivato un pagamento o mostrare il saldo aggiornato agli utenti?

💡 Tramite API puoi​

  • Recuperare tutti i conti bancari collegati a un’azienda
  • Visualizzare dettagli e saldi aggiornati
  • Alimentare dashboard finanziarie
  • Costruire report automatici per CFO o amministrazione

6. Recupera le transazioni di un conto specifico​

📌 Caso d’uso​

Hai bisogno di verificare se una fattura è stata pagata e aggiornare il tuo sistema?

💡 Tramite API puoi​

  • Ottenere tutte le transazioni bancarie di un conto
  • Accedere a dettagli come:
    • date
    • amount
    • description
  • Collegare automaticamente le transazioni alle fatture
  • Implementare logiche di matching personalizzate

🗓️ SCADENZE

7. Recupera le date di scadenza delle fatture non pagate​

📌 Caso d’uso​

Vuoi sapere quali fatture sono aperte e quando scadono per:

  • Inviare reminder automatici
  • Aggiornare il CRM
  • Generare task interni

💡 Tramite API puoi​

  • Recuperare le scadenze delle fatture aperte
  • Accedere a dati come:
    • amount
    • created_at
    • expected_payment_date
    • payment_status
    • payment_method
    • payment_date

Questo permette di costruire sistemi di sollecito completamente automatizzati.

🔄 RICONCILIAZIONI

8. Esporta riconciliazioni di documenti e transazioni​

📌 Caso d’uso​

Effettui la riconciliazione sia su Sibill che nel tuo software contabile e vuoi evitare duplicazioni.

💡 Tramite API puoi​

  • Recuperare l’elenco delle riconciliazioni per azienda
  • Associare documenti e flussi alle relative transazioni
  • Esportare dati per il tuo software contabile
  • Ridurre errori e lavoro manuale

🚀 Integrazione tipica

Un’integrazione completa può includere:

  1. Creazione automatica fatture
  2. Invio allo SDI
  3. Ricezione webhook per aggiornamento stato
  4. Recupero transazioni bancarie
  5. Riconciliazione automatica
  6. Aggiornamento dashboard e CRM

In pratica: automatizzi l’intero ciclo attivo, dall’emissione alla riconciliazione.

Se stai progettando un’integrazione complessa (ERP, SaaS multi-tenant, piattaforme marketplace), il consiglio è strutturare fin da subito:

  • gestione webhook idempotente
  • retry automatici
  • log di audit
  • sincronizzazione incrementale tramite date di aggiornamento