Electronic Receipts (E-Receipts)

The Electronic Receipts API enables you to issue, submit and manage electronic receipts with the Italian Revenue Agency through a single integration. The solution is designed to automate the entire commercial document issuance process, simplifying tax management for physical stores and business management software.

With Openapi, you can configure companies, business locations, Stores, telematic cash registers and cashiers, creating a complete infrastructure for managing electronic receipts. Once the configuration is complete, each Store is ready to issue commercial documents, manage returns and cancellations, and monitor all operations through the API.

The API supports the entire lifecycle of electronic receipts: from the initial configuration to issuance, retrieval and the management of subsequent operations, providing a scalable integration suitable even for businesses with multiple points of sale.

The solution is designed for business management software, POS systems, ERP platforms, retail applications and any software that needs to integrate electronic receipt management directly into its operational workflows.

All operations are managed through a dedicated Electronic Receipts infrastructure, allowing you to manage the entire environment through a single API integration.

Company, Store and Cash Register Configuration

POST /IT-configurations

Configuration is the first mandatory step to use the Electronic Receipts API. Through this endpoint, you can register your company and configure the entire infrastructure required to manage commercial documents.

During this phase, you can configure the company's registered office, create one or more Stores (points of sale), associate one or more telematic cash registers with each Store and configure callbacks to automatically receive notifications about the operations performed by the API.

Each Store can manage one or more telematic cash registers, while every electronic receipt can be associated with the cash register used to issue the commercial document.

REQUEST EXAMPLE

To configure your company, send a request to POST /IT-configurations. In the following example, the company, its registered office, a Store with two telematic cash registers and the callbacks used to automatically receive operation updates are configured.

{
  "fiscal_id": "YourCompanyFiscal_id",
  "name": "Company Name",
  "email": "[email protected]",
  "receipts": true,
  "customer_invoice": true,
  "supplier_invoice": true,
  "e_receipts": false,
  "legal_storage": false,
  "merchant_address": {
    "street_address": "Main Street",
    "street_number": "10",
    "zip_code": "00100",
    "city": "Rome",
    "province": "RM"
  },
  "stores": [
    {
      "label": "Downtown Store",
      "address": {
        "street_address": "Main Street",
        "street_number": "10",
        "zip_code": "00100",
        "city": "Rome",
        "province": "RM"
      },
      "cash_registers": [
        {
          "label": "Cash Register 1"
        },
        {
          "label": "Cash Register 2"
        }
      ]
    }
  ],
  "receipts_authentication": {
    "taxCode": "FHHWMF96L52D111B",
    "password": "1234567891****d",
    "pin": "1********4"
  },
  "api_configurations": [
    {
      "event": "receipt",
      "callback": {
        "url": "https://your-server.com/123232"
      }
    },
    {
      "event": "customer_invoice",
      "callback": {
        "url": "https://your-server.com/123232"
      }
    },
    {
      "event": "supplier_invoice",
      "callback": {
        "url": "https://your-server.com/123232"
      }
    },
    {
      "event": "receipt-error",
      "callback": {
        "url": "https://your-server.com/error"
      }
    }
  ]
}

RESPONSE EXAMPLE

If the configuration is completed successfully, the API returns the registered company details together with the enabled services, the Store configuration and the associated telematic cash registers. The response also confirms that the configuration is active and provides the unique identifier that will be used for subsequent management operations.

{
  "data": {
    "id": "679ca42e**********016df7",
    "fiscal_id": "YourCompanyFiscal_id",
    "name": "Company Name",
    "email": "[email protected]",
    "active": true,
    "receipts": true,
    "customer_invoice": true,
    "supplier_invoice": true,
    "merchant_address": {
      "street_address": "Main Street",
      "street_number": "10",
      "zip_code": "00100",
      "city": "Rome",
      "province": "RM"
    },
    "stores": [
      {
        "label": "Downtown Store",
        "cash_registers": [
          {
            "label": "Cash Register 1"
          },
          {
            "label": "Cash Register 2"
          }
        ]
      }
    ],
    "receipts_authentication": {
      "taxCode": "FHHWMF96L52D111B"
    },
    "api_configurations": [
      {
        "event": "receipt",
        "callback": {
          "method": "JSON",
          "url": "https://www.mysite.com/myEndpoint",
          "field": "data",
          "retry": 0
        }
      }
    ],
    "create_timestamp": 1738318895
  },
  "success": true,
  "message": "",
  "error": null
}

