描述
获取退件单数据，最多查询300个
路径
HTTP Verb | URL |
|---|---|
| POST | /api/supplier-service/v1/b2c/returnOrderList |
请求头样例
POST /api/supplier-service/v1/b2c/orderList HTTP/1.1 Host: http://cfs-qa.etowertech.com/ Content-Type: application/json |
请求字段
| 字段名 | 数据类型 | 最大长度 | 必填性 | 描述 |
|---|---|---|---|---|
orderNoList | List | 300 | O | 订单号 |
referenceNoList | List | 300 | O | 订单参考号 |
请求样例
客户参考号样例：
{ |
系统订单号样例：
{ |
返回参数
字段名 | 数据类型 | 最大长度 | 描述 |
|---|---|---|---|
referenceNo | String | 客户参考号 | |
orderNo | String | 系统订单号 | |
dateCreated | Date | 订单创建时间 | |
| shipperId | Integer | 发货人id | |
type | Short |
退件类型 （0:尾程退件;1:FBA退仓;2:买家退件） | |||
| typeMsg | String | 退件类型名称 | |
warehouseCode | String | 仓库代码 | |
| status | Short |
| 订单状态（0:已创建;1:已接收;2:已入库;3:已取消;4:已到仓;5:下单异常;6:入库异常） | |||
| statusMsg | String | 订单状态名称 | |
| correlationReferenceNo | String | 原始订单参考号 | |
| fbaReturnNo | String |
| FBA退货计划单号 | |
| fbaReturnId | String |
| FBA订单ID | |||
| eta | Date | 预计到达时间 | |
| returnReason | String | 退件原因 | |
| remark | String | 备注 | |
| lastMailType | Short |
| 运输方式（1:快递单; 2:陆运单） | |
| expressNoList | Array |
快递单号 |
| rmaNumber |
| String |
| 第三方单号 |
| putAwayDate |
| Date |
| 上架时间 |
| dateCreated |
| Date |
| 创建时间 |
| dateModified |
| Date |
| 更新时间 |
| productList | Array |
| 商品列表 |
| serviceName |
| String |
| 退件服务名称 |
| serviceCode | String |
| 退件服务代码 |
| senderAddress |
| Object |
...
| 发件人地址 |
productList参数
字段名 | 数据类型 | 最大长度 | 描述 | ||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
sku | String | 商品编码 | |||||||||||
| productCount | Integer | 数量 | |||||||||||
| handleType | Short | 处理方式（0:重新上架;1: | 20GP退回国内;2: | 40GP不良品;3: | 40HQ（HC）销毁;4: | 45HQ（HC）待检查;5: | 40RH;6:20HQ（HC）;7:45GP;8:20RH;10:45RH;11:20HT;12:40HT;13:20RF;14:40RF;15:45RF;16:20FR;17:40FR;18:20NOR;19:40NOR;20:20TK;21:40TK;22:45TK;23:20OT;24:40OT;25:45OT;26:20HZ;27:40HZ;28:45HZ;quantity | Integer | 集装箱数量 | containerNo | String | 海柜号 |
返回样例
...
| 换标;6:产品升级） | |||
| handleTypeMsg | String | 处理方式名称 | |
| goodProductCount | Integer | 处理结果数量（良品） | |
| defectiveProductCount | Integer | 处理结果数量（不良品） |
senderAddress参数
| contactName | String | 255 | M | 联系人姓名 |
| contactPhone | String | 255 | M | 联系人电话 |
| contantEmail | String | 255 | O | 联系人邮箱 |
| companyName | String | 255 | O | 联系人公司 |
| country | String | 2 | M | 国家二字码 |
| state | String | 128 | O | 州(省) |
| city | String | 128 | M | 城市 |
| district | String | 128 | O | 区 |
| postcode | String | 32 | O | 邮编 |
| addressLine1 | String | 512 | M | 地址1 |
| addressLine2 | String | 512 | O | 地址2 |
| addressLine3 | String | 512 | O | 地址3 |
返回样例
| 代码块 |
|---|
{
"code":"0",
"data":[
{
"correlationReferenceNo":"",
"eta":"",
"expressNoList":"",
"fbaReturnId":"333333",
"fbaReturnNo":"111111",
"lastMailType":2,
"lastMailTypeMsg":"Land",
"orderNo":"R7317220609000006O",
"productList":[],
"putAwayDate":"",
"referenceNo":"555555555",
"remark":"",
"returnReason":"",
"rmaNumber":"cv",
"shipperId":7317,
"status":1,
"statusMsg":"Accepted",
"thirdCreatedTime":"",
"type":1,
"typeMsg":"FBA Return",
"warehouseCode":"Alex-AU"
},
{
"correlationReferenceNo":"QQ20230009",
"eta":"",
"expressNoList":[
"78789798798"
],
"fbaReturnId":"",
"fbaReturnNo":"",
"lastMailType":1,
"lastMailTypeMsg":"Express",
"orderNo":"R15319241128000001O",
"productList":[
{
"defectiveProductCount":0,
"goodProductCount":1,
"handleType":0,
"handleTypeMsg":"Re-Launch",
"productCount":1,
"sku":"QQ001"
},
{
"defectiveProductCount":1,
"goodProductCount":0,
"handleType":2,
"handleTypeMsg":"Defective",
"productCount":1,
"sku":"QQ001"
}
],
"putAwayDate":"2024-11-28 14:32:18",
"referenceNo":"Q20241128001",
"remark":"",
"returnReason":"",
"rmaNumber":"",
"shipperId":15319,
"status":2,
"statusMsg":"Complete",
"thirdCreatedTime":"",
"type":2,
"typeMsg":"Buyer Return",
"warehouseCode":"Lynn001"
}
],
"errors":"",
"message":"",
"messageId":"",
"success":true,
"warnList":""
} |