Body

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 of accepted values at https://big.btwentyfour.com/codes#id1

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

/b24Message/order/@orderType

Text 1000
(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 1100
(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 1200
(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 1300
(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 1400
(Header): Sender Yes

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

 <sender gln="7340117836950" /> 

/b24Message/order/sender/@gln

Number 1500
(Header): Recipient Yes

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

 <recipient gln="7340117815580" /> 

/b24Message/order/recipient/@gln

Number 1600
(Header): Buyer Order date

The date when the order was issued by the buyer.

 <documentReference documentType="BuyerOrder" id="555666" date="2020-08-25" /> 

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

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

The purchase order number set by the buyer.

 <documentReference documentType="BuyerOrder" id="555666" date="2020-08-25" /> 

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

Text 1800
(Header) : Customer Order Number No

A unique Id for the order made by the ultimate Customer. Primarily used for dropship orders and other cases where the order originates from an order made by a consumer, rather than the retailer themselves.

 <documentReference documentType="CustomerOrder" id="777888" date="2020-08-24" /> 

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

Text 1900
(Header) : Customer Order Date No

The date the order was made by the ultimate Customer.

 <documentReference documentType="CustomerOrder" id="777888" date="2020-08-24" /> 

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

Date/Time 2000
(Header): Contract order number No

Reference to the contract order number (if available).

 <documentReference documentType="ContractOrder" id="666777" date="2019-06-18" /> 

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

Text 2100
(Header): Btwentyfour order draft number

Order draft number generated by Btwentyfour Open Commerce Platform. It is created in one of two instances : either when the order was created using The Bwentyfour Open Commerce Platform UI, or when the order has failed to meet the recipient's validation rules, which creates a draft in the UI that can be altered to meet the requirements.

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

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

Text 2200
(Header): Btwentyfour order draft Date

The date/time the order draft was created.

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

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

Date/Time 2300
(Header): Btwentyfour order number

Order number generated by Btwentyfour Open Commerce Platform. It is created when the Order is read into the system.

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

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

Text 2400
(Header) : Btwentyfour Order Date

The date/time the order was originally read into the Btwentyfour Open Commerce Platform system.

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

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

Date/Time 2500
(Header): Season

The season code for the referred items

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

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

Text 2600
(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 2700
(Header) : Requested Earliest Shipping Date No

The earliest date for the ordered goods to be shipped/sent from the seller (supplier or manufacturer) to the buyer. (order should not be shipped earlier than…)

<property name="earliestShippingDate">2020-09-09</property>

 

/b24Message/despatchAdvice/property[@name="earliestShippingDate"] Date/Time 2750
(Header) : Requested Latest Shipping Date No

The latest date for the ordered goods to be shipped/sent from the seller (supplier or manufacturer) to the buyer. (order should not be shipped later than…)

<property name="latestShippingDate">2020-09-14</property>

 

/b24Message/order/property[@name="latestShippingDate"] Date/Time 2760
(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 2800
(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 2900
(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 3000
(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 3100
(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 3200
(Header): Purchaser No

The name of the buying organization's responsible person for the purchase/purchase order.

<property name="purchaser">FristName LastName</property>

 

/b24Message/order/property[@name="purchaser"] Text 3220
(Header): Purchaser Email Address No

The email address of the buying organization's purchaser/responsible person for the purchase order.

<property name="purchaserEmailAddress">name.lastname@comapny.org</property>

 

/b24Message/order/property[@name="purchaserEmailAddress"] Text 3240
(Header): Purchasing Assistant No

Name of person/resource assisting with the purchase/purchase order within the buying organization.

<property name="purchasingAssistant">FirstName LastName</property>

 

/b24Message/order/property[@name="purchasingAssistant"] Text 3260
(Header): Purchasing Assistant Email No

The email address of the buying organization's purchasing assistant.

<property name="purchasingAssistantEmailAddress">name.lastname@company.org</property>

 

/b24Message/order/property[@name="purchasingAssistantEmail"] Text 3280
(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 3300
(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 3400
(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 3500
(Header): Supplier generated order

Is the orders created by the supplier?

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

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

Yes/No 3600
(Header): Transportation Method No

The method/mode of transport used for the shipping the ordered goods (such as "Maritime/Sea", "Air", "Road")
 

<property name="transportationMethod" code="1">Maritime (Sea) transport</property>

 

/b24Message/order/property[@name="transportationMethod"] Text 3600
(Header): Incoterms No

Series of three-letter abbreviations/codes, indicating trade terms related to common contractual sales practices. Incoterms rules are intended to clearly communicate the tasks, costs, and risks associated with the global or international transportation and delivery of goods.
 

<property name="incoterms" code="DDP">Delivery Duty Paid</property>

 

/b24Message/order/property[@name="incoterms"]/@code Text 3650
(Header): Terms of Delivery No

Free text information/description about agreed/used delivery terms for ordered goods.

 <property name="termsOfDelivery">The seller hands over the goods once they have been imported and placed at the disposal of the buyer on the arriving means of transport, ready for unloading at the specified destination. The seller bears all costs and risks associated with transporting the goods to the specified place and shall clear the goods not only for export but also for import, pay all duties for export and import and complete all customs formalities.</property> 

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

Text N/A 3700
(Header): Port of Arrival No

The intended port of arrival/destination for the ordered goods. (Code = UN/LOCODE) 

<property name="portOfArrival" code="SEVFA">Västra Frölunda/Göteborg</property>

 

/b24Message/order/property[@name="portOfArrival"] Text 3750
(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 3800
(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 3900
(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 4000
(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 4100
(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 4200
(Header): Invoicee GLN

The invoicee party, identified by a GLN.

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

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

Text 4300
(Header): Invoicee Name

Name of the invoicee.

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

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

Text 4400
(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 4500
(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 4600
(Header): Invoicee Address

Address of the invoicee.

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

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

Text 4700
(Header): Invoicee Zip code

Zip code of the invoicee.

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

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

Text 4800
(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 4900
(Header): Invoicee City

City of the invoicee.

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

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

Text 5000
(Header): Invoicee Country

Country of the invoicee.

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

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

Text 5100
(Header): Invoicee Country Code

Country code of the invoicee.

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

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

Text 5200
(Header): Invoicee Org No

Corporate identity number of the invoicee party.

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

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

Text 5300
(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 5400
(Header): Invoicee Contact

Name of a invoicee.

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

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

Text 5500
(Header): Invoicee Phone Number

Telephone number of the invoicee.

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

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

Text 5600
(Header): Invoicee Email

An e-mail address of the invoicee.

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

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

Text 5700
(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 5800
(Header): Ultimate Consignee Name

Name of the ultimate consignee.

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

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

Text 5900
(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 6000
(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 6100
(Header): Ultimate Consignee Address

Address of the ultimate consignee.

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

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

Text 6200
(Header): Ultimate Consignee Zip Code

Zip code of the ultimate consignee.

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

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

Text 6300
(Header): Ultimate Consignee City

City of the ultimate consignee.

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

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

Text 6400
(Header): Ultimate Consignee Country

Country of the ultimate consignee.

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

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

Text 6500
(Header): Ultimate Consignee Country Code

Country code of the ultimate consignee.

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

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

Text 6600
(Header): Ultimate Consignee Org No

Corporate identity number of the ultimate consignee party.

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

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

Text 6700
(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 6800
(Header): Ultimate Consignee Contact

Name of a ultimate consignee.

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

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

Text 6900
(Header): Ultimate Consignee Phone number

Telephone number of the ultimate consignee.

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

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

Text 7000
(Header): Ultimate Consignee Email

An e-mail address of the ultimate consignee.

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

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

Text 7100
(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 7200
(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 7300
(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 7400
(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 7500
(Header): Ultimate Customer Address

Address of the ultimate customer.

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

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

Text 7600
(Header): Ultimate Customer Zip Code

Zip code of the ultimate customer.

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

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

Text 7700
(Header): Ultimate Customer City

City of the ultimate customer.

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

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

Text 7800
(Header): Ultimate Customer Country

Country of the ultimate customer.

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

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

Text 7900
(Header): Ultimate Customer Country Code

Country code of the ultimate customer.

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

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

Text 8000
(Header): Ultimate Customer Phone number

Telephone number of the ultimate customer.

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

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

Text 8100
(Header): Ultimate Customer Email

An e-mail address of the ultimate customer.

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

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

Text 8200
(Header): Supplier GLN Yes

The supplier/brand, identified by a GLN.

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

/b24Message/order/supplier/@gln

Number 8300
(Header): Supplier Name

Name of the supplier party.

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

/b24Message/order/supplier/@name

Text 8400
(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 8500
(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 8600
(Header): Supplier Address

Address of the supplier party.

 <address>StreetAddress</address> 

/b24Message/order/supplier/location/address

Text 8700
(Header): Supplier Address second row

Address of the supplier party, second row

 <coAddress>Street Address second row</coAddress> 

/b24Message/order/supplier/location/coAddress

Text 8800
(Header): Supplier Zip Code

Zip code of the supplier party.

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

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

Text 8900
(Header): Supplier City

City of the supplier party.

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

/b24Message/order/supplier/location/city

Text 9000
(Header): Supplier State

State of the supplier party

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

/b24Message/order/supplier/location/state

Text 9100
(Header): Supplier State Code

State code of the supplier party

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

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

Text 9200
(Header): Supplier Country

Country of the supplier party.

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

/b24Message/order/supplier/location/country

Text 9300
(Header): Supplier Country Code

Country code of the supplier party.

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

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

Text 9400
(Header): Supplier Telephone Number

Telephone Number of the supplier party.

 <telephoneNumber>+45000000002</telephoneNumber> 

/b24Message/order/supplier/location/telephoneNumber

Text 9500
(Header): Supplier Email Address

Email Address of the supplier party.

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

/b24Message/order/supplier/location/emailAddress

Text 9600
(Header): Supplier external ID

External identifier, set by sender of the message

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

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

Text 9700
(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 9800
(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 9900
(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 10000
(Header) Buyer Department No

The name of the department/organziational unit responsible for the purchase order within the buyer organization. 

<buyer gln="7340117836950" name="Btwentyfour Demo Buying Group"  contact="Buyer's contact reference" department="Btwentyfour Demo Buying Group, Running/Athletics Department">

 

/b24Message/orders/buyer/@department Text 10050
(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 10100
(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 10200
(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 10300
(Header): Buyer Address

Address of the buyer party.

 <address>StreetAddress</address> 

/b24Message/order/buyer/location/address

Text 10400
(Header): Buyer Address second row

Address of the buyer party, second row

 <coAddress>Street Address second row</coAddress> 

/b24Message/order/buyer/location/coAddress

Text 10500
(Header): Buyer Zip code

Zip code of the buyer party.

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

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

Text 10600
(Header): Buyer City

City of the buyer party.

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

/b24Message/order/buyer/location/city

Text 10700
(Header): Buyer State

State of the buyer party

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

/b24Message/order/buyer/location/state

Text 10800
(Header): Buyer State Code

State code of the buyer party

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

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

Text 10900
(Header): Buyer Country

Country of the buyer party.

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

/b24Message/order/buyer/location/country

Text 11000
(Header): Buyer Country Code

Country code of the buyer party.

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

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

Text 11100
(Header): Buyer Telephone Number

Telephone Number of the buyer party.

 <telephoneNumber>+45000000001</telephoneNumber> 

/b24Message/order/buyer/location/telephoneNumber

Text 11200
(Header): Buyer Email Address

Email Address of the buyer party.

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

/b24Message/order/buyer/location/emailAddress

Text 11300
(Header): Buyer external ID

External identifier, set by sender of the message

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

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

Text 11400
(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 11500
(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 11600
(Header): Shipper Name

Name of the shipper/carrier

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

/b24Message/order/shipper/@name

Text 11700
(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 11800
(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 11900
(Header): Shipper Address

Address of the shipper/carrier party

 <address>StreetAddress</address> 

/b24Message/order/shipper/location/address

Text 12000
(Header): Shipper Zip code

Zip code of the shipper/carrier party

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

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

Text 12100
(Header): Shipper City

City of the shipper/carrier party

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

/b24Message/order/shipper/location/city

Text 12200
(Header): Shipper State

State of the shipper/carrier party

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

/b24Message/order/shipper/location/state

Text 12300
(Header): Shipper State Code

State code of the shipper/carrier party

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

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

Text 12400
(Header): Shipper Country

Country of the shipper/carrier party

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

/b24Message/order/shipper/location/country

Text 12500
(Header): Shipper Country Code

Country code of the shipper/carrier party

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

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

Text 12600
(Header): Shipper Telephone Number

Telephone Number of the shipper/carrier party.

 <telephoneNumber>+463333333333</telephoneNumber> 

/b24Message/order/shipper/location/telephoneNumber

Text 12700
(Header): Shipper Email Address

Email Address of the shipper/carrier party.

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

/b24Message/order/shipper/location/emailAddress

Text 12800
(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 12900
(Header): Delivery party (Consignee) Name

Name of the delivery party/consignee.

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

/b24Message/order/consignee/@name

Text 13000
(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 13100
(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 13200
(Header): Delivery party (Consignee) Address

Address of the delivery party/consignee.

 <address>StreetAddress</address> 

/b24Message/order/consignee/location/address

Text 13300
(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 13400
(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 13500
(Header): Delivery party (Consignee) City

City of the delivery party/consignee.

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

/b24Message/order/consignee/location/city

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

State of the delivery party/consignee party

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

/b24Message/order/consignee/location/state

Text 13700
(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 13800
(Header): Delivery party (Consignee) Country

Country of the delivery party/consignee.

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

/b24Message/order/consignee/location/country

Text 13900
(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 14000
(Header): Delivery party (Consignee) Telephone Number

Telephone Number of the delivery party/consignee.

 <telephoneNumber>+45000000003</telephoneNumber> 

/b24Message/order/consignee/location/telephoneNumber

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

Email Address of the delivery party/consignee.

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

/b24Message/order/consignee/location/emailAddress

Text 14200
(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 14300
(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 14400
(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 14500
(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 14600
(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 14700
(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 14800
(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 14900
(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 15000
(Line/Item): Buyer order parent line number No

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 15100
(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 15200
(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 15300
(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 15400
(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 15500
(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 15600
(Item/Line): Transportation Method No

The method/mode of transport used for the shipping the ordered item (such as "Maritime/Sea", "Air", "Road").
 

<property name="transportationMethod" code="1">Maritime (Sea) transport</property>

 

/b24Message/order/item/property[@name="transportationMethod"] Text N/A 15610
(Item/Line): Incoterms No

Series of three-letter abbreviations, indicating trade terms related to common contractual sales practices. Incoterms rules are intended to clearly communicate the tasks, costs, and risks associated with the global or international transportation and delivery of goods.
 

<property name="incoterms" code="DDP">Delivery Duty Paid</property>

 

/b24Message/order/item/property[@name="incoterms"] Text 15620
(Item/Line): Terms of Delivery No

Free text information/description about agreed/used delivery terms for the ordered item.

<property name="termsOfDelivery">The seller hands over the goods once they have been imported and placed at the disposal of the buyer on the arriving means of transport, ready for unloading at the specified destination. The seller bears all costs and risks associated with transporting the goods to the specified place and shall clear the goods not only for export but also for import, pay all duties for export and import and complete all customs formalities.</property> 

 

/b24Message/order/item/property[@name="termsOfDelivery"] Text 15650
(Item/Line): Port of Arrival No

The intended port of arrival/destination for the ordered item. (Code = UN/LOCODE) 
 

<property name="portOfArrival" code="SEVFA">Västra Frölunda/Göteborg</property>

 

/b24Message/order/item/property[@name="portOfArrival"] Text 15660
(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 15700
(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 15800
(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 15900
(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 16000
(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 16100
(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 16200
(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 16300
(Line/Item): Brand

The brand of the product.

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

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

Text 16400
(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 16500
(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 16600
(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 16700
(Line/Item): Name

The name of the product.

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

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

Text 16800
(Line/Item): Category

The product category.

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

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

Text 16900
(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 17000
(Item/Line): VAS Label Catalog Name No

The buyer's internal catalog reference for ordered products. To be printed by the supplier on the label/tag of the ordered item.

<property name="VASLabelCatalogName">Team 2022</property>

 

/b24Message/order/item/property[@name="VASLabelCatalogName"] Text 17050
(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 17100
(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 17200
(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 17300
(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 17400
(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 17500
(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 17600
(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 17700
(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 17800
(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 17900
(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 18000
(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 18100
(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 18200
(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 18300
(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 18400
(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 18500
(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 18600
(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 18700
(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 18800
(Item/Line): Customized Item No

Indicates whether the ordered item is customized by the customer/consumer. (Y/N)

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

 

/b24Message/order/item/property[@name="customizedItem"] Yes/No 18850
(Line/Item): Color description

Color description of the product

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

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

Text 18900
(Line/Item): Size

Size of the product

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

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

Text 19000
(Line/Item): Barcode Yes

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

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

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

Number 19100
(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 19200
(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 19300
(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 19400
(Line/Item): Discount Percentage

The discount percentage for the product.

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

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

Number 19500
(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 19600
(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 19700
(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 19800