Italian Invoicing API

OpenAPI Definition:
Download

Getting started

A-CUBE API helps you handling the interaction with SDI (Sistema Di Interscambio) through simple REST APIs.

When you get onboard the A-CUBE API Platform you will receive:

  • username and password for the authentication
  • a recipient code that must be used in all the invoices that you will receive from third party companies

This is the process to create and send a new invoice explained in few steps:

  1. Login into the platform to obtain a JWT token
  2. Create an invoice payload in JSON format
  3. The invoice payload is sent to POST /invoices
  4. The invoice payload is validated, translated into FatturaPA XML format and sent to the SDI
  5. Every notification from SDI will be dispatched in real time to the configured endpoints. All the notification will always be available using the notifications API

Environments

  • sandbox is the environment where you can test the entire platform without paying at any time, the communication with SDI is simulated. The base URL is https://api-sandbox.acubeapi.com
  • production is the environment where the communication with SDI is real, you can't send an invoice to test. If you want to make a real test then you will need to send a credit note to cancel the sent invoice. The base URL is https://api.acubeapi.com

We support the following TLS protocols: TLSv1_2016 TLSv1.1_2016 TLSv1.2_2018

Authentication

You can find all the information about the authentication here.