xml RETANN (Return Announcement)

The Return message intent is to exchange information related to returns

General usage

- The message includes functionality to differentiate classes of returns, and to permit financial valuation of returns facilitating price protection claims, auditing, statutory declarations, etc.

Name Required Description Examples Xpath Type Limits Sort Id
(Header) : EDI message name No

The name of the EDI message

 
 <returnAnnouncement text="Btwentyfour Example Returns Announcement">
/b24Message/returnAnnouncement/@text Text 1000 1
(Header) : Environment No

Environment/test indicator - either "Production" or "Test"

 
 <returnAnnouncement text="Btwentyfour Example Returns Announcement" environment="Production">
/b24Message/returnAnnouncement/@environment Text 1100 2
(Header) : Currency No

The currency in which the price information in the order is specified

 
 <returnAnnouncement text="Btwentyfour Example Returns Announcement" environment="Production" currency="EUR">
/b24Message/returnAnnouncement/@currency Text 1200 3
(Header) : Btwentyfour message ID No

Message ID set by Btwentyfour Open Commerce Platform.

 
 <returnAnnouncement text="Btwentyfour Example Returns Announcement" environment="Production" currency="EUR" messageId="123456" messageDate="2021-12-09T12:19:05.167Z">
/b24Message/returnAnnouncement/@messageId Number 1300 4
(Header) : Btwentyfour message date No

Message date set by Btwentyfour Open Commerce Platform.

 
 <returnAnnouncement text="Btwentyfour Example Returns Announcement" environment="Production" currency="EUR" messageId="123456" messageDate="2021-12-09T12:19:05.167Z">
/b24Message/returnAnnouncement/@messageDate Date/Time 1400 5
(Header) : Sender Yes

The sender of the EDI message, identified by a GLN

 
 <sender gln="7340117836950"/>
/b24Message/returnAnnouncement/sender/@gln Number 1500 6
(Header) : Recipient Yes

The recipient of the EDI message, identified by a GLN

 
 <recipient gln="7340117815580"/>
/b24Message/returnAnnouncement/recipient/@gln Number 1600 7
(Header) : Return Announcement number Yes

The ID of the return announcement, set by the sender

 
 <documentReference documentType="ReturnAnnouncement" id="777888" date="2021-12-09"/>
/b24Message/returnAnnouncement/documentReference[@documentType="ReturnAnnouncement"]/@id Text 1700 8
(Header) : Return Announcement date Yes

The date of the return announcement, set by the sender

 
 <documentReference documentType="ReturnAnnouncement" id="777888" date="2021-12-09"/>
/b24Message/returnAnnouncement/documentReference[@documentType="ReturnAnnouncement"]/@date Date/Time 1800 9
(Header) : Buyer order number No

The purchase order number set by the buyer

 
 <documentReference documentType="BuyerOrder" id="555666" date="2020-12-01">
/b24Message/returnAnnouncement/documentReference[@documentType="BuyerOrder"]/@id Text 1900 10
(Header) : Order date No

The purchase order date set by the buyer

 
 <documentReference documentType="BuyerOrder" id="555666" date="2020-12-01">
/b24Message/returnAnnouncement/documentReference[@documentType="BuyerOrder"]/@date Date/Time 2000 11
(Header) : Despatch advice identification No

The despatch advice number set by the supplier

 
 <documentReference documentType="DespatchAdvice" id="95159" date="2021-12-02">
/b24Message/returnAnnouncement/documentReference[@documentType="DespatchAdvice"]/@id Text 2100 12
(Header) : Despatch advice date No

The despatch advice date set by the supplier

 
 <documentReference documentType="DespatchAdvice" id="95159" date="2021-12-02">
/b24Message/returnAnnouncement/documentReference[@documentType="DespatchAdvice"]/@date Date/Time 2200 13
(Header) : Delivery note number No

The delivery note number set by the supplier

 
 <documentReference documentType=DeliveryNote" id="95159" date="2021-12-02">
