版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

描述


获取退件单数据,最多查询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
Accept: application/json
Authorization:WallTech etotest8xkIIphLnbkjRACNj4P:pc9H97D-_b2_TSCVvNj81A
X-WallTech-Date:Tue, 02 Aug 2022 06:43:37 GMT

请求字段


字段名数据类型最大长度必填性描述
orderNoList
List300O订单号
referenceNoList
List300O订单参考号


请求样例


客户参考号样例:

{
    "referenceNoList": [
"EC03142        "Q20241128001",
        "555555555"
    ]
}


系统订单号样例:


{
    "orderNoList": [
        "R15319241128000001O",
        "C12283230314000003OR7317220609000006O"
    ]
}



返回参数


字段名

数据类型

最大长度

描述

referenceNo

String

客户参考号

orderNo

String

系统订单号

dateCreated

Date

订单创建时间

shipperIdInteger
发货人id

type

Short
退件类型

退件类型 (0:尾程退件;1:FBA退仓;2:买家退件)

typeMsgString
退件类型名称

warehouseCode

String

仓库代码

statusShort
订单状态

订单状态(0:已创建;1:已接收;2:已入库;3:已取消;4:已到仓;5:下单异常;6:入库异常)
statusMsgString
订单状态名称
correlationReferenceNoString
原始订单参考号
fbaReturnNoString
fba退货计划单号

FBA退货计划单号
fbaReturnIdString
fba订单id

FBA订单ID
etaDate
预计到达时间
returnReasonString
退件原因
remarkString
备注
lastMailTypeShort
运输方式:快递单、陆运单

运输方式(1:快递单; 2:陆运单)
expressNoListArray
快递单号(运输方式为快递单时必填)

快递单号

truckType
rmaNumber
Short
String
卡车类型(运输方式为陆运单时必填)

第三方单号
weight
putAwayDate
BigDecimal
Date
集装箱重量

上架时间
volume
dateCreated
BigDecimal
Date
集装箱体积

创建时间
expressNo
dateModified
String
Date
快递单号(运输方式为陆陆运单且卡车类型为散柜时必填)

更新时间
containerInfoList
productListArray
柜信息(运输方式为陆运单且卡车类型为整柜时必填)

商品列表
palletCount
serviceName
Integer
String
托盘数量

退件服务名称
rmaNumber
serviceCodeString
第三方单号

退件服务代码
putAwayDate
senderAddress
Date
Object
上架时间productListArray商品列表

柜信息


发件人地址


productList参数

字段名

数据类型

最大长度

描述

containerType

sku

String

商品编码

productCountInteger

数量

handleTypeShort


处理方式(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;

quantityInteger

集装箱数量

containerNoString海柜号

商品信息

...

字段名

...

数据类型

...

最大长度

...

描述

...

sku

...

商品编码

...

数量

...

返回样例

...

换标;6:产品升级)
handleTypeMsgString
处理方式名称
goodProductCountInteger
处理结果数量(良品)
defectiveProductCountInteger
处理结果数量(不良品)


senderAddress参数

contactNameString255M联系人姓名
contactPhoneString255M联系人电话
contantEmailString255O联系人邮箱
companyNameString255O联系人公司
countryString2M国家二字码
stateString128O州(省)
cityString128M

城市

districtString128O
postcodeString32O邮编
addressLine1String512M地址1
addressLine2String512O地址2
addressLine3String512O地址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":""
}