当前位置： API文档

wms.stockout.JitOrder.search（JIT出库单查询）

1.接口说明

1.1 接口描述：获取ERP的JIT出库单单据信息
1.2 适用版本：客户端 V1.5.3.3及以上版本
1.3 增量获取：按照制单时间进行获取
1.4 时间跨度：

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

名称字段类型长度
必须描述
标记名称

flag_name

String
32
y标记名称
货品数量

goods_count

Decimal(19,4)
y

货品数量

货品种类数

goods_type_count

Int11
y

货品种类数

物流公司名称

logistics_company_name

String

40
y

系统内手动维护的物流公司名称

物流单号logistics_no
String40
y物流单号
物流公司idlogistics_idint
y系统内手动维护的物流公司对应的id
制单员
operator_name
String
50y制单员
po编号列表

po_no_list

String255
y

po编号列表

收货仓名称
receive_warehouse_name
String64
y收货仓名称
收货仓编号
receive_warehouse_noString40
y收货仓编号
备注remarkString255
y备注
店铺编号shop_noString20y店铺编号
店铺idshop_idshort
y店铺id
店铺名称shop_nameString128y店铺名称
平台拣货单号src_tidsString255y平台拣货单号
状态
statusByte
y状态
出库单号stockout_noString40
y出库单号
出库单idstockout_idInt11y出库单id
仓库编号
warehouse_noString40
y仓库编号
仓库名称warehouse_nameString64
y仓库名称
仓库idwarehouse_idint
y仓库id
邮费
weigh_post_costString40
y邮费
发货时间consign_timeString
y发货时间，

格式: yyyy-MM-dd HH:mm:ss

最后修改时间modifiedString
y最后修改时间格式: yyyy-MM-dd HH:mm:ss

创建时间

createdString
y

创建时间，

格式: yyyy-MM-dd HH:mm:ss

销售总金额
amountDecimal(19,4)
y销售总金额（供货价*数量）
明细列表

detail_list

List<Map<String, Object>>


y明细列表

detail_list

名称字段类型长度
必须描述
条码
barcodeString
50是条码
批次号
batch_noString
40
是

批次号

品牌名称brand_nameString64
是品牌名称
是否残次品defectboolean
是是否残次品
有效期

expire_date

String

是有效期
货品名称goods_nameString255是

货品名称

货品编码goods_no

String

40
是货品编码
数量
numDecimal(19,4)
是

数量

备注remarkString255是备注
规格编码spec_code

String

40
是规格编码
规格名称

spec_name

String100
是

规格名称

总体积

volume

Decimal(19,4)
是

总体积，货品长宽高*数量

总重量

weight

Decimal(19,4)
是

总重量，货品重量*数量

商家编码
spec_no

String

40
是商家编码
品牌编号brand_no

String

32是品牌编号
品牌名称brand_name

String

64是品牌名称
审核时成本
checked_cost_price

Decimal(19,4)


是审核时成本（货品出库时的瞬时成本）
含税供货价tax_price

Decimal(19,4)


是含税供货价
供货价price

Decimal(19,4)


是供货价
出库单idstockout_idint
是出库单id
货品idgoods_idint
是货品id
单品idspec_idint
是单品id
最后修改时间modifiedString
是最后修改时间格式: yyyy-MM-dd HH:mm:ss

创建时间

createdString
是

创建时间，

格式: yyyy-MM-dd HH:mm:ss

明细idrec_idint
是明细id
po单号po_no
String
是po单号

5.请求示例

Json格式请求报文
[
    {
        "end_time": "2022-08-30 11:10:04",
        "start_time": "2022-08-25 11:10:04"
    }
]
PHP

<?php
include 'wdtsdk.php';
  
$client = new WdtErpClient("url", "wdtapi3", "appkey", "secret")

$parMap = new stdClass();
$parMap->start_time = '2022-08-25 11:10:04' ;
$parMap->end_time = '2022-08-30 11:10:04' ;

$pager = new Pager(2, 0, true);

try {
    $data = $client->pageCall("wms.stockout.JitOrder.search", $pager, $parMap);
}catch(WdtErpException $e)
{
    echo $e->getMessage();
}
?>

JAVA
C#

6.响应示例

  6.1 正常响应示例 

JSON

{
    "status": 0,
    "data": {
        "total_count": 4,
        "order_list": [{
            "flag_id": 0,
            "consign_time": "2022-10-18 11:19:34",
            "operator_id": 23,
            "detail_list": [{
                "stockout_id": 1630052,
                "spec_id": 158800,
                "goods_name": "阿拉蕾 新品黄色",
                "goods_no": "all",
                "num": 2,
                "spec_name": "黄色",
                "spec_code": "",
                "defect": false,
                "barcode": "all1",
                "remark": "",
                "batch_no": "",
                "expire_date": "",
                "brand_id": 2138,
                "price": 0,
                "tax_price": 0,
                "checked_cost_price": 8.95,
                "spec_no": "all1",
                "brand_name": "商品",
                "brand_no": "BD202103300001",
                "volume": "0",
                "weight": "4"
            }],
            "goods_type_count": 1,
            "remark": "",
            "receive_warehouse_id": 30,
            "goods_count": 2,
            "stockout_id": 1630052,
            "flag_name": "无",
            "logistics_id": 972,
            "warehouse_no": "zxy03",
            "logistics_company_name": "唯品专配22",
            "shop_no": "vip_yqf",
            "receive_warehouse_name": "VIP_BJ",
            "receive_warehouse_no": "VIP_BJ",
            "amount": "0.00000000",
            "logistics_no": "111111112",
            "created": "2022-10-18 11:19:04",
            "stockout_no": "CH202210183",
            "shop_name": "唯品测试_勿用勿用!!!",
            "src_tids": "PICK-20220901003",
            "shop_id": 281,
            "operator_name": "aaaaa",
            "weigh_post_cost": 0,
            "warehouse_name": "zxy的测试仓3",
            "po_no_list": "34565466576713333",
            "warehouse_id": 395,
            "status": 110
        }]
    }
}

   6.2 异常响应示例

JSON
{
    "message": "时间参数必填",
    "status": 100
}




常用工具