Electronic invoicing easy, fast and with high security standards
Automates sending, signing, receiving and digital storage of electronic invoices via API
The Electronic Invoicing API allows you to send XML electronic invoices to the interchange system (SdI) in real time via the POST /invoices endpoint.
In particular, the format must be made explicit at the request stage using the content-type header. The invoice will be queued immediately and the UUID of the invoice will be obtained as a callback.
It is possible to activate invoicing for sending to Sdi, with electronic signature and/or with Regulatory Storage.
You can set up invoicing options via the POST /business_registry_configurations endpoint.
In particular, with this first request you can indicate whether to use the API exclusively for sending and receiving invoices or whether to also activate the signature option (apply_signature) and/or regulation-compliant storage (apply_legal_storage).
Once the configuration is complete, it will only be possible to use the endpoint of the set option.
The service allows, in addition to sending, the electronic signature to be affixed to the XML e-invoice via the POST /invoices_signature endpoint.
This will ensure the integrity of the contained data. A signed invoice has greater legal 'robustness' than an unsigned document.
The signature is mandatory for electronic invoices to the PA.
You can send and activate regulation-compliant storage for 10 years on active and passive electronic invoices via the POST /invoices_legal_storage endpoint via API.
Regulation-compliant storage is mandatory and guarantees authenticity, integrity, reliability, readability and retrievability of invoices. The regulation-compliant storage available via Openapi is compliant with the eIDAS regulation.
No, the email entered during the configuration cannot be changed. It is crucial to enter the correct email during this step.
Yes, you can import via API the history of active invoices (via the POST endpoint /customer_invoice_imports) and passive invoices (POST endpoint /supplier_invoice_imports).
In addition, it is possible to send both active (via the POST /customer_invoice_imports_legal_storage endpoint) and passive (POST /supplier_invoice_imports_legal_storage endpoint) invoices to Storage.
Yes, through the POST /invoices_signature_legal_storage endpoint you can perform the entire signing process, sending to SDI and regulation-compliant storage with a single request.
The word "euro" must be entered in the invoice description, otherwise the system may require manual confirmation.
There are two possible reasons why you are not receiving invoices:
- you haven't completed the configuration
- you have no available credit
To receive invoices, you must configure the system using the POST/api_configurations endpoint. Specifically, you need to set the value "supplier-invoice", as indicated in the documentation. Once configured, invoices will be sent to the specified callback.
You can then retrieve invoices using GET /invoices.
IMPORTANT: If your credit runs out, incoming invoices will no longer be delivered.
If the customer is a private individual, the SdI code is always '0000000' (seven times zero).
The Recipient Code to be set is JKKZDGR.
No, if you do not need to receive incoming invoices, registering the recipient code is not required.
No, a specific technical implementation is not required. However, for security reasons, you need to open a ticket to request the addition of your domain to our whitelist.
If your account has been suspended due to a lack of credit, you can reactivate it by sending a request to:
PATCH/business_registry_configurations/{fiscal_id}/activate.
NOTE: As soon as your account is suspended, you will receive an email reminder with reactivation instructions. Make sure to check your inbox regularly.
You can check the signed status of a document via the GET /firma_elettronica/{id} endpoint.
The service returns the response in real time.
The cost of sending an invoice to SdI is €0.025 on subscription, €0.07 per individual request.
The cost of Electronic Invoice Storage is €0.035 and Electronic Invoice Signature is €0.02.
Yes, it is possible to activate an annual subscription, and thus save on the cost of a single call.
In the Subscription section of the individual API you can see the available options (with their prices and savings percentage) and you can also activate the subscription of your choice.
In the Usage section, at the API level, you can monitor your free and subscription or top-up requests.
They are available both in graphical mode (period month and year) and with a textual summary.