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 |
|
/b24Message/order/@orderType |
Text | 1000 | ||
(Header): Currency | The currency in which the price information in the order is specified. |
|
/b24Message/order/@currency |
Text | 1100 | ||
(Header): EDI message name | The name of the EDI message |
|
/b24Message/order/@text |
Text | 1200 | ||
(Header): Btwentyfour message ID | Message ID set by Btwentyfour Open Commerce Platform |
|
/b24Message/order/@messageId |
Number | 1300 | ||
(Header): Btwentyfour message date | Message date set by Btwentyfour Open Commerce Platform |
|
/b24Message/order/@messageDate |
Date/Time | 1400 | ||
(Header): Sender | Yes | The sender of the EDI message, identified by a GLN. |
|
/b24Message/order/sender/@gln |
Number | 1500 | |
(Header): Recipient | Yes | The recipient of the EDI message, identified by a GLN. |
|
/b24Message/order/recipient/@gln |
Number | 1600 | |
(Header): Buyer Order date | The date when the order was issued by the buyer. |
|
/b24Message/order/documentReference[@documentType="BuyerOrder"]/@date |
Date/Time | 1700 | ||
(Header) : Buyer Order Number | Yes | The purchase order number set by the buyer. |
|
/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. |
|
/b24Message/order/documentReference[@documentType="ContractOrder"]/@id |
Text | 1900 | |
(Header) : Customer Order Date | No | The date the order was made by the ultimate Customer. |
|
/b24Message/order/documentReference[@documentType="ContractOrder"]/@date |
Date/Time | 2000 | |
(Header): Contract order number | No | Reference to the contract order number (if available). |
|
/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. |
|
/b24Message/order/documentReference[@documentType="b24OrderDraft"]/@id |
Text | 2200 | ||
(Header): Btwentyfour order draft Date | The date/time the order draft was created. |
|
/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. |
|
/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. |
|
/b24Message/order/documentReference[@documentType="b24Order"]/@date |
Date/Time | 2500 | ||
(Header): Season | The season code for the referred items |
|
/b24Message/order/property[@name="season"] |
Text | 2600 | ||
(Header): Requested Delivery Date | The requested date of delivery for the order, set by the buyer. |
|
/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…) |
|
/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…) |
|
/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. |
|
/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. |
|
/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. |
|
/b24Message/order/property[@name="allowBackOrder"] |
Yes/No | 3000 | ||
(Header): Customer order notes | Any specific notes related to the order. |
|
/b24Message/order/property[@name="customerOrderNotes"] |
Text | 3100 | ||
(Header): Customer Order Reference | Notes to be put on packing slip. |
|
/b24Message/order/property[@name="customerOrderRef"] |
Text | 3200 | ||
(Header): Purchaser | No | The name of the buying organization's responsible person for the purchase/purchase order. |
|
/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. |
|
/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. |
|
/b24Message/order/property[@name="purchasingAssistant"] | Text | 3260 | |
(Header): Purchasing Assistant Email | No | The email address of the buying organization's purchasing assistant. |
|
/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) |
|
/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. |
|
/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. |
|
/b24Message/order/property[@name="shippingDate"] |
Date/Time | 3500 | ||
(Header): Supplier generated order | Is the orders created by the supplier? |
|
/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") |
|
/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. |
|
/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. |
|
/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) |
|
/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. |
|
/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 |
|
/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 |
|
/b24Message/order/property[@name="orderGrossValue"] |
Number | 4000 | ||
(Header): Discount Percentage | Total discount percentage for the whole order, specified on header level. |
|
/b24Message/order/property[@name="discountPercentage"] |
Number | 4100 | ||
(Header): Discount Amount | Total discount amount for the whole order, specified on header level. |
|
/b24Message/order/property[@name="discountAmount"] |
Number | 4200 | ||
(Header): Invoicee GLN | The invoicee party, identified by a GLN. |
|
/b24Message/order/property[@name="invoicee"] |
Text | 4300 | ||
(Header): Invoicee Name | Name of the invoicee. |
|
/b24Message/order/property[@name="invoiceeName"] |
Text | 4400 | ||
(Header): Invoicee Name 2 | A second name field for the invoicee party |
|
/b24Message/order/property[@name="invoiceeName2"] |
Text | 4500 | ||
(Header): Invoicee Name 3 | A third name field for the invoicee party |
|
/b24Message/order/property[@name="invoiceeName3"] |
Text | 4600 | ||
(Header): Invoicee Address | Address of the invoicee. |
|
/b24Message/order/property[@name="invoiceeAddress"] |
Text | 4700 | ||
(Header): Invoicee Zip code | Zip code of the invoicee. |
|
/b24Message/order/property[@name="invoiceeCityCode"] |
Text | 4800 | ||
(Header): Payment Terms | No | The order's payment terms, specified in plain text. |
|
/b24Message/order/property[@name="paymentTerms"] |
Text | 4900 | |
(Header): Invoicee City | City of the invoicee. |
|
/b24Message/order/property[@name="invoiceeCity"] |
Text | 5000 | ||
(Header): Invoicee Country | Country of the invoicee. |
|
/b24Message/order/property[@name="invoiceeCountry"] |
Text | 5100 | ||
(Header): Invoicee Country Code | Country code of the invoicee. |
|
/b24Message/order/property[@name="invoiceeCountryCode"] |
Text | 5200 | ||
(Header): Invoicee Org No | Corporate identity number of the invoicee party. |
|
/b24Message/order/property[@name="invoiceeOrgNo"] |
Text | 5300 | ||
(Header): Invoicee VAT No | VAT number (value added tax number) of the invoicee party. |
|
/b24Message/order/property[@name="invoiceeVatNo"] |
Text | 5400 | ||
(Header): Invoicee Contact | Name of a invoicee. |
|
/b24Message/order/property[@name="invoiceeContact"] |
Text | 5500 | ||
(Header): Invoicee Phone Number | Telephone number of the invoicee. |
|
/b24Message/order/property[@name="invoiceeTelephoneNumber"] |
Text | 5600 | ||
(Header): Invoicee Email | An e-mail address of the invoicee. |
|
/b24Message/order/property[@name="invoiceeEmailAddress"] |
Text | 5700 | ||
(Header): Ultimate Consignee GLN | The party to which the goods are ultimately delivered, identified by a GLN. |
|
/b24Message/order/property[@name="ultimateConsignee"] |
Text | 5800 | ||
(Header): Ultimate Consignee Name | Name of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeName"] |
Text | 5900 | ||
(Header): Ultimate Consignee Name 2 | A second name field for the ultimate consignee party |
|
/b24Message/order/property[@name="ultimateConsigneeName2"] |
Text | 6000 | ||
(Header): Ultimate Consignee Name 3 | A third name field for the ultimate consignee party |
|
/b24Message/order/property[@name="ultimateConsigneeName3"] |
Text | 6100 | ||
(Header): Ultimate Consignee Address | Address of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeAddress"] |
Text | 6200 | ||
(Header): Ultimate Consignee Zip Code | Zip code of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeCityCode"] |
Text | 6300 | ||
(Header): Ultimate Consignee City | City of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeCity"] |
Text | 6400 | ||
(Header): Ultimate Consignee Country | Country of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeCountry"] |
Text | 6500 | ||
(Header): Ultimate Consignee Country Code | Country code of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeCountryCode"] |
Text | 6600 | ||
(Header): Ultimate Consignee Org No | Corporate identity number of the ultimate consignee party. |
|
/b24Message/order/property[@name="ultimateConsigneeOrgNo"] |
Text | 6700 | ||
(Header): Ultimate Consignee VAT No | VAT number (value added tax number) of the ultimate consignee party. |
|
/b24Message/order/property[@name="ultimateConsigneeVatNo"] |
Text | 6800 | ||
(Header): Ultimate Consignee Contact | Name of a ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeContact"] |
Text | 6900 | ||
(Header): Ultimate Consignee Phone number | Telephone number of the ultimate consignee. |
|
/b24Message/order/property[@name="ultimateConsigneeTelephoneNumber"] |
Text | 7000 | ||
(Header): Ultimate Consignee Email | An e-mail address of the ultimate consignee. |
|
/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. |
|
/b24Message/order/property[@name="ultimateCustomerName"] |
Text | 7200 | ||
(Header): Ultimate Customer Name 2 | A second name field for the ultimate customer party |
|
/b24Message/order/property[@name="ultimateCustomerName2"] |
Text | 7300 | ||
(Header): Ultimate Customer Name 3 | A third name field for the ultimate customer party |
|
/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). |
|
/b24Message/order/property[@name="ultimateCustomer"] |
Text | 7500 | ||
(Header): Ultimate Customer Address | Address of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerAddress"] |
Text | 7600 | ||
(Header): Ultimate Customer Zip Code | Zip code of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerCityCode"] |
Text | 7700 | ||
(Header): Ultimate Customer City | City of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerCity"] |
Text | 7800 | ||
(Header): Ultimate Customer Country | Country of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerCountry"] |
Text | 7900 | ||
(Header): Ultimate Customer Country Code | Country code of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerCountryCode"] |
Text | 8000 | ||
(Header): Ultimate Customer Phone number | Telephone number of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerTelephoneNumber"] |
Text | 8100 | ||
(Header): Ultimate Customer Email | An e-mail address of the ultimate customer. |
|
/b24Message/order/property[@name="ultimateCustomerEmailAddress"] |
Text | 8200 | ||
(Header): Supplier GLN | Yes | The supplier/brand, identified by a GLN. |
|
/b24Message/order/supplier/@gln |
Number | 8300 | |
(Header): Supplier Name | Name of the supplier party. |
|
/b24Message/order/supplier/@name |
Text | 8400 | ||
(Header): Supplier Name 2 | A second name field for the supplier party |
|
/b24Message/order/supplier/property[@name="name2"] |
Text | 8500 | ||
(Header): Supplier Name 3 | A third name field for the supplier party |
|
/b24Message/order/supplier/property[@name="name3"] |
Text | 8600 | ||
(Header): Supplier Address | Address of the supplier party. |
|
/b24Message/order/supplier/location/address |
Text | 8700 | ||
(Header): Supplier Address second row | Address of the supplier party, second row |
|
/b24Message/order/supplier/location/coAddress |
Text | 8800 | ||
(Header): Supplier Zip Code | Zip code of the supplier party. |
|
/b24Message/order/supplier/location/city/@code |
Text | 8900 | ||
(Header): Supplier City | City of the supplier party. |
|
/b24Message/order/supplier/location/city |
Text | 9000 | ||
(Header): Supplier State | State of the supplier party |
|
/b24Message/order/supplier/location/state |
Text | 9100 | ||
(Header): Supplier State Code | State code of the supplier party |
|
/b24Message/order/supplier/location/state/@code |
Text | 9200 | ||
(Header): Supplier Country | Country of the supplier party. |
|
/b24Message/order/supplier/location/country |
Text | 9300 | ||
(Header): Supplier Country Code | Country code of the supplier party. |
|
/b24Message/order/supplier/location/country/@code |
Text | 9400 | ||
(Header): Supplier Telephone Number | Telephone Number of the supplier party. |
|
/b24Message/order/supplier/location/telephoneNumber |
Text | 9500 | ||
(Header): Supplier Email Address | Email Address of the supplier party. |
|
/b24Message/order/supplier/location/emailAddress |
Text | 9600 | ||
(Header): Supplier external ID | External identifier, set by sender of the message |
|
/b24Message/order/supplier/property[@name="id"] |
Text | 9700 | ||
(Header): Supplier internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/order/supplier/property[@name="internalId"] |
Text | 9800 | ||
(Header): Buyer GLN | Yes | The buying party, identified by a GLN. |
|
/b24Message/order/buyer/@gln |
Number | 9900 | |
(Header): Buyer Name | Name of the buyer party. |
|
/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. |
|
/b24Message/orders/buyer/@department | Text | 10050 | |
(Header): Buyer Name 2 | A second name field for the buyer party |
|
/b24Message/order/buyer/property[@name="name2"] |
Text | 10100 | ||
(Header): Buyer Name 3 | A third name field for the buyer party |
|
/b24Message/order/buyer/property[@name="name3"] |
Text | 10200 | ||
(Header): Buyer Contact | Name of the buyer's contact/reference person. |
|
/b24Message/order/buyer/@contact |
Text | 10300 | ||
(Header): Buyer Address | Address of the buyer party. |
|
/b24Message/order/buyer/location/address |
Text | 10400 | ||
(Header): Buyer Address second row | Address of the buyer party, second row |
|
/b24Message/order/buyer/location/coAddress |
Text | 10500 | ||
(Header): Buyer Zip code | Zip code of the buyer party. |
|
/b24Message/order/buyer/location/city/@code |
Text | 10600 | ||
(Header): Buyer City | City of the buyer party. |
|
/b24Message/order/buyer/location/city |
Text | 10700 | ||
(Header): Buyer State | State of the buyer party |
|
/b24Message/order/buyer/location/state |
Text | 10800 | ||
(Header): Buyer State Code | State code of the buyer party |
|
/b24Message/order/buyer/location/state/@code |
Text | 10900 | ||
(Header): Buyer Country | Country of the buyer party. |
|
/b24Message/order/buyer/location/country |
Text | 11000 | ||
(Header): Buyer Country Code | Country code of the buyer party. |
|
/b24Message/order/buyer/location/country/@code |
Text | 11100 | ||
(Header): Buyer Telephone Number | Telephone Number of the buyer party. |
|
/b24Message/order/buyer/location/telephoneNumber |
Text | 11200 | ||
(Header): Buyer Email Address | Email Address of the buyer party. |
|
/b24Message/order/buyer/location/emailAddress |
Text | 11300 | ||
(Header): Buyer external ID | External identifier, set by sender of the message |
|
/b24Message/order/buyer/property[@name="id"] |
Text | 11400 | ||
(Header): Buyer internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/order/buyer/property[@name="internalId"] |
Text | 11500 | ||
(Header): Shipper GLN | The shipper/carrier of the goods, identified with a GLN |
|
/b24Message/order/shipper/@gln |
Number | 11600 | ||
(Header): Shipper Name | Name of the shipper/carrier |
|
/b24Message/order/shipper/@name |
Text | 11700 | ||
(Header): Shipper Name 2 | A second name field for the shipper party |
|
/b24Message/order/shipper/property[@name="name2"] |
Text | 11800 | ||
(Header): Shipper Name 3 | A third name field for the shipper party |
|
/b24Message/order/shipper/property[@name="name3"] |
Text | 11900 | ||
(Header): Shipper Address | Address of the shipper/carrier party |
|
/b24Message/order/shipper/location/address |
Text | 12000 | ||
(Header): Shipper Zip code | Zip code of the shipper/carrier party |
|
/b24Message/order/shipper/location/city/@code |
Text | 12100 | ||
(Header): Shipper City | City of the shipper/carrier party |
|
/b24Message/order/shipper/location/city |
Text | 12200 | ||
(Header): Shipper State | State of the shipper/carrier party |
|
/b24Message/order/shipper/location/state |
Text | 12300 | ||
(Header): Shipper State Code | State code of the shipper/carrier party |
|
/b24Message/order/shipper/location/state/@code |
Text | 12400 | ||
(Header): Shipper Country | Country of the shipper/carrier party |
|
/b24Message/order/shipper/location/country |
Text | 12500 | ||
(Header): Shipper Country Code | Country code of the shipper/carrier party |
|
/b24Message/order/shipper/location/country/@code |
Text | 12600 | ||
(Header): Shipper Telephone Number | Telephone Number of the shipper/carrier party. |
|
/b24Message/order/shipper/location/telephoneNumber |
Text | 12700 | ||
(Header): Shipper Email Address | Email Address of the shipper/carrier party. |
|
/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. |
|
/b24Message/order/consignee/@gln |
Number | 12900 | ||
(Header): Delivery party (Consignee) Name | Name of the delivery party/consignee. |
|
/b24Message/order/consignee/@name |
Text | 13000 | ||
(Header): Delivery party (Consignee) Name 2 | A second name field for the delivery party (Consignee) |
|
/b24Message/order/consignee/property[@name="name2"] |
Text | 13100 | ||
(Header): Delivery party (Consignee) Name 3 | A third name field for the delivery party (Consignee) |
|
/b24Message/order/consignee/property[@name="name3"] |
Text | 13200 | ||
(Header): Delivery party (Consignee) Address | Address of the delivery party/consignee. |
|
/b24Message/order/consignee/location/address |
Text | 13300 | ||
(Header): Delivery party (Consignee) Address second row | Address of the delivery party/consignee, second row |
|
/b24Message/order/consignee/location/coAddress |
Text | 13400 | ||
(Header): Delivery party (Consignee) Zip Code | Zip code of the delivery party/consignee. |
|
/b24Message/order/consignee/location/city/@code |
Text | 13500 | ||
(Header): Delivery party (Consignee) City | City of the delivery party/consignee. |
|
/b24Message/order/consignee/location/city |
Text | 13600 | ||
(Header): Delivery party (Consignee) State | State of the delivery party/consignee party |
|
/b24Message/order/consignee/location/state |
Text | 13700 | ||
(Header): Delivery party (Consignee) State Code | State code of the delivery party/consignee party |
|
/b24Message/order/consignee/location/state/@code |
Text | 13800 | ||
(Header): Delivery party (Consignee) Country | Country of the delivery party/consignee. |
|
/b24Message/order/consignee/location/country |
Text | 13900 | ||
(Header): Delivery party (Consignee) Country Code | Country code of the delivery party/consignee. |
|
/b24Message/order/consignee/location/country/@code |
Text | 14000 | ||
(Header): Delivery party (Consignee) Telephone Number | Telephone Number of the delivery party/consignee. |
|
/b24Message/order/consignee/location/telephoneNumber |
Text | 14100 | ||
(Header): Delivery party (Consignee) Email Address | Email Address of the delivery party/consignee. |
|
/b24Message/order/consignee/location/emailAddress |
Text | 14200 | ||
(Header): Delivery party (Consignee) external ID | External identifier, set by sender of the message |
|
/b24Message/order/consignee/property[@name="id"] |
Text | 14300 | ||
(Header): Delivery party (Consignee) internal ID | Internal identifier, mapped in the Btwentyfour Open Commerce Platform. |
|
/b24Message/order/consignee/property[@name="internalId"] |
Text | 14400 | ||
(Line/Item): Supplier Item ID | The supplier's unique item ID of the product. |
|
/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") |
|
/b24Message/order/item/@quantity |
Number | 14600 | |
(Line/Item): Requested delivery date product | The desired date of delivery for the product, set by the buyer. |
|
/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. |
|
/b24Message/order/item/property[@name="shippingDate"] |
Date/Time | 14800 | ||
(Line/Item): Buyer order number | Yes | The purchase order number set by the buyer. |
|
/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. |
|
/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 |
|
/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. |
|
/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. |
|
/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. |
|
/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 |
|
/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 |
|
/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"). |
|
/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. |
|
/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. |
|
/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) |
|
/b24Message/order/item/property[@name="portOfArrival"] | Text | 15660 | |
(Line/Item): Ultimate consignee GLN | GLN for ultimate delivery party. If different per item. |
|
/b24Message/order/item/property[@name="ultimateConsignee"] |
Number | 15700 | ||
(Line/Item): Ultimate consignee ID | External identifier for ultimate delivery party. If different per item. |
|
/b24Message/order/item/property[@name="ultimateConsigneeId"] |
Text | 15800 | ||
(Line/Item): Delivery party (Consignee) GLN | GLN for delivery party. If different per item. |
|
/b24Message/order/item/property[@name="consignee"] |
Number | 15900 | ||
(Line/Item): Delivery party (Consignee) ID | External identifier for delivery party. If different per item. |
|
/b24Message/order/item/property[@name="consigneeId"] |
Text | 16000 | ||
(Line/Item): Unit of measure | The unit of measure for the product: such as PCE, PAIR. |
|
/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 |
|
/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 |
|
/b24Message/order/item/property[@name="numUnits_CU_in_TU"] |
Number | 16300 | ||
(Line/Item): Brand | The brand of the product. |
|
/b24Message/order/item/property[@name="brand"] |
Text | 16400 | ||
(Line/Item): Description | Description of the product, preferably including: model name, colour and size. |
|
/b24Message/order/item/property[@name="description"] |
Text | 16500 | ||
(Line/Item): Goods Class | The goods class of the product - either FEDAS, B24 Product Category Keys |
|
/b24Message/order/item/property[@name="goodsClass"]@code |
Text | 16600 | ||
(Line/Item): Model number (style number) | The model number of the product. |
|
/b24Message/order/item/property[@name="modelNo"] |
Text | 16700 | ||
(Line/Item): Name | The name of the product. |
|
/b24Message/order/item/property[@name="name"] |
Text | 16800 | ||
(Line/Item): Category | The product category. |
|
/b24Message/order/item/property[@name="category"] |
Text | 16900 | ||
(Line/Item): VAT rate | The VAT rate for the product, set by the buyer. |
|
/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. |
|
/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. |
|
/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. |
|
/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"). |
|
/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. |
|
/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) |
|
/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). |
|
/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). |
|
/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). |
|
/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). |
|
/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). |
|
/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). |
|
/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). |
|
/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). |
|
/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. |
|
/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") |
|
/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 |
|
/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 |
|
/b24Message/order/item/property[@name="retailPromotion"]/@code |
Text | 18700 | ||
(Line/Item): Cancellation date | The date when the order item expires (cancellation date) |
|
/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) |
|
/b24Message/order/item/property[@name="customizedItem"] | Yes/No | 18850 | |
(Line/Item): Color description | Color description of the product |
|
/b24Message/order/item/dimension[@name="color"] |
Text | 18900 | ||
(Line/Item): Size | Size of the product |
|
/b24Message/order/item/dimension[@name="size"] |
Text | 19000 | ||
(Line/Item): Barcode | Yes | The supplier's EAN/UPC code of the product. |
|
/b24Message/order/item/itemReference[@registry="Supplier"] |
Number | 19100 | |
(Line/Item): Buyer Item ID | The buyer's unique item ID of the product. |
|
/b24Message/order/item/itemReference[@registry="Buyer" and @name="itemId"] |
Text | 19200 | ||
(Line/Item): Net price with currency | The net purchase price of the product. |
|
/b24Message/order/item/price[@type="netPrice"]/@value and @currency |
Number | 19300 | ||
(Line/Item): Gross price with currency | The gross purchase price of the product. |
|
/b24Message/order/item/price[@type="grossPrice"]/@value and @currency |
Number | 19400 | ||
(Line/Item): Discount Percentage | The discount percentage for the product. |
|
/b24Message/order/item/price[@type="discountPercentage"]/@value |
Number | 19500 | ||
(Line/Item): Discount Amount | Discount amount for one piece of the ordered item. |
|
/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. |
|
/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). |
|
/b24Message/order/item/price[@type="netSalesPriceExVAT"]/@value and @currency |
Number | 19800 |