xml ORDERS (Order)

The ORDERS message provides the ability for a buyer to order specified quantities of goods and services from a seller under conditions agreed between the seller and the buyer.

General usage

- A buyer may order for one or more goods items or services.
- A purchase order may refer to goods items or services related to one or more delivery schedules, call-offs, etc.
- A purchase order for cross-border transactions may contain additional information for customs and/or statistical purposes.
- A purchase order may contain details for transport and destination as well as delivery patterns.

Fields used in the ORDERS message

In the below table you find a comprehensive list of required and optional fields for Order data.

Name Required Description Examples XPATH Type Limits Sort
(Header): Order type

Specifies the type of order, see code list at https://big.btwentyfour.com/codes#id10

 
 <order text="Btwentyfour Example Order" environment="Production" orderType="PRE_ORDER" currency="SEK">

/b24Message/order/@orderType

 Text 100
(Header): Currency

The currency in which the price information in the order is specified.

 
 <order text="Btwentyfour Example Order" environment="Production" orderType="PRE_ORDER" currency="SEK">

/b24Message/order/@currency

 Text 200
(Header): EDI message name

The name of the EDI message

 
 <order text="Btwentyfour Example Order" environment="Production" orderType="PRE_ORDER" currency="SEK">

/b24Message/order/@text

 Text 300
(Header): Btwentyfour message ID

Message ID set by Btwentyfour Open Commerce Platform

 
 <order text="Btwentyfour Example Order" orderType="PRE_ORDER" currency="EUR" messageId="237356" messageDate="2020-08-25T12:19:05.167Z">

/b24Message/order/@messageId

 Number 400
(Header): Btwentyfour message date

Message date set by Btwentyfour Open Commerce Platform

 
 <order text="Btwentyfour Example Order" orderType="PRE_ORDER" currency="EUR" messageId="237356" messageDate="2020-08-25T12:19:05.167Z">

/b24Message/order/@messageDate

 Date/Time 500
(Header): Sender Yes

The sender of the EDI message, identified by a GLN.

 
 <sender gln="7340117836950" />

/b24Message/order/sender/@gln

 Number 600
(Header): Recipient Yes

The recipient of the EDI message, identified by a GLN.

 
 <recipient gln="7340117815580" />

/b24Message/order/recipient/@gln

 Number 700
(Header): Buyer Order date

The date when the order was issued by the buyer.

 
 <documentReference documentType="BuyerOrder" id="555666" date="2015-10-01">

/b24Message/order/documentReference[@documentType="BuyerOrder"]/@date

 Date/Time 800
(Header) : Buyer Order Number Yes

The purchase order number set by the buyer. 

 
<documentReference documentType="BuyerOrder" id="555666" date="2015-10-01">

 

 /b24Message/order/documentReference[@documentType="BuyerOrder"]/@id Text 850
(Header): Contract order number

Reference to the contract order number (if available).

 
 <documentReference documentType="ContractOrder" id="555666" date="2015-10-01">

/b24Message/order/documentReference[@documentType="ContractOrder"]/@id

 Text 900
(Header): Btwentyfour order draft number

Order draft number generated by Btwentyfour Open Commerce Platform.

 
 <documentReference documentType="b24OrderDraft" id="555666" date="2015-10-01">

/b24Message/order/documentReference[@documentType="b24OrderDraft"]/@id

 Text 1000
(Header): Btwentyfour order number

Order number generated by Btwentyfour Open Commerce Platform.

 
 <documentReference documentType="b24Order" id="555666" date="2015-10-01">

/b24Message/order/documentReference[@documentType="b24Order"]/@id

 Text 1100
(Header): Season

The season code for the referred items

 
 <property name="season">SS21</property>

/b24Message/order/property[@name="season"]

 Text 1200
(Header): Requested Delivery Date

The requested date of delivery for the order, set by the buyer.

 
 <property name="deliveryDate">2015-11-01</property>

/b24Message/order/property[@name="deliveryDate"]

 Date/Time 1400
(Header): Requested earlieast delivery date

The earliest requested date of delivery for the order, set by the buyer.

 
 <property name="earliestDeliveryDate">2015-11-01</property>

/b24Message/order/property[@name="earliestDeliveryDate"]

 Date/Time 1500
(Header): Requested latest delivery date

The latest requested date of delivery for the order, set by the buyer.

 
 <property name="latestDeliveryDate">2015-12-01</property>

/b24Message/order/property[@name="latestDeliveryDate"]

 Date/Time 1600
(Header): Allow Backorder

Indicates whether the buyer allows items to be back-ordered or not. If no, ("N"), then the whole order should be cancelled unless the seller cannot fulfill the the ordered quantities.

 
 <property name="allowBackOrder">N</property>

/b24Message/order/property[@name="allowBackOrder"]

 Yes/No 1700
(Header): Customer order notes

Any specific notes related to the order.

 
 <property name="customerOrderNotes">longer note made by Buyer to the supplier</property>

/b24Message/order/property[@name="customerOrderNotes"]

 Text 1800
(Header): Customer Order Reference

Notes to be put on packing slip.

 
 <property name="customerOrderRef">Note to be put on packing slip</property>

/b24Message/order/property[@name="customerOrderRef"]

 Text 1900
(Header): Gift Order

