当前位置: API文档

wms.stockin.Refund.queryWithDetail(退货入库单查询)

¥标准

1.接口说明

1.1 接口描:获取ERP的退货入库单单据信息
1.2 适用版本:客户端 V1.2.4.3及以上版本
1.3 增量获取:支持
1.4 时间跨度:start_time和end_time最大跨度为30天。

1.5注意事项:【权限校验】:仓库权限 为了达到保护用户隐私数据安全的目的本接口不返回淘系订单数据相关平台规则点击这里淘系数据获取办法点击这里

本接口中涉及到用户隐私的字段数据仅自有平台订单返回。具体字段详情见下面表格;

字段描述字段名
买家昵称buyer_nick
收件人姓名receiver_name
收件地址receiver_address
收件人手机receiver_mobile
收件人固话
receiver_telno
客户姓名customer_name
证件号码id_card

2.调用场

2.1 举例说明:财务系统、SAP、数据分析等系统的对接

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境http://47.92.239.46/openapi
正式环境http://wdt.wangdian.cn/

  3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
卖家账号, 由旺店通分配
接口账号keyString
由旺店通分配appkey, 在发送的数据中对应 key 字段
saltString
由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt.
接口名称methodString
调用的接口名称
版本号vString
1.0
秒级时间戳timestampint
秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。
签名signString
签名
分页大小page_sizeint
分页大小,分页查询必传
分页编号page_noint
分页编号,分页查询必传
是否计算查询结果的总条数calc_totalint
是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数


名称字段类型长度
必须描述
查询参数

params

Map<String, Object>
y

查询参数

分页pager
pager
y
分页

params

名称字段类型长度
必须描述
仓库编号

warehouse_no

String


n

仓库编号

入库单号

stockin_no

String
n入库单号
退换单号refund_noString
n退换入库
店铺编号shop_nosString
n多个编号间使用英文逗号分隔

入库单状态

statusString255

英文逗号拼接的状态值:

10=已取消;20=编辑中;30=待审核;37=待质检;40=质检确认;

60=待结算;70=暂估结算;80=已完成

时间条件类型
time_type
int

n查询的时间条件类型, 0:修改时间; 1:入库时间 不传默认为0
开始时间

start_time

Date
y

起始时间, yyyy-MM-dd HH:mm:ss格式

结束时间

start_time

Date
y结束时间, yyyy-MM-dd HH:mm:ss格式

pager


名称字段类型长度
必须描述
分页大小

page_size

int4n

分页大小

页号

page_no

int4n

从0开始

4.响应参数

名称字段类型长度
必须描述
状态码statusint
y

返回0为正常

错误信息messageString
n无错误信息不返回
退货入库单信息dataMap<String, Object>
n退货入库信息

data

响应参数说明示例值或者格式、具体含义、使用方法及注意事项(如隐私数据淘系平台不返回,其他平台正常返回

名称字段类型长度
必须描述
单据数据

order

List<Map<String, Object>>


y

入库单相关数据

总数

total_count

int

11n

查询条件总数单据

order

名称字段类型长度
必须描述
入库单号

order_no

String
y

入库单号

入库单状态statusint

y入库单状态,参考传入参数描述
仓库编号

warehouse_no

String


y

仓库编号

仓库名称

warehouse_name

String
y仓库名称
入库单创建时间created_timetimestamp
y入库单创建时间
入库单备注remarkString
y入库单备注

物流方式

logistics_type

int
y

物流方式

审核时间check_time
String
y审核时间
退换单号

refund_no

String
y

退换单号

货品总数

goods_count

Decimal(19,4)
y货品总数
退换单实际退款金额

actual_refund_amount

Decimal(19,4)
y退换单实际退款金额
客户编码

customer_no

String
y客户编码
退货人姓名

customer_name

String
y退货人姓名
客户网名

nick_name

String
y客户网名
店铺名称

shop_name

String
y店铺名称
店铺编号

shop_no

String
y店铺编号
店铺备注

shop_remark

String
y店铺备注
标记名称

flag_name

String
y标记名称
订单编号

trade_no_list

String
y订单编号,若为多个以“,”分割
入库单总金额

total_price

Decimal(19,4)
y入库单总金额
最后修改时间

modified

String
y

退货入库单最后修改时间, 样例: 2020-04-23 14:55:08

入库单明细

details_list

List<Map<String, Object>>


y入库单明细

details_list

名称字段类型长度
必须描述
入库单id

stockin_id

int
入库单ID
数量

num

Decimal(19,4)
数量
退回价格cost_priceDecimal(19,4)
退回价格
总成本total_costDecimal(19,4)
总成本
明细备注

remark

String

明细备注

调整后数量right_numDecimal(19,4)
调整后数量
明细ID(主键)

rec_id

int

明细ID(主键)

货品名称goods_nameString

货品名称

货品编码goods_no

String


货品编码
商家编码

spec_no

String

商家编码

自定义属性2

prop2

String

自定义属性2

规格名

spec_name

String

规格名

规格码

spec_code

String

规格码

品牌编号

brand_no

String

品牌编号

品牌名称

brand_name

String

品牌名称

入库单位名称

goods_unit

String

入库单位名称

基本单位名称

basic_unit_name

String

基本单位名称

批次号

batch_no

String

批次号

有效期

expire_date

String

有效期

货位

position_no

String

货位

5.请求示例

Json格式请求报文
[{
"start_time": "2019-09-01",
"end_time": "2019-10-01"
}]
PHP

<?php
header("Content-Type: text/html; charset=UTF-8");
date_default_timezone_set("Asia/Shanghai");
require_once('wdtsdk.php');
 
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret");
 
$paraMap = new stdClass();
$paraMap->start_time = "2019-09-01";
$paraMap->end_time = "2019-10-01";
 
 
$pager = new Pager(1, 0, true);
$response = $client->pageCall("wms.stockin.Refund.queryWithDetail",$pager, $paraMap);
 
?>

JAVA

C#

6.响应示

  6.1 正常响应示例 

JSON

{
"status": 0,
"data": {
"total_count": 63,
"order": [{
"order_no": "RK1909180009",
"details_list": [{
"stockin_id": 1587,
"num": 1.0000,
"src_price": 5.0000,
"price": 5.0000,
"total_cost": 2.0000,
"remark": "[[2102336978]x4.0000;2102340340]x3.0000;",
"right_num": 1.0000,
"rec_id": 2232,
"goods_name": "张钟墙的苹果",
"goods_no": "zzqdpg",
"spec_no": "zzqdpg",
"prop2": "",
"spec_name": "111111111",
"spec_code": "",
"brand_no": "BRAND",
"brand_name": "无",
"platform_id": 0,
"trade_no": "JY201908260009",
"trade_type": "线下订单"
}],
"seq_no": 1,
"created_time": 1568802721000,
"stockin_id": 1587,
"customer_no": "KH201809200001",
"total_price": 2.0000,
"refund_no": "TK1909180004",
"trade_no_list": "JY201908260009",
"remark": "----ZS201908260008",
"goods_count": 1.0000,
"shop_name": "张钟墙的店铺",
"warehouse_name": "张钟墙的仓库",
"actual_refund_amount": 5.0000,
"warehouse_no": "960430",
"shop_remark": "",
"nick_name": "张钟墙",
"customer_name": "",
"stockin_time": 1568802722000,
"status": 80,
"check_time": 1568802721000,
"shop_no": "960430"
}]
}
}

   6.2 异常响应示例

JSON
{
"status": 100,
"message": "仓库不存在"
}


常用工具