Versions Compared

Key

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

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.

Info

Arrival date (DELIVERY_DATE)

Anchor
dd
dd

  • 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

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

buyer, supplier, delivery, marketplace

dtSTRING[20]

Must

Four PARTY_ROLES are possible:
buyer
supplier
delivery (Goods recipient)
marketplace

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
* = 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 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 ofattention 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
Will be transmitted differently depending on the language of the client

. . . . . . . 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
* = Either company name or first name and surname are mandatory

. . . . . . 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
The text P.O. Box must be added to the address labellabel

. . . . . . CITY

Zürich

dtMLSTRING[50]

BMEcat NS

Must

City

. . . . . . COUNTRY

Schweiz

dtMLSTRING[50]

BMEcat NS

Must

Country – submitted in German only.
Possible values are for example Schweiz, Deutschland and Liechtenstein

. . . . . . COUNTRY_CODED

CH

dtCOUNTRIES

BMEcat NS

Must

Country code according ISO 3166-1 ALPHA-2
Possible values are for example CH, DE, AT and LI

. . . . . . PHONE

0448447700

dtMLSTRING[50]

BMEcat NS

Can

Phone number

. . . . . . EMAIL

spmpartnerresponses@digitecgalaxus.ch

dtSTRING[255]

BMEcat NS

Must

Galaxus Email Address (hardcoded)
(warning) Please do not send any emails to this address, the mailbox is not maintainedis 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

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

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

. . . . UDX.DG.DELIVERY_TYPE

direct_delivery

dtSTRING[250]

Must

Delivery type:
direct_delivery = direct delivery 
warehouse_delivery = warehouse delivery

. . . . UDX.DG.SATURDAY_DELIVERY_ALLOWED

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 from Monday to Saturday.

. . . . UDX.DG.IS_COLLECTIVE_ORDER

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

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

. 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

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