Send Electronic Invoices and e-Receipts Easily, Quickly and Securely
Automate the submission of B2B and B2G electronic invoices across major European countries, as well as e-receipts in Italy, through a single API. Ensure regulatory compliance, operational reliability, and enterprise-grade security.
The service currently supports Italy, France, and Germany. Each country follows its own regulations and transmission workflows, but all can be managed through a single REST API.
Yes. The same API allows you to configure companies and manage electronic invoicing across all supported countries. Only certain fields and the transmission methods required by local regulations vary from one country to another.
Although the integration is carried out through a single REST API, each country has its own regulations, formats, and transmission channels.
- Italy: Electronic invoices are transmitted through the Sistema di Interscambio (SDI), which manages invoice submission, receipt, and status notifications.
- France: Electronic invoicing follows the framework defined by French regulations, using the Peppol network and authorized channels for the exchange of electronic documents.
- Germany: Electronic invoicing uses the standards defined by German regulations, such as XRechnung and ZUGFeRD, with transmission via Peppol where applicable.
The Openapi API automatically handles the differences between countries, allowing you to integrate a single solution for company configuration, invoice submission, receipt, and monitoring across all supported markets.
For associations and cooperatives, the Receipts service is activated through a guided process managed by our support team.
To request activation:
- Purchase the Premium Support (2 hours) package
- Open a support ticket requesting the activation of the Receipts service for an Association/Cooperative
One of our support agents will contact you as soon as possible to complete the setup process.
During the procedure, you will need to provide the legal representative’s details. In addition, the legal representative must have access to the Italian Tax Portal (Cassetto Fiscale) using their own credentials (username and password), which are required to complete the service activation.
Yes, the service supports the management of multiple companies. To enable invoicing for each company, simply complete the dedicated configuration process through the Business Registry Configuration endpoint, repeating the operation for every company you wish to activate.
Once the configuration is completed, each company will be able to use the service independently with its own invoicing settings.
No, but beyond 10 configurations there is an additional cost of €1 per configuration.
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. 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.
The Recipient Code to be set for invoice reception is: PIC7CPS
To complete the configuration, you can register this code directly in the dedicated section of the Italian Revenue Agency portal. For more details, please refer to our guide on how to configure the recipient code.
Yes, you can import invoice history using the POST /IT-invoices_import endpoint.
No. If you do not need to receive passive invoices, there is no need to register any Recipient Code.
Yes, electronic invoices addressed to the Public Administration are automatically signed by the system before being sent.
Alternatively, it is possible to use a custom signing certificate by activating the automatic qualified electronic signature (QES Automatic) via Openapi through the dedicated endpoint POST /certificates/namirial-automatic. Once activated, it will be necessary to include the service credentials in the request header for invoice submission, in order to enable signing with the configured certificate.
When using a custom signature, in addition to the certificate activation cost, a per-signature fee will apply of €0.013 under the subscription plan or €0.045 with pay-as-you-go credit top-up.
In the absence of a custom certificate, the system will automatically apply the service’s default digital signature.
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.
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.
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
Costs are charged for submission, cancellation, and return operations.
An additional €1 cost applies beyond 10 Business configurations.
Italy
- Electronic receipts: starting from €0.009 with a subscription or €0.019 with pay-as-you-go billing.
- Electronic invoices: starting from €0.049 with a subscription or €0.154 with pay-as-you-go billing.
France
- Electronic invoices: starting from €0.017 with a subscription or €0.090 with pay-as-you-go billing.
Germany
- Electronic invoices: starting from €0.017 with a subscription or €0.090 with pay-as-you-go 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.