Versions Compared

Key

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

Main function

Notification about the registration of a customer return.

Note

Note

Registered returns are not always returned by customers.

Image Removedimage-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>
				</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

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