Peppol Order Agreement transaction 3.1 (T110)

Specification identification
An identification of the specification containing the total set of rules regarding semantic content, cardinalities and business rules to which the data contained in the instance document conforms.The identification may include the version of the specification as well as any customizations applied.

Example value: urn:fdc:peppol.eu:poacc:trns:order_agreement:3

Business process type identifier
Identifies the business process context in which the transaction appears. It enables the buyer to process the document in an appropriate way.

Fixed value: urn:fdc:peppol.eu:poacc:bis:order_agreement:3

Order agreement identifier
A unique identifier for an order agreement. The identifier must be globally unique since the receiver is using it as an order number (issued by the seller).

Example value: 0263bf48-9a55-4d15-adf5-2c2921036d1c

Sales order reference
An identifier of a referenced sales order, issued by the Seller.

Example value: 112233

Order agreement issue date
The date on which an order agreement was issued. Must be formatted YYYY-MM-DD

Example value: 2018-05-18

Order agreement issue time
The time of the day when the order agreement was issued. Format = "hh:mm:ss"

Example value: 12:10:35

Order agreement note
Free-form text applying to the order agreement.Free text applying to the order agreement.

Example value: We have a new phone number 33 44 55

Order agreement currency
The default currency for the order agreement

Example value: EUR

Buyer reference identifier
An identifier assigned by the Buyer used for internal routing purposes. The identifier is defined by the buyer (contact ID, department, office id, project code), but provided by the seller in the order agreement and later in the invoice.

Example value: abc123

Previous order reference

Previous order agreement identifier
A reference to a previous identifier for an order agreement. Used to indicatete that this agreement is a change to a previous agreement. This is an optional business term but is a required element in the UBL syntax so if no previous order identifier is available use NA.

Example value: O-1234

TENDER OR LOT REFERENCE

Tender or lot reference
The identification of the call for tender or lot the order agreement relates to.

Example value: PPID-123

Additional document

Document identifier
An identifier for the referenced document.

Example value: doc-34

Document description
Textual description of the document.

Example value: Timesheet

Attachment

Attached document
The attached document embeded as binary object, coded as Base64. The binary object has two supplementary components: a Mime Code, which specifies the Mime type of the attachment and a Filename that is provided by (or on behalf of) the sender of the document

Example value: QklTIE9yZGVyIEFncmVlbWVudCAtIDQyQQ==

Attached document Mime code
The mime code of the attached document.

Example value: application/pdf

Attached document Filename
The file name of the attached document

Example value: Hours-spent.pdf

External reference
Reference to external document

External document URI
The Uniform Resource Identifier (URI) that identifies where the external document is located.

Example value: http://www.test.eu/image.jpg

Contract reference
The identification of a contract.

Contract identifier
A reference that uniquely identifies a contract that relates to this transaction.

Example value: C-97324

Seller supplier party
The supplier is the legal person or organization who provides a product or service.

Party information

Seller party electronic address
Identifies the seller party's electronic address

Example value: 7300010000001

Scheme identifier
Scheme identifier for the electronic address

Example value: 0088

Party identification

Seller party identification
A identifier for the seller that is issued by the party that sends the document in which the identifier is used.Identifies a party.

Example value: DK88777654

Scheme identifier
Scheme identifier for party identification

Example value: 0184

Postal Address

Address line 1
The main address line in an address. Usually the street name and number or post office box.

Example value: Main Street 23

Address line 2
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: 3rd Floor

City
The common name of a city where the address is located.

Example value: København V

Post code
The identifier for an addressable group of properties according to the relevant postal service, such as a ZIP code or Post Code.

Example value: 1550

Country subdivision
The subdivision of a country such as region, county, state, province etc.

Address line

Address line 3
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: Gate 34

Country

Country code
A code that identifies the country.The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions". Codes must be according to the alpha-2 representation.

Example value: DK

Party name

Sellers legal registration name
The full (formal) name by which the seller is registered in the national registry of legal entities or persons.The name of the party.

Example value: Seller company Ltd.

Seller legal registration identifier
Identifies a company as registered with the company registration scheme.

Example value: 987654321

Scheme identifier
The identification scheme identifier of the buyer legal registration identifier.

Example value: 0002

Contact information

Contact point
The name of the contact point.

Example value: Ole Olsen

Contact telephone number
A phone number for the contact point.

Example value: +45 33 12 12 21

Contact email address
An e-mail address for the contact point.

Example value: test.name@foo.bar

Customer party
The customer is the legal person or organization who is in demand of a product or service.

Party information

Buyer party electronic address
Identifies the buyer party's electronic address

Example value: 7300010000001

Scheme identifier
Scheme identifier for the electronic address

Example value: 0088

Party identification

Buyer customer account identifier
A identifier for the buyer that is issued by the party that sends the document in which the identifier is used.An identification for the buyer party.

