E-Invoicing Guide

Additional Properties

This information can optionally be sent with the invoice in addition to the standard data.

note

Details on the UBL attributes can be found at peppol.eu

Attribute	Description	Example	Country Support
ESR.UBL_DueDate	Due date of payment. Only to be specified if it differs from terms of payment.	"2024-08-15"	_[DE] _[IT]
UBL_Contact			_[DE]
UBL_Person			_[DE]
ESR.UBL_PaymentTerms	Terms of the payment. Only to be specified if it differs from the terms of payment in the configuration.	"30 days net"	_[DE]
ESR.UBL_Delivery.D	The date on which the supply of goods or services was delivered	"2024-07-08"	_[DE] _[PL]
ESR.UBL_Delivery.Adr	The address where the delivery was made		_[DE]
ESR.UBL_Delivery.Adr2	The address extension where the delivery was made		_[DE]
ESR.UBL_Delivery.City	The city where the delivery was made		_[DE]
ESR.UBL_Delivery.Zip	The postcode where the delivery was made		_[DE]
ESR.UBL_Delivery.Country	The country code where the delivery was made		_[DE]
ESR.UBL_ProfileID	"Identifies the business process context in which the transaction appears" (see more at peppol.eu)		_[DE]
ESR.UBL_BuyerReference	An identifier assigned by the buyer used for internal routing purposes. An invoice must have buyer reference or purchase order reference (BT-13).		_[DE]
ESR.UBL_OrderReference			_[DE]
ESR.UBL_ContractDocumentReference	The identification of a contract.		_[DE]
ESR.UBL_ProjectReference	The identification of the project the invoice refers to.		_[DE]
ESR.UBL_Supplier.Name	The name of the supplier. Only to be specified if it differs from the ContactName in the configuration.	"John Doe"	_[DE]
ESR.UBL_Supplier.Telephone	The contact phone number of the supplier. Only to be specified if it differs from the ContactTelephone in the configuration.	"123456789"	_[DE]
ESR.UBL_Supplier.ContactElectronicMail	The email address of the supplier. Only to be specified if it differs from the ContactElectronicMail in the configuration.	`j.doe@efsta.eu`	_[DE]
ESR.UBL_Payee.Nam	The name of the payee. Only to be specified if it differs from the Nam field of the Customer object.		_[DE]
ESR.UBL_Payee.TaxId	The VAT number of the payee. Only to be specified if it differs from the TaxId field of the Customer object.		_[DE]
ESR.UBL_Payee.GLN	The GLN number of the payee.		_[DE]
ESR.UBL_Payee.Adr	The address of the payee. Only to be specified if it differs from the Adr field of the Customer object.		_[DE]
ESR.UBL_Payee.Adr2	The address extension of the payee. Only to be specified if it differs from the Adr2 field of the Customer object.		_[DE]
ESR.UBL_Payee.City	The city name of the payee. Only to be specified if it differs from the City field of the Customer object.		_[DE]
ESR.UBL_Payee.Zip	The postcode of the payee. Only to be specified if it differs from the Zip field of the Customer object.		_[DE]
ESR.UBL_Payee.Ctry	The country code of the payee. Only to be specified if it differs from the Ctry field of the Customer object.		_[DE]
Pos.UBL_OrderLineReference			_[DE]
Pos.UBL_TaxExemptionReasonCode	A coded statement of the reason for why the amount is exempted from VAT.		_[DE]
Pos.UBL_TaxExemptionReason			_[DE]

Example Request

JSON
XML

{"Tra":
    {"ESR":
        {"DD": "IT-TEST", "DDto": "WSRLPXY", "NFS": "INVOICE", "UBL_DueDate": "2024-08-15",
        "Ctm":
            {"TaxId": "IT02348690211", "Nam": "The Buyercompany S.p.A", "Adr": "Via Roma 1",
                "Zip": "12345", "City": "Milano (MI)"
            },
        "PosA": {
            "Pos": { "PN": "1", "Dsc": "test", "TaxG": "B", "Amt": "1.00"}},
        "PayA": {
            "Pay": { "Dsc": "Contanti", "PayG": "cash", "Amt": "1.00"}}
        },
    }
}

<Tra>
  <ESR DD="IT-TEST" DDto="WSRLPXY" NFS="INVOICE" UBL_DueDate="2024-08-15">
    <Ctm TaxId="IT02348690211" Nam="The Buyercompany S.p.A" Adr="Via Roma 1" Zip="12345" City="Milano (MI)"/>
    <PosA>
      <Pos PN="1" Dsc="test" TaxG="B" Amt="1.00"/>
    </PosA>
    <PayA>
      <Pay Dsc="Contanti" PayG="cash" Amt="1.00"/>
    </PayA>
  </ESR>
</Tra>

Additional Properties​

Additional Properties