/b24Message/returnAnnouncement/documentReference[@documentType="DeliveryNote"]/@id Text 2300 14
(Header) : Delivery note date No

The delivery note date set by the supplier

 
 <documentReference documentType="DeliveryNote" id="95159" date="2021-12-02">
/b24Message/returnAnnouncement/documentReference[@documentType="DeliveryNote"]/@date Date/Time 2400 15
(Header) : Agreement Number No

The reference number/ID of an agreement

 
 <documentReference documentType="AgreementNumber" id="325899" date="2021-12-09"/>
/b24Message/returnAnnouncement/documentReference[@documentType="AgreementNumber"]/@id Text 2500 16
(Header) : Agreement date No

The reference date of an agreement

 
 <documentReference documentType="AgreementNumber" id="325899" date="2021-12-09"/>
/b24Message/returnAnnouncement/documentReference[@documentType="AgreementNumber"]/@date Date/Time 2600 17
(Header) : Delivery date No

The date when the goods were originally delivered to the buyer, by the supplier as per the original order flow.

 
 <property name="deliveryDate">2021-12-09</property>
/b24Message/returnAnnouncement/property[@name="deliveryDate"] Date/Time 2700 18
(Header) : Earliest collection date No

The earliest date from which the returned goods will be available for collection by the supplier. This along with the value latest collection date forms a window of a time during which the goods are available for collection/pick up.

 
 <property name="earliestCollectionDate">2021-12-08</property>
/b24Message/returnAnnouncement/property[@name="earliestCollectionDate"] Date/Time 2800 19
(Header) : Latest collection date No

The latest date until which the returned goods will be available for collection by the supplier. This along with the value earliest collection date forms a window of a time during which the goods are available for collection/pick up.

 
 <property name="latestCollectionDate">2021-12-09</property>
/b24Message/returnAnnouncement/property[@name="latestCollectionDate"] Date/Time 2900 20
(Header) : Supplier GLN Yes

The supplier/brand, identified by a GLN

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier">
/b24Message/returnAnnouncement/supplier/@gln Number 3000 21
(Header) : Supplier Name No

Name of the supplier party

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier">
/b24Message/returnAnnouncement/supplier/@name Text 3100 22
(Header) : Supplier Org Number No

Corporate identity number of the supplier party

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier" orgNo="99999999-9999">
/b24Message/returnAnnouncement/supplier/@orgNo Text 3200 23
(Header) : Supplier VAT number No

VAT number (value added tax number) of the supplier party

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier" vatNo="SE999999999999">
/b24Message/returnAnnouncement/supplier/@vatNo Text 3300 24
(Header) : Supplier Contact No

Name of a contact person

 
 <supplier gln="7340117815580" name="Btwentyfour Demo Supplier" contact="ReferenceName">
/b24Message/returnAnnouncement/supplier/@contact Text 3400 25
(Header) : Supplier Address No

Address of the supplier party

 
 <address>StreetAddress</address>
/b24Message/returnAnnouncement/supplier/location/address Text 3500 26
(Header) : Supplier Zip Code No

Zip code of the supplier party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/supplier/location/city/@code Text 3600 27
(Header) : Supplier City No

City of the supplier party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/supplier/location/city Text 3700 28
(Header) : Supplier Country No

Country of the supplier party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/supplier/location/country Text 3800 29
(Header) : Supplier Country Code No

Country code of the supplier party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/supplier/location/country/@code Text 3900 30
(Header) : Supplier Phone number No

Telephone number of the contact person

 
 <telephoneNumber>+45000000002</telephoneNumber>
/b24Message/returnAnnouncement/supplier/location/telephoneNumber Number 4000 31
(Header) : Supplier Email No

An e-mail address of the contact person

 
 <emailAddress>supplier@email.com</emailAddress>
/b24Message/returnAnnouncement/supplier/location/emailAddress Text 4100 32
(Header) : Supplier external ID No

