当前位置: API文档
wms.stockout.Sales.searchPositionDetail(销售出库实际出库明细查询)
1.接口说明
1.1 接口描述:获取销售出库实际出库明细 |
1.2 适用版本:客户端V1.4.3.0及以上版本 |
1.3 增量获取:支持 |
1.4 时间跨度:起止时间跨度不超过60分钟 |
1.5注意事项:权限校验:【仓库权限】 |
2.调用场景
2.1 举例说明:财务系统、SAP、数据分析等系统的对接 |
3.请求参数说明
3.1 请求地址
环境 | HTTP地址 |
---|---|
测试环境 | http://47.92.239.46/openapi |
正式环境 | http://wdt.wangdian.cn/openapi |
3.2 公共请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 卖家账号, 由旺店通分配 | |
接口账号 | key | String | 是 | 由旺店通分配appkey, 在发送的数据中对应 key 字段,获取方式点击这里 | |
盐 | salt | String | 是 | 由旺店通分配appsecret,是由两部分构成, 冒号前面的部分是secret, 冒号后面的部分是salt. 例如一个appsecret是testsecret:testsalt, 那么secret为testsecret, salt为testsalt. | |
接口名称 | method | String | 是 | 调用的接口名称 | |
版本号 | v | String | 是 | 1.0 | |
秒级时间戳 | timestamp | Int | 是 | 秒级时间戳, 当前时间戳减去 2012-01-01 00:00:00(1325347200), 时间与服务器时间差120s内即合法。 | |
签名 | sign | String | 是 | 签名 | |
分页大小 | page_size | Int | 否 | 分页大小,分页查询必传 | |
分页编号 | page_no | Int | 否 | 分页编号,分页查询必传,标准接口page_no从0开始 | |
是否计算查询结果的总条数 | calc_total | Int | 否 | 是否计算查询结果的总条数, 需要计算则1, 否则填0 |
3.3 业务请求参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
查询参数 | params | Map<String, Object> | Y | 查询参数 | |
分页 | pager | pager | Y | 分页 |
params
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
开始时间 | start_time | String | 40 | y | 出库单最后修改时间, 格式: yyyy-MM-dd HH:mm:ss |
结束时间 | end_time | String | 40 | y | 最后修改时间 格式: yyyy-MM-dd HH:mm:ss |
出库单号 | stockout_no | String | 20 | n | 出库单号 |
销售订单号 | trade_no | String | 40 | n | 系统订单号(ERP订单号) |
仓库编号 | warehouse_no | String | 40 | n | 仓库编号 |
pager
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
分页大小 | page_size | Int | 4 | n | 分页大小(单量较大的卖家,page_size建议200以下) |
页号 | page_no | Int | 4 | n | 从0开始 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
状态码 | status | Int | y | 状态码,0表示调用成功 | |
错误信息 | message | String | y | 无错误信息不返回 | |
出库单信息 | data | Map<String, Object> | n | 出库单信息 |
data
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
总数 | total_count | Int | 11 | n | 查询条件总单据数 |
单据数据 | order_list | List<Map<String, Object>> | y | 单据数据 |
order_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
出库单ID | stockout_id | Int | 11 | y | 出库单ID |
出库单号 | stockout_no | String | 40 | y | 出库单号 |
仓库编号 | warehouse_no | String | 40 | y | 仓库编号 |
仓库id | warehouse_id | Int | 11 | y | 仓库主键 |
订单编号 | trade_no | String | 40 | y | 订单编号 |
销售出库单详情 | detail_list | List<Map<String, Object>> | y | 销售出库单详情 |
detail_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
销售出库单id | stockout_id | Int | 11 | y | 销售出库单id |
销售出库单明细id | stockout_detail_id | Int | 11 | y | 销售出库单明细id |
分配明细id | rec_id | Int | 11 | y | 分配明细id |
商家编码 | spec_no | String | 40 | Y | 商家编码 |
规格名称 | spec_name | String | 100 | y | 规格名称 |
货品编号 | goods_no | String | 40 | y | 货品编号 |
货品名称 | goods_name | String | 255 | y | 货品名称 |
货品简称 | short_name | String | 255 | y | 货品简称 |
条码 | barcode | String | 50 | y | 条码 |
分摊后单价 | share_price | Decimal(19,4) | y | 分摊后单价(对应页面货品成交价字段) | |
数量 | num | Decimal(19,4) | y | 数量 | |
分配数量 | dis_num | Decimal(19,4) | y | 分配数量(实际货位/批次分配到的数量) | |
货品批次 | batch_no | String | 40 | y | 货品批次号 |
有效期 | expire_date | String | y | 有效期 | |
货位 | position_no | String | 20 | y | 货位 |
备注 | remark | String | 255 | y | 订单明细备注 |
5.请求示例
[ { "start_time": "2022-12-05 15:54:02", "end_time": "2022-12-05 15:54:05", "trade_no": "JY202212050006", "stockout_no": "CK2022120534" } ] | |
<?php header("Content-Type: text/html; charset=UTF-8"); date_default_timezone_set("Asia/Shanghai"); $client = new WdtErpClient("url", "wdtapi3", "appkey", "secret") $parMap = new stdClass(); $parMap->start_time = '2022-12-05 15:54:02'; $parMap->end_time = '2022-12-05 15:54:05'; $parMap->trade_no = 'JY202212050006'; $parMap->stockout_no = 'CK2022120534'; //$parMap->warehouse_no = '0423'; $pager = new Pager(5, 0, true); $data = $client->pageCall("wms.stockout.Sales.searchPositionDetail", $pager, $parMap); ?> | |
JAVA | |
C# |
6.响应示例
6.1 正常响应示例
{ "status": 0, "data": { "total_count": 1, "order_list": [ { "warehouse_no": "0423", "detail_list": [ { "stockout_id": 73592, "stockout_detail_id": 291624, "rec_id": 20351, "barcode": "sjdcsz", "position_no": "J-3", "batch_no": "", "dis_num": 1.0000, "spec_no": "sjdcsz", "spec_name": "sjdcsz", "goods_no": "sjdcsz", "goods_name": "盛洁的脆柿子", "short_name": "", "share_price": 0.0000, "remark": "赠品策略编号:sss,规则名称:sss,原始单号:TID-WqEiYIJSgw", "num": 1.0000, "expire_date": "" }, { "stockout_id": 73592, "stockout_detail_id": 291625, "rec_id": 20352, "barcode": "sjdcsz", "position_no": "J-3", "batch_no": "", "dis_num": 6.0000, "spec_no": "sjdcsz", "spec_name": "sjdcsz", "goods_no": "sjdcsz", "goods_name": "盛洁的脆柿子", "short_name": "", "share_price": 8.3333, "remark": "", "num": 6.0000, "expire_date": "" }, { "stockout_id": 73592, "stockout_detail_id": 291626, "rec_id": 20353, "barcode": "sjdcsz", "position_no": "J-3", "batch_no": "", "dis_num": 1.0000, "spec_no": "sjdcsz", "spec_name": "sjdcsz", "goods_no": "sjdcsz", "goods_name": "盛洁的脆柿子", "short_name": "", "share_price": 10.0000, "remark": "", "num": 1.0000, "expire_date": "" } ], "stockout_no": "CK2022120534", "stockout_id": 73592, "trade_no": "JY202212050006", "warehouse_id": 11 } ] } } |
6.2 异常响应示例
{ "status": 100, "message": "您的查询时间过宽,查询时间不能大于60分钟" } |