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.DueDate	Due date of payment. Only to be specified if it differs from terms of payment.	"2024-08-15"	_[BE] _[DE] _[FR] _[IT]
ESR.PaymentTerms	Terms of the payment. Only to be specified if it differs from the terms of payment in the configuration.	"30 days net"	_[BE] _[DE] _[FR]
ESR.Delivery.D	The date on which the supply of goods or services was delivered	"2024-07-08"	_[BE] _[DE] _[FR] _[PL]
ESR.Delivery.Adr	The address where the delivery was made		_[BE] _[DE] _[FR]
ESR.Delivery.Adr2	The address extension where the delivery was made		_[BE] _[DE] _[FR]
ESR.Delivery.City	The city where the delivery was made		_[BE] _[DE] _[FR]
ESR.Delivery.Zip	The postcode where the delivery was made		_[BE] _[DE] _[FR]
ESR.Delivery.Ctry	The country code where the delivery was made		_[BE] _[DE] _[FR]
ESR.Ctm.BuyerReference	An identifier assigned by the buyer used for internal routing purposes. An invoice must have buyer reference or purchase order reference (BT-13).		_[BE] _[DE] _[FR]
ESR.Ctm.AccountingReference	The buyer's accounting reference (BT-19), e.g. the cost centre the buyer books the invoice on. Written to `cbc:AccountingCost` on invoices and credit notes.	"KST-4711"	_[BE] _[DE] _[FR]
ESR.OrderReference	The buyer's purchase order number (BT-13).	"PO-4711"	_[BE] _[DE] _[FR]
ESR.SellerOrderReference	The seller's own order number for the same deal (BT-14), e.g. a hotel's reservation confirmation number. Not a substitute for `ESR.OrderReference` or `ESR.Ctm.BuyerReference`. If sent without `ESR.OrderReference`, the purchase order reference is filled with "NA".	"CONF-123456"	_[BE] _[DE] _[FR]
ESR.Pos.OrderLineReference			_[BE] _[DE] _[FR]
ESR.ContractDocumentReference	The contract the invoice refers to (BT-12).	"CT-2026-17"	_[BE] _[DE] _[FR]
ESR.ProjectReference	The project the invoice refers to (BT-11). On credit notes it is sent as an additional document reference with document type code 50.	"PRJ-2026-01"	_[BE] _[DE] _[FR]
ESR.Metadata `InvoiceNote`	Free-text note on invoice level (BT-22), sent as a document-level `ESR.Metadata` entry: JSON `{"Key": "InvoiceNote", "Value": "…"}`, XML `<Meta Key="InvoiceNote" Value="…"/>`. An e-invoice carries at most one note: in France the text is appended to the mandatory payment terms mentions.	"Room 204, 3 nights"	_[BE] _[DE] _[FR]

Example Request

JSON
XML

{"Tra":
    {"ESR":
        {"DT": "INVOICE", "DD": "IT", "DDto": "WSRLPXY", "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": "Esempio di prodotto", "TaxG": "B", "Amt": "1.00"}},
        "PayA": {
            "Pay": { "Dsc": "Contanti", "PayG": "cash", "Amt": "1.00"}}
        },
    }
}

<Tra>
  <ESR DT="INVOICE" DD="IT" DDto="WSRLPXY" 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="Esempio di prodotto" TaxG="B" Amt="1.00"/>
    </PosA>
    <PayA>
      <Pay Dsc="Contanti" PayG="cash" Amt="1.00"/>
    </PayA>
  </ESR>
</Tra>

Additional Properties​

Additional Properties