External identifier, set by sender of the message

 
 <property name="id">5122186</property>
/b24Message/returnAnnouncement/supplier/property[@name="id"] Text 4200 33
(Header) : Supplier internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">8899</property>
/b24Message/returnAnnouncement/supplier/property[@name="internalId"] Text 4300 34
(Header) : Supplier Name 2 No

A second name field for the supplier party

 
 <property name="name2">The second supplier name</property>
/b24Message/returnAnnouncement/supplier/property[@name="name2"] Text 4400 35
(Header) : Buyer GLN Yes

The buying party, identified by a GLN

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group">
/b24Message/returnAnnouncement/buyer/@gln Number 4500 36
(Header) : Buyer Name No

Name of the buyer party

 
 <buyer gln="7340117836950" name="Btwentyfour Demo Buying Group">
/b24Message/returnAnnouncement/buyer/@name Text 4600 37
(Header) : Buyer Address No

Address of the buyer party

 
 <address>StreetAddress</address>
/b24Message/returnAnnouncement/buyer/location/address Text 4700 38
(Header) : Buyer Zip Code No

Zip code of the buyer party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/buyer/location/city/@code Text 4800 39
(Header) : Buyer City No

City of the buyer party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/buyer/location/city Text 4900 40
(Header) : Buyer State No

State of the buyer party

 
 <state code="StateCode">StateName</state>
/b24Message/returnAnnouncement/buyer/location/state Text 5000 41
(Header) : Buyer State Code No

State code of the buyer party

 
 <state code="StateCode">StateName</state>
/b24Message/returnAnnouncement/buyer/location/state/@code Text 5100 42
(Header) : Buyer Country No

Country of the buyer party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/buyer/location/country Text 5200 43
(Header) : Buyer Country Code No

Country code of the buyer party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/buyer/location/country/@code Text 5300 44
(Header) : Buyer Phone number No

Telephone number of the contact person

 
 <telephoneNumber>+45000000001</telephoneNumber>
/b24Message/returnAnnouncement/buyer/location/telephoneNumber Number 5400 45
(Header) : Buyer Email No

An e-mail address of the contact person

 
 <emailAddress>buyer@email.com</emailAddress>
/b24Message/returnAnnouncement/buyer/location/emailAddress Text 5500 46
(Header) : Buyer external ID No

External identifier, set by sender of the message

 
 <property name="id">3512421</property>
/b24Message/returnAnnouncement/buyer/property[@name="id"] Text 5600 47
(Header) : Buyer internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">1133</property>
/b24Message/returnAnnouncement/buyer/property[@name="internalId"] Text 5700 48
(Header) : Buyer Name 2 No

A second name field for the buyer party

 
 <property name="name2">The second buyer name</property>
/b24Message/returnAnnouncement/buyer/property[@name="name2"] Text 5800 49
(Site) : Site GLN No

The site/store location party, from which the goods were originally delivered and are now being returned from, identified by a GLN.

 
 <site gln="7340117804522" name="Site Location Name" contact="Reference Name" orgNo="77777777-7777" vatNo="DK6666666666666">
/b24Message/returnAnnouncement/site/@gln Number 5900 50
(Site) : Site Name No

Name of the site party

 
 <site gln="7340117804522" name="Site Location Name" contact="Reference Name" orgNo="77777777-7777" vatNo="DK6666666666666">
/b24Message/returnAnnouncement/site/@name Text 6000 51
(Site) : Site Address No

Address of the site party

 
 <address>StreetAddress</address>
/b24Message/returnAnnouncement/site/location/address Text 6100 52
(Site) : Site Zip Code No

Zip code of the site party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/site/location/city/@code Text 6200 53
(Site) : Site City No

City of the site party

 
 <city code="ZipCode">CityName</city>
/b24Message/returnAnnouncement/site/location/city Text 6300 54
(Site) : Site State No

State of the site party

 
 <state code="StateCode">StateName</state>
