E-Invoicing Guide
General API Information
Customer Data
Other than when issuing simplified invoices, electronic documents always require full identification of the customer, including additional address information for the transport system. It is recommended to provide a well-maintained customer database on POS software side, and eventually a function to enter data of walk-in customers. Details about customer data can be found at Ctm Elements.
Customer data is mandatory for the E-Invoice. For B2B invoices, a TaxId must also always be specified.
ESR Specification
First you have to trigger the electronic delivery of a transaction document. To do so, please specify Document Delivery ESR.DD, (e.g.: DD="IT"/DD="DE"). If you want to use the test system just append -TEST, f.e: "IT-TEST".
Secondly, you must specify the recipient of the Document Delivery (DDto) if required.
In the DDto field, the delimiter ; can be used to add additional information.
| Attribute | Description | Example(s) |
|---|---|---|
ESR.DD | System through which the E-Invoice is transmitted. At minimum, the country code must be specified; a specific system can also be provided if applicable. | "DE" "IT" "IT-TEST" "IT-FatturaPA" |
ESR.DDto | Country-specific recipient identifier for the E-Invoice. The value and format depend on the country and whether the invoice is (B2B, B2G). | "VSRLPXY" (IT, B2B) "j.doe@efsta.eu" (DE, B2B) |
Details for each Country can be found in the Country-Specific Guide