Issuing Electronic Receipts

POST /IT-e-receipts

The POST /IT-e-receipts endpoint allows you to issue an electronic receipt for physical points of sale. The document is transmitted using the Store (PEM) and the telematic cash register previously configured through the IT-configurations service.

To use this service, the e_receipts option must be enabled in the company configuration, a valid Italian VAT number must be provided as the fiscal_id, and at least one Store with its associated telematic cash register must already be configured.

When issuing the document, you can specify the cashier, Store and telematic cash register to be used. The API automatically verifies ownership of the specified resources and uses the configuration associated with the selected Store and telematic cash register.

By default, the service issues a sales receipt (type: sale). It also supports advanced scenarios such as proof of purchase, returns and cancellations through the dedicated endpoints and schemas described in the documentation.

REQUEST EXAMPLE

To issue an electronic receipt, send a request to POST /IT-e-receipts. In the following example, a sales receipt (type: sale) is issued and associated with a previously configured Store, telematic cash register and cashier. The document contains a single sales item and an electronic payment equal to the total receipt amount.

{
  "fiscal_id": "11122211133",
  "type": "sale",
  "cashier_id": "69d7c469f6d16f5f4003eca6",
  "store_id": "69ca63ce0f8c187ebf0aa36c",
  "cr_id": "69d8cfbba3ccba0fcc0d0184",
  "items": [
    {
      "type": "goods",
      "id": 1,
      "quantity": "4.00",
      "description": "Premium wireless mouse",
      "unit_price": "2.00",
      "vat_rate_code": "22.00"
    }
  ],
  "electronic_payment_amount": "8.00"
}

RESPONSE EXAMPLE

If the request is processed successfully, the API returns the newly created electronic receipt together with its unique identifier, document number, issue date, processing status and all tax information associated with the commercial document.

{
  "data": {
    "fiscal_id": "11122211133",
    "type": "sale",
    "cashier_id": "69d7c469f6d16f5f4003eca6",
    "store_id": "69ca63ce0f8c187ebf0aa36c",
    "cr_id": "69d8cfbba3ccba0fcc0d0184",
    "status": "ready",
    "created_at": "2026-04-17T15:30:12.000Z",
    "items": [
      {
        "type": "goods",
        "id": 1,
        "quantity": "4.00",
        "description": "Premium wireless mouse",
        "unit_price": "2.00",
        "vat_rate_code": "22.00",
        "simplified_vat_allocation": false,
        "discount": "0.00",
        "surcharge": "0.00",
        "prepaid_or_voucher": false,
        "complimentary": false
      }
    ],
    "document_number": "0001-0003",
    "document_date": "2026-04-17T17:30:12.000Z",
    "total_amount": 8,
    "is_voidable": true,
    "is_returnable": true
  },
  "success": true,
  "message": "",
  "error": null
}

Retrieving Electronic Receipts

GET /IT-e-receipts

The GET /IT-e-receipts endpoint allows you to retrieve all electronic receipts issued through the API. It provides a complete overview of commercial documents generated across one or more points of sale.

The endpoint supports the available query parameters, allowing you to filter results based on your application's requirements. This makes it easy to search, monitor and manage large volumes of electronic receipts generated by business management software, ERP systems and retail platforms.

Each returned document includes the main tax information together with the identifiers required to retrieve the complete receipt details or perform subsequent operations, such as returns and cancellations.

REQUEST EXAMPLE

To retrieve electronic receipts, simply send a request to GET /IT-e-receipts. You can use the available query parameters to filter the returned documents according to your business needs.

GET /IT-e-receipts

RESPONSE EXAMPLE

If the request is successful, the API returns the list of matching electronic receipts. Each document includes the processing status, document number, issue date, sold items, payment information and indicators showing whether the receipt can still be cancelled or used for a return operation.