/b24Message/returnAnnouncement/site/location/state Text 6400 55
(Site) : Site State Code No

State code of the site party

 
 <state code="StateCode">StateName</state>
/b24Message/returnAnnouncement/site/location/state/@code Text 6500 56
(Site) : Site Country No

Country of the site party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/site/location/country Text 6600 57
(Site) : Site Country Code No

Country code of the site party

 
 <country code="CountryCode">CountryName</country>
/b24Message/returnAnnouncement/site/location/country/@code Text 6700 58
(Site) : Site Phone number No

Telephone number of the contact person

 
 <telephoneNumber>+45000000003</telephoneNumber>
/b24Message/returnAnnouncement/site/location/telephoneNumber Number 6800 59
(Site) : Site Email No

An e-mail address of the contact person

 
 <emailAddress>SiteLocation@email.com</emailAddress>
/b24Message/returnAnnouncement/site/location/emailAddress Text 6900 60
(Site) : Site external ID No

External identifier, set by sender of the message

 
 <property name="id">1422182</property>
/b24Message/returnAnnouncement/site/property[@name="id"] Text 7000 61
(Site) : Site internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name="internalId">1132</property>
/b24Message/returnAnnouncement/site/property[@name="internalId"] Text 7100 62
(Site) : Site Name 2 No

A second name field for the site party

 
 <property name="name2">The second site location party name</property>
/b24Message/returnAnnouncement/site/property[@name="name2"] Text 7200 63
(Header) : Ship From gln No

The party from which the returned goods will be delivered back to the supplier if it is different from the site from which the goods are returned, identified by a gln

 
 <property name="shipFrom">Ship From GLN</property>
/b24Message/returnAnnouncement/property[@name="shipFrom"] Number 7300 64
(Header) : Ship From Name No

Name of the Ship From Party

 
 <property name = "shipFromName">Ship From Name</property>
/b24Message/returnAnnouncement/property[@name="shipFromName"] Text 7400 65
(Header) : Ship From Address No

Address of the ship from party

 
 <property name = "shipFromAddress">Ship From Address</property>
/b24Message/returnAnnouncement/property[@name="shipFromAddress"] Text 7500 66
(Header) : Ship From Zip Code No

Zip code of the ship from party

 
 <property name = "shipFromCityCode">Ship From ZipCode</property>
/b24Message/returnAnnouncement/property[@name="shipFromCityCode"] Text 7600 67
(Header) : Ship From City No

City of the ship from party

 
 <property name = "shipFromCity">Ship From City</property>
/b24Message/returnAnnouncement/property[@name="shipFromCity"] Text 7700 68
(Header) : Ship From State No

State of the ship from party

 
 <property name = "shipFromState">Ship From State</property>
/b24Message/returnAnnouncement/property[@name="shipFromState"] Text 7800 69
(Header) : Ship From State Code No

State code of the ship from party

 
 <property name = "shipFromStateCode">Ship From State Code</property>
/b24Message/returnAnnouncement/property[@name="shipFromStateCode"] Text 7900 70
(Header) : Ship From Country No

Country of the ship from party

 
 <property name = "shipFromCountry">Ship From Country</property>
/b24Message/returnAnnouncement/property[@name="shipFromCountry"] Text 8000 71
(Header) : Ship From Country Code No

Country code of the ship from party

 
 <property name = "shipFromCountryCode">Ship From Country Code</property>
/b24Message/returnAnnouncement/property[@name="shipFromCountryCode"] Text 8100 72
(Header) : Ship From Phone number No

Telephone number of the contact person

 
 <property name = "shipFromTelephoneNumber">Ship From PhoneNumber</property>
/b24Message/returnAnnouncement/property[@name="shipFromTelephoneNumber"] Number 8200 73
(Header) : Ship From Email No

An e-mail address of the contact person

 
 <property name = "shipFromEmailAddress">Ship From Email Address</property>
