Versions Compared

Key

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

Main functions

  1. Order confirmation: Confirmation of the receipt of the order and the estimated arrival date per item

  2. Delivery date update: Update of the estimated arrival date per item:

    1. We expect the arrival date at the recipient of the goods and not the shipment date

    2. The date reported to us is communicated directly to the end customer and should therefore be as accurate as possible

    3. The date must not be automatically pushed back again and again in any case

Panel
panelIconId21a9
panelIcon:leftwards_arrow_with_hook:
panelIconText↩️
bgColor#FFFAE6

Order confirmation WITH arrival dates

If estimated arrival dates are available at the time of order confirmation, they should be transmitted in the order response.

Expand
titleExample file
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<ORDERRESPONSE xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentrans.org/XMLSchema/2.1" version="2.1">
	<ORDERRESPONSE_HEADER>
		<ORDERRESPONSE_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<ORDERRESPONSE_DATE>2017-06-14T15:53:18</ORDERRESPONSE_DATE>
			<SUPPLIER_ORDER_ID>191919</SUPPLIER_ORDER_ID>
		</ORDERRESPONSE_INFO>
	</ORDERRESPONSE_HEADER>
	<ORDERRESPONSE_ITEM_LIST>
		<ORDERRESPONSE_ITEM>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>2</QUANTITY>
			<DELIVERY_DATE>
				<DELIVERY_START_DATE>2017-06-21</DELIVERY_START_DATE>
				<DELIVERY_END_DATE>2017-06-21</DELIVERY_END_DATE>
			</DELIVERY_DATE>
		</ORDERRESPONSE_ITEM>
	</ORDERRESPONSE_ITEM_LIST>
</ORDERRESPONSE>
Panel
panelIconId1f504
panelIcon:arrows_counterclockwise:
panelIconText🔄
bgColor#FFFAE6

Additional: Delivery date update

If the delivery date (or estimated arrival date) of a backorder changes, this can be communicated to us in another ORDR, eliminating the need for manual updating in CMI. Any number of ORDRs can be sent to us per order. Each additional ORDR updates the arrival date of the items in the backlog.

💡 If the backorder delivery for marketplace/direct delivery orders takes longer than 30 days, the order item must be canceled.

Expand
titleExample file
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<ORDERRESPONSE xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentrans.org/XMLSchema/2.1" version="2.1">
	<ORDERRESPONSE_HEADER>
		<ORDERRESPONSE_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<ORDERRESPONSE_DATE>2017-06-14T15:53:18</ORDERRESPONSE_DATE>
			<SUPPLIER_ORDER_ID>191919</SUPPLIER_ORDER_ID>
		</ORDERRESPONSE_INFO>
	</ORDERRESPONSE_HEADER>
	<ORDERRESPONSE_ITEM_LIST>
		<ORDERRESPONSE_ITEM>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>2</QUANTITY>
			<DELIVERY_DATE>
				<DELIVERY_START_DATE>2017-06-21</DELIVERY_START_DATE>
				<DELIVERY_END_DATE>2017-06-21</DELIVERY_END_DATE>
			</DELIVERY_DATE>
		</ORDERRESPONSE_ITEM>
	</ORDERRESPONSE_ITEM_LIST>
</ORDERRESPONSE>
Panel
panelIconId1f500
panelIcon:twisted_rightwards_arrows:
panelIconText🔀
bgColor#FFFAE6

Additional: Cancellation

Cancellation via Order Response is optional and disabled by default (function analog to ORDCHG EDIFACT).

If activated:

  • Quantities not confirmed in the Order Response are cancelled (this always refers to the quantity initially ordered)

  • Complete positions can be cancelled by confirmation with QUANTITY=0

  • Positions not included remain in the backorder

Expand
titleExample file