Indicates if the order is a gift order or not, Y=Yes/True, order is a gift, N=No/False, order is NOT a gift. (Any order not containing the gift-order field at all, is to be considered as NOT being a gift order)

 
 <property name="giftOrder">Y</property>

/b24Message/order/property[@name="giftOrder"]

 Yes/No 2000
(Header): Gift Message

Gift Message/personal greeting to be added to the order before delivery. Typical application scenario would be a B2C where consumer is buying a present and have the gift message specified for the intended gift recipient.

 
 <property name="giftMessage">I am so happy for you!</property>

/b24Message/order/property[@name="giftMessage"]

 Text 2100
(Header): Requested Shipping Date

The date for the ordered goods to be shipped/sent from the seller (supplier or manufacturer) to the buyer.

 
<property name="shippingDate">YYYY-MM-DD</property>

 

 /b24Message/order/property[@name="shippingDate"] Date/Time 2150
(Header): Supplier generated order

Is the orders created by the supplier?

 
 <property name="supplierGeneratedOrder">Y</property>

/b24Message/order/property[@name="supplierGeneratedOrder"]

 Yes/No 2200
(Header): Terms of delivery

Any specific terms of delivery set by the buyer.

 
 <property name="termsOfDelivery">instructional text</property>

/b24Message/order/property[@name="termsOfDelivery"]

 Text 2300
(Header): Shipping Type

The buyer's/consumer's chosen delivery service level when receiving the ordered goods via shipper/carrier.

 
 <property name="shippingType">Standard Pick up Point</property>

/b24Message/order/property[@name="shippingType"]

 Text 2400
(Header): Order net value

The total net value of the order, after discount is applied (the sum of netPrice multiplied by quantity for all items). Set by the buyer

 
 <property name="orderNetValue">540.00</property>

/b24Message/order/property[@name="orderNetValue"]

 Number 2500
(Header): Order gross value

The total gross value of the order, before discount is applied (the sum of grossPrice multiplied by quantity for all items). Set by the buyer

 
 <property name="orderGrossValue">600.00</property>

/b24Message/order/property[@name="orderGrossValue"]

 Number 2600
(Header): Discount Percentage

Total discount percentage for the whole order, specified on header level.

 
 <property name="discountPercentage">20.00</property>

/b24Message/order/property[@name="discountPercentage"]

 Number 2700
(Header): Discount Amount

Total discount amount for the whole order, specified on header level.

 
 <property name="discountAmount">36.00</property>

/b24Message/order/property[@name="discountAmount"]

 Number 2800
(Header): Invoicee GLN

The invoicee party, identified by a GLN.

 
 <property name="invoicee">invoiceeGLN</property>

/b24Message/order/property[@name="invoicee"]

 Text 3000
(Header): Invoicee Name

Name of the invoicee.

 
 <property name="invoiceeName">invoiceeName</property>

/b24Message/order/property[@name="invoiceeName"]

 Text 3100
(Header): Invoicee Name 2

A second name field for the invoicee party

 
 <property name="invoiceeName2">The second invoicee name</property>

/b24Message/order/property[@name="invoiceeName2"]

 Text 3200
(Header): Invoicee Name 3

A third name field for the invoicee party

 
 <property name="invoiceeName3">The third invoicee name</property>

/b24Message/order/property[@name="invoiceeName3"]

 Text 3300
(Header): Invoicee Address

Address of the invoicee.

 
 <property name="invoiceeAddress">invoiceeAddress</property>

/b24Message/order/property[@name="invoiceeAddress"]

 Text 3400
(Header): Invoicee Zip code

Zip code of the invoicee.

 
 <property name="invoiceeCityCode">invoiceeZipCode</property>

/b24Message/order/property[@name="invoiceeCityCode"]

 Text 3500
(Header): Payment Terms No

The order's payment terms, specified in plain text. 

 
<property name="paymentTerms">30 Days</property>

 

 /b24Message/order/property[@name="paymentTerms"] Text 3550
(Header): Invoicee City

City of the invoicee.

 
 <property name="invoiceeCity">invoiceeCity</property>

/b24Message/order/property[@name="invoiceeCity"]

 Text 3600
(Header): Invoicee Country

Country of the invoicee.

 
 <property name="invoiceeCountry">invoiceeCountryName</property>

/b24Message/order/property[@name="invoiceeCountry"]

 Text 3700
(Header): Invoicee Country Code

Country code of the invoicee.

 
 <property name="invoiceeCountryCode">invoiceeCountryCode</property>

/b24Message/order/property[@name="invoiceeCountryCode"]

 Text 3800
(Header): Invoicee Org No

Corporate identity number of the invoicee party.

 
 <property name="invoiceeOrgNo">invoiceeOrgNo</property>

/b24Message/order/property[@name="invoiceeOrgNo"]

 Text 3900
(Header): Invoicee VAT No

VAT number (value added tax number) of the invoicee party.

 
 <property name="invoiceeVatNo">invoiceeVatNumber</property>

/b24Message/order/property[@name="invoiceeVatNo"]

 Text 4000
(Header): Invoicee Contact

Name of a invoicee.

 
 <property name="invoiceeContact">invoiceeContact</property>

/b24Message/order/property[@name="invoiceeContact"]

 Text 4100
