Versions Compared

Key

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

Main functionsfunction

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

    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]

    M/C/S

    Description

    ORDER

    Must

    -

    -

    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

    -

    -

    Must

    . . . . PARTY

    Must

    -

    -

    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 merchants

    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

    , 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

    -

    -

    Can

    . . . . . . . TITLE

    Can

    Mr., Ms.

    dtMLSTRING[20]

    BMEcat NS

    Can

    Salutation
    Will be transmitted differently

    Salutation (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 *Street incl. No.

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

    . . . . . . STREET

    Can

    Musterstrasse 200b

    dtMLSTRING[50]

    BMEcat NS

    Can

    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

    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

    Must

    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

    spmpartnerresponses@digitecgalaxus

    Must

    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 Modified

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

    )

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

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

    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.

    Must

    private_customer

    dtSTRING[250]

    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

    . . . 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.Arrival date at delivery address

    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

    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