{
  "data": [
    {
      "fiscal_id": "11122211133",
      "type": "sale",
      "cashier_id": null,
      "store_id": "69e1f1335c3954b240083fd4",
      "cr_id": "69e1f1335c3954b240083fd5",
      "status": "ready",
      "created_at": "2026-04-17T15:30:12.000Z",
      "items": [
        {
          "type": "goods",
          "id": 1,
          "quantity": "4.00",
          "description": "Premium wireless mouse",
          "unit_price": "2.00",
          "vat_rate_code": "22.00",
          "simplified_vat_allocation": false,
          "discount": "0.00",
          "surcharge": "0.00",
          "prepaid_or_voucher": false,
          "complimentary": false
        }
      ],
      "invoice_issuing": false,
      "uncollected_dcr_to_ssn": false,
      "discount": "0.00",
      "additional_text": null,
      "cash_payment_amount": "0.00",
      "electronic_payment_amount": "8.00",
      "ticket_restaurant_payment_amount": "0.00",
      "ticket_restaurant_quantity": 0,
      "services_uncollected_amount": "0.00",
      "goods_uncollected_amount": "0.00",
      "id": "69e2520543070c786b0c77c4",
      "document_number": "0001-0003",
      "document_date": "2026-04-17T17:30:12.000Z",
      "total_amount": 8,
      "is_voidable": true,
      "is_returnable": true
    }
  ],
  "success": true,
  "message": "",
  "error": null
}

Managing Returns

PATCH /IT-e-receipts/{id}

The PATCH /IT-e-receipts/{id} endpoint allows you to return one or more items included in an electronic receipt that has already been issued. The identifier of the original document is specified in the request path, while the items to be returned and their quantities are defined in the request body.

A return can be associated with a specific cashier, Store or telematic cash register. If these parameters are not provided, the system automatically uses the telematic cash register that issued the original receipt. Before processing a return, you can use the GET /IT-e-receipts/{id}/returnable-items endpoint to retrieve the items that are still eligible for return together with their available quantities.

The specified quantities are automatically validated against the original receipt, preventing returns that exceed the quantities available for each item.

REQUEST EXAMPLE

To register the return of one or more items, send a request to PATCH /IT-e-receipts/{id}, specifying the items to be returned and their quantities. Optionally, you can also specify the telematic cash register and the cashier responsible for the operation.

{
  "cr_id": "69e0ad3456b8f49252094fab",
  "cashier_id": "69d7c469f6d16f5f4003eca6",
  "items": [
    {
      "id": 1,
      "quantity": "2.00"
    }
  ]
}

RESPONSE EXAMPLE

If the return is completed successfully, the API generates a new commercial document of type return, linked to the original electronic receipt through the parent_receipt_id field. This guarantees complete traceability of the operation without modifying the original document.

{
  "data": {
    "fiscal_id": "11122211133",
    "type": "return",
    "cashier_id": null,
    "store_id": "69e1f1335c3954b240083fd4",
    "cr_id": "69e1f1335c3954b240083fd5",
    "status": "ready",
    "created_at": "2026-04-17T15:36:57.000Z",
    "items": [
      {
        "type": "goods",
        "id": 1,
        "quantity": "1.00",
        "description": "Premium wireless mouse",
        "unit_price": "2.00",
        "vat_rate_code": "22.00",
        "simplified_vat_allocation": false,
        "discount": "0.00",
        "surcharge": "0.00",
        "prepaid_or_voucher": false,
        "complimentary": false
      }
    ],
    "id": "69e2539a43070c786b0c77c5",
    "parent_receipt_id": "69e2520543070c786b0c77c4",
    "document_number": "0001-0004",
    "document_date": "2026-04-17T17:36:58.000Z",
    "is_voidable": false,
    "is_returnable": false
  },
  "success": true,
  "message": "",
  "error": null
}

Cancelling an Electronic Receipt

DELETE /IT-e-receipts/{id}