(Header): Invoicee Phone Number

Telephone number of the invoicee.

 
 <property name="invoiceeTelephoneNumber">invoiceeTelephoneNumber</property>

/b24Message/order/property[@name="invoiceeTelephoneNumber"]

 Text 4200
(Header): Invoicee Email

An e-mail address of the invoicee.

 
 <property name="invoiceeEmailAddress">invoiceeEmailAddress</property>

/b24Message/order/property[@name="invoiceeEmailAddress"]

 Text 4300
(Header): Ultimate Consignee GLN

The party to which the goods are ultimately delivered, identified by a GLN.

 
 <property name="ultimateConsignee">ultimateConsigneeGLN</property>

/b24Message/order/property[@name="ultimateConsignee"]

 Text 4400
(Header): Ultimate Consignee Name

Name of the ultimate consignee.

 
 <property name="ultimateConsigneeName">ultimateConsigneeName</property>

/b24Message/order/property[@name="ultimateConsigneeName"]

 Text 4500
(Header): Ultimate Consignee Name 2

A second name field for the ultimate consignee party

 
 <property name="ultimateConsigneeName2">The second ultimate consignee name</property>

/b24Message/order/property[@name="ultimateConsigneeName2"]

 Text 4600
(Header): Ultimate Consignee Name 3

A third name field for the ultimate consignee party

 
 <property name="ultimateConsigneeName3">The third ultimate consignee name</property>

/b24Message/order/property[@name="ultimateConsigneeName3"]

 Text 4700
(Header): Ultimate Consignee Address

Address of the ultimate consignee.

 
 <property name="ultimateConsigneeAddress">ultimateConsigneeAddress</property>

/b24Message/order/property[@name="ultimateConsigneeAddress"]

 Text 4800
(Header): Ultimate Consignee Zip Code

Zip code of the ultimate consignee.

 
 <property name="ultimateConsigneeCityCode">ultimateConsigneeZipCode</property>

/b24Message/order/property[@name="ultimateConsigneeCityCode"]

 Text 4900
(Header): Ultimate Consignee City

City of the ultimate consignee.

 
 <property name="ultimateConsigneeCity">ultimateConsigneeCity</property>

/b24Message/order/property[@name="ultimateConsigneeCity"]

 Text 5000
(Header): Ultimate Consignee Country

Country of the ultimate consignee.

 
 <property name="ultimateConsigneeCountry">ultimateConsigneeCountryName</property>

/b24Message/order/property[@name="ultimateConsigneeCountry"]

 Text 5100
(Header): Ultimate Consignee Country Code

Country code of the ultimate consignee.

 
 <property name="ultimateConsigneeCountryCode">ultimateConsigneeCountryCode</property>

/b24Message/order/property[@name="ultimateConsigneeCountryCode"]

 Text 5200
(Header): Ultimate Consignee Org No

Corporate identity number of the ultimate consignee party.

 
 <property name="ultimateConsigneeOrgNo">ultimateConsigneeOrgNo</property>

/b24Message/order/property[@name="ultimateConsigneeOrgNo"]

 Text 5300
(Header): Ultimate Consignee VAT No

VAT number (value added tax number) of the ultimate consignee party.

 
 <property name="ultimateConsigneeVatNo">ultimateConsigneeVatNumber</property>

/b24Message/order/property[@name="ultimateConsigneeVatNo"]

 Text 5400
(Header): Ultimate Consignee Contact

Name of a ultimate consignee.

 
 <property name="ultimateConsigneeContact">ultimateConsigneeContact</property>

/b24Message/order/property[@name="ultimateConsigneeContact"]

 Text 5500
(Header): Ultimate Consignee Phone number

Telephone number of the ultimate consignee.

 
 <property name="ultimateConsigneeTelephoneNumber">ultimateConsigneeTelephoneNumber</property>

/b24Message/order/property[@name="ultimateConsigneeTelephoneNumber"]

 Text 5600
(Header): Ultimate Consignee Email

An e-mail address of the ultimate consignee.

 
 <property name="ultimateConsigneeEmailAddress">ultimateConsigneeEmailAddress</property>

/b24Message/order/property[@name="ultimateConsigneeEmailAddress"]

 Text 5700
(Header): Ultimate Customer Name

Name of the customer to which the goods are ultimately delivered, identified by a name and address.

 
 <property name="ultimateCustomerName">ultimateCustomerName</property>

/b24Message/order/property[@name="ultimateCustomerName"]

 Text 5800
(Header): Ultimate Customer Name 2

A second name field for the ultimate customer party

 
 <property name="ultimateCustomerName2">The second ultimate customer name</property>

/b24Message/order/property[@name="ultimateCustomerName2"]

 Text 5900
(Header): Ultimate Customer Name 3

A third name field for the ultimate customer party

 
 <property name="ultimateCustomerName3">The third ultimate customer name</property>

