Versions Compared

Key

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

Main functions

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

  2. 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.
    (warning) For the addresses, take into account the maximum number of characters and map into other address fields/lines where necessary.

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

  4. Transmission of order items and expected purchase prices (excl. VAT) for suppliers and sales prices (excl. VAT) for dealers.
    (warning) If the transmitted price cannot be accepted, our purchasing department must be contacted.

  5. Transmission of our estimated or desired arrival date per item (DELIVERY_END_DATE)
    (warning) We provide the arrival date at the consignee, not the desired delivery date.

Info

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.

InfoArrival date (DELIVERY_DATE) Anchordddd
  • 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

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

  • 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

Expand
titleSchema
Image Removed

Example files Order Placement (ORDP)

XML Element

Sample values

Data type [maxLength]

M/C/S

Description

ORDER

-

-

Must

Main function

Transmission of the order.

Info

Warehouse locations incl. GLN

warehouse locations CH & EU

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

Must

Order placement date

. . ORDER_INFO

Must

-

-

Must

. . . ORDER_ID

Must

9316271

dtSTRING[

250

25]

Must

Galaxus purchase order ID

. . . ORDER_DATE

Must

2017-09-22T15:30:33

dtDATETIME

Must

Date of order entry at Digitec Galaxus

. . . LANGUAGE

Must

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

-

-

Must

. . . . . PARTY_ID

Must

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 value can be

a value chosen from your side for example our customer number with you

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]

Must

Four PARTY_ROLES are possible:

buyer
supplier
delivery

(Goods recipient)


marketplace

With

For suppliers, the buyer is always Digitec Galaxus AG

With merchantsNAME

For dealers, the buyer is always the end customer

. . . . . ADDRESS

Must

-

-

Must

For a suggestion on address mapping cf. also Order address mapping

(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

Can *

For 

Company name

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

For EU-Hub

Partners we always transmit Galaxus Deutschland GmbH here (also for private customers) here

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

Can

For the attention of

. . . . . . NAME3

Can

Block A

dtMLSTRING[50]

BMEcat NS

Can

Building

. . . . . . DEPARTMENT

Can

Accounting

dtMLSTRING[50]

BMEcat NS

Can

Department

. . . . . . CONTACT_DETAILS

Can

-

-

-

. . . . . . . TITLE

Can

TITLE

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Can

Salutation


Will be transmitted differently

(depending on the language of the

client

customer)

. . . . . . . FIRST_NAME

Can *

Ulla

dtMLSTRING[50]

BMEcat NS

Can *

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

. . . . . . . CONTACT_NAME

Can *

Mustermann

dtMLSTRING[50]

BMEcat NS

Can *

ZIP

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

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

of address or post office box

. . . . . . BOXNO

Can

7

dtMLSTRING[20]

BMEcat NS

Can

P.O.

Box

box number


The

(the text P.O.

Box

box must be added to the address label)

. . . . . . CITY

Must

Zürich

dtMLSTRING[50]

BMEcat NS

Must

City

. . . . . . COUNTRY

Schweiz

Must

Schweiz, Deutschland, Liechtenstein, Österreich

dtMLSTRING[50]

BMEcat NS

Must

Country

– submitted

(transmitted in German only

.
Possible values are for example Schweiz, Deutschland and Liechtenstein

)

. . . . . . COUNTRY_CODED

Must

CH, DE, LI, AT

dtCOUNTRIES

BMEcat NS

MustPHONE

Country code according ISO 3166-1 ALPHA-2

Possible values are for example CH, DE, AT and LI

. . . . . . PHONE

Can

0448447700

dtMLSTRING[50]

BMEcat NS

Can

Phone number

. . . . . . EMAIL

Must

spmpartnerresponses@digitecgalaxus

noreply@galaxus.ch, noreply@galaxus.de

dtSTRING[255]

BMEcat NS

Must

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
Image Added

. . . . . . VAT_ID

Can

CHE-109.049.266

dtMLSTRING[50]

BMEcat NS

Can

Currently,

VAT number (currently only for supplier orders the VAT_ID of our commercial register address is

only displayed

transmitted in the PARTY_ROLE

buyer for supplier orders.

=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.
Must be printed on the paper delivery note for direct deliveries.

. . . ORDER_PARTIES_REFERENCE

Must

-

-

Must

. . . . BUYER_IDREF

Must

2045638

dtSTRING[250]

BMEcat NS

Must

Galaxus internal customer

ID

ID

. . . . SUPPLIER_IDREF

Must

1928008

dtSTRING[250]

BMEcat NS

Must

Galaxus internal partner ID

. . . CURRENCY

Must

CHF, EUR

dtCURRENCIES

BMEcat NS

Must

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
(warning) A company name or first and last name can exist for both private_customer and business_customer.

private_customer
company

. . . . UDX.DG.DELIVERY_TYPE

Must

direct_delivery

dtSTRING[250]

Must

Delivery type:

direct_delivery

 = direct delivery 


warehouse_

delivery = warehouse

delivery

. . . . UDX.DG.SATURDAY_DELIVERY_ALLOWED

Can

true, false

dtBOOLEAN

Can

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

-Zone (e.g. Germany) we transmit always false. Therefor please ignore this and deliver

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

Must

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]

Can

Order reference for direct deliveries of business end customers (max. 150 characters).
Must be

clearly visible

printed on the paper delivery note.

. . . . UDX.DG.PHYSICAL_DELIVERY_NOTE_REQUIRED

Must

false, true

dtBOOLEAN

Must

true = Delivery must contain a paper delivery note
false = Delivery must not 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

-

-

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

from Data Preparation Stage 1

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

(info) GTIN-8,-12,-13 are converterd to GTIN-14

on our end

(by adding leading zeroes)

. . . . BUYER_PID

Must

6406567

dtSTRING[50]

BMEcat NS

Must

Galaxus

internal

product

ID

key

. . . . DESCRIPTION_SHORT

Must

Fingerring, Herr der Ringe

dtMLSTRING[150]

BMEcat NS

Must

Galaxus internal product name (without brand)

. . . QUANTITY

Must

2

dtNUMBER

Must

Item

Position

position quantity

. . . ORDER_UNIT

Must

C62

dtPUNIT[2]

BMEcat NS

Must

Always C62 (hardcoded), unit = piece

. . . PRODUCT_PRICE_FIX

Must

-

-

Must

. . . . PRICE_AMOUNT

Must

12.59

dtNUMBER

BMEcat NS

Must

Unit price excl. VAT

PurchasePriceExclVat / SalesPriceExclVat from Data Preparation Stage 1

. . . . TAX_DETAILS_FIX

Must

-

-

Must

. . . . . TAX_AMOUNT

Must

0.97

dtNUMBER

Must

VAT amount per piece

. . . PRICE_LINE_AMOUNT

Must

25.18

dtNUMBER

Must

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
type="fixed": Fixed order - delivery exactly on 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

PRICE_LINE_AMOUNTs excl. VAT