Return Notification

If a customer initiates the return of product(s) in an order, Digital River sends the return pre-advice to the fulfillment partner.

Supported Formats and Data Interchange Modes (Digital River to Fulfillment Partner)

Format
AS2
FTP/SFTP
Web Service Post to Fulfiller
XML
Supported
Recommended (Best Practice)
Supported (Custom Implementation)
EDI X12 (180-1)
Supported (Best Practice)
Supported
Not Supported

Recommended Frequency

  • Batch at scheduled intervals


XML Specification

File Name Format

  • returnNotification_YYYYMMDD_HHMISS.xml

XML Schema

XML Sample


EDI X12 180-1 Specification

File Name Format

  • EDI180-1_YYYYMMDD_HHMISS.edi

EDI X12 180-1 Supported Version

  • 00401

EDI X12 180-1 Definition of Data Elements

Position Element ID Description Type Min/Max Required Comments
Envelope:






ISA
 
Interchange Control Header
 
1
Y

ISA01
I01


2/2
Y
00
ISA02
I02


10/10
Y

ISA03
I03
Security Information Qualifier
ID
Authorization Information Qualifier
ID
00
ISA04
I04
Security Information
AN
Authorization Information
AN

ISA05
I05
Interchange Sender Qualifier
ID
2/2
Y

ISA06
I06
Interchange Sender ID
AN

Y

ISA07
I05
Interchange Receiver Qualifier
ID
2/2
Y

ISA08
I07
Interchange Receiver ID
AN
15/15
Y

ISA09
I08
Interchange Date
DT

Y

ISA10
I09
Interchange Time
TM

Y

ISA11
I10
Interchange Control Standards Id
ID
ID
Y

ISA12
I11
Interchange Control Version Num
ID
5/5
Y

ISA13
I12
Interchange Control Number
N0
9/9
Y

ISA14
I13
Acknowledgment Requested
ID
1/1
Y

ISA15
I14
Usage Indicator
ID
1/1
Y
P=Production, T=Test
ISA16
I15
Component Element Separator

1/1
Y








GS 
 
Functional Group Header 

1
Y
 
GS01
479
Functional Identifier Code
ID
2/2
Y

GS02
142
Application Sender's Code
AN
2/15
Y

GS03
124
Application Receiver's Code
AN
2/15
Y

GS04
373
Date
DT
8/8
Y

GS05
337
Time
TM
4/8
Y

GS06
28
Group Control Number
N0
1/9
Y

GS07
455
Responsible Agency Code
ID
1/2
Y

GS08
480
Version / Release / Industry Id
AN
1/12
Y
4010







Heading:






ST
 
Transaction Set Header
 
1
Y

ST01
143
Transaction Set Identifier Code
ID
3/3
Y
180
ST02
329
Transaction Set Control Number
AN
4/9
Y








BGN
 
Beginning Segment

1
Y
 
BGN01
353
Transaction Set Purpose Code
ID
2/2
Y



00 - Original




BGN02
127
Reference Identification
AN
1/50
Y
Return ID
BGN03
373
Date
DT
8/8
Y

BGN04
337
Time
TM
4/8
Y

BGN07
640
Reference Identification Qualifier
ID
2/2
Y



RD - Return Details






 




PRF
 
Purchase Order Reference

1
Y
 
PRF01
324
Purchase Order Number
AN
1/22
Y
DR Order ID
PRF04
373
Date
DT
8/8
Y








DTM
 
Date/Time Reference

1
Y
 
DTM01
374
Date/Time Qualifier
ID
3/3
Y



324- Returned




DTM02
373
Date
DT
8/8
Y








N9
 
Reference Identification

1
Y
 
N901
128
Reference Identification Qualifier
ID
2/3
Y



CN - Channel Id






SN - Site ID






LO - Locale




N902
127
Reference Identification
AN
1/30
Y








SAC
 
Service, Promotion, Allowance, or Charge
 
1
N
 
SAC01
248
Allowance or Charge Indicator
ID
1/1
Y

 
 
A - Allowance/Discount
 
 
 
 
 
 
C - Charge
 
 
 
 
SAC02
1300
Service, Promotion, Allowance, or Charge Code
ID
4/4
Y



D340 - Merchandise Total



Total of all D340s at the item level


F050 - Discount Total



Total of all F050s at the item level
 
 
G830 - Shipping and Handling Total
 
 
 
Total of all G830s at the item level


H850 - Total Tax on merchandise and Shipping



Total of all H850s at the item level


FEE0 - Total of all Fees



Total of all FEEns at the item level


FTX0 - Total Tax on all Fees



Total of all FTXns at the item level
 
 
ZZZZ - Order Total
 
 
 
Total of all ZZZZs at the item level
SAC05
610
Amount

1/15
Y

SAC15
352
Description

