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 at https://big.btwentyfour.com/codes#id10

 <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): 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): Terms of delivery

Any specific terms of delivery set by the buyer.

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

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

Text 3700
(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 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
(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
(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
(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