/b24Message/order/property[@name="ultimateCustomerName3

 Text 6000
(Header): Ultimate Customer GLN

The GLN of the shop/marketplace where the ultimate customer purchased its ordered item(s).

 
 <property name="ultimateCustomer">ultimateCustomerGLN</property>

/b24Message/order/property[@name="ultimateCustomer"]

 Text 6100
(Header): Ultimate Customer Address

Address of the ultimate customer.

 
 <property name="ultimateCustomerAddress">ultimateCustomerAddress</property>

/b24Message/order/property[@name="ultimateCustomerAddress"]

 Text 6200
(Header): Ultimate Customer Zip Code

Zip code of the ultimate customer.

 
 <property name="ultimateCustomerCityCode">ultimateCustomerZipCode</property>

/b24Message/order/property[@name="ultimateCustomerCityCode"]

 Text 6300
(Header): Ultimate Customer City

City of the ultimate customer.

 
 <property name="ultimateCustomerCity">ultimateCustomerCity</property>

/b24Message/order/property[@name="ultimateCustomerCity"]

 Text 6400
(Header): Ultimate Customer Country

Country of the ultimate customer.

 
 <property name="ultimateCustomerCountry">ultimateCustomerCountryName</property>

/b24Message/order/property[@name="ultimateCustomerCountry"]

 Text 6500
(Header): Ultimate Customer Country Code

Country code of the ultimate customer.

 
 <property name="ultimateCustomerCountryCode">ultimateCustomerCountryCode</property>

/b24Message/order/property[@name="ultimateCustomerCountryCode"]

 Text 6600
(Header): Ultimate Customer Phone number

Telephone number of the ultimate customer.

 
 <property name="ultimateCustomerTelephoneNumber">ultimateCustomerTelephoneNumber</property>

/b24Message/order/property[@name="ultimateCustomerTelephoneNumber"]

 Text 6700
(Header): Ultimate Customer Email

An e-mail address of the ultimate customer.

 
 <property name="ultimateCustomerEmailAddress">ultimateCustomerEmailAddress</property>

/b24Message/order/property[@name="ultimateCustomerEmailAddress"]

 Text 6800
(Header): Supplier GLN Yes

The supplier/brand, identified by a GLN.

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier">

/b24Message/order/supplier/@gln

 Number 6900
(Header): Supplier Name

Name of the supplier party.

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier">

/b24Message/order/supplier/@name

 Text 7000
(Header): Supplier Name 2

A second name field for the supplier party

 
 <property name="name2">The second supplier name</property>

/b24Message/order/supplier/property[@name="name2"]

 Text 7100
(Header): Supplier Name 3

A third name field for the supplier party

 
 <property name="name3">The third supplier name</property>

/b24Message/order/supplier/property[@name="name3"]

 Text 7200
(Header): Supplier Address

Address of the supplier party.

 
 <address>StreetAddress</address>

/b24Message/order/supplier/location/address

 Text 7300
(Header): Supplier Address second row

Address of the supplier party, second row

 
 <coAddress>Street Address second row</coAddress>

/b24Message/order/supplier/location/coAddress

 Text 7400
(Header): Supplier Zip Code

Zip code of the supplier party.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/supplier/location/city/@code

 Text 7500
(Header): Supplier City

City of the supplier party.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/supplier/location/city

 Text 7600
(Header): Supplier State

State of the supplier party

 
 <state code="StateCode">StateName</state>

/b24Message/order/supplier/location/state

 Text 7700
(Header): Supplier State Code

State code of the supplier party

 
 <state code="StateCode">StateName</state>

/b24Message/order/supplier/location/state/@code

 Text 7800
(Header): Supplier Country

Country of the supplier party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/supplier/location/country

 Text 7900
(Header): Supplier Country Code

Country code of the supplier party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/supplier/location/country/@code

 Text 8000
(Header): Supplier Telephone Number

Telephone Number of the supplier party.

 
 <telephoneNumber>+45000000002</telephoneNumber>

/b24Message/order/supplier/location/telephoneNumber

 Text 8100
(Header): Supplier Email Address

Email Address of the supplier party.

 
 <emailAddress>supplier@email.com</emailAddress>

/b24Message/order/supplier/location/emailAddress

 Text 8200
(Header): Supplier external ID

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/order/supplier/property[@name="id"]

 Text 8300
(Header): Supplier internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/order/supplier/property[@name="internalId"]

 Text 8400
(Header): Buyer GLN Yes

The buying party, identified by a GLN.

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group" contact="Buyer's contact reference">

/b24Message/order/buyer/@gln

 Number 8500
(Header): Buyer Name

Name of the buyer party.

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group" contact="Buyer's contact reference">

/b24Message/order/buyer/@name

 Text 8600
(Header): Buyer Name 2

A second name field for the buyer party

 
 <property name="name2">The second buyer name</property>

/b24Message/order/buyer/property[@name="name2"]

 Text 8700
(Header): Buyer Name 3

A third name field for the buyer party

 
 <property name="name3">The third buyer name</property>

/b24Message/order/buyer/property[@name="name3"]

 Text 8800
(Header): Buyer Contact

Name of the buyer's contact/reference person.

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group" contact="Buyer's contact reference">

/b24Message/order/buyer/@contact

 Text 8900
(Header): Buyer Address

Address of the buyer party.

 
 <address>StreetAddress</address>

/b24Message/order/buyer/location/address

 Text 9000
(Header): Buyer Address second row

Address of the buyer party, second row

 
 <coAddress>Street Address second row</coAddress>

/b24Message/order/buyer/location/coAddress

 Text 9100
(Header): Buyer Zip code

Zip code of the buyer party.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/buyer/location/city/@code

 Text 9200
(Header): Buyer City

City of the buyer party.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/buyer/location/city

 Text 9300
(Header): Buyer State

State of the buyer party

 
 <state code="StateCode">StateName</state>

/b24Message/order/buyer/location/state

 Text 9400
(Header): Buyer State Code

State code of the buyer party

 
 <state code="StateCode">StateName</state>

/b24Message/order/buyer/location/state/@code

 Text 9500
(Header): Buyer Country

Country of the buyer party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/buyer/location/country

 Text 9600
(Header): Buyer Country Code

Country code of the buyer party.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/buyer/location/country/@code

 Text 9700
(Header): Buyer Telephone Number

Telephone Number of the buyer party.

 
 <telephoneNumber>+45000000001</telephoneNumber>

/b24Message/order/buyer/location/telephoneNumber

 Text 9800
(Header): Buyer Email Address

Email Address of the buyer party.

 
 <emailAddress>buyer@email.com</emailAddress>

/b24Message/order/buyer/location/emailAddress

 Text 9900
(Header): Buyer external ID

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/order/buyer/property[@name="id"]

 Text 10000
(Header): Buyer internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/order/buyer/property[@name="internalId"]

 Text 10100
(Header): Shipper GLN

The shipper/carrier of the goods, identified with a GLN

 
 <shipper gln="2222222222222" name="Shipper's name">

/b24Message/order/shipper/@gln

 Number 10200
(Header): Shipper Name

Name of the shipper/carrier

 
 <shipper gln="2222222222222" name="Shipper's name">

/b24Message/order/shipper/@name

 Text 10300
(Header): Shipper Name 2

A second name field for the shipper party

 
 <property name="name2">The second shipper name</property>

/b24Message/order/shipper/property[@name="name2"]

 Text 10400
(Header): Shipper Name 3

A third name field for the shipper party

 
 <property name="name3">The third shipper name</property>

/b24Message/order/shipper/property[@name="name3"]

 Text 10500
(Header): Shipper Address

Address of the shipper/carrier party

 
 <address>StreetAddress</address>

/b24Message/order/shipper/location/address

 Text 10600
(Header): Shipper Zip code

Zip code of the shipper/carrier party

 
 <city code="ZipCode">CityName</city>

/b24Message/order/shipper/location/city/@code

 Text 10700
(Header): Shipper City

City of the shipper/carrier party

 
 <city code="ZipCode">CityName</city>

/b24Message/order/shipper/location/city

 Text 10800
(Header): Shipper State

State of the shipper/carrier party

 
 <state code="StateCode">StateName</state>

/b24Message/order/shipper/location/state

 Text 10900
(Header): Shipper State Code

State code of the shipper/carrier party

 
 <state code="StateCode">StateName</state>

/b24Message/order/shipper/location/state/@code

 Text 11000
(Header): Shipper Country

Country of the shipper/carrier party

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/shipper/location/country

 Text 11100
(Header): Shipper Country Code

Country code of the shipper/carrier party

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/shipper/location/country/@code

 Text 11200
(Header): Shipper Telephone Number

Telephone Number of the shipper/carrier party.

 
 <telephoneNumber>+463333333333</telephoneNumber>

/b24Message/order/shipper/location/telephoneNumber

 Text 11300
(Header): Shipper Email Address

Email Address of the shipper/carrier party.

 
 <emailAddress>shipper@email.com</emailAddress>

/b24Message/order/shipper/location/emailAddress

 Text 11400
(Header): Delivery party (Consignee) GLN

The delivery party/consignee (the receiving party of the goods), identified by a GLN.

 
 <consignee gln="7340117804522" name="Delivery Party Name">

/b24Message/order/consignee/@gln

 Number 11500
(Header): Delivery party (Consignee) Name

Name of the delivery party/consignee.

 
 <consignee gln="7340117804522" name="Delivery Party Name">

/b24Message/order/consignee/@name

 Text 11600
(Header): Delivery party (Consignee) Name 2

A second name field for the delivery party (Consignee)

 
 <property name="name2">The second delivery party (Consignee) name</property>

/b24Message/order/consignee/property[@name="name2"]

 Text 11700
(Header): Delivery party (Consignee) Name 3

A third name field for the delivery party (Consignee)

 
 <property name="name3">The third delivery party (Consignee) name</property>

/b24Message/order/consignee/property[@name="name3"]

 Text 11800
(Header): Delivery party (Consignee) Address

Address of the delivery party/consignee.

 
 <address>StreetAddress</address>

/b24Message/order/consignee/location/address

 Text 11900
(Header): Delivery party (Consignee) Address second row

Address of the delivery party/consignee, second row

 
 <coAddress>Street Address second row</coAddress>

/b24Message/order/consignee/location/coAddress

 Text 12000
(Header): Delivery party (Consignee) Zip Code

Zip code of the delivery party/consignee.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/consignee/location/city/@code

 Text 12100
(Header): Delivery party (Consignee) City

City of the delivery party/consignee.

 
 <city code="ZipCode">CityName</city>

/b24Message/order/consignee/location/city

 Text 12200
(Header): Delivery party (Consignee) State

State of the delivery party/consignee party

 
 <state code="StateCode">StateName</state>

/b24Message/order/consignee/location/state

 Text 12300
(Header): Delivery party (Consignee) State Code

State code of the delivery party/consignee party

 
 <state code="StateCode">StateName</state>

/b24Message/order/consignee/location/state/@code

 Text 12400
(Header): Delivery party (Consignee) Country

Country of the delivery party/consignee.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/consignee/location/country

 Text 12500
(Header): Delivery party (Consignee) Country Code

Country code of the delivery party/consignee.

 
 <country code="CountryCode">CountryName</country>

/b24Message/order/consignee/location/country/@code

 Text 12600
(Header): Delivery party (Consignee) Telephone Number

Telephone Number of the delivery party/consignee.

 
 <telephoneNumber>+45000000003</telephoneNumber>

/b24Message/order/consignee/location/telephoneNumber

 Text 12700
(Header): Delivery party (Consignee) Email Address

Email Address of the delivery party/consignee.

 
 <emailAddress>consignee@email.com</emailAddress>

/b24Message/order/consignee/location/emailAddress

 Text 12800
(Header): Delivery party (Consignee) external ID

External identifier, set by sender of the message

 
 <property name="id">5122186</property>

/b24Message/order/consignee/property[@name="id"]

 Text 12900
(Header): Delivery party (Consignee) internal ID

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>

/b24Message/order/consignee/property[@name="internalId"]

 Text 13000
(Line/Item): Supplier Item ID

The supplier's unique item ID of the product.

 
 <item quantity="2" deliveryDate="2015-11-01" id="1000000002222">

/b24Message/order/item/@id

 Text 13100
(Line/Item): Ordered Quantity Yes

The ordered quantity of the product. (Must be a positive integer. Returns can be specified using orderType="RETURN_ORDER")

 
 <item quantity="2" deliveryDate="2015-11-01" id="1000000002222">

/b24Message/order/item/@quantity

 Number 13200
(Line/Item): Requested delivery date product

The desired date of delivery for the product, set by the buyer.

 
 <item quantity="2" deliveryDate="2015-11-01" id="1000000002222">

/b24Message/order/item/@deliveryDate

 Date/Time 13300
(Line/Item): Shipping Date

The date for the ordered item to be shipped from the seller (supplier or manufacturer) to the buyer.

 
 <property name="shippingDate">YYYY-MM-DD</property>  ?

/b24Message/order/item/property[@name="shippingDate"]

 Date/Time 13400
(Line/Item): Buyer order number Yes

The purchase order number set by the buyer.

 
 <documentReference documentType="BuyerOrder" id="555666" date="2015-10-01" lineNo="2">

/b24Message/order/item/documentReference[@documentType="BuyerOrder"]/@id

 Text 13500
(Line/Item): Buyer order line number Yes

The order line number of the product, set by the buyer.

 
 <documentReference documentType="BuyerOrder" id="555666" date="2015-10-01" lineNo="2">

/b24Message/order/item/documentReference[@documentType="BuyerOrder"]/@lineNo

 Text 13600
(Line/Item): Buyer order parent line number

Reference to TU line number, used in pack orders

 
 <documentReference documentType="BuyerOrder" id="Sample_PO0000105" date="2020-08-25" lineNo="2" parentLineNo="1">

/b24Message/order/item/documentReference[@documentType="BuyerOrder"]/@parentLineNo

 Text 13700
(Line/Item): Btwentyfour order line number

The order line number of the product, set by the Btwentyfour Open Commerce Platform.

 
 <documentReference documentType="b24Order" lineNo="0">

/b24Message/order/item/documentReference[@documentType="b24Order"]/@lineNo

 Number 13800
(Line/Item): Requested earlieast delivery date

The earliest requested date of delivery for the order, set by the buyer.

 
 <property name="earliestDeliveryDate">2020-09-17</property>

/b24Message/order/item/property[@name="earliestDeliveryDate"]

 Date/Time 13900
(Line/Item): Requested latest delivery date

The latest requested date of delivery for the order, set by the buyer.

 
 <property name="latestDeliveryDate">2020-09-21</property>

/b24Message/order/item/property[@name="latestDeliveryDate"]

 Date/Time 14000
(Line/Item): Order line net value

The net value of the order line (the sum of netPrice multiplied by quantity per item). Set by the buyer

 
 <property name="orderLineNetValue">180.00</property>

/b24Message/order/item/property[@name="orderLineNetValue"]

 Number 14100
(Line/Item): Order line gross value

The gross value of the order line (the sum of grossPrice multiplied by quantity per item). Set by the buyer

 
 <property name="orderLineGrossValue">200.00</property>

/b24Message/order/item/property[@name="orderLineGrossValue"]

 Number 14200
(Line/Item): Ultimate consignee GLN

GLN for ultimate delivery party. If different per item.

 
 <property name="ultimateConsignee">ultimateConsigneeGLN</property>

/b24Message/order/item/property[@name="ultimateConsignee"]

 Number 14300
(Line/Item): Ultimate consignee ID

External identifier for ultimate delivery party. If different per item.

 
 <property name="ultimateConsigneeId">0808</property>

/b24Message/order/item/property[@name="ultimateConsigneeId"]

 Text 14400
(Line/Item): Delivery party (Consignee) GLN

GLN for delivery party. If different per item.

 
 <property name="consignee">consigneeGLN</property>

/b24Message/order/item/property[@name="consignee"]

 Number 14500
(Line/Item): Delivery party (Consignee) ID

External identifier for delivery party. If different per item.

 
 <property name="consigneeId">0202</property>

/b24Message/order/item/property[@name="consigneeId"]

 Text 14600
(Line/Item): Unit of measure

The unit of measure for the product: such as PCE, PAIR.

 
 <property name="unitOfMeasure">PCE</property>

/b24Message/order/item/property[@name="unitOfMeasure"]

 Text 14700
(Line/Item): Logistic unit

The logistic unit: CU=consumer unit, TU=trade unit. Used for pack orders

 
 <property name="logisticUnit">CU</property>

/b24Message/order/item/property[@name="logisticUnit"]

 Text 14800
(Line/Item): Number of CU in TU

Quantity of the product within the TU, used in pack orders

 
 <property name="numUnits_CU_in_TU">2</property>

/b24Message/order/item/property[@name="numUnits_CU_in_TU"]

 Number 14900
(Line/Item): Brand

The brand of the product.

 
 <property name="brand" registry="Supplier">Brand</property>

/b24Message/order/item/property[@name="brand"]

 Text 15000
(Line/Item): Description

Description of the product, preferably including: model name, colour and size.

 
 <property name="description" registry="Supplier">Description</property>

/b24Message/order/item/property[@name="description"]

 Text 15100
(Line/Item): Goods Class

The goods class of the product - either FEDAS, B24 Product Category Keys

 
 <property name="goodsClass" code="200537" set="Fedas" registry="Supplier">200537</property>

/b24Message/order/item/property[@name="goodsClass"]@code

 Text 15200
(Line/Item): Model number (style number)

The model number of the product.

 
 <property name="modelNo" registry="Supplier">33546</property>

/b24Message/order/item/property[@name="modelNo"]

 Text 15300
(Line/Item): Name

The name of the product.

 
 <property name="name" registry="Supplier">Name</property>

/b24Message/order/item/property[@name="name"]

 Text 15400
(Line/Item): Category

The product category.

 
 <property name="category" code="00" registry="Supplier">Category</property>

/b24Message/order/item/property[@name="category"]

 Text 15500
(Line/Item): VAT rate

The VAT rate for the product, set by the buyer.

 
 <property name="VAT">25</property>

/b24Message/order/item/property[@name="VAT"]

 Number 15600
(Line/Item): Value Added Service label text

A specific label text (e.g. a product description) specified by the buyer for the supplier to print on the label/tag of the ordered item.

 
 <property name="VASLabelText">Value Added Service label text</property>

/b24Message/order/item/property[@name="VASLabelText"]

 Text 15700
(Line/Item): Value Added Service label barcode

A specific barcode issued by the buyer for the supplier to print on the label/tag of the ordered item.

 
 <property name="VASLabelBarcode">7313492579415</property>

/b24Message/order/item/property[@name="VASLabelBarcode"]

 Number 15800
(Line/Item): Value Added Service label barcode type

Specification of the barcode standard used by the buyer for the VASLabelBarcode (e.g. "EAN13" or "UPCA").

 
 <property name="VASLabelBarcodeType">EAN13</property>

/b24Message/order/item/property[@name="VASLabelBarcodeType"]

 Text 15900
(Line/Item): Value Added Service label price

The price specified by the buyer for the supplier to print on the label/tag of the ordered item.

 
 <property name="VASLabelPrice">10.00</property>

/b24Message/order/item/property[@name="VASLabelPrice"]

 Number 16000
(Line/Item): Value Added Service label currency

The currency referring to the label price specified by the buyer (ISO 4217 standard code to be used)

 
 <property name="VASLabelCurrency">EUR</property>

/b24Message/order/item/property[@name="VASLabelCurrency"]

 Text 16100
(Line/Item): Value Added Service 2nd label price

Second price specified by the buyer for the supplier to print on the label/tag of the ordered item (only used if more than one specified VAS label price).

 
 <property name="VASLabelPrice2">100.00</property>

/b24Message/order/item/property[@name="VASLabelPrice2"]

 Number 16200
(Line/Item): Value Added Service 2nd label currency

Currency referring to "VASLabelPrice2"/2nd label price specified by the buyer. (ISO 4217 code to be used).

 
 <property name="VASLabelCurrency2">SEK</property>

/b24Message/order/item/property[@name="VASLabelCurrency2"]

 Text 16300
(Line/Item): Value Added Service 3rd label price

Third price specified by the buyer for the supplier to print on the label/tag of the ordered item (only used if more than two specified VAS label prices).

 
 <property name="VASLabelPrice3">72</property>

/b24Message/order/item/property[@name="VASLabelPrice3"]

 Number 16400
(Line/Item): Value Added Service 3rd label currency

Currency referring to "VASLabelPrice3"/3rd label price specified by the buyer. (ISO 4217 code to be used).

 
 <property name="VASLabelCurrency3">DKK</property>

/b24Message/order/item/property[@name="VASLabelCurrency3"]

 Text 16500
(Line/Item): Value Added Service 4th label price

Fourth price specified by the buyer for the supplier to print on the label/tag of the ordered item (only used if more than three specified VAS label prices).

 
 <property name="VASLabelPrice4">104.00</property>

/b24Message/order/item/property[@name="VASLabelPrice4"]

 Number 16600
(Line/Item): Value Added Service 4th label currency

Currency referring to "VASLabelPrice4"/4th label price specified by the buyer. (ISO 4217 code to be used).

 
 <property name="VASLabelCurrency4">NOK</property>

/b24Message/order/item/property[@name="VASLabelCurrency4"]

 Text 16700
(Line/Item): Value Added Service 5th label price

Fifth price specified by the buyer for the supplier to print on the label/tag of the ordered item (only used if more than four specified VAS label prices).

 
 <property name="VASLabelPrice5">9.00</property>

/b24Message/order/item/property[@name="VASLabelPrice5"]

 Number 16800
(Line/Item): Value Added Service 5th label currency

Currency referring to "VASLabelPrice5"/5th label price specified by the buyer. (ISO 4217 code to be used).

 
 <property name="VASLabelCurrency5">GBP</property>

/b24Message/order/item/property[@name="VASLabelCurrency5"]

 Text 16900
(Line/Item): Gift Message

Gift Message/personal greeting to be added to the ordered item before delivery. Typical application scenario would be a B2C where consumer is buying a present and have the gift message specified for the intended gift recipient.

 
 <property name="giftMessage">I am so happy for you!</property>

/b24Message/order/item/property[@name="giftMessage"]

 Text 17000
(Line/Item): Trade Unit content

Text summary of what SKUs/items the ordered trade unit/pre pack should contain. (E.g. "S=2, M=4, L=4, XL=2")

 
 <property name="TU_Content">S=2, M=4, L=4, XL=2</property>

/b24Message/order/item/property[@name="TU_Content"]

 Text 17100
(Line/Item): Retail promotion

Name of the promotion or campaign the product are intended for. Example: SuperSale2021

 
 <property name="retailPromotion" code="SS21">SuperSale2021</property>

/b24Message/order/item/property[@name="retailPromotion"]

 Text 17200
(Line/Item): Retail promotion code

Code of the promotion or campaign the product are intended for. Example: SS21

 
 <property name="retailPromotion" code="SS21">SuperSale2021</property>

/b24Message/order/item/property[@name="retailPromotion"]/@code

 Text 17300
(Line/Item): Cancellation date

The date when the order item expires (cancellation date)

 
 <property name="cancellationDate">2022-01-01</property>

/b24Message/order/item/property[@name="cancellationDate"]

 Date/Time 17400
(Line/Item): Color description

Color description of the product

 
 <dimension name="color">Orange</dimension>

/b24Message/order/item/dimension[@name="color"]

 Text 17500
(Line/Item): Size

Size of the product

 
 <dimension name="size">42</dimension>

/b24Message/order/item/dimension[@name="size"]

 Text 17600
(Line/Item): Barcode with type Yes

The supplier's EAN/UPC code of the product.

 
 <itemReference registry="Supplier" coding="EAN13">7313492579415</itemReference>

/b24Message/order/item/itemReference[@registry="Supplier" and @coding="EAN13"]

 Number 17700
(Line/Item): Buyer Item ID

The buyer's unique item ID of the product.

 
 <itemReference registry="Buyer" name="itemId">998877</itemReference>

/b24Message/order/item/itemReference[@registry="Buyer" and @name="itemId"]

 Text 17800
(Line/Item): Net price with currency

The net purchase price of the product.

 
 <price type="netPrice" value="10.00" currency="SEK" />

/b24Message/order/item/price[@type="netPrice"]/@value and @currency

 Number 17900
(Line/Item): Gross price with currency

The gross purchase price of the product.

 
 <price type="grossPrice" value="10.00" currency="SEK" />

/b24Message/order/item/price[@type="grossPrice"]/@value and @currency

 Number 18000
(Line/Item): Discount Percentage

The discount percentage for the product.

 
 <price type="discountPercentage" value="5.00" />

/b24Message/order/item/price[@type="discountPercentage"]/@value

 Number 18100
(Line/Item): Discount Amount

Discount amount for one piece of the ordered item.

 
 <price type="discountAmount" value="10.00" currency="EUR"></price>

/b24Message/order/item/price[@type="discountAmount"]/@value and @currency

 Number 18200
(Line/Item): Net Sales Price

The Sales Price for one unit of the sold product after deducted discount/markdown, including VAT. Net Sales Price is typically applicable on B2C orders from a retailer/marketplace to the supplier of the product to show what the consumer has paid for the ordered item.

 
  <price type="netSalesPrice" value="25.00" currency="SEK">

/b24Message/order/item/price[@type="netSalesPrice"]/@value and @currency

 Number 18300
(Line/Item): Net Sales Price Ex. VAT

The Sales Price for one unit of the sold product after deducted discount/markdown, excluding VAT. Net Sales Price ex. VAT is typically applicable on B2C orders from a retailer/marketplace to the supplier of the product to indicate what the consumer has paid for the ordered item (after deduction of VAT).

 
  <price type="netSalesPriceExVAT" value="20.00" currency="SEK">

/b24Message/order/item/price[@type="netSalesPriceExVAT"]/@value and @currency

 Number 18400