Versions Compared

Key

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

Main function

Shipment notification similar to the physical delivery note.

Note

The delivery note number/reference of the paper delivery note must exactly match the DISPATCHNOTIFICATION_ID element.

Note

For returns/replacement deliveries/RMA no shipping messages should be transmitted.

Info

Notes to the EU-Hub

Partial shipments
Separate DELR must be transmitted with corresponding SHIPMENT_ID and QUANTITY according to the physical shipment. The EXPINV (per order or per shipment) is independent.
Shipment split (1 item split into several packages)
Shipment split is currently not possible. All items must be shipped completely in one package.

image-20240104-122859.png

Expand
titleExample file for direct delivery to end customer (supplier and dealer)
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<DISPATCHNOTIFICATION 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">
	<DISPATCHNOTIFICATION_HEADER>
		<CONTROL_INFO>
			<GENERATION_DATE>2017-06-14T17:05:34</GENERATION_DATE>
		</CONTROL_INFO>
		<DISPATCHNOTIFICATION_INFO>
			<DISPATCHNOTIFICATION_ID>11720161201040841</DISPATCHNOTIFICATION_ID>
			<DISPATCHNOTIFICATION_DATE>2017-06-14T17:15:01</DISPATCHNOTIFICATION_DATE>
			<PARTIES>
				<PARTY>
					<PARTY_ROLE>delivery</PARTY_ROLE>
					<ADDRESS>
						<NAME xmlns="http://www.bmecat.org/bmecat/2005">Mustermann GmbH</NAME>
						<CONTACT_DETAILS>
							<FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005">Ulla</FIRST_NAME>
							<CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005">Mustermann</CONTACT_NAME>
						</CONTACT_DETAILS>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Musterstrasse 200b</STREET>
						<ZIP xmlns="http://www.bmecat.org/bmecat/2005">8000</ZIP>
						<CITY xmlns="http://www.bmecat.org/bmecat/2005">Zürich</CITY>
						<COUNTRY xmlns="http://www.bmecat.org/bmecat/2005">Schweiz</COUNTRY>
						<COUNTRY_CODED xmlns="http://www.bmecat.org/bmecat/2005">CH</COUNTRY_CODED>
					</ADDRESS>
				</PARTY>
			</PARTIES>
			<SHIPMENT_ID>99.00.123456.12345678</SHIPMENT_ID>
			<SHIPMENT_CARRIER>swisspost</SHIPMENT_CARRIER>
		</DISPATCHNOTIFICATION_INFO>
	</DISPATCHNOTIFICATION_HEADER>
	<DISPATCHNOTIFICATION_ITEM_LIST>
		<DISPATCHNOTIFICATION_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>
			<ORDER_REFERENCE>
				<ORDER_ID>9316271</ORDER_ID>
			</ORDER_REFERENCE>
		</DISPATCHNOTIFICATION_ITEM>
	</DISPATCHNOTIFICATION_ITEM_LIST>
