版本比较

标识

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

描述


获取退件单数据,最多查询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": [
        "Q20241128001",
        "EC03142555555555"
    ]
}


系统订单号样例:


{
    "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退货计划单号
fbaReturnIdString
FBA订单ID
etaDate
预计到达时间
returnReasonString
退件原因
remarkString
备注
lastMailTypeShort
运输方式(1:快递单; 2:陆运单)
expressNoListArray

快递单号

注:运输方式为快递单时必填

truckTypeShort

卡车类型(1:海运整柜;2:海运散柜;3:铁运整柜;4:铁运散柜)

注:运输方式为陆运单时必填

truckTypeMsg

String卡车类型名称weightBigDecimal集装箱重量volumeBigDecimal集装箱体积expressNoString

快递单号

注:运输方式为陆陆运单且卡车类型为散柜时必填

containerListArray

柜信息

注:运输方式为陆运单且卡车类型为整柜时必填

palletCountInteger托盘数量rmaNumberString
第三方单号
putAwayDateDate
上架时间
productListdateCreatedArrayDate
商品列表创建时间

...

dateModified
字段名
Date
数据类型

更新时间
最大长度
productList
描述
Array
containerType

商品列表
Short
serviceName

containerTypeMsgString名称quantityInteger

集装箱数量

containerNoString海柜号

商品信息

String
退件服务名称
serviceCodeString
退件服务代码
senderAddressObject
发件人地址


productList参数

字段名

数据类型

最大长度

描述

sku

String

商品编码

quantityproductCountInteger

数量

handleTypeShort
处理方式(0:重新上架;1:退回国内;2:不良品;3:销毁;4:待检查;5:换标;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":""
}