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.
Info |
---|
Order references
|
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, WarehouseEU (Galaxus Deutschland GmbH): Commercial register address and bank details, Warehouse
Info |
---|
Changes to the ORDP
|
Documentation
Expand | ||
---|---|---|
| ||
Example files Order Placement (ORDP)
XML Element
Sample values
Data type [maxLength]
M/C/S
Description
ORDER
-
-
Main function
Transmission of the order.
Info |
---|
Warehouse locations incl. GLN |
Info |
---|
Link example files for direct deliveries to end customers and warehouse deliveries |
XML Element | M/C/S | Sample values | Data type [maxLength] | Description |
---|---|---|---|---|
ORDER | Must | - | - | See Namespaces regarding the correct usage of namespaces. |
. ORDER_HEADER | Must | - | - |
Must
. . CONTROL_INFO | Must | - | - |
Must
. . . GENERATION_DATE | Must | 2017-09-22T15:42:57 | dtDATETIME |
Order placement date | |||
. . ORDER_INFO | Must | - | - |
Must
. . . ORDER_ID | Must | 9316271 | dtSTRING[ |
25] |
Galaxus purchase order ID | |||
. . . ORDER_DATE | Must | 2017-09-22T15:30:33 | dtDATETIME |
Date of order entry at Digitec Galaxus | |||
. . . LANGUAGE | Must | ger, eng, fra, ita | dtLANG BMEcat NS |
Language of end customer according to ISO-639-2/B, must be used on paper delivery notes and in RESPONSECOMMENTs. | |||
. . . PARTIES | Must | - | - |
. . . . PARTY | Must |
- | - |
Must
. . . . . PARTY_ID | Must | 2045638, 7640151820008 CH, DE, AT (marketplace) | dtSTRING[250] BMEcat NS |
type="buyer_specific" is the |
Galaxus internal customer ID |
(except with the PARTY_ROLE = marketplace where this value can be |
customized) 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 | Must | buyer, supplier, delivery, marketplace | dtSTRING[20] |
Must
buyer |
|
For suppliers, the buyer is always Digitec Galaxus AG |
For dealers, the buyer is always the end customer | |||
. . . . . ADDRESS | Must | - | - |
Must
For a suggestion on address mapping cf. also Order address mapping
All address fields/combinations can occur with both UDX.DG.CUSTOMER_TYPE=private_customer and UDX.DG.CUSTOMER_TYPE=company | |||
. . . . . . NAME | Can * | Mustermann GmbH | dtMLSTRING[50] BMEcat NS |
Can *
Company name |
For EU-Hub |
partners 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, always Galaxus Deutschland GmbH is transmitted (also for private customers) | |||
. . . . . . NAME2 | Can | Ulla Mustermann | dtMLSTRING[50] BMEcat NS |
For the attention of | |||
. . . . . . NAME3 | Can | Block A | dtMLSTRING[50] BMEcat NS |
Can
Building | |||
. . . . . . DEPARTMENT | Can | Accounting | dtMLSTRING[50] BMEcat NS |
Department | |
. . . . . . CONTACT_DETAILS |
-
-
Can
Can | - | - | ||
. . . . . . . TITLE | Can | Mr., Ms. | dtMLSTRING[20] BMEcat NS |
Can
Will be transmitted differently
Salutation (depending on the language of the |
customer) | |||
. . . . . . . FIRST_NAME | Can * | Ulla | dtMLSTRING[50] BMEcat NS |
Can *
First name | |||
. . . . . . . CONTACT_NAME | Can * | Mustermann | dtMLSTRING[50] BMEcat NS |
Can *
Last name | |||
. . . . . . STREET | Can | Musterstrasse 200b | dtMLSTRING[50] BMEcat NS |
Can
Street incl. No.
Street and house number | |||
. . . . . . ZIP | Must | 8000 | dtMLSTRING[20] BMEcat NS |
Must
ZIP code |
. . . . . . BOXNO | Can | 7 | dtMLSTRING[20] BMEcat NS |
P.O. |
box number |
The
(the text P.O. |
box must be added to the address label) | |||
. . . . . . CITY | Must | Zürich | dtMLSTRING[50] BMEcat NS |
Must
City |
. . . . . . COUNTRY |
Must | Schweiz, Deutschland, Liechtenstein, Österreich | dtMLSTRING[50] BMEcat NS |
Country |
(transmitted in German only |
Possible values are for example Schweiz, Deutschland and Liechtenstein
) | |||
. . . . . . COUNTRY_CODED | Must | CH, DE, LI, AT | dtCOUNTRIES BMEcat NS |
Country code according ISO 3166-1 ALPHA-2 |
. . . . . . PHONE | Can | 0448447700 | dtMLSTRING[50] BMEcat NS |
Phone number | |
Must |
noreply@galaxus.ch, noreply@galaxus.de | dtSTRING[255] BMEcat NS |
Galaxus Email Address (hardcoded) |
| |||||
. . . . . . VAT_ID | Can | CHE-109.049.266 | dtMLSTRING[50] BMEcat NS |
Can
VAT number (currently only for supplier orders the VAT_ID of our commercial register address is |
transmitted in the PARTY_ROLE |
=buyer) | |||
. . . CUSTOMER_ORDER_REFERENCE | Can | - | - |
Can
Only transmitted for direct deliveries to end customers | |||
. . . . ORDER_ID | Can | 10515922 | dtSTRING[250] |
Can
End customer Galaxus order number. | |||
. . . ORDER_PARTIES_REFERENCE | Must | - | - |
Must
. . . . BUYER_IDREF | Must | 2045638 | dtSTRING[250] BMEcat NS |
Galaxus internal customer |
ID | |||
. . . . SUPPLIER_IDREF | Must | 1928008 | dtSTRING[250] BMEcat NS |
Galaxus internal partner ID | |||
. . . CURRENCY | Must | CHF, EUR | dtCURRENCIES BMEcat NS |
Transaction currency according to ISO 4217:1995 | |||
. . . HEADER_UDX | Must | - | udxHEADER |
Must
. . . . UDX.DG.CUSTOMER_TYPE | Must | private_customer | dtSTRING[250] |
Must
Customer type:
private_customer = private customer
company = company
A company name or first and last name can exist for both private_customer and business_customer.
private_customer | |||
. . . . UDX.DG.DELIVERY_TYPE | Must | direct_delivery | dtSTRING[250] |
Must
direct_delivery |
|
delivery | |||
. . . . UDX.DG.SATURDAY_DELIVERY_ALLOWED | Can | true, false | dtBOOLEAN |
Only transmitted with direct_delivery. |
|
For orders in the EU |
is always transmitted false. Therefore, please ignore and perform the package delivery from Monday to Saturday. | |||
. . . . UDX.DG.IS_COLLECTIVE_ORDER | Must | true, false | dtBOOLEAN |
true = Collective order | |
. . . . |
UDX.DG.END_CUSTOMER_ORDER_REFERENCE | Can | A362799 | dtSTRING[150] |
Order reference for direct deliveries of business end customers (max. 150 characters). |
printed on the paper delivery note. | |||
. . . . UDX.DG.PHYSICAL_DELIVERY_NOTE_REQUIRED | Must | false, true | dtBOOLEAN |
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.
If this cannot be distinguished, a delivery note must be included in each package. | |||
. ORDER_ITEM_LIST | Must | - | - |
| |||
. . ORDER_ITEM | Must | - | - |
Must
. . . LINE_ITEM_ID | Must | 1 | dtSTRING[50] |
Must
Continuous document line numbering, starting at «1». Is not needed in the answer documents. | |||
. . . PRODUCT_ID | Must | - | - |
Must
At least 2 of the following 3 IDs will be sent | |||
. . . . SUPPLIER_PID | Must | A375-129 | dtSTRING[32] BMEcat NS |
Must
Partner specific item number (ProviderKey) from Data Preparation Stage 1
Partner product key | |||
. . . . INTERNATIONAL_PID | Can | 09783404175109 | dtSTRING[14] BMEcat NS |
Can
GTIN-14 |
with leading zeros - is only transmitted if also included in the product data feed GTIN-8,-12,-13 are converterd to GTIN-14 |
(by adding leading zeroes) | |||
. . . . BUYER_PID | Must | 6406567 | dtSTRING[50] BMEcat NS |
Galaxus |
product |
key | |||
. . . . DESCRIPTION_SHORT | Must | Fingerring, Herr der Ringe | dtMLSTRING[150] BMEcat NS |
Galaxus internal product name (without brand) |
. . . QUANTITY | Must | 2 | dtNUMBER |
Item |
position quantity | |||
. . . ORDER_UNIT | Must | C62 | dtPUNIT[2] BMEcat NS |
Always C62 (hardcoded), unit = piece | |||
. . . PRODUCT_PRICE_FIX | Must | - | - |
Must
. . . . PRICE_AMOUNT | Must | 12.59 | dtNUMBER BMEcat NS |
Unit price excl. VAT |
PurchasePriceExclVat / SalesPriceExclVat from Data Preparation Stage 1
. . . . TAX_DETAILS_FIX | Must | - | - |
Must
. . . . . TAX_AMOUNT | Must | 0.97 | dtNUMBER |
VAT amount | |||
. . . PRICE_LINE_AMOUNT | Must | 25.18 | dtNUMBER |
Unit Price excl. VAT * quantity | |||
. . . DELIVERY_DATE | Can | - | - |
Can
See the introduction for the explanation of the different type attributes.
Latest delivery date according to calculated standard delivery time type="optional" (default): Always fastest possible delivery until this date | |||
. . . . DELIVERY_START_DATE | Can | 2020-11-30T00:00:00 | dtDATETIME |
Can
Arrival date at delivery address
Latest arrival date | |||
. . . . DELIVERY_END_DATE | Can | 2020-11-30T00:00:00 | dtDATETIME |
Can
Arrival date at delivery address
Same value as in DELIVERY_START_DATE | |||
. ORDER_SUMMARY | Must | - | - |
Must
. . TOTAL_ITEM_NUM | Must | 2 | dtCOUNT |
Must
Sum of all QUANTITYs | |||
. . TOTAL_AMOUNT | Must | 25.18 | dtNUMBER |
Must
Sum of all |
PRICE_LINE_AMOUNTs excl. VAT |