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
|
Info | ||||||
---|---|---|---|---|---|---|
Arrival date (DELIVERY_DATE)
|
Info |
---|
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 |
Info |
---|
Changes to the ORDP
|
Documentation
Expand | ||
---|---|---|
| ||
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 * = Either company name or first name and surname are mandatory |
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 GTIN-8,-12,-13 are converterd to GTIN-14 on our end by adding leading zeroes |
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 |