Example value: 7300010000001

Scheme identifier
Scheme identifier for party identification

Example value: 0088

Postal address

Address line 1
The main address line in an address.Usually the street name and number or post office box.

Example value: P.O. Box 19999

Address line 2
An additional address line in an address that can be used to give further details supplementing the main line.

City
The common name of a city where the address is located.

Example value: Amsterdam

Post code
The identifier for an addressable group of properties according to the relevant postal service, such as a ZIP code or Post Code.

Example value: 1000 GG

Country subdivision
The subdivision of a country such as region, county, state, province etc.

Address line

Address line 3
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: Gate 34

Country

Country code
A code that identifies the country.The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions". Codes must be according to the alpha-2 representation.

Example value: NL

Party name

Buyer name
The full name of the buyer.The name of the party who ordered the items and receives the response.

Example value: Customer AS

Buyers legal registration identifier
Identifies a company as registered with the company registration scheme.

Example value: 987654321

Scheme identifier
The identification scheme identifier of the buyer legal registration identifier.

Example value: 0002

Contact information

Contact point
The name of the contact point.

Example value: May Jones

Contact telephone number
A phone number for the contact point.

Example value: +31 (0) 20 525 1111

Contact email address
An e-mail address for the contact point.

Example value: maj.jones@test.nl

Originator party
The unit initiating the order. Most often the end user.

Party information

Party identification

Originator identifier
An identifier for the party that originally requested the ordered items.

Example value: 7300010000001

Scheme identifier
Scheme identifier for party identification

Example value: 0088

Party name

Originator name
The name of the party that originally requested the ordered items.

Example value: Originator name

Accounting customer party/Invoicee
The invoicee is the legal person or organization acting on behalf of the customer and who receives the invoice for the order.

Party information

Party identification

Accounting customer identifier
A unique identifier of the accounting customer

Example value: 7300010000001

Scheme identifier
Scheme identifier for party identification

Example value: 0088

Party name

Accounting customer name
Accounting customer name

Example value: Information services

Delivery information
Delivery gives information on when and where the goods and services are deleivered.

Promised delivery period
The period when the goods or services are delivered.

Period start date
The date when the period starts.The date is the first day of the period. Must be formatted YYYY-MM-DD

Example value: 2018-05-15

Period start time
The start time of the period. Format = "hh:mm:ss"

Example value: 10:00:00

Period end date
The date on which the period ends.The date is the last day of the period. Must be formatted YYYY-MM-DD

Example value: 2018-05-15

Period end time
The end time of the period.Format = "hh:mm:ss"

Example value: 12:30:00

Delivery party

Party identification

Delivery party identifier
A identifier for the party that carries out the delivery.

Example value: 7300010000001

Scheme identifier
Scheme identifier for party identification

Example value: 0088

Party name

Delivery party name
The name of the party to which the goods and services are deliverd.

Example value: Delivery party name

Delivery party address

Address line 1
The main address line in an address. Usually the street name and number or post office box.

Example value: Main Street 23

Address line 2
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: 3rd Floor

City
The common name of a city where the address is located.

Example value: København V

Post code
The identifier for an addressable group of properties according to the relevant postal service, such as a ZIP code or Post Code.

Example value: 1550

Country subdivision
The subdivision of a country such as region, county, state, province etc.

Address line

Address line 3
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: Gate 34

Country

Country code
A code that identifies the country.The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions". Codes must be according to the alpha-2 representation.

Example value: DK

Delivery terms information
Information on delivery location and special delivery terms

Buyer delivery terms
The terms that the buyer applies to the delivery the ordered items.

Example value: EXW

Delivery special terms
A description of special conditions relating to the delivery terms.

Example value: Customer pick up

Delivery location information

Delivery terms location
The location to which the delivery terms refer. Used to qualify the delivery terms e.g. "Terms of delivery are FOB Rotterdam"

Example value: København

Delivery address information

Address line 1
The main address line in an address.Usually the street name and number or post office box.

Example value: Hovedgade 1

Address line 1
An additional address line in an address that can be used to give further details supplementing the main line.

City
The common name of a city where the address is located.

Example value: København

Post code
The identifier for an addressable group of properties according to the relevant postal service, such as a ZIP code or Post Code.

Example value: 1550

Country subdivision
The subdivision of a country such as region, county, state, province etc.

Address line

Address line 3
An additional address line in an address that can be used to give further details supplementing the main line.

Example value: Gate 34

Country

Country code
A code that identifies the country.The lists of valid countries are registered with the ISO 3166-1 Maintenance agency, "Codes for the representation of names of countries and their subdivisions". Codes must be according to the alpha-2 representation.

Example value: NL

Allowance or charge information
Information on allowance and/or charges applies to the whole order agreement and is included in the calculation of the order agreement total amount.

