Send electronic receipts and invoices to the Revenue Agency quickly, easily, and securely
Automate the real-time transmission of commercial documents and electronic invoices via API, ensuring regulatory compliance, operational reliability, and high-level security.
The required information is:
- Tax Code
- Company Name
- Tax Code
- Password
- PIN
Additionally, the “receipts” field must be set to true.
The data must belong to the subject responsible for sending the receipts. Therefore, if you are developing on behalf of third parties, the credentials must belong to the final client.
Access credentials must be updated quarterly, as the Italian Revenue Agency periodically expires them.
At this stage, it is also possible to configure the types of events for which you wish to receive notifications.
To correctly configure a company for managing B2B and Public Administration electronic invoicing, the following data is required:
- Company tax identifier (Tax Code or VAT Number)
- Company legal name
Email address for communications and notifications
(The email address provided cannot be changed after the configuration is created.)
During configuration, it is also necessary to specify how you intend to use the service:
- Active invoices only (customer_invoice)
- Passive invoices only (supplier_invoice)
- Full invoice cycle management (active and passive)
- To enable the desired features, the corresponding fields must be set to true in the request.
You can also configure which types of events you want to receive notifications for.
Important note for receiving passive invoices
To correctly receive invoices from suppliers, setting the supplier_invoice field to true is not sufficient. You must register our Recipient Code (PIC7CPS) on the Italian Revenue Agency website in order to correctly associate the receiving channel.
Yes. With Openapi, it is possible to manage, for the same company, both the entire B2B and Public Administration electronic invoicing cycle and the transmission of commercial documents (electronic receipts) to the Italian Revenue Agency using a single API.
During configuration, simply set the following fields to true:
- customer_invoice (active invoices)
- supplier_invoice (passive invoices)
- receipts (commercial documents)
This allows you to enable all required features through a single integration.
Yes, you can activate multiple companies by completing the configuration procedure through the dedicated endpoint (Business Registry Configuration).
No, but beyond 10 configurations there is an additional cost of €1 per configuration.
Yes. Electronic invoices destined for the Public Administration are automatically signed by the system before being sent.
During transmission, you may provide your own certificate credentials using the EU-QES_automatic service if you wish to apply a custom digital signature.
If no custom certificate is provided, the service’s default digital signature will be applied.
Yes, you can import invoice history using the POST /IT-invoices_import endpoint.
Yes. Through the PATCH /IT-configuration endpoint, you can update various settings at any time, including:
- Activation or deactivation of the electronic receipt service (receipts)
- Authentication credentials
- Notification event types
Important note: the email address provided during configuration cannot be changed. It is therefore essential to enter the correct address from the beginning, as it will be used for all communications and notifications.
There may be two main reasons:
- The configuration was not completed correctly.
- You do not have available credit.
To receive passive invoices, you must:
- Complete the configuration via POST /api_configurations.
- Set the supplier_invoice value as specified in the documentation. In this way, invoices will be sent to the specified callback.
You can then retrieve them via GET /invoices.
IMPORTANT: if your available credit runs out, passive invoices will no longer be delivered.
The Recipient Code to be set for invoice reception is: PIC7CPS
No. If you do not need to receive passive invoices, there is no need to register any Recipient Code.
Yes. When retrieving a single receipt, you can download it in the default JSON format or as a PDF. To get the PDF, simply set the Content-Type header to "application/pdf".
Notifications can be configured for the following events:
- receipt: when a new receipt is sent and ready
- receipt-credentials: when there are updates to the credentials
- receipt-retry: when communication with the Italian Revenue Agency (AdE) portal fails and the receipt will be retried
- customer-invoice: when any status change occurs for active invoices
- supplier-invoice: when any status change occurs for passive invoices
- receipt-error: when the Italian Revenue Agency (AdE) returns an error for an electronic receipt
The system stores and makes available responses related to receipt submissions, cancellations, and returns for 12 months. After this period, the data is automatically deleted.
Electronic receipts are sent in real time. Response times depend on the Italian Revenue Agency.
Costs are charged for submission, cancellation, and return operations.
An additional €1 cost applies beyond 10 Business configurations.
In the Usage section, at API level, you can monitor all requests made, whether free, subscription-based, or credit-based.
Two viewing modes are available:
- Graphical view: monthly or yearly periods
- Text summary: detailed consumption breakdown
Electronic receipt: starting from €0.009 with subscription or €0.019 with credit-based billing
Electronic invoices: starting from €0.049 with subscription or €0.154 with credit-based billing
Yes, you can activate an annual subscription to reduce the cost per call for both electronic receipts and electronic invoices.
In the API Subscription section, you can:
- View available options with prices and savings percentages
- Activate your preferred subscription directly from the interface.