Order transmission interface (PurchaseOrder)
With the purchase order interface, you can process Unite orders faster and more efficiently.
Explanation of transmitted information
The following data is transmitted by Unite for each order:
Information on header level
Description | openTRANS segment | Specifications |
Order number | ORDER_ID | Max. 21 characters; must be used as a reference number in every transaction. For more information about the order number, see the EDI interface overview page. |
Buyer address | BUYER_PARTY | Address of the ordering customer (buyer), including PARTY_ID and VAT ID (depending on delivery country). For regular orders (via Spotmarket and Single Creditor BusinessShops), this refers to the respective Unite entity. |
Supplier specific customer ID | BUYER_PARTY/PARTY_ID | Used to assign the order to your specific customer account. |
Supplier address | SUPPLIER_PARTY | Supplier’s address, including PARTY_ID. |
Unite supplier number | SUPPLIER_PARTY/PARTY_ID | Please include the supplier number on every response document. |
Invoice address | INVOICE_PARTY | Address of the invoice recipient (identical to BUYER_PARTY). |
Delivery address | DELIVERY_PARTY | Delivery address of the goods recipient (customer). Note: The name fields within the address lines (NAME, NAME2, NAME3) may contain up to 70 characters each. |
Information on item level (line level)
Description | openTRANS segment | Specifications |
Line item number | LINE_ITEM_ID | |
Article number | SUPPLIER_AID | Article number from your submitted catalogue. May also be used for shipping cost items. |
Unite article number | BUYER_AID | Derived from SUPPLIER_AID with a Unite catalogue prefix. |
Quantity ordered | QUANTITY | |
Order unit | ORDER_UNIT | |
Unit price | PRICE_AMOUNT | Net unit price of the item based on the price quantity (see PRICE_QUANTITY). |
Total price | PRICE_LINE_AMOUNT | Net total price for the item line (PRICE_LINE_AMOUNT = PRICE_AMOUNT × QUANTITY ÷ PRICE_QUANTITY). |
Price quantity | PRICE_QUANTITY | Quantity on which the unit price (PRICE_AMOUNT) is based. If the quantity is 1, this field is not transmitted. |
Supported formats and transport protocols
Unite uses the proven openTRANS data format to transfer orders to your system in an automated and error-free way. The Unite standard is based on openTRANS 1.0 (ORDER).
Further supported formats and transport protocols are listed on the EDI interface overview page.
Sample files for order transmission
Below you’ll find sample files with comments and specifications:
Order using openTRANS Order
For orders placed via the Spotmarket or Single Creditor BusinessShops, Unite acts as both the buyer and invoice recipient.
Order using openTRANS C-Order
For orders from an Exclusive Catalogue or BusinessShop (transacting service: order forwarding), the end customer acts as the buyer, including an individual customer ID.