Return Notification Details

Return Notification

The Return Notification service is a non-interactive process.

Return Notification Response

The Return Notification Response is non-real time process. The Return Notification Response appears some time after a processing the Return Notification. It can provide different responses codes depending on the success of the requested notification.

Note:

The Return Notification and Return Notification Response appear in separate job files.

See the examples for a successful Return Notification response and an unsuccessful Return Notification response.

Return Notification Request Example

<ns1:ReturnNotification xmlns:ns1="http://integration.digitalriver.com/commonRequisition/1.0">
	<returnID>300078209</returnID>
	<requisitionID>8955446119</requisitionID>
	<returnType>OrderLevelSatisfactionRefund
	</returnType>
	<returnReason>MATCH_PROMOTIONAL_PRICE
	</returnReason>
	<returnComments>Coupon Code CC33719704</returnComments>
	<returnPrices>
		<shipping>
			<currencyCode>USD</currencyCode>
			<amount>12.85</amount>
		</shipping>
		<tax>
			<currencyCode>USD</currencyCode>
			<amount>0.00</amount>
		</tax>
		<total>
			<currencyCode>USD</currencyCode>
			<amount>12.85</amount>
		</total>
	</returnPrices>
	<returnLineItems>
		<item>
			<returnLineItemID>355832709</returnLineItemID>
			<requisitionLineItemID>10402595919</requisitionLineItemID>
			<productData>
				<productDataID>2525521100</productDataID>
				<mfrPartNumber>6940LC/33</mfrPartNumber>
				<shipperPartNumber>3978477</shipperPartNumber>
				<sku>6940LC</sku>
				<name>Electric shaver</name>
				<companyID>philipsna</companyID>
			</productData>
			<returnLineItemReason>MATCH_PROMOTIONAL_PRICE
			</returnLineItemReason>
			<returnLineItemComments>Coupon Code CC33719704
			</returnLineItemComments>
			<quantity>0</quantity>
			<remainingQuantity>0</remainingQuantity>
			<returnLineItemPrices>
				<shipping>
					<currencyCode>USD</currencyCode>
					<amount>12.85</amount>
				</shipping>
				<remainingShipping>
					<currencyCode>USD</currencyCode>
					<amount>0.00</amount>
				</remainingShipping>
				<tax>
					<currencyCode>USD</currencyCode>
					<amount>0.00</amount>
				</tax>
				<remainingTax>
					<currencyCode>USD</currencyCode>
					<amount>0.00</amount>
				</remainingTax>
				<total>
					<currencyCode>USD</currencyCode>
					<amount>12.85</amount>
				</total>
			</returnLineItemPrices>
		</item>
	</returnLineItems>
</ns1:ReturnNotification>

The returnReasonelement can contain one of the following values:

Serial Number
Return Notification Reason
1
Canceled But Shipped
2
Cannot Download
3
Customer Error
4
Damaged Product
5
Duplicate Order
6
Fraud
7
Missing Items From Order
8
Never Received
9
Ordered Without Permission
10
Phone Order Error
11
Trialware
12
Refused Order
13
Unable to Ship to Country
14
Undeliverable Address
15
Vendor Approved Refund
16
Wrong Product
17
Customer Satisfaction Issue

Successful Return Notification Response Example

A successful returnNotification process sets the status element in the returnNotificationResponse to OK and the reasonCode to 200.

<ns1:ReturnNotificationResponseBatch xmlns:ns1 = "http://integration.digitalriver.com/ReturnNotification">
    <returnNotificationResponse>
        <returnID>302145009</returnID>
        <requisitionID>8968734519</requisitionID>
        <status>OK</status>
        <reasonCode>200</reasonCode>
        <returnExternalReferenceID>900331202|</returnExternalReferenceID>
        <externalReturns>
            <externalReturn xmlns:xsi = "http://www.w3.org/2001/XMLSchema-instance">
                <address>
                    <city>Eden Prairie</city>
                    <countryA2>US</countryA2>
                    <country>US</country>
                    <countryName>United States</countryName>
                    <line1>9625 W 76th St.</line1>
                    <line2>Suite 150</line2>
                    <line3/>
                    <name1>Digital River, Inc.</name1>
                    <name2>globalTech returns</name2>
                    <postalCode>55344</postalCode>
                    <state>MN</state>
                </address>
                <subFulfillerID>350</subFulfillerID>
                <subFulfillerRMANumber/>
                <externalReturnLineItems>
                    <externalReturnLineItem>
                        <returnLineItemID>358283809</returnLineItemID>
                        <quantity>1</quantity>
                    </externalReturnLineItem>
                    <externalReturnLineItem>
                        <returnLineItemID>358283909</returnLineItemID>
                        <quantity>2</quantity>
                    </externalReturnLineItem>
                </externalReturnLineItems>
            </externalReturn>
    </returnNotificationResponse>
</ns1:ReturnNotificationResponseBatch>

Unsuccessful Return Notification Response Example

An unsuccessful Return Notification process sets the status element in the returnNotificationResponse to ERROR. This signifies that the processing failed when sending the Return Notification and results in an unsuccessful response.

An unsuccessful return contains one of the following values:

Code
Return Notification Response Reason
401
Processing Failed for Invalid Requisition
402
Processing Failed for Invalid SKU/ShipperPartNumber
403
Processing failed due to already existing RMA
422
Processing failed due to unknown error
500
Processing failed for undefined reason
<ns1:ReturnNotificationResponseBatch xmlns:ns1 = "http://integration.digitalriver.com/ReturnNotification">
    <returnNotificationResponse>
        <returnID>301971309</returnID>
        <requisitionID>11999335842</requisitionID>
        <status>Error</status>
        <reasonCode>401</reasonCode>
        <statusDescription>gT Receipt_id not found. Invalid RequisitionID : 11999335842 ||</statusDescription>
    </returnNotificationResponse>
</ns1:ReturnNotificationResponseBatch>