Main functions
Transmission of order references for use in EDI response files and on paper delivery notes (cf. delivery note templates for warehouse delivery, direct delivery CH, direct delivery EU and marketplace direct delivery).
Transmission of the addresses of the parties involved: buyer and invoice address (PARTY_ROLE = buyer), seller (PARTY_ROLE = supplier) and delivery address (PARTY_ROLE = delivery). Optionally, a fourth party can be transmitted to transmit our customer number with you in the PARTY_ROLE = marketplace.
For the addresses, take into account the maximum number of characters and map into other address fields/lines where necessary.Transmission of the goods recipient's language (../LANGUAGE)
The language specifies the communication language with the goods recipient and should be used for the paper delivery note and the communication with the end customer. Possible values are our four shop languages: ger, eng, fra, ita (acc. to ISO-639-2/B)Transmission of order items and expected purchase prices (excl. VAT) for suppliers and sales prices (excl. VAT) for dealers.
If the transmitted price cannot be accepted, our purchasing department must be contacted.Transmission of our estimated or desired arrival date per item (DELIVERY_END_DATE)
We provide the arrival date at the consignee, not the desired delivery date.
Order references
Purchase order id (../ORDER_INFO/ORDER_ID)
Identifies the purchase order between us and you and is expected on all EDI response documents from us and on the paper delivery note for deliveries back to our warehouses.
Sales order id (../ORDER_INFO/CUSTOMER_ORDER_REFERENCE/ORDER_ID)
Only provided for direct deliveries (UDX.DG.DELIVERY_TYPE = direct_delivery) to end customers.
Identifies the sales order to the end customer and is displayed to him in our shop.
Should appear on the paper delivery note for the end customer, but not in the EDI response documents.
Order reference of business end customer (../ORDER_INFO/UDX.DG.END_CUSTOMER_ORDER_REFERENCE)
Only provided for direct deliveries (UDX.DG.DELIVERY_TYPE = direct_delivery) to business end customers.
Should appear on the paper delivery note for the end customer, not in the EDI response documents.
Arrival date (DELIVERY_DATE)
No DELIVERY_DATE provided
The item was transmitted without a stock or replenishment date (Data preparation Stage 1)
Delivery should be made as soon as possible
As soon as a delivery date is known, a delivery date update must take place (manually via CMI or via Order Response)
If the item is "End of Life" (EOL), it must be cancelled (manually via CMI or via Supplier Cancel Notification)
DELIVERY_DATE type=”optional”
The date corresponds to the calculated latest arrival date at the consignee's according to our calculated delivery time.
Delivery should be made as soon as possible for the delivery time compliance.
If the expected arrival date cannot be met, this must be communicated by means of a delivery date update (manually via CMI or Order Response)
DELIVERY_DATE type=”fixed” (dated order for warehouse deliveries)
The date is identical for all items
The delivery is expected exactly on this date
This date must be confirmed in the Order Response
Our commercial register and warehouse addresses incl. GLNs
CH (Digitec Galaxus AG): Commercial register address and bank details, Warehouse
EU (Galaxus Deutschland GmbH): Commercial register address and bank details, Warehouse
Changes to the ORDP
Customisation of the ORDP format or the element names is not possible. The only fields that can be freely selected/filled with a fixed (always the same) value are the PARTY_ID with the PARTY_ROLE marketplace and the PARTY_ID of type=gln in the PARTY_ROLE supplier.
For direct deliveries to end customers, their e-mail addresses are never transmitted, with the exception of orders for non-physical products such as warranty extensions or e-licences.
Documentation
Example files Order Placement (ORDP)
XML Element | Sample values | Data type [maxLength] | M/C/S | Description |
|---|---|---|---|---|
ORDER | - | - | Must | See Namespaces regarding the correct usage of namespaces. |
ORDER_HEADER | - | - | Must | |
CONTROL_INFO | - | - | Must | |
GENERATION_DATE | 2017-09-22T15:42:57 | dtDATETIME | Must | Order placement date |
ORDER_INFO | - | - | Must | |
ORDER_ID | 9316271 | dtSTRING[250] | Must | Galaxus purchase order ID |
ORDER_DATE | 2017-09-22T15:30:33 | dtDATETIME | Must | Date of order entry at Digitec Galaxus |
LANGUAGE | ger, eng, fra, ita | dtLANG BMEcat NS | Must | Language of end customer according to ISO-639-2/B, must be used on paper delivery notes and in RESPONSECOMMENTs. |
PARTIES | - | - | Must | |
PARTY | - | - | Must | |
PARTY_ID | 2045638, 7640151820008 CH, DE, AT (marketplace) | dtSTRING[250] BMEcat NS | Must | type="buyer_specific" is the- Galaxus internal customer ID, except with the PARTY_ROLE = marketplace where this can be a value chosen from your side for example our customer number with you type="gln" ist the GLN number (also known as ILN) of the commercial register address or of the warehouse address. Only transmitted if available Warehouse deliveries Direct deliveries (dealer & supplier) |
PARTY_ROLE | buyer, supplier, delivery, marketplace | dtSTRING[20] | Must | Four PARTY_ROLES are possible: With suppliers, the buyer is always Digitec Galaxus AG With merchants, the buyer is always the end customer |
ADDRESS | - | - | Must | For a suggestion on address mapping cf. also Order address mapping |
NAME | Mustermann GmbH | dtMLSTRING[50] BMEcat NS | Can * | Company name For EU-Hub Partners we always transmit Galaxus Deutschland GmbH here (also for private customers) here with the PARTY_ROLE = delivery For deliveries to our warehouses we state either Digitec Galaxus AG or Galaxus Deutschland GmbH here Also compare Example files Order placment |
NAME2 | Ulla Mustermann | dtMLSTRING[50] BMEcat NS | Can | For the attention of |
NAME3 | Block A | dtMLSTRING[50] BMEcat NS | Can | Building |
DEPARTMENT | Accounting | dtMLSTRING[50] BMEcat NS | Can | Department |
CONTACT_DETAILS | - | - | Can | |
TITLE | Mr., Ms. | dtMLSTRING[20] BMEcat NS | Can | Salutation |
FIRST_NAME | Ulla | dtMLSTRING[50] BMEcat NS | Can * | First name
|
CONTACT_NAME | Mustermann | dtMLSTRING[50] BMEcat NS | Can * | Last name |
STREET | Musterstrasse 200b | dtMLSTRING[50] BMEcat NS | Can | Street incl. No. |
ZIP | 8000 | dtMLSTRING[20] BMEcat NS | Must | ZIP code of address or post office box |
BOXNO | 7 | dtMLSTRING[20] BMEcat NS | Can | P.O. Box number |
CITY | Zürich | dtMLSTRING[50] BMEcat NS | Must | City |
COUNTRY | Schweiz | dtMLSTRING[50] BMEcat NS | Must | Country – submitted in German only. |
COUNTRY_CODED | CH | dtCOUNTRIES BMEcat NS | Must | Country code according ISO 3166-1 ALPHA-2 |
PHONE | 0448447700 | dtMLSTRING[50] BMEcat NS | Can | Phone number |
dtSTRING[255] BMEcat NS | Must | Galaxus Email Address (hardcoded) | ||
VAT_ID | CHE-109.049.266 | dtMLSTRING[50] BMEcat NS | Can | Currently, the VAT_ID of our commercial register address is only displayed in the PARTY_ROLE buyer for supplier orders. |
CUSTOMER_ORDER_REFERENCE | - | - | Can | Only transmitted for direct deliveries to end customers |
ORDER_ID | 10515922 | dtSTRING[250] | Can | End customer Galaxus order number. |
ORDER_PARTIES_REFERENCE | - | - | Must | |
BUYER_IDREF | 2045638 | dtSTRING[250] BMEcat NS | Must | Galaxus internal customer ID |
SUPPLIER_IDREF | 1928008 | dtSTRING[250] BMEcat NS | Must | Galaxus internal partner ID |
CURRENCY | CHF | dtCURRENCIES BMEcat NS | Must | Transaction currency according to ISO 4217:1995 |
HEADER_UDX | - | udxHEADER | Must | |
UDX.DG.CUSTOMER_TYPE | private_customer | dtSTRING[250] | Must | Customer type: |
UDX.DG.DELIVERY_TYPE | direct_delivery | dtSTRING[250] | Must | Delivery type: |
UDX.DG.SATURDAY_DELIVERY_ALLOWED | true, false | dtBOOLEAN | Can | Only transmitted with direct_delivery. For orders in the EU-Zone (e.g. Germany) we transmit always false. Therefor please ignore this and deliver from Monday to Saturday. |
UDX.DG.IS_COLLECTIVE_ORDER | true, false | dtBOOLEAN | Must | true = Collective order |
UDX.DG.END_CUSTOMER_ORDER_REFERENCE | A362799 | dtSTRING[150] | Can | Order reference of business end customers (max. 150 characters). Must be clearly visible on the paper delivery note. |
UDX.DG.PHYSICAL_DELIVERY_NOTE_REQUIRED | false, true | dtBOOLEAN | Must | true = Delivery must contain a paper delivery note 🌲 use this information to rescue some trees and reduce the CO₂ footprint. If you can not differantiate you must always add a paper delivery note to your deliveries. |
ORDER_ITEM_LIST | - | - | Must |
|
ORDER_ITEM | - | - | Must | |
LINE_ITEM_ID | 1 | dtSTRING[50] | Must | Continuous document line numbering, starting at «1». Is not needed in the answer documents. |
PRODUCT_ID | - | - | Must | At least 2 of the following 3 IDs will be sent |
SUPPLIER_PID | A375-129 | dtSTRING[32] BMEcat NS | Must | Partner specific item number (ProviderKey) from Data Preparation Stage 1 |
INTERNATIONAL_PID | 09783404175109 | dtSTRING[14] BMEcat NS | Can | GTIN-14 from Data Preparation Stage 1
|
BUYER_PID | 6406567 | dtSTRING[50] BMEcat NS | Must | Galaxus internal product ID |
DESCRIPTION_SHORT | Fingerring, Herr der Ringe | dtMLSTRING[150] BMEcat NS | Must | Galaxus internal product name (without brand) |
QUANTITY | 2 | dtNUMBER | Must | Item Position quantity |
ORDER_UNIT | C62 | dtPUNIT[2] BMEcat NS | Must | Always C62 (hardcoded), unit = piece |
PRODUCT_PRICE_FIX | - | - | Must | |
PRICE_AMOUNT | 12.59 | dtNUMBER BMEcat NS | Must | Unit price excl. VAT PurchasePriceExclVat / SalesPriceExclVat from Data Preparation Stage 1 |
TAX_DETAILS_FIX | - | - | Must | |
TAX_AMOUNT | 0.97 | dtNUMBER | Must | VAT amount |
PRICE_LINE_AMOUNT | 25.18 | dtNUMBER | Must | Unit Price excl. VAT * quantity |
DELIVERY_DATE | - | - | Can | See the introduction for the explanation of the different type attributes. |
DELIVERY_START_DATE | 2020-11-30T00:00:00 | dtDATETIME | Can | Arrival date at delivery address |
DELIVERY_END_DATE | 2020-11-30T00:00:00 | dtDATETIME | Can | Arrival date at delivery address |
ORDER_SUMMARY | - | - | Must | |
TOTAL_ITEM_NUM | 2 | dtCOUNT | Must | Sum of all QUANTITYs |
TOTAL_AMOUNT | 25.18 | dtNUMBER | Must | Sum of all Price Line Amounts excl. VAT |
GTIN-8,-12,-13 are converterd to GTIN-14 on our end by adding leading zeroes