</DISPATCHNOTIFICATION>
Expand
titleExample file warehouse delivery
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<DISPATCHNOTIFICATION 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">
	<DISPATCHNOTIFICATION_HEADER>
		<CONTROL_INFO>
			<GENERATION_DATE>2019-02-13T17:05:34</GENERATION_DATE>
		</CONTROL_INFO>
		<DISPATCHNOTIFICATION_INFO>
			<DISPATCHNOTIFICATION_ID>11720161201040841</DISPATCHNOTIFICATION_ID>
			<DISPATCHNOTIFICATION_DATE>2019-02-13T17:05:45</DISPATCHNOTIFICATION_DATE>
			<PARTIES>
				<PARTY>
					<PARTY_ROLE>delivery</PARTY_ROLE>
					<ADDRESS>
						<NAME xmlns="http://www.bmecat.org/bmecat/2005">Digitec Galaxus AG</NAME>
						<NAME2 xmlns="http://www.bmecat.org/bmecat/2005">Receiving Wohlen</NAME2>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Ferroring 23</STREET>
						<ZIP xmlns="http://www.bmecat.org/bmecat/2005">5612</ZIP>
						<CITY xmlns="http://www.bmecat.org/bmecat/2005">Villmergen</CITY>
						<COUNTRY xmlns="http://www.bmecat.org/bmecat/2005">Schweiz</COUNTRY>
						<COUNTRY_CODED xmlns="http://www.bmecat.org/bmecat/2005">CH</COUNTRY_CODED>
					</ADDRESS>
				</PARTY>
			</PARTIES>
		</DISPATCHNOTIFICATION_INFO>
	</DISPATCHNOTIFICATION_HEADER>
	<DISPATCHNOTIFICATION_ITEM_LIST>
		<DISPATCHNOTIFICATION_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>
			<ORDER_REFERENCE>
				<ORDER_ID>9316271</ORDER_ID>
			</ORDER_REFERENCE>
			<LOGISTIC_DETAILS>
				<PACKAGE_INFO>
					<PACKAGE>
						<PACKAGE_ID>00001234560000000018</PACKAGE_ID>
						<PACKAGE_ORDER_UNIT_QUANTITY>2</PACKAGE_ORDER_UNIT_QUANTITY>
					</PACKAGE>
				</PACKAGE_INFO>
			</LOGISTIC_DETAILS>
		</DISPATCHNOTIFICATION_ITEM>
		<DISPATCHNOTIFICATION_ITEM>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005">A475-177</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005">09783404658123</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005">6406987</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>5</QUANTITY>
			<ORDER_REFERENCE>
				<ORDER_ID>9316271</ORDER_ID>
			</ORDER_REFERENCE>
			<LOGISTIC_DETAILS>
				<PACKAGE_INFO>
					<PACKAGE>
						<PACKAGE_ID>00001234560000000028</PACKAGE_ID>
						<PACKAGE_ORDER_UNIT_QUANTITY>3</PACKAGE_ORDER_UNIT_QUANTITY>
					</PACKAGE>
					<PACKAGE>
						<PACKAGE_ID>00001234560000000038</PACKAGE_ID>
						<PACKAGE_ORDER_UNIT_QUANTITY>2</PACKAGE_ORDER_UNIT_QUANTITY>
					</PACKAGE>
				</PACKAGE_INFO>
			</LOGISTIC_DETAILS>
		</DISPATCHNOTIFICATION_ITEM>
	</DISPATCHNOTIFICATION_ITEM_LIST>
</DISPATCHNOTIFICATION>

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

DISPATCHNOTIFICATION

Must

See Namespaces regarding the correct usage of namespaces.

. DISPATCHNOTIFICATION_HEADER

Must

. . CONTROL_INFO

Must

. . . GENERATION_DATE

Must

2019-01-14T17:05:34

dtDATETIME

Document creation timestamp

. . DISPATCHNOTIFICATION_INFO

Must

. . . DISPATCHNOTIFICATION_ID

Must

1172016120104084

dtSTRING[250]

(warning) Reference of the paper delivery note (delivery note number) - must be unique and not repeated

. . . DISPATCHNOTIFICATION_DATE

Must

2017-06-14T17:15:01

dtDATETIME

Dispatch date

. . . PARTIES

Must

. . . . PARTY

Must

. . . . . PARTY_ROLE

Must

delivery

dtSTRING[20]

Recipient of delivery

. . . . . ADDRESS

Must

The element ADDRESS in the  PARTY_ROLE delivery must be present, even without any sub-elements.

. . . . . . NAME

Should

Mustermann GmbH

dtMLSTRING[50]

BMEcat NS

Company name
(warning) The XML entities &amp;, &lt;, &gt;, &apos; and &quot; must be escaped

. . . . . . NAME3

Should

Block A

dtMLSTRING[50]

BMEcat NS

Building

. . . . . . DEPARTMENT

