当前位置: API文档
stock_inout_sn_query.php(查询出入库对应序列号)
1.1 接口描述:序列号出入库查询 |
1.2 适用版本:客户端 V2.4.5.0及以上版本 |
1.3 增量获取:按照序列号的最后修改时间增量获取数据,请求时输入start_time和end_time作为时间跨度的筛选条件。 |
1.4 时间跨度:start_time和end_time最大跨度为30天,开始时间和结束时间取值范围为闭区间取值,例如2018-11-01 00:00:00至2018-11-30 23:59:59,建议根据获取数据量的多少适当减小时间跨度。 |
2.1 举例说明:自有商城接入ERP、金蝶接入、用友接入、SAP接入等 |
环境 | HTTP地址 |
---|---|
测试环境 | https://sandbox.wangdian.cn/openapi2/stock_inout_sn_query.php |
正式环境 | https://api.wangdian.cn/openapi2/stock_inout_sn_query.php |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
卖家账号 | sid | String | 是 | 购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。 | |
接口账号 | appkey | String | 是 | 本开放平台“自助对接”功能模块内自助申请,获取方式点击这里 | |
时间戳 | timestamp | int | 是 | 北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。 | |
签名 | sign | String | 是 | API输入参数签名结果,签名算法介绍单击这里 |
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
出入库单号 | order_no | varchar | 否 | 出入库单号(按照单号查询不校验时间) | |
单据类型 | order_type | int | 否 | 0 出库单 1 入库单,默认0 | |
源单据类型 | sub_order_type | int | 否 | 源单据类型 出库单:1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 13委外出库 入库单: 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 12 委外入库 | |
序列号 | sn | varchar | 否 | 序列号 传该字段可以不传开始时间和结束时间 | |
商家编码 | spec_no | varchar | 否 | 商家编码 | |
开始时间 | start_time | datetime | 是 | 序列号最后更新时间,格式:yyyy-MM-dd HH:mm:ss | |
结束时间 | end_time | datetime | 是 | 序列号最后更新时间,格式:yyyy-MM-dd HH:mm:ss | |
页码 | page_no | int | 否 | 页码,不传值默认从0页开始 | |
页面大小 | page_size | int | 否 | 页面大小 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40 |
4.响应参数
4.1 公共响应参数
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
错误码 | code | int | 11 | 是 | 状态码:0表示成功,其他表示失败 |
错误描述 | message | varchar | 255 | 是 | 错误描述 |
数据条数 | total_count | int | 10 | 否 | 符合条件的数据条数,用来分页 当page_no = 0时返回 |
序列号出入库数据 | details_list | data[ ] | 否 | 响应参数的1级数据节点,包含当前页的序列号出入库的数据节点,节点下数据字段详见下述 |
4.2 业务响应参数
details_list
名称 | 字段 | 类型 | 长度 | 必须 | 描述 |
---|---|---|---|---|---|
出入库单号 | order_no | varchar | 40 | 是 | 出入库单号 |
源单号类型 | src_order_type | int | 11 | 是 | 源单号类型 出库单:1销售订单, 2调拨出库, 3采购退货出库, 4盘亏出库, 5生产出库, 6现款销售出库, 7其他出库, 8多发出库, 9纠错出库,10保修配件出库, 11初始化出库, 12jit拣货出库 入库单: 1采购入库, 2调拨入库, 3退货入库, 4盘盈入库, 5生产入库, 6其他入库, 7保修入库, 8纠错入库, 9初始化入库 10 预入库 11 JIT退货入库 |
源单号 | src_order_no | varchar | 40 | 是 | 源单号 |
序列号 | sn | varchar | 40 | 是 | 序列号 |
商家编码 | spec_no | varchar | 40 | 是 | 商家编码 |
创建时间 | created | datetime | 是 | 创建时间,格式:yyyy-MM-dd HH:mm:ss |
6.响应示例
6.1 正常响应示例
6.2 异常响应示例
JSON | { "code": 2180, "message": "start_time与end_time时间跨度不能超过最大范围30天" } |