Smart Receipts Guide

​

Introduction

Invopop’s Smart Receipts provider allows you to generate and issue electronic tickets (documento commerciale/scontrino elettronico) in Italy. The documento commerciale is a digital fiscal document that records sales transactions and transmits them to the Agenzia delle Entrate (AdE). This digital receipt replaces traditional paper receipts while maintaining full fiscal compliance and serves as official proof of purchase for your customers. Italian law requires businesses to transmit sales data digitally through either a certified Registratore Telematico (RT) or the AdE’s online portal. Smart Receipts streamlines this process by providing a secure interface to relay your sales data to the AdE through a local provider. Important distinctions for the Documento Commerciale:

• It is not an invoice (fattura) - invoices require detailed buyer information and follow different tax rules.
• It does not replace transport documents (documento di trasporto).
• It is not a simple internal receipt - it serves an official fiscal function requiring AdE transmission.
• It must include VAT at the time of sale - deferred VAT payment is not permitted.

The AdE portal provides functionality to create tickets, void them entirely, and process refunds at the item level. Invopop’s Smart Receipts implementation supports all these operations, allowing you to manage your electronic tickets programmatically through our API or manually via the Console. The AdE portal provides functionality to create tickets, void them entirely, and process refunds at the item level. Invopop’s Smart Receipts implementation supports all these operations, allowing you to manage your electronic tickets programmatically through our API or manually via the Console.

​

Prerequisites

Before you begin, ensure you have:

• An Italian tax ID (Partita IVA) for the supplier.
• Invoice line items that include:
  • quantity,
  • name ,
  • price (including VAT),
  • VAT rate,
  • item type (specified in extension).

​

Setup

There are five key processes to prepare:

1. Create a supplier post-registration workflow.
2. Connect the Italian Smart Receipts app.
3. Configure a supplier registration workflow.
4. Prepare an invoicing workflow.
5. Prepare a voiding workflow.

Follow these steps in the Invopop Console.

​

Running

Each company who will issue e-receipts must first register as a supplier in Invopop. In this section we’ll first explain how to register a supplier using the registration workflow we setup, and then how to issue and void invoices on behalf of that supplier, with the corresponding workflows. As usual, the recommended approach for running jobs is to perform two steps; first upload the document to the silo, second create a job.

​

Register a Supplier

You can register suppliers either manually via the Invopop Console or programmatically via the API. The process is essentially the same, so for this guide we’ll demonstrate the manual process.

1. Navigate to Contacts → Suppliers in the sidebar
2. Click + New Supplier
3. In the editor, enter the supplier details

Here’s an example using test data (only valid for sandbox environments): Tap Build, ensure there are no errors, and click Save. We should now see the document. Find and click the Select Workflow button. Select the Register Supplier workflow created during setup, and click Run Workflow. The execution should be successful, and the silo entry will now be in the Processing state. Tap the Meta tab to see the registration link: Tap the registration link and a new browser window will be presented with a form to upload the credentials for the supplier. Note that this form can be shared directly with the supplier if required. The details from this form are sent securely to local partner who will be responsible for sending them to the AdE. We will update the supplier with the provided codice fiscale for future use but will not store any type of credentials.

​

Send an Invoice

Use these GOBL document examples as templates in the Invopop Console or when creating silo entries via the API. For proper validation and normalization, set these properties in your GOBL Invoices:

• Set $region to IT
• Include it-ticket-v1 in $addons

While Invopop attempts to set these automatically based on other invoice fields, we recommend defining them explicitly. The example below shows a simple B2C invoice from an Italian supplier. Key points to note:

• The it-ticket-v1 addon ensures validation using AdE CF V1 rules
• Extensions (ext) fields specify values that cannot be determined otherwise:
  • Items have an extension identifying them as goods or services
  • VAT exemptions require an Italian exemption code
• The prices_include field indicates that item prices include VAT
• VAT for “Cleaning Products” automatically sets to the standard rate
• Totals and calculations are generated automatically

B2C Invoice

The AdE will automatically generate a document number for the invoice. Once the invoice is sent, you will find the document number in a stamp inside the document header. After the AdE accepts the invoice, they add a reference to each line item. This reference, stored in the it-ticket-line-ref extension, is essential for processing refunds. The example below shows a complete invoice with these references.

B2C Invoice Complete

​

Refund an Invoice

When a customer requests a refund for specific items, you can process it by issuing a corrective invoice. Since this is still considered sending an invoice, you can use the same workflow as before. To create a corrective invoice take a original GOBL Invoice and:

1. Set the type field to corrective
2. Add a reference to the original invoice using the preceeding object
3. Include the original document number stamp from the first invoice
4. Keep the lines and quantities you want to refund

The example below shows a corrective invoice that refunds two units of “Cleaning Products” from the original invoice. The corrective invoice:

• Preserves the it-ticket-line-ref extension from the original invoice
• References the original invoice using the preceeding object
• Maintains the same line item references for accurate tracking

Corrective Invoice

​

Void an Invoice

You can void an invoice if it was issued in error, such as when a receipt is accidentally sent twice. To void an invoice:

1. Locate the silo entry uuid of the invoice
2. Run the “Void AdE CF Invoices” workflow with this uuid

​

FAQ

Please contact the Invopop support team if you have any questions that are not listed here.