Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Main function

Transmission of the order.

Info

Warehouse locations incl. GLN

warehouse locations CH & EU

image-20240104-125254.png
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

-

-

. . CONTROL_INFO

Must

-

-

. . . GENERATION_DATE

Must

2017-09-22T15:42:57

dtDATETIME

Order placement date

. . ORDER_INFO

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

-

-

. . . . . 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
For PARTY_ROLE = marketplace and UDX.DG.DELIVERY_TYPE = warehouse_delivery PARTY_ID corresponds to COUNTRY_CODED of PARTY_ROLE = buyer (CH for Switzerland or DE for the whole EU)

Direct deliveries (dealer & supplier)
If PARTY_ROLE = marketplace and UDX.DG.DELIVERY_TYPE = direct_delivery, PARTY_ID corresponds to the country of the sales portal (ISO 3166-2)

. . . . . PARTY_ROLE

Must

buyer, supplier, delivery, marketplace

dtSTRING[20]

buyer
supplier
delivery
marketplace

For suppliers, the buyer is always Digitec Galaxus AG
For dealers, the buyer is always the end customer

. . . . . ADDRESS

Must

-

-

(warning) 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

Company name

For EU-Hub partners with the PARTY_ROLE = delivery, 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

Building

. . . . . . DEPARTMENT

Can

Accounting

dtMLSTRING[50]

BMEcat NS

Department

. . . . . . CONTACT_DETAILS

Can

-

-

. . . . . . . TITLE

Can

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Salutation (depending on the language of the customer)

. . . . . . . FIRST_NAME

Can *

Ulla

dtMLSTRING[50]

BMEcat NS

First name
* = Either company name or first name and surname are mandatory

. . . . . . . CONTACT_NAME

Can *

Mustermann

dtMLSTRING[50]

BMEcat NS

Last name
* = Either company name or first name and surname are mandatory

. . . . . . STREET

Can

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Street and house number

. . . . . . ZIP

Must

8000

dtMLSTRING[20]

BMEcat NS

ZIP code

. . . . . . BOXNO

Can

7

dtMLSTRING[20]

BMEcat NS

P.O. box number (the text P.O. box must be added to the address label)

. . . . . . CITY

Must

Zürich

dtMLSTRING[50]

BMEcat NS

City

. . . . . . COUNTRY

Must

Schweiz, Deutschland, Liechtenstein, Österreich

dtMLSTRING[50]

BMEcat NS

Country (transmitted in German only)

. . . . . . 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

. . . . . . EMAIL

Must

noreply@galaxus.ch, noreply@galaxus.de

dtSTRING[255]

BMEcat NS

Galaxus Email Address (hardcoded)
(warning) Please do not send any emails to this address, the mailbox is not maintained
(question) The email address of the end customer can be viewed in the CMI if required (carrier notification, service case):

Expand
titleClick here to expand

. . . . . . VAT_ID

Can

CHE-109.049.266

dtMLSTRING[50]

BMEcat NS

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

-

-

Only transmitted for direct deliveries to end customers

. . . . ORDER_ID

Can

10515922

dtSTRING[250]

End customer Galaxus order number.
Must be printed on the paper delivery note for direct deliveries.

. . . ORDER_PARTIES_REFERENCE

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

. . . . UDX.DG.CUSTOMER_TYPE

Must

private_customer

dtSTRING[250]

private_customer
company

. . . . UDX.DG.DELIVERY_TYPE

Must

direct_delivery

dtSTRING[250]

direct_delivery
warehouse_delivery

. . . . UDX.DG.SATURDAY_DELIVERY_ALLOWED

Can

true, false

dtBOOLEAN

Only transmitted with direct_delivery.
true = Saturday delivery allowed, delivery from Monday to Saturday if possible
false = Saturday delivery not allowed, no delivery on Saturday

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
false = No collective order
Internal field with no relevance for order processing

. . . . UDX.DG.END_CUSTOMER_ORDER_REFERENCE

Can

A362799

dtSTRING[150]

Order reference for direct deliveries of business end customers (max. 150 characters).
Must be printed on the paper delivery note.

. . . . UDX.DG.PHYSICAL_DELIVERY_NOTE_REQUIRED

Must

false, true

dtBOOLEAN

true = Delivery must contain a paper delivery note
false = Delivery must not contain a paper delivery note

If this cannot be distinguished, a delivery note must be included in each package.

. ORDER_ITEM_LIST

Must

-

-

 

. . ORDER_ITEM

Must

-

-

. . . LINE_ITEM_ID

Must

1

dtSTRING[50]

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

Must

A375-129

dtSTRING[32]

BMEcat NS

Partner product key

. . . . INTERNATIONAL_PID

Can

09783404175109

dtSTRING[14]

BMEcat NS

GTIN-14 with leading zeros - is only transmitted if also included in the product data feed

(info) 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

-

-

. . . . PRICE_AMOUNT

Must

12.59

dtNUMBER

BMEcat NS

Unit price excl. VAT

. . . . TAX_DETAILS_FIX

Must

-

-

. . . . . TAX_AMOUNT

Must

01.9702

dtNUMBER

VAT amount per piece

. . . PRICE_LINE_AMOUNT

Must

25.18

dtNUMBER

Unit Price excl. VAT * quantity

. . . DELIVERY_DATE

 Can

-

-

Latest delivery date according to calculated standard delivery time

type="optional" (default): Always fastest possible delivery until this date
type="fixed": Fixed order - delivery exactly on this date

. . . . DELIVERY_START_DATE

Can

2020-11-30T00:00:00

dtDATETIME

Latest arrival date

. . . . DELIVERY_END_DATE

Can

2020-11-30T00:00:00

dtDATETIME

Same value as in DELIVERY_START_DATE

. ORDER_SUMMARY

Must

-

-

. . TOTAL_ITEM_NUM

Must

2

dtCOUNT

Sum of all QUANTITYs

. . TOTAL_AMOUNT

Must

25.18

dtNUMBER

Sum of all PRICE_LINE_AMOUNTs excl. VAT