当前位置： API文档

wms.stockin.JitRefund.searchOrderWithDetail（JIT退货入库单查询）

¥标准

1.接口说明

1.1 接口描述：获取ERP的JIT退货入库单单据信息
1.2 适用版本：客户端 V1.4.3.9及以上版本
1.3 增量获取：按照最后修改时间获取
1.4 时间跨度：请求时间最大跨度为30天。

1.5注意事项：【权限校验】：仓库权限

2.调用场景

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

3.请求参数说明

   3.1 请求地址

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

  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
否分页编号，分页查询必传，标准接口page_no从0开始
是否计算查询结果的总条数calc_totalint
否是否计算查询结果的总条数, 需要计算则1, 否则填0         

   3.3 业务请求参数


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

params

Map<String, Object>
y

查询参数

分页pager
pager
y
分页

params

名称字段类型长度
必须描述
开始时间

start_time

String40y

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

结束时间

end_time

String40y结束时间, 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

List<Map<String, Object>>


y

JIT入库单相关数据

总数

total_count

Int

11n

查询条件总数单据

order_list

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

stockin_id

Int11y入库单id
入库单号

stockin_no

String40
y

入库单号

退货单号

refund_no

String40
y

退货单号

仓库编号

warehouse_no

String

40
y

仓库编号

仓库名称

warehouse_name

String64
y仓库名称
入库单状态statusInt
4
y

入库单状态

10：已取消
20：编辑中
30：待审核
37：待质检
40：质检待确认
80：已完成

最后修改时间

modified

String40y

入库单最后修改时间

创建时间createdString40
y入库单创建时间
审核时间check_time
String40
y审核时间
备注remarkString255
y备注
平台退货单号jit_refund_noString50y平台退货单号
制单人operator_nameString40y制单人
标记名称

flag_name

String32
y标记名称
便签数量

note_count

Int6
y便签数量
货品数量

goods_count

Decimal(19,4)
y货品数量

货品种类

goods_type_count

Int6y

货品种类

店铺编号

shop_no

String
20
y店铺编号
店铺id

shop_id

Int6
y店铺id
含税货款总额

tax_amount

Decimal(19,4)
y含税货款总额
货款金额
amountDecimal(19,4)
y货款金额
货品总成本
total_costDecimal(19,4)
y货品总成本
仓库idwarehouse_idshort
y仓库id
入库单明细列表

detail_list

List<Map<String, Object>>


y入库单明细列表

detail_list

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

stockin_id

Int11是入库单ID
商家编码

spec_no

String40
是

商家编码

预期入库数量

expect_num

Decimal(19,4)
是预期入库数量
数量

num

Decimal(19,4)
是入库数量
辅助数量

num2

Decimal(19,4)
是辅助数量
备注

remark

String255是

备注

货品名称goods_nameString255是

货品名称

货品编码goods_no

String

40
是货品编码
规格名称

spec_name

String100
是

规格名称

规格码

spec_code

String40是

规格码

是否残次品

defect

bool1
是

是否残次品

基本单位

base_unit_name

String20
是

基本单位

辅助单位

aux_unit_name

String20是

辅助单位

品牌编号

brand_no

String32
是品牌编号
品牌id

brand_id

Int11
是品牌id
成本价

checked_cost_price

Decimal(19,4)
是成本价
价格
price
Decimal(19,4)
是价格
含税价格tax_priceDecimal(19,4)
是含税价格
金额amountDecimal(19,4)
是金额
含税金额
tax_amountDecimal(19,4)
是含税金额
PO单
po_noString40
是PO单
总成本
checked_cost_amount
Decimal(19,4)
是总成本（建议使用该字段）
总成本total_costDecimal(19,4)
是总成本
明细idrec_idint
是明细id
单品idspec_idint
是

单品id

货品idgoods_idint
是货品id
最后修改时间modifiedString
是最后修改时间 格式: yyyy-MM-dd HH:mm:ss
创建时间createdString

创建时间 格式: yyyy-MM-dd HH:mm:ss

5.请求示例

Json格式请求报文
[{
"start_time": "2019-09-01 00:00:00",
"end_time": "2019-10-01 23:59:59"
}]
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.JitRefund.searchOrderWithDetail",$pager, $paraMap);
 
?>

JAVA
C#

6.响应示例

  6.1 正常响应示例 

JSON

{
    "status": 0,
    "data": {
        "total_count": 2,
        "order_list": [{
            "tax_amount": "0",
            "stockin_id": 88526,
            "amount": "0",
            "total_cost": "8.8888",
            "created": "2022-12-30 09:48:13",
            "detail_list": [{
                "stockin_id": 88526,
                "spec_no": "FFFFFFFFFFFFFFFF202011268479",
                "remark": "",
                "goods_name": "半身裙A8QZ920040",
                "goods_no": "QZ920040555",
                "spec_name": "绿色 S",
                "spec_code": "",
                "defect": false,
                "brand_id": 0,
                "checked_cost_price": 2,
                "price": 0,
                "tax_price": 0,
                "po_no": "12345678",
                "amount": 0,
                "tax_amount": 0,
                "checked_cost_amount": 2,
                "base_unit_name": "无",
                "aux_unit_name": "无",
                "num": "1.0000",
                "expect_num": "1.0000",
                "num2": "1.0000",
                "brand_no": "BRAND",
                "total_cost": "2"
            }, {
                "stockin_id": 88526,
                "spec_no": "FFFFFFFFFFFFFFFF202011268477",
                "remark": "",
                "goods_name": "半身裙A8QZ920040",
                "goods_no": "QZ920040556",
                "spec_name": "绿色 M",
                "spec_code": "",
                "defect": false,
                "brand_id": 0,
                "checked_cost_price": 2.3333,
                "price": 0,
                "tax_price": 0,
                "po_no": "12345678",
                "amount": 0,
                "tax_amount": 0,
                "checked_cost_amount": 4.6666,
                "base_unit_name": "无",
                "aux_unit_name": "无",
                "num": "2.0000",
                "expect_num": "6.0000",
                "num2": "2.0000",
                "brand_no": "BRAND",
                "total_cost": "4.6666"
            }, {
                "stockin_id": 88526,
                "spec_no": "FFFFFFFFFFFFFFFF202011268478",
                "remark": "",
                "goods_name": "半身裙A8QZ920040",
                "goods_no": "QZ920040558",
                "spec_name": "绿色 XL",
                "spec_code": "",
                "defect": false,
                "brand_id": 0,
                "checked_cost_price": 1.1111,
                "price": 0,
                "tax_price": 0,
                "po_no": "12345678",
                "amount": 0,
                "tax_amount": 0,
                "checked_cost_amount": 2.2222,
                "base_unit_name": "无",
                "aux_unit_name": "无",
                "num": "2.0000",
                "expect_num": "2.0000",
                "num2": "2.0000",
                "brand_no": "BRAND",
                "total_cost": "2.2222"
            }],
            "refund_no": "2342344234",
            "goods_type_count": 3,
            "remark": "",
            "goods_count": "5.0000",
            "flag_name": "无",
            "jit_refund_no": "3453245345",
            "operator_name": "刘子渲",
            "shop_id": 281,
            "warehouse_name": "nff1",
            "warehouse_no": "234234234",
            "stockin_no": "RK202212302",
            "modified": "2022-12-30 09:48:22",
            "note_count": 0,
            "status": 80,
            "check_time": "2022-12-30 09:48:22",
            "shop_no": "vip_yqf"
        }]
    }
}

   6.2 异常响应示例

JSON
{
    "status": 100,
    "message": "您的查询时间过宽,查询时间不能大于30天"
}



常用工具