1/80
N

 
 
 
 
 
 
 
N1
 
Name
 
1
Y
 
N101
98
Entity Identifier Code
ID
2/2
Y



ST - Ship To






BT - Bill To




N102
93
Name
AN
1/35
Y

N103
66
Identification Code Qualifier
ID
2/2




SI - Shopper ID




N104
67
Identification Code
AN
1/80

Shopper ID







N3
 
Address Information
 
2
Y
 
N301
166
Street Address
AN
1/35
Y

N302
166
Street Address 2
AN
1/35
N








N4
 
Geographic Location
 
1
Y
 
N401
19
City Name
AN
2/30
Y

N402
156
State or Province Code
ID
2/2
Y

N403
116
Postal Code
ID
3/15
Y

N404
26
Country Code
ID
2/3
Y








PER
 
Administrative Contact
 
1
N
 
PER01
366
Contact Function Code
ID
2/2
Y



IC – Information Contact




PER02
93
Name
AN
1/36
Y

PER03
365
Communication Number Qualifier
ID
2/2
N



TE – Telephone




PER04
364
Communication Number
AN
1/36
N

PER07
type365
Communication Number Qualifier
ID
2/2
N



EM – Email ID




PER08
NA
Email ID
AN
1/40
N








Detail:






BLI
 
Baseline Item Data

1
Y
 
BLI01
235
Product/Service ID Qualifier
ID
2/2
Y



IN - Buyer's Item Number




BLI02
234
Product/Service ID
AN
1/48
Y

BLI03
380
Quantity
R
1/15
Y

BLI04
355
Unit or Basis for Measurement
ID
2/2
Y



EA - Each




BLI08
235
Product/Service ID Qualifier
ID
2/2
Y



RN - Row Number




BLI09
234
Product/Service ID
AN
1/48

Line Number
BLI10
235
Product/Service ID Qualifier
ID
2/2
Y



SK - DR product ID




BLI11
234
Product/Service ID
AN
1/48

DR SKU
BLI12
235
Product/Service ID Qualifier
ID
2/2
Y



MG - MFG Part no




BLI13
234
Product/Service ID
AN
1/48
Y
MFG Part Number


 

 
 
 
PID
 
Product/Item Description

1
Y
 
PID01
349
Item description type
ID
1/1
Y



F - Free-form




PID05
352
Description
AN
1/80
Y








RDR
 
Return Disposition Reason

1
N
 
RDR01
1292
Returns Disposition Code
ID
2/2
Y

RDR02
1293
Return Request Reason Code
ID
2/2
Y

RDR04
352
Description
AN
1/80
Y








SAC
 
Service, Promotion, Allowance, or Charge
 
1
N
 
SAC01
248
Allowance or Charge Indicator

1/1
Y

 
 
A - Allowance
 
 
 
 
 
 
C - Charge
 
 
 
 
SAC02
1300
Service, Promotion, Allowance, or Charge Code

4/4
Y
All values are total amounts, not per unit amount


D340 - Merchandise Amount



VAT excl. Unit Price before applying discounts * Qty


F050 - Discount Amount



Product discounts (SAC01=A)
 
 
G830 - Shipping and Handling
 
 
 
Net shipping excl. tax (actual shipping - shipping discounts)


H850 - Tax on merchandise



Tax amount on merchandise & shipping


FEE1 - Fee1



Fees


FTX1 - Tax on Fee1



Tax on Fees


FEE2 - Fee2



Fees


FTX2 - Tax on Fee2



Tax on Fees


FEE3 - Fee3



Fees


FTX3 - Tax on Fee3



Tax on Fees


FEE4 - Fee4



Fees


FTX4 - Tax on Fee4



Tax on Fees


FEE5 - Fee5



Fees


FTX5 - Tax on Fee5



Tax on Fees
 
 
ZZZZ - Line Item Total
 
 
 
Total Line Item amount
SAC05
610
Amount

1/15
Y

SAC15
352
Description

1/80
N
For fees, fee name will be here







NTE
 
Comments at the Line Level

1
N
 
NTE01
363
Qualifier for Comments
ID
3/3
Y



CAR - Comments




NTE02
352
Comments
ID
1/40
Y








Summary:






SE 
 
Transaction Set Trailer

1
Y

SE01
96
Number of Included Segments
N0
1/10
Y

SE02
329
Transaction Set Control Number
AN
4/9
Y

Envelope:






GE
 
Functional Group Trailer

1
Y

GE01
97
Number of Transaction Sets Included
N0
1/6
Y

GE02
28
Group Control Number
N0
1/9
Y

IEA
 
Interchange Control Trailer 
 
1
Y

IEA01
I16
Number of Included Functional Groups
N0
1/5
Y

IEA02
I12
Interchange Control Number
N0
9/9
Y