Charge indicator
Boolean indicator, charge ='true', allowance = 'false'

Example value: false

Document level allowance or charge reason code
The reason for the document level allowance or charge, expressed as a code. For allowances a subset of codelist UNCL5189 is to be used, and for charges codelist UNCL7161 applies. The Document level allowance reason code and the Document level allowance reason shall indicate the same allowance reason

Example value: 95

Allowance or charge reason
The reason for the allowance or charge, expressed as text.

Example value: Discount

Document level allowance or charge percentage
The percentage that may be used, in conjunction with the document level allowance base amount, to calculate the document level allowance or charge amount. To state 20%, use value 20.

Example value: 20

Allowance or charge amount
The allowance or charge amount (net amount).

Example value: 200

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Document level allowance or charge base amount
The base amount that may be used, in conjunction with the document level allowance or charge percentage, to calculate the document level allowance or charge amount. Must be rounded to maximum 2 decimals

Example value: 1000

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there

Example value: EUR

TAX CATEGORY

Document level allowance or charge TAX category code
A coded identification of what TAX category applies to the document level allowance or charge.

Example value: S

Document level allowance or charge TAX rate
The TAX rate, represented as percentage that applies to the document level allowance or charge.

Example value: 25.00

Tax scheme information

Tax scheme. E.g. “VAT” or “GST”

Example value: VAT or GST

Tax total information

TAX total amount
The total TAX amount.The sum of all TAX category tax amounts.

Example value: 250

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

TAX breakdown
A group of business terms providing information about TAX breakdown by different categories, rates and exemption reasons

TAX category taxable amount
Sum of all taxable amounts subject to a specific TAX category code and TAX category rate (if the TAX category rate is applicable). The sum of line net amounts minus allowances plus charges on document level which are subject to a specific TAX categorycode and TAX category rate (if the TAX category rate is applicable).

Example value: 1000

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

TAX category tax amount
The total TAX amount for a given TAX category.Calculated by multiplying the TAX category taxable amount with the TAX category rate for the relevant TAX category.

Example value: 1000

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

TAX category information

TAX category code
Coded identification of a TAX category.

Example value: S

TAX category rate
The TAX rate, represented as percentage that applies for the relevant TAX category.A TAX rate of 0% is applied for calculation purposes, even if the item is outside the scope of TAX.

Example value: 25

TAX exemption reason text
A textual statement of the reason for why the base amount is exempted from TAX.

Example value: Exempt

Tax scheme information

Tax scheme. E.g. “VAT” or “GST”

Example value: VAT or GST

Document totals

Sum of line amounts
Sum of all line amounts in the document.

Example value: 1200

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Total amount without TAX
The total amount of the document without TAX including all line net amounts minus sum of allowance amount on document level plus sum of charges on document level.

Example value: 1000

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Total amount with TAX
The total amount of the document with TAX. The total amount with TAX is the Total amount without TAX plus the Total TAX amount. The Total amount shall be equal or greater than zero.

Example value: 1250

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Sum of allowances on document level
Sum of all allowances on document levelAllowances on line level are included in the line amount which is summed up into the "sum of line net amount".

Example value: 200

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Sum of charges on document level
Sum of all charges on document level.Charges on line level are included in the line amount which is summed up into the "sum of line net amount".

Example value: 0

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Paid amounts
The sum of amounts which have been paid a-priori.

Example value: 500

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Rounding of document total
Any rounding of the "Document total including TAX"

Example value: 0.13

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Amount due for payment
The outstanding amount that is requested to be paid.This amount is the "document total amount with TAX" minus the "Paid amount" that has been paid a-priori. The amount will be zero in case the document total amount with TAX is fully paid .

Example value: 750

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Order agreement line information

Line item information

Order agreement line identifier
An identifier for an individual line that is unique within an order agreement.

Example value: 1

Order agreement line note
Free-form text applying to the order agreement line.

Example value: Example text of this order agreement line

Ordered quantity
The number of item units that are ordered.

Example value: 10

Ordered quantity unit of measure
The unit of measure that applies to the ordered quantity.

Example value: C62

Order agreeement line amount
Order agreeement line amountThe total amount for the order agreement line, including all taxes except TAX.

Example value: 1000

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Delivery information on order agreeement line level

Accepted quantity
The number of item units that are delivered.

Example value: 10

Accepted quantity unit of measure
The unit of measure that applies to the accepted quantity.

Example value: C62

Promised delivery period for the order agreement line

Period start date
The date when the period starts. Must be formatted YYYY-MM-DD

Example value: 2018-05-15

Period start time
The start time of the period. Format = "hh:mm:ss"

Example value: 11:00:00

Period end date
The date on which the period ends.The date is the last day of the period. Must be formatted YYYY-MM-DD