/b24Message/returnAnnouncement/property[@name="shipFromEmailAddress"] Text 8300 74
(Header) : Ship From external ID No

External identifier, set by sender of the message

 
 <property name = "shipFromId">Ship From External Id</property>
/b24Message/returnAnnouncement/property[@name="shipFromId"] Text 8400 75
(Header) : Ship From internal ID No

Internal identifier, mapped in the Btwentyfour Open Commerce Platform.

 
 <property name = "shipFromInternalId">Ship From Internal Id</property>
/b24Message/returnAnnouncement/property[@name="shipFromInternalId"] Text 8500 76
(Header) : Ship From Name 2 No

A second name field for the Ship From name

 
 <property name = "shipFromName2">Ship From Secondary Name</property>
/b24Message/returnAnnouncement/property[@name="shipFromName2"] Text 8600 77
(Item/Line) : Supplier Item ID No

The supplier's unique item ID of the product

 
 <item id="1000000001111">
/b24Message/returnAnnouncement/item/@id Text 8700 78
(Item/Line) : Return announcement line number No

The return announcement line number

 
 <documentReference documentType="ReturnAnnouncement" id="777888" date="2021-12-09" lineNo="1"/>
/b24Message/returnAnnouncement/item/documentReference[@documentType="ReturnAnnouncement"]/@lineNo Text 8800 79
(Item/Line) : Article description No

The supplier's article description

 
 <property name="description">product description</property>
/b24Message/returnAnnouncement/item/property[@name="description"] Text 8900 80
(Item/Line) : Unit of measure No

Unit of measure

 
 <property name="unitOfMeasure">PCE</property>
/b24Message/returnAnnouncement/item/@unitOfMeasure Text 9000 81
(Item/Line) : Barcode with type Yes

The supplier's EAN/UPC code of the product

 
 <itemReference registry="Supplier" coding="EAN13">7313492579392</itemReference>
/b24Message/returnAnnouncement/item/itemReference[@registry="Supplier" and @coding="barcodeType"] Number 9100 82
(Item/Line) : Buyer Item id No

The buyer's unique item ID of the product

 
 <itemReference registry="Buyer" name="itemId">198877</itemReference>
/b24Message/returnAnnouncement/item/itemReference[@registry="Buyer" and @name="itemId"] Text 9200 83
(Item/Line) : Buyer Department(Item level) No

The buyer's department that handles the article

 
 <property name ="buyerDepartment">1102</property>
/b24Message/returnAnnouncement/property[@name="buyerDepartment"] Text 9300 84
(Item/Line) : Net price with currency No

The net price of the product

 
 <price type="netPrice" value="90.00" currency="EUR"/>
/b24Message/returnAnnouncement/item/price[@type="netPrice"]/@value and @currency Number 9400 85
(Item/Line) : Gross price with currency No

The gross price of the product

 
 <price type="grossPrice" value="100.00" currency="EUR"/>
/b24Message/returnAnnouncement/item/price[@type="grossPrice"]/@value and @currency Number 9500 86
(Item/Line) : Discount percentage No

The discount percentage for the product

 
 <price type="discountPercentage" value="10.00" currency="EUR"/>
/b24Message/returnAnnouncement/item/price[@type="discountPercentage"]/@value Number 9600 87
(Item/Line) : Discount amount No

The discount amount for the product

 
 <price type="discountAmount" value="15.00" currency="EUR"/>
/b24Message/returnAnnouncement/item/price[@type="discountAmount"]/@value Number 9700 88
(Item/Line) : Quantity Return Yes

The quantity of the item

 
 <quantity type="Return" value="5">
/b24Message/returnAnnouncement/item/quantity[@type="Return" and @value] Number 9800 89
(Item/Line) : Reason Yes

Reason for return

 
 <quantityReason code="4D" value="1">Damaged Goods</quantityReason >
/b24Message/returnAnnouncement/item/quantity/quantityReason[@code & @value] Text 9900 90