当前位置: API文档

stock_goods_sn_query.php序列号管理查询接口

¥标准

1.接口说明

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,建议根据获取数据量的多少适当减小时间跨度。
1.5注意事项:(如果传序列号和商家编码时可以不用穿时间参数)

2.调用场景

2.1 举例说明:自有商城接入ERP、金蝶接入、用友接入、SAP接入等

3.请求参数说明

   3.1 请求地址

环境HTTP地址
测试环境https://sandbox.wangdian.cn/openapi2/stock_goods_sn_query.php
正式环境https://api.wangdian.cn/openapi2/stock_goods_sn_query.php

   3.2 公共请求参数

名称字段类型长度
必须描述
卖家账号sidString
购买ERP时由旺店通分配给ERP购买方,请从ERP购买方获取。
接口账号appkeyString
本开放平台“自助对接”功能模块内自助申请,获取方式点击这里
时间戳timestampint
北京时间1970-01-01 08:00:00起至现在的总秒数,10位int值,旺店通企业版API服务端允许请求最大时间误差为5min,date.timezone = Asia/Shanghai。
签名signString
API输入参数签名结果,签名算法介绍单击这里

   3.3 业务请求参数

名称字段类型长度必须描述
序列号
sn
String
20

序列号
商家编码
spec_no
String
40

商家编码
序列号状态
status
int
11

序列号状态:0已取消,5未启用,10初始录入,15二次录入,20已入库,30已占用,40已出库
货品编码
goods_noString40
货品编码
出库源单据编号
src_order_noString40

出库单对应的原始单据编号,比如订单编号,采购单号
入库源单据编号src_order_in_noString40入库单对应的原始单据编号,比如订单编号,采购单号
开始时间
start_timedatetime

序列号最后更新开始时间,格式:yyyy-MM-dd HH:mm:ss
结束时间
end_timedatetime

序列号最后更新结束时间,格式:yyyy-MM-dd HH:mm:ss

页码page_noint

页码,不传值默认从0页开始
页码大小page_sizeint
页面大小 每页返回的数据条数,输入值范围1~100,不传本参数,输入值默认为40


 4.响应参数

  4.1 公共响应参数


名称字段类型长度
必须描述
错误码codeint11状态码:0表示成功,其他表示失败
错误描述messagevarchar255错误描述
数据条数total_countint10符合条件的数据条数,用来分页 当page_no = 0时返回
序列号节点
goods_listdata[ ]
响应参数的1级数据节点,包含序列号数据节点,节点下数据字段详见下述“stockout_list”," stockin_list","position_list"及"logs_list"

   4.2 业务响应参数

goods_list

名称字段类型长度必须描述
序列号唯一码
rec_idint10序列号唯一码
序列号
snvarchar40序列号
序列号编码
sn_numbervarchar40序列号编码
仓库id
warehouse_idint10仓库id
仓库编码
warehouse_novarchar40仓库编码
仓库名称
warehouse_namevarchar40仓库名称
供应商编码
provider_novarchar40

供应商编码
供应商名称
provider_namevarchar64
供应商名称
序列号状态
status
int
11

序列号状态:0已取消,5未启用,10初始录入,15二次录入,20已入库,30已占用,40已出库
货品编码
goods_novarchar40货品编码
货品名称
goods_namevarchar40

货品名称
商家编码
spec_novarchar40商家编码
规格码spec_codevarchar40规格码
规格名称spec_namevarchar40规格名称
序列号最后更新时间createddatetime


序列号最后更新时间,格式:yyyy-MM-dd HH:mm:ss
序列号类型sn_typeint11序列号类型:1,强序列号2,弱序列号
序列号创建类型created_typeint11序列号创建类型:0:外部录入 1:手动创建
入库单据明细节点stockin_listdata
入库单据明细节点,字段详细见stockin_list表
出库单据明细节点stockout_listdata
出库单据明细节点,字段详细见stockout_list表
货品库位库存节点position_listdata
货品库位库存节点,字段详细见position_list表
序列号操作日志节点logs_listdata
序列号操作日志节点,字段详细见logs_list表

  stockin_list

名称字段类型长度必须描述
入库单编号
stockin_novarchar40入库单编号
入库类型order_type_namevarchar40
入库类型
源单号src_order_novarchar40入库单源单号
入库单状态
status
int
10

入库单状态
经办人
shortnamevarchar
40

入库单经办人
建单时间
created
datetime
入库单建单时间,格式:yyyy-MM-dd HH:mm:ss
审核时间
check_timedatetime

入库单审核时间,格式:yyyy-MM-dd HH:mm:ss

  stockout_list

名称字段类型长度必须描述
出库单编号
stockout_novarchar40出库单编号
出库类型order_type_namevarchar40
出库类型
源单号src_order_novarchar40出库单源单号
入库单状态
status
int
10

出库单状态
经办人
shortnamevarchar
40

出库单经办人
建单时间
created
datetime
出库单建单时间,格式:yyyy-MM-dd HH:mm:ss

  position_list

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

仓库编码