Example value: 2018-05-15

Period end time
The end time of the period. Format = "hh:mm:ss"

Example value: 12:00:00

Price information

Item net price
The price of an item, exclusive of TAX, after subtracting item price discount."The net price has to be equal with the gross price less the item price discount.

Example value: 100

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Item price base quantity
The number of item units to which the price applies.

Example value: 1

Base quantity unit of measure
The unit of measure that applies to the base quantity.

Example value: C62

Price type
The type of the item price. The type may be given by using codes from UN/CEFACT code list 5387.

Price discount information
Information on discounts connected to the price

AllowanceChargeIndicator
Only discounts are allowed for the price, hence the only valid value is false (meaning an allowance)

Fixed value: false

Discount amount
Discount amount connected to the price

Example value: 200

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Item list price
The gross price of the item before subtracting discounts. E.g. list price.

Example value: 200

Currency identifier, if element "Order agreement currency" (tir110-007) is used, this attribute must be the same code as used there.

Example value: EUR

Item information

Item description
Free-form field that can be used to give a text description of the item. A detailed description of the item.

Example value: Window 23", double glass

Item name
A name for an item. A short name given to an item, such as a name from a Catalogue, as distinct from a description.

Example value: Window

Buyers item identification

Buyers item identifier
An identifier, assigned by the buyer, for the item. Associates the item with its identification according to the buyer's system.

Example value: 111111

Sellers item identification

The Sellers item identifier
An identifier, assigned by the seller, for the item. Associates the item with its identification according to the seller's system.

Example value: 3249834

Standard item identification

Item standard identifier
An item identifier based on a registered scheme. Associates the item with its identification according to a standard system.

Example value: 05704066204093

Item standard identifier identification scheme identifier
The identification scheme identifier of the Item standard identifier

Example value: 0160

Item document references

Document identifier
Identifier of a document

Example value: docid7687

External Item Specifications Type
A functional description of the attachment/image expressed as code

Document description
Textual description of the document.

Example value: Picture of window

Attachment information

Attached document
The attached document embeded as binary object, coded as Base64. The binary object has two supplementary components: a Mime Code, which specifies the Mime type of the attachment and a Filename that is provided by (or on behalf of) the sender of the document

Example value: QklTIE9yZGVyIEFncmVlbWVudCAtIDQyQQ==

Attached document Mime code
The mime code of the attached document.

Example value: application/pdf

Attached document Filename
The file name of the attached document

Example value: Hours-spent.pdf

External reference

External document URI
The Uniform Resource Identifier (URI) that identifies where the external document is located.

Example value: http://www.example.com/index.html

Commodity classification information

Item classification code
A code for classifying the item by its type or nature. Classification codes are used to allow grouping of similar items for a various purposes e.g. public procurement (CPV), e-Commerce (UNSPSC) etc.

Example value: 16B

Item classification identifier identification scheme identifier
The identification scheme identifier of the Item classification identifier

Example value: MP

Item classification identifier version identification scheme identifier
The identification scheme version identifier of the Item classification identifier

Example value: 20.0601

Clear text name equivalent of classification code
The textual equivalent of the code value

Example value: Office furniture

Contracted item

Contracted item indicator
The code CT indicates that the item is offered in accordance to the referenced contract.

Fixed value: CT

Line TAX information

Item TAX category code
The TAX category code for the item.

Example value: S

Line TAX rate
The TAX percentage rate that applies to the line amount.

Example value: 25

Tax scheme information

Tax scheme. E.g. “VAT” or “GST”

Example value: VAT or GST

Additional item property information
A group of business terms providing information about properties of the goods and services invoiced.

Item property name
The name of the property.The name must be sufficiently descriptive to define the value. The definition may be supplemented with the property unit of measure when relevant.

Example value: Color

Item property code
Code for the item property according to a property code system.

Name code list id.
An identifier for the code list used for the Name code, this is bilaterally agreed

Item property value
The value of the item property.

Example value: Red

Item property unit of measure
The unit of measure in which the property value is stated, if relevant. May not be relevant when properties are descriptive.

Value quantity unit of measure
The unit of measure that applies to the value quantity.

Property classification
Standardized and predefined classification of items properties.

Item label information
Information about the items environmental, social, ethical and quality type of labelling.

Item label name
The name of the product label.

Example value: EU EcoLabel

Certificate type code
The UBL structure used for item labeling requires this elements, use the value NA.

Fixed value: NA

Item label type
The label type such environmental, quality, social etc.

Example value: Environmental

Item label value
The label value that applies to the item.

Example value: Item label value

Issuer party information

Party name

Issuer name
The UBL structure used for item labeling requires this elements, use the value NA.

Example value: NA

Label document

Item label reference
A reference to where the label specification can be found, e.g. a URI.

Example value: http://www.label.eu/test/