Versions Compared

Key

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

Main function

Notification about the registration of a customer return.

Note

Note

Registered returns are not always returned by customers.

image-20240104-140537.pngImage Removed

Expand
titleExample file
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<RETURNREGISTRATION 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">
	<RETURNREGISTRATION_HEADER>
		<RETURNREGISTRATION_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<RETURNREGISTRATION_ID>67773882</RETURNREGISTRATION_ID>
			<RETURNREGISTRATION_DATE>2017-06-13T15:49:49</RETURNREGISTRATION_DATE>
			<LANGUAGE xmlns="http://www.bmecat.org/bmecat/2005">ger</LANGUAGE>
			<PARTIES>
				<PARTY>
					<PARTY_ID xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">2045638</PARTY_ID>
					<PARTY_ROLE>buyer</PARTY_ROLE>
				</PARTY>
				<PARTY>
					<PARTY_ID xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">1928008</PARTY_ID>
					<PARTY_ROLE>supplier</PARTY_ROLE>
				</PARTY>
			</PARTIES>
			<ORDER_PARTIES_REFERENCE>
				<BUYER_IDREF xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">2045638</BUYER_IDREF>
				<SUPPLIER_IDREF xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">1928008</SUPPLIER_IDREF>
			</ORDER_PARTIES_REFERENCE>
			<SHIPMENT_ID>99.60.114348.00119018</SHIPMENT_ID>
			<TRACKING_TRACING_URL>
				<![CDATA[https://service.post.ch/EasyTrack/submitParcelData.do?formattedParcelCodes=996011434800119018]]>
			</TRACKING_TRACING_URL>
		</RETURNREGISTRATION_INFO>
	</RETURNREGISTRATION_HEADER>
	<RETURNREGISTRATION_ITEM_LIST>
		<RETURNREGISTRATION_ITEM>
			<LINE_ITEM_ID>1</LINE_ITEM_ID>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005" type="supplierProductKey">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005" type="gtin">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005" type="DgProductId">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>2</QUANTITY>
			<ORDER_UNIT xmlns="http://www.bmecat.org/bmecat/2005">C62</ORDER_UNIT>
			<RETURNREASON>2</RETURNREASON>
		</RETURNREGISTRATION_ITEM>
	</RETURNREGISTRATION_ITEM_LIST>
	<RETURNREGISTRATION_SUMMARY>
		<TOTAL_ITEM_NUM>2</TOTAL_ITEM_NUM>
	</RETURNREGISTRATION_SUMMARY>
</RETURNREGISTRATION>

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

RETURNREGISTRATION

Must

-

-

See Namespaces regarding the correct usage of namespaces.

. RETURNREGISTRATION_HEADER

Must

-

-

. . RETURNREGISTRATION_INFO

Must

-

-

. . . ORDER_ID

Must

9316271

dtSTRING[25]

Galaxus Purchase Order ID

. . . RETURNREGISTRATION_ID

Must

67773882

dtSTRING[250]

Return Registration ID

. . . RETURNREGISTRATION_DATE

Must

2017-06-13T15:49:49

dtDATETIME

Return Registration timestamp

. . . LANGUAGE

Must

ger, eng, fra, ita

dtLANG[n/a]

BMEcat NS

End customer: language

. . . PARTIES

Must

-

-

. . . . PARTY

Must

-

-

. . . . . PARTY_ID

Must

2045638

dtSTRING[250]

BMEcat NS

Galaxus internal customer ID

. . . . . PARTY_ROLE

Must

buyer, supplier

dtSTRING[20]

buyer & supplier

Main function

Notification about the registration of a customer return.

Note

Note

Registered returns are not always returned by customers.

image-20240104-140537.pngImage Added

Expand
titleExample file
Code Block
languagexml
<?xml version="1.0" encoding="utf-8"?>
<RETURNREGISTRATION 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">
	<RETURNREGISTRATION_HEADER>
		<RETURNREGISTRATION_INFO>
			<ORDER_ID>9316271</ORDER_ID>
			<RETURNREGISTRATION_ID>67773882</RETURNREGISTRATION_ID>
			<RETURNREGISTRATION_DATE>2017-06-13T15:49:49</RETURNREGISTRATION_DATE>
			<LANGUAGE xmlns="http://www.bmecat.org/bmecat/2005">ger</LANGUAGE>
			<PARTIES>
				<PARTY>
					<PARTY_ID xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">2045638</PARTY_ID>
					<PARTY_ROLE>buyer</PARTY_ROLE>
					<ADDRESS>
						<CONTACT_DETAILS>
							<FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005">Hans</FIRST_NAME>
							<CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005">Müller</CONTACT_NAME>
						</CONTACT_DETAILS>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Teststrasse 50</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>
						<EMAIL xmlns="http://www.bmecat.org/bmecat/2005">noreply@galaxus.ch</EMAIL>
					</ADDRESS>
				</PARTY>
				<PARTY>
					<PARTY_ID xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">1928008</PARTY_ID>
					<PARTY_ROLE>supplier</PARTY_ROLE>
					<ADDRESS>
						<NAME xmlns="http://www.bmecat.org/bmecat/2005">Musterfirma AG</NAME>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Teststrasse 112</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>
						<EMAIL xmlns="http://www.bmecat.org/bmecat/2005">noreply@galaxus.ch</EMAIL>
					</ADDRESS>
				</PARTY>
				<PARTY>
					<PARTY_ID xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">2045638</PARTY_ID>
					<PARTY_ROLE>delivery</PARTY_ROLE>
					<ADDRESS>
						<CONTACT_DETAILS>
							<FIRST_NAME xmlns="http://www.bmecat.org/bmecat/2005">Hans</FIRST_NAME>
							<CONTACT_NAME xmlns="http://www.bmecat.org/bmecat/2005">Müller</CONTACT_NAME>
						</CONTACT_DETAILS>
						<STREET xmlns="http://www.bmecat.org/bmecat/2005">Teststrasse 50</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>
						<EMAIL xmlns="http://www.bmecat.org/bmecat/2005">noreply@galaxus.ch</EMAIL>
					</ADDRESS>
				</PARTY>
			</PARTIES>
			<ORDER_PARTIES_REFERENCE>
				<BUYER_IDREF xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">2045638</BUYER_IDREF>
				<SUPPLIER_IDREF xmlns="http://www.bmecat.org/bmecat/2005" type="buyer_specific">1928008</SUPPLIER_IDREF>
			</ORDER_PARTIES_REFERENCE>
			<SHIPMENT_ID>996011434800119018</SHIPMENT_ID>
			<TRACKING_TRACING_URL>https://service.post.ch/EasyTrack/submitParcelData.do?formattedParcelCodes=996011434800119018</TRACKING_TRACING_URL>
		</RETURNREGISTRATION_INFO>
	</RETURNREGISTRATION_HEADER>
	<RETURNREGISTRATION_ITEM_LIST>
		<RETURNREGISTRATION_ITEM>
			<LINE_ITEM_ID>1</LINE_ITEM_ID>
			<PRODUCT_ID>
				<SUPPLIER_PID xmlns="http://www.bmecat.org/bmecat/2005" type="supplierProductKey">A375-129</SUPPLIER_PID>
				<INTERNATIONAL_PID xmlns="http://www.bmecat.org/bmecat/2005" type="gtin">09783404175109</INTERNATIONAL_PID>
				<BUYER_PID xmlns="http://www.bmecat.org/bmecat/2005" type="DgProductId">6406567</BUYER_PID>
			</PRODUCT_ID>
			<QUANTITY>2</QUANTITY>
			<ORDER_UNIT xmlns="http://www.bmecat.org/bmecat/2005">C62</ORDER_UNIT>
			<RETURNREASON>2</RETURNREASON>
		</RETURNREGISTRATION_ITEM>
	</RETURNREGISTRATION_ITEM_LIST>
	<RETURNREGISTRATION_SUMMARY>
		<TOTAL_ITEM_NUM>2</TOTAL_ITEM_NUM>
	</RETURNREGISTRATION_SUMMARY>
</RETURNREGISTRATION>

XML Element

M/C/S

Sample values

Data type [maxLength]

Description

RETURNREGISTRATION

Must

-

-

See Namespaces regarding the correct usage of namespaces.

. RETURNREGISTRATION_HEADER

Must

-

-

. . RETURNREGISTRATION_INFO

Must

-

-

. . . ORDER_ID

Must

9316271

dtSTRING[25]

Galaxus Purchase Order ID

. . . RETURNREGISTRATION_ID

Must

67773882

dtSTRING[250]

Return Registration ID

. . . RETURNREGISTRATION_DATE

Must

2017-06-13T15:49:49

dtDATETIME

Return Registration timestamp

. . . LANGUAGE

Must

ger, eng, fra, ita

dtLANG[n/a]

BMEcat NS

End customer: language

. . . PARTIES

Must

-

-

. . . . PARTY

Must

-

-

. . . . . PARTY_ID

Must

2045638

dtSTRING[250]

BMEcat NS

Galaxus internal customer ID

. . . . . PARTY_ROLE

Must

buyer, supplier

dtSTRING[20]

buyer & supplier

. . . . . ADDRESS

Must

-

-

(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

Company name

. . . . . . NAME2

Can

Ulla Mustermann

dtMLSTRING[50]

BMEcat NS

For the attention of

. . . . . . NAME3

Can

Block A

dtMLSTRING[50]

BMEcat NS

Building

. . . . . . DEPARTMENT

Can

Accounting

dtMLSTRING[50]

BMEcat NS

Department

. . . . . . CONTACT_DETAILS

Can

-

-

. . . . . . . TITLE

Can

Mr., Ms.

dtMLSTRING[20]

BMEcat NS

Salutation (depending on the language of the customer)

. . . . . . . FIRST_NAME

Can *

Ulla

dtMLSTRING[50]

BMEcat NS

First name

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

. . . . . . . CONTACT_NAME

Can *

Mustermann

dtMLSTRING[50]

BMEcat NS

Last name

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

. . . . . . STREET

Can

Musterstrasse 200b

dtMLSTRING[50]

BMEcat NS

Street and house number

. . . . . . ZIP

Must

8000

dtMLSTRING[20]

BMEcat NS

ZIP code

. . . . . . BOXNO

Can

7

dtMLSTRING[20]

BMEcat NS

P.O. box number (the text P.O. box must be added to the address label)

. . . . . . CITY

Must

Zürich

dtMLSTRING[50]

BMEcat NS

City

. . . . . . COUNTRY

Must

Schweiz, Deutschland

dtMLSTRING[50]

BMEcat NS

Country (transmitted in German only)

. . . . . . COUNTRY_CODED

Must

CH, DE

dtCOUNTRIES

BMEcat NS

Country code according ISO 3166-1 ALPHA-2

. . . . . . PHONE

Can

0448447700

dtMLSTRING[50]

BMEcat NS

Phone number

. . . . . . EMAIL

Must

noreply@galaxus.ch, noreply@galaxus.de

dtSTRING[255]

BMEcat NS

Galaxus Email Address (hardcoded)
(warning) Please do not send any emails to this address, the mailbox is not maintained

. . . ORDER_PARTIES_REFERENCE

Must

-

-

. . . . BUYER_IDREF

Must

2045638

dtSTRING[250]

BMEcat NS

Galaxus internal customer ID

. . . . SUPPLIER_IDREF

Must

1928008

dtSTRING[250]

BMEcat NS

Galaxus internal partner ID

. . . SHIPMENT_ID

Must

99.60.1143489960114348.00119018

dtSTRING[250]

Package number of the physical return

. . . TRACKING_TRACING_URL

Must

<![CDATA[
https://service.post.ch/EasyTrack/submitParcelData.do?formattedParcelCodes=
99.60.114348.00119018&
lang=de&shortcut=swisspost-tracking
]]>

dtSTRING[255]

URL of the shipment number, so that the return shipment can be tracked

. RETURNREGISTRATION_ITEM_LIST

Must

-

-

. . RETURNREGISTRATION_ITEM

Must

-

-

. . . LINE_ITEM_ID

Must

1

dtSTRING[50]

Continuous document line numbering, starting at «1»

. . . 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[n/a]

Item position quantity

. . . ORDER_UNIT

Must

C62

dtPUNIT[3]

«C62» (hardcoded), stands for the unit piece

. . . RETURNREASON

Must

2

dtINTEGER[n/a]

Return reason:

«1» (Don't like)
«2» (Wrong size)
«3» (Wrong product)
«4» (Delivery too late)
«5» (Does not match the description)
«6» (Wrong order)

. RETURNREGISTRATION_SUMMARY

Must

-

-

. . TOTAL_ITEM_NUM

Must

2

dtCOUNT[n/a]

Sum of all quantities