仓库名称warehouse_namevarchar40仓库名称
商家编码spec_novarchar40商家编码
货品编号goods_novarchar40货品编号
货品名称goods_namevarchar40货品名称
规格码spec_codevarchar40规格码
规格名称spec_namevarchar40规格名称
条形码barcodevarchar40条形码
货位position_novarchar40货位
货区zone_novarchar40货区
库存量stock_numdecimal(19,4)库存量
今日销量today_numdecimal(19,4)今日销量
未付款量unpay_numdecimal(19,4)未付款量
预订单量subscribe_numdecimal(19,4)预订单量
待审核量order_numdecimal(19,4)待审核量
待发货量sending_numdecimal(19,4)待发货量
委外出库占用量wms_reserve_numdecimal(19,4)委外出库占用量
生产在途量process_onway_numdecimal(19,4)生产在途量
锁定量lock_numdecimal(19,4)锁定量
待采购量to_purchase_numdecimal(19,4)待采购量
采购在途purchase_numdecimal(19,4)采购在途
采购到货量purchase_arrive_numdecimal(19,4)采购到货量
调拨在途transfer_numdecimal(19,4)调拨在途
采购退货return_numdecimal(19,4)采购退货
销售退货在途量refund_onway_numdecimal(19,4)销售退货在途量
仓储库存wms_sync_stockdecimal(19,4)仓储库存
库存差异wms_stock_diffdecimal(19,4)库存差异
昨日销量num_yesterdaydecimal(19,4)昨日销量
7天销量num_7daysdecimal(19,4)7天销量
14天销量num_14daysdecimal(19,4)14天销量
月销量num_monthdecimal(19,4)月销量
总销量num_alldecimal(19,4)总销量
默认货位is_default_posiitonint
11
默认货位
库存标记flag_namevarchar
40
库存标记

  logs_list

名称字段类型长度必须描述
事件
event_typevarchar40

事件
仓库编号
warehouse_novarchar40

仓库编号
仓库名称
name
varchar40

仓库名称
操作人
shortnamevarchar40

操作人
内容
messagevarchar512

操作内容
时间
createddatetime


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

5.请求示例

PHP
<?php
require_once ('./WdtClient.php');
$c = new WdtClient();
$c->sid = 'apidevnew2';
$c->appkey = '';
$c->appsecret = '';
$c->gatewayUrl = 'http://api.wangdian.cn/openapi2/stock_goods_sn_query.php';

$c->putApiParam('start_time','2020-05-25 00:56:02');
$c->putApiParam('end_time','2020-05-25 23:58:02');

$json = $c->wdtOpenApi();
var_dump($json);
?>
JAVA
package com.wangdian.api.stock;

import java.io.IOException;
import java.util.HashMap;
import java.util.Map;

import com.wangdian.api.WdtClient;

public class StockGoodsSnQuery {

    public static void main(String[] args) {
        // TODO Auto-generated method stub
        WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url");
        //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看,测试环境url=https://sandbox.wangdian.cn/openapi2/
        //调用正式环境时请将sid、appkey、appsecret切换为实际参数,参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看,调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/
        
        Map<String, String> params = new HashMap<String, String>();
        //params.put("sn", "");
        params.put("start_time", "2021-12-27 16:47:44");
        params.put("end_time", "2022-01-20 16:47:44");

        try {
            String response = client.execute("stock_goods_sn_query.php", params);
            System.out.println(response);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }

}
C#
using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;
 
namespace StockGoodsSnQuery
{
    class StockGoodsSnQuery
    {
        static void Main(string[] args)
        {
            WdtClient client = new WdtClient();
            client.sid = "";
            client.appkey = "";
            client.appsecret = "";
            client.gatewayUrl = "https://sandbox.wangdian.cn/openapi2/stock_goods_sn_query.php";
 
            client.putParams("start_time", "2017-04-05 00:00:00");
            client.putParams("end_time", "2017-04-05 23:59:59");
            
 
            string result = client.wdtOpenapi();
            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
  }
python
import WdtClient

t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/')
params = {}
params.update({"spec_no": ''})
params.update({"sn": ''})
params.update({"start_time": '2021-01-01 00:00:00'})
params.update({"end_time": '2021-01-01 00:59:59'})
params.update({"page_size": '40'})
params.update({"page_no": '0'})

response = t.execute("stock_goods_sn_query.php", params)
print(response)

6.响应示例

   6.1 正常响应示例 

JSON
{
    "code": 0,
    "message": "succeed",
    "total_count": 1,
    "goods_list": [{
        "rec_id": "537",
        "sn": "SN20200520289",
        "sn_number": "",
        "warehouse_id": "8",
        "spec_id": "2076",
        "provider_id": "0",
        "status": "40",
        "sn_type": "1",
        "created_type": "0",
        "spec_no": "强SN-3",
        "goods_name": "强序列号货品1",
        "short_name": "强序列号货品1",
        "goods_no": "202005181608",
        "spec_code": "强序列号货品1",
        "spec_name": "强序列号货品1",
        "created": "2020-05-25 09:42:38",
        "stockin_list": [{
            "rec_id": "537",
            "spec_id": "2076",
            "stockin_id": "278",
            "stockin_no": "RK2005200006",
            "src_order_type": "6",
            "src_order_no": "",
            "status": "80",
            "operator_id": "2",
            "created": "2020-05-20 14:08:33",
            "check_time": "2020-05-20 14:10:04",
            "order_type_name": "其他入库"
        }],
        "stockout_list": [{
            "rec_id": "537",
            "spec_id": "2076",
            "stockout_id": "614",
            "stockout_no": "CK2020052501",
            "status": "110",
            "src_order_type": "1",
            "src_order_no": "JY202005250001",
            "operator_id": "2",
            "created": "2020-05-25 09:21:51",
            "order_type_name": "销售订单"
        }],
        "position_list": [],
        "logs_list": [{
            "rec_id": "537",
            "spec_id": "2076",
            "operator_id": "2",
            "event_type": "销售出库",
            "warehouse_id": "8",
            "warehouse_no": "zsy001",
            "name": "zsy的小仓库",
            "shortname": "闫玉坤",
            "message": " 出库单号:CK2020052501 货品:强序列号货品1 商家编码:强SN-3",
            "created": "2020-05-25 09:42:38"
        }]
    }]
}

   6.2 异常响应示例

JSON
{
    "code": 2180,
    "message": "start_time与end_time时间跨度不能超过最大范围30天"
}







常用工具