Return Registration RETP

Main function

Notification about the registration of a customer return.

Note

Registered returns are not always returned by customers.

 

image-20240104-140537.png
XML tree view

 

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

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

-

-

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

9960114348.00119018

dtSTRING[250]

Package number of the physical return

. . . TRACKING_TRACING_URL

Must

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