Should

Accounting

dtMLSTRING[50]

BMEcat NS

Department

. . . . . . CONTACT_DETAILS

Can

-

-

 

. . . . . . . TITLE

Should

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Salutation

. . . . . . . FIRST_NAME

Should

Ulla

dtMLSTRING[50]

BMEcat NS

First name

. . . . . . . CONTACT_NAME

Should

Mustermann

dtMLSTRING[50]

BMEcat NS

Last name

. . . . . . STREET

Should

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Street incl. No.

. . . . . . ZIP

Should

8000

dtMLSTRING[20]

BMEcat NS

ZIP code of address or post office box

. . . . . . BOXNO

Should

7

dtMLSTRING[20]

BMEcat NS

P.O. Box number

. . . . . . CITY

Should

Zürich

dtMLSTRING[50]

BMEcat NS

City

. . . . . . COUNTRY

Should

Schweiz

dtMLSTRING[50]

BMEcat NS

Country

. . . . . . COUNTRY_CODED

Can

CH, DE, AT

dtCOUNTRIES

BMEcat NS

Country code according ISO 3166-1 ALPHA-2

. . . SHIPMENT_ID

Should *

99.00.123456.12345678,
per Briefpost,
nicht vorhanden

dtSTRING[250]

* = Must for direct deliveries to end customers:

  • Consignment number/package number of the shipping service provider for tracking purposes
    💡 If possible for parcels to the warehouse, if the consignment number is available as a barcode (even if SSCC has not been implemented), transmit it here

  • If the shipment is made by letter post, then «per Briefpost»

  • If there is no tracking option for the goods shipment, then «nicht vorhanden»

. . . SHIPMENT_CARRIER

Should *

swisspost, dhl, dhlfreight, hermes, tnt, dpd, ups, gls, fedex, dachser, planzer, transoflex, gebruederweiss, galliker, quickpac, austria-post, dsv, schenker, sidler, noerpel, emons, hellmann

dtSTRING[50]

* = Must for direct deliveries to end customers
(question) Currently, only the values listed under sample values are permitted. If a different logistics service provider is used, the responsible Integration Manager needs to be contacted.

. DISPATCHNOTIFICATION_ITEM_LIST

Must

. . DISPATCHNOTIFICATION_ITEM

Must

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

. . . . SERIAL_NUMBER

Can

0021010000

dtSTRING[50]

BMEcat NS

Serial number: Unique identification of a single product (product instance).
The element can occur accordingly several times for QUANTITY > 1.

. . . QUANTITY

Must

5

dtNUMBER

Quantity (Integer > 0)

. . . ORDER_REFERENCE

Must

. . . . ORDER_ID

Must

9316271

dtSTRING[25]

Reference Order ID – indicates the corresponding order for the delivery

. . . LOGISTIC_DETAILS

Should *

Warehouse deliveries (supplier)
* = If this element can be sent, its sub-elements are must fields and the conditions from Incoming goods automation with SSCC must be met.

Direct deliveries (supplier & merchant)
* = Basically this element and its sub-elements should not be sent. However, it can be used to specify different tracking codes per item and piece.

. . . . PACKAGE_INFO

Should *

. . . . . PACKAGE

Should *

. . . . . . PACKAGE_ID

Should *

00001234560000000028, 99.00.123456.12345678

dtSTRING[50]

Best: SSCC
Minimum requirement: barcode value present on a label on the pallet or package
Compatible code type: GS1-128
The scannable code must correspond exactly to the PACKAGE_ID
The value must be unique and must not be repeated within one year

(warning) For direct deliveries (if LOGISTIC_DETAILS are sent), the consignment number must be transmitted here
💡 Several PACKAGE elements can be used to transmit different consignment numbers (parcels) in one DELR

. . . . . . PACKAGE_ORDER_UNIT_QUANTITY

Should *

3

dtNUMBER

Number of pieces of an item available in the package / on the pallet