Use cases:

  • Ordered ORDP: Product xy quantity 12
    Confirmed ORDR: Product xy quantity 9
    --> 3 of product xy were cancelled (9 open backorder)

  • Ordered ORDP: Product xy quantity 10
    Confirmed ORDR: Product xy quantity 0
    --> Of product xy all [10] were cancelled (no [0] open backorder)

  • Ordered ORDP: ORDP: Product xy quantity 5
    Confirmed ORDR: Item for product xy is not included in the Order Response
    --> None [0] of product xy was cancelled (all [5] open backorder)

Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<ORDERRESPONSE xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentrans.org/XMLSchema/2.1" version="2.1">
	<ORDERRESPONSE_HEADER>
		<ORDERRESPONSE_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<ORDERRESPONSE_DATE>2017-06-14T15:53:18</ORDERRESPONSE_DATE>
			<SUPPLIER_ORDER_ID>191919</SUPPLIER_ORDER_ID>
		</ORDERRESPONSE_INFO>
	</ORDERRESPONSE_HEADER>
	<ORDERRESPONSE_ITEM_LIST>
		<ORDERRESPONSE_ITEM>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>7</QUANTITY>
			<DELIVERY_DATE>
				<DELIVERY_START_DATE>2017-06-21</DELIVERY_START_DATE>
				<DELIVERY_END_DATE>2017-06-21</DELIVERY_END_DATE>
			</DELIVERY_DATE>
		</ORDERRESPONSE_ITEM>
		<ORDERRESPONSE_ITEM>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>0</QUANTITY>
		</ORDERRESPONSE_ITEM>
	</ORDERRESPONSE_ITEM_LIST>
</ORDERRESPONSE>
Panel
panelIconId21a9
panelIcon:leftwards_arrow_with_hook:
panelIconText↩️
bgColor#F4F5F7

Minimum: Order confirmation WITHOUT arrival date

If no arrival data can be exported, an order response without positions can be transmitted (see example file below).
Deviations from the arrival data from the Order Placement must be communicated to us (manually in the CMI or automatically via delivery date update).

Expand
titleExample file
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<ORDERRESPONSE xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://www.opentrans.org/XMLSchema/2.1" version="2.1">
	<ORDERRESPONSE_HEADER>
		<ORDERRESPONSE_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<ORDERRESPONSE_DATE>2017-06-14T15:53:18</ORDERRESPONSE_DATE>
			<SUPPLIER_ORDER_ID>191919</SUPPLIER_ORDER_ID>
		</ORDERRESPONSE_INFO>
	</ORDERRESPONSE_HEADER>
</ORDERRESPONSE>
image-20240104-123548.png

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

ORDERRESPONSE

Must

-

-

See Namespaces regarding the correct usage of namespaces.

. ORDERRESPONSE_HEADER

Must

-

-


. . ORDERRESPONSE_INFO

Must

-

-


. . . ORDER_ID

Must

9316271

dtSTRING[25]

Galaxus Purchase Order ID

. . . ORDERRESPONSE_DATE

Must

2017-06-14T15:53:18

dtDATETIME

Order Response timestamp

. . . SUPPLIER_ORDER_ID

Should

191919

dtSTRING[250]

Order ID from your ERP

Important for merchants: The ID will be printed onto our return labels as Code-39-Barcode and must comply with ISO/IEC 16388 norm.
The SUPPLIER_ORDER_ID is also displayed on the marketplace sales fee reports.

. ORDERRESPONSE_ITEM_LIST

Should

-

-

. . ORDERRESPONSE_ITEM

Should

-

-

 

. . . PRODUCT_ID

Must

-

-

. . . . SUPPLIER_PID

Must

A375-129

dtSTRING[32]

BMEcat NS

Partner product key

. . . . INTERNATIONAL_PID

Should

09783404175109

dtSTRING[14]

BMEcat NS

GTIN-14 with leading zeros

. . . . BUYER_PID

Can

6406567

dtSTRING[50]

BMEcat NS

Galaxus product key

. . . QUANTITY

Must

2

dtNUMBER

Quantity as integer > 0

. . . DELIVERY_DATE

Should

-

-

Date of arrival at the recipient of the goods:

  • If the arrival date cannot be met, we require an update of the date via Order Response or CMI

  • If this date can not be sent, the ORDERRESPONSE_ITEM_LIST must be omitted completely

. . . . DELIVERY_START_DATE

Should

2017-06-21

dtDATETIME

Estimated arrival date:

  • If the arrival date is unknown, the segment must be left blank or "order confirmation WITHOUT arrival date" can be sent
    (warning) «unknown» or «fake» delivery dates are not allowed

  • A date in the past does not trigger date updates

  • For orders with DELIVERY_DATE type="fixed" this must be confirmed

. . . . DELIVERY_END_DATE

Should

2017-06-21

dtDATETIME

Same value as DELIVERY_START_DATE