Environment:
Skip to main content
This documentation is in BETA version, for any information contact us at api@sibill.it

Supported Use Cases

This page collects the main scenarios in which you can integrate the Sibill APIs into your management system, ERP, e-commerce or SaaS product.

✅ What you can do with the Sibill APIs​

Below you will find the main use cases organised by functional area.

🧾 INVOICE MANAGEMENT

1. Automatically send electronic invoices​

📌 Use case​

Do you generate many invoices every month and want to avoid manual operations from the WebApp?

You can create and send electronic invoices directly from your system, using JSON or XML compatible with electronic invoicing.

💡 Possible automations​

  • Automatic invoice generation from your database
  • Direct submission to the SDI (Sistema di Interscambio)
  • Creation of drafts for internal review before submission
  • Integration with e-commerce flows or recurring subscriptions

2. Track the status of invoices sent to the SDI​

📌 Use case​

Do you want to know if an invoice is:

  • Delivered
  • Rejected
  • Pending
  • Discarded

💡 Via API you can​

  • Receive webhook notifications on every status change
  • Display the status in real time in your UI
  • Sync ERP or CRM with the official SDI status
  • Trigger automated workflows (e.g. reissue in case of error)

📌 Use case​

Are you building a management system or a customer portal with a document list, filters and advanced search?

💡 Via API you can​

  • List all documents (issued and received)
  • Filter by:
    • creation_date
    • delivery_date
    • status
  • Retrieve full details:
    • created_at
    • creation_date
    • delivery_date
    • delivery_status
    • direction
    • flows
    • format
    • gross_amount
    • vat_amount
    • number
    • status
    • updated_at

In addition to invoices, you can also access:

  • Credit notes
  • Debit notes
  • Self-invoices
  • Delivery notes (DDT)
  • Quotes

Every document available in the WebApp is accessible via API.

📌 Use case​

Do you receive automatic payments (e.g. bank transfers, Stripe, PayPal) and want to avoid manual checks?

💡 Via API you can​

  • Insert a reconciliation_identifier at the time of issuance
  • Automatically associate the payment when it arrives
  • Mark the invoice as paid in your system
  • Build real-time reconciliation dashboards

🏦 ACCOUNTS & TRANSACTIONS

5. View company bank accounts and balances​

📌 Use case​

Do you want to know which account received a payment or show users an up-to-date balance?

💡 Via API you can​

  • Retrieve all bank accounts linked to a company
  • View details and updated balances
  • Feed financial dashboards
  • Build automated reports for CFOs or accounting teams

6. Retrieve transactions from a specific account​

📌 Use case​

Do you need to verify whether an invoice has been paid and update your system?

💡 Via API you can​

  • Get all bank transactions for an account
  • Access details such as:
    • date
    • amount
    • description
  • Automatically link transactions to invoices
  • Implement custom matching logic

🗓️ FLOWS

7. Retrieve due dates for unpaid invoices​

📌 Use case​

Do you want to know which invoices are open and when they are due in order to:

  • Send automated reminders
  • Update the CRM
  • Generate internal tasks

💡 Via API you can​

  • Retrieve the due dates of open invoices
  • Access data such as:
    • amount
    • created_at
    • expected_payment_date
    • payment_status
    • payment_method
    • payment_date

This allows you to build fully automated follow-up systems.

🔄 RECONCILIATIONS

8. Export reconciliations of documents and transactions​

📌 Use case​

Do you perform reconciliation both in Sibill and in your accounting software and want to avoid duplications?

💡 Via API you can​

  • Retrieve the list of reconciliations per company
  • Associate documents and flows with their related transactions
  • Export data to your accounting software
  • Reduce errors and manual work

🚀 Typical integration

A complete integration can include:

  1. Automatic invoice creation
  2. Submission to the SDI
  3. Receiving webhooks for status updates
  4. Retrieving bank transactions
  5. Automatic reconciliation
  6. Dashboard and CRM updates

In practice: you automate the entire active cycle, from issuance to reconciliation.

If you are designing a complex integration (ERP, multi-tenant SaaS, marketplace platforms), the recommendation is to structure from the start:

  • Idempotent webhook handling
  • Automatic retries
  • Audit logs
  • Incremental synchronisation via update dates