UBL Order and OrderResponse are the XML documents for electronic ordering in UBL 2.1. A buyer sends an Order with parties, delivery and lines; the seller answers with an OrderResponse that accepts, rejects or accepts with changes. Peppol BIS Ordering 3 defines how they are used on the Peppol network, alongside invoices in Peppol BIS Billing. Klarbon support is planned, not available yet.
What is in a UBL Order?
| Part | Holds |
|---|---|
| Header | order number, issue date, currency, customisation and profile identifiers |
| Parties | buyer, seller, and where needed consignee and delivery party |
| Delivery | address and requested period |
| Order lines | item identifiers or free text, quantity, price |
| Totals | anticipated monetary total |
| Property | Value |
|---|---|
| Syntax | UBL 2.1, roots Order and OrderResponse |
| Peppol profile | urn:fdc:peppol.eu:poacc:bis:ordering:3 |
| Order identifier | urn:fdc:peppol.eu:poacc:trns:order:3, transaction 3.7 |
| Response identifier | urn:fdc:peppol.eu:poacc:trns:order_response:3, transaction 3.3 |
| Response codes | AB acknowledged, AP accepted, RE rejected, CA accepted with changes |
| Based on | CEN BII2 Profile 28, Ordering |
OpenPeppol publishes BIS Ordering and the transaction versions of the May 2026 release (BIS Ordering, Peppol BIS 3 documents). The document schemas come from OASIS UBL 2.1 (OASIS).
Order or invoice?
| UBL Order | Peppol BIS Billing invoice | |
|---|---|---|
| Sent by | buyer | seller |
| Purpose | request goods or services | claim payment |
| Tax and totals | anticipated totals, tax optional | VAT breakdown and payable amount required |
| Followed by | despatch advice, then invoice | payment |
An order is not an invoice and cannot be turned into one without the seller's tax and payment data.
What does Klarbon do with UBL orders?
Opening orders and order responses is planned in Klarbon, not available yet. Klarbon does not send orders on Peppol. Klarbon opens UBL invoices and credit notes; see the invoice viewer.
Related
Frequently asked questions
What is a UBL Order?
An XML document in the OASIS Universal Business Language, UBL 2.1, in which a buyer orders goods or services from a seller. Its root element is Order, and it lists the parties, delivery details and order lines with items, quantities and prices.
What is a UBL OrderResponse?
The seller's answer to an order, with root element OrderResponse. In Peppol BIS Ordering the seller can accept the order, reject it or accept it with changes.
Which response codes does Peppol use?
The OrderResponseCode holds codes such as AB for acknowledged, AP for accepted, RE for rejected and CA for conditionally accepted, meaning accepted with changes.
How does Peppol identify ordering documents?
By the profile urn:fdc:peppol.eu:poacc:bis:ordering:3 and the customisation identifiers urn:fdc:peppol.eu:poacc:trns:order:3 for the order and urn:fdc:peppol.eu:poacc:trns:order_response:3 for the response.
Sources
- OpenPeppol, Peppol BIS Ordering 3 docs.peppol.eu
- OpenPeppol, Peppol BIS version 3 documents, May 2026 release docs.peppol.eu
- OASIS, Universal Business Language 2.1 docs.oasis-open.org