The DELETE /IT-e-receipts/{id} endpoint allows you to cancel an electronic receipt that has already been issued. The operation does not modify the original document. Instead, it generates a new cancellation document linked to the original receipt through the parent_receipt_id field, ensuring complete fiscal traceability of the operation.

Optionally, you can specify the cashier, Store or telematic cash register that will perform the cancellation. If these parameters are not provided, the system automatically uses the telematic cash register associated with the original document.

An electronic receipt can only be cancelled if it is still eligible for cancellation. Receipts that have already been cancelled or fully returned cannot be cancelled again.

REQUEST EXAMPLE

To cancel an electronic receipt, simply send a request to DELETE /IT-e-receipts/{id}, specifying the identifier of the document to be cancelled. Optionally, you can include the cashier, Store or telematic cash register in the request body to specify which resource will perform the operation.

DELETE /IT-e-receipts/69e2584a4a218eb38c03c012

RESPONSE EXAMPLE

If the cancellation is completed successfully, the API returns a new document of type void, linked to the original electronic receipt through the parent_receipt_id field. This preserves the complete history of all operations performed on the commercial document.

{
  "data": {
    "fiscal_id": "11122211133",
    "type": "void",
    "cashier_id": null,
    "store_id": "69e1f1335c3954b240083fd4",
    "cr_id": "69e1f1335c3954b240083fd5",
    "status": "ready",
    "created_at": "2026-04-17T15:57:10.000Z",
    "id": "69e2585782410398e20c4642",
    "parent_receipt_id": "69e2584a4a218eb38c03c012",
    "is_voidable": false,
    "is_returnable": false
  },
  "message": "Voided receipt: 69e2584a4a218eb38c03c012",
  "success": true,
  "error": null
}

Cashier Management

Each electronic receipt can be associated with a specific cashier. Through the dedicated endpoints, you can create and manage cashiers operating across your points of sale, assigning individual credentials and ensuring complete traceability of every transaction.

Cashier management is particularly useful for businesses with multiple operators or checkout stations, making it possible to identify exactly who issued each commercial document.

POST /IT-cashiers

The POST /IT-cashiers endpoint allows you to create a new cashier for the Electronic Receipts service. Each cashier has their own credentials and can be associated with electronic receipts issued through the API.

REQUEST EXAMPLE

To create a new cashier, send a request to POST /IT-cashiers, specifying the cashier's email address, full name and the company's VAT number to which the cashier will be associated.

{
  "email": "[email protected]",
  "name": "John Smith",
  "fiscal_id": "11122211133"
}

RESPONSE EXAMPLE

If the request is processed successfully, the API returns the newly created cashier, including the unique identifier, activation status and the company associated with the profile.

{
  "data": {
    "id": "69d7c469f6d16f5f4003eca6",
    "email": "[email protected]",
    "name": "John Smith",
    "status": "active",
    "fiscal_id": "11122211133"
  },
  "success": true,
  "message": "Cashier created successfully",
  "error": null
}

Store and Cashier Management

The Electronic Receipts API is designed to support businesses with multiple points of sale and multiple operators. During the initial configuration, you can define one or more Stores, associate one or more telematic cash registers with each Store and manage the cashiers operating within your infrastructure.

Each electronic receipt can be linked to a specific Store, telematic cash register and, where applicable, the cashier who performed the transaction. This ensures complete traceability of commercial documents while simplifying the management of retail chains, multi-store businesses and organizations with multiple checkout stations.

The dedicated endpoints also allow you to manage Store maintenance operations, including Store reactivation, daily closing procedures and communications required in emergency situations, ensuring compliance with the operational workflows supported by the service.

Automate Electronic Receipt Management

The Electronic Receipts API enables you to manage the entire lifecycle of electronic receipts through a single integration, from company and Store configuration to document issuance, retrieval, returns and cancellations.

With support for Stores, telematic cash registers and cashiers, the solution is suitable for both single points of sale and businesses with multiple locations, providing a scalable integration aligned with the operational processes required for managing electronic receipts in Italy.

With easy-to-integrate REST APIs and comprehensive documentation, you can automate electronic receipt management within business management software, POS systems, ERP platforms and retail applications, reducing manual tasks and streamlining operational workflows.