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.

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:

Notes

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