Peppol-SdI

The Peppol-SdI is a service that takes invoices in UBL format from the Peppol network, converts them into the Italian FatturaPA XML format, and submits them to the Italian government on your behalf using the A-Cube IT APIs.

Getting Started

To use the Peppol-SdI service, follow these steps:

1. Activate the service: Contact A-Cube customer support and request activation of the feature for your account.
2. After activation:
   1. Create and registrer to the A-Cube SMP a new Legal Entity you will send invoices to.
   2. Enable the Peppol-SdI bridge functionality for the Legal Entity.

Submitting Invoices

To submit invoices using the Peppol-SdI Bridge service:

1. Create UBL Invoice: Generate a UBL invoice in your system, ensuring it includes the endpoint identifier of the Legal Entity you created before in the AccountingCustomerParty.Party.EndpointID node.
2. Register the supplier: If not already done before, create another Legal Entity in the A-Cube platform (no need for a SMP registration) having the participant id of the supplier that appears into the AccountingSupplierParty.Party.EndpointID node.
   Why?

   This step is necessary to avoid receiving and transform invoices from unknown suppliers, since the Peppol network is open to all participants.

   info
3. Submit the Invoice: Send the UBL invoice via your Peppol access point. A-Cube will receive and process the invoice, handling the format conversion and submission to SdI.

End 2 End ID

The e2e_id is a unique identifier used to correlate events with the original invoice.

A-Cube generates this value based on specific details in the UBL invoice using the following formula:

md5sum(<company_id>##<invoice_date>##<invoice_number>)

Components:

• <company_id>: The fiscal identifier of the AccountSupplierParty in the UBL invoice. A-Cube determines this using the following priority (top to bottom):
  1. AccountSupplierParty.Party.PartyTaxScheme.CompanyID
  2. AccountSupplierParty.Party.PartyIdentification.ID
  3. AccountSupplierParty.Party.EndpointID
• <invoice_date>: The invoice date in the UBL document, formatted as YYYYMMDD (node IssueDate).
• <invoice_number>: The invoice ID in the UBL document (node ID).

Example:

md5sum(IT12345678901##20250115##Invoice/3)

echo -n 'IT12345678901##20250115##Invoice/3' | md5sum

d786dcab488f218ce4f58933b09b7452

Get notified about the status of your invoices

To stay informed about the status of your invoices, you can request A-Cube to register webhooks for notifications.

Notification Types

Success

Triggered when the UBL invoice is successfully converted and submitted to the Italian government.

Payload schema:

{
  "e2e_id": "<e2e_id>",
  "invoice_uuid": "<invoice_uuid>"
}

You can use the <invoice_uuid> value to retrieve the invoice status from the A-Cube IT APIs and get notified with the dedicated webhook system.

Error

Triggered if errors occur during invoice conversion or submission.

Payload schema:

{
  "e2e_id": "<e2e_id>",
  "error_message": "<error_message>",
  "violations": [
    {
      "propertyPath": "<property path which casued the error>",
      "message": "<message>"
    }
  ]
}

Zero VAT rate

If an invoice has a zero VAT rate, in Italy you must specify a special field named Natura explaining the reason for the tax exemption.

Since the UBL format does not include this field, you can add it to the AdditionalItemProperty node of the corresponding line item in the UBL invoice.

A-Cube will extract the value from the UBL invoice and include it's value in the FatturaPA XML submission.

Example:

...
<Item>
  <AdditionalItemProperty>
    <Name>Natura</Name>
    <Value>N3.1</Value>
  </AdditionalItemProperty>
</Item>
...

Supported values

The following Natura values are supported:

Value	Description (italian)
N1	escluse ex art. 15 del DPR 633/72
N2.1	non soggette ad IVA ai sensi degli artt. da 7 a 7-septies del DPR 633/72
N2.2	non soggette - altri casi
N3.1	non imponibili - esportazioni
N3.2	non imponibili - cessioni intracomunitarie
N3.3	non imponibili - cessioni verso San Marino
N3.4	non imponibili - operazioni assimilate alle cessioni all'esportazione
N3.5	non imponibili - a seguito di dichiarazioni d'intento
N3.6	non imponibili - altre operazioni che non concorrono alla formazione del plafond
N4	esenti
N5	regime del margine / IVA non esposta in fattura
N6.1	inversione contabile - cessione di rottami e altri materiali di recupero
N6.2	inversione contabile - cessione di oro e argento ai sensi della legge 7/2000 nonché di oreficeria usata ad OPO
N6.3	inversione contabile - subappalto nel settore edile
N6.4	inversione contabile - cessione di fabbricati
N6.5	inversione contabile - cessione di telefoni cellulari
N6.6	inversione contabile - cessione di prodotti elettronici
N6.7	inversione contabile - prestazioni comparto edile e settori connessi
N6.8	inversione contabile - operazioni settore energetico
N6.9	inversione contabile - altri casi
N7	IVA assolta in altro stato UE (prestazione di servizi di telecomunicazioni, tele-radiodiffusione ed elettronici ex art. 7-octies, comma 1 lett. a, b, art. 74-sexies DPR 633/72)

Notes

• The transformation of the UBL invoice into the FatturaPA XML format is based on the official Italian government guidelines.