API文档

stockin_batch_detail.php（查询入库类接口委外回传的效期和批次信息）

1.接口说明

1.1 接口描述：入库类查询接口可以返回委外回传的效期，批次信息

1.2 适用版本：客户端 V2.6.1.2及以上版本

1.3 增量获取：

①若查询源单据编码src_order_no或入库单编码stockin_no时，start_time与end_time非必传，否则start_time与end_time必传，默认创建时间范围。

1.4 时间跨度：时间跨度：start_time和end_time最大跨度为30天（测试环境时间跨度start_time和end_time最大跨度为60分钟），开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-30 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

1.5 注意事项：本接口不返回淘系订单数据，淘系订单数据获取办法单击这里。

2.调用场景

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

3.请求参数说明

3.1 请求地址

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

3.2 公共请求参数

名称	字段	类型	必须	描述
卖家账号	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输入参数签名结果，签名算法介绍单击这里

3.3 业务请求参数

名称	字段	类型	长度	必须	描述
开始时间	start_time	datetime		是	增量获取数据，start_time作为开始时间，格式：yyyy-MM-dd HH:mm:ss
结束时间	end_time	datetime		是	增量获取数据，end_time作为结束时间，格式：yyyy-MM-dd HH:mm:ss
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为30，使用举例单击这里
页号	page_no	int		否	不传值默认从0页开始
源单据编码	src_order_no	varchar	40	否	源单据编码
入库单编码	stockin_no	varchar	40	否	入库单编码

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	11	否	只有page_no = 0 时才返回的符合条件的数据总条数，用来分页
入库委外回传节点	stockin_batch_detail	data[]		否	包含当前页的入库委外回传的数据节点,节点下数据字段详见下述“stockin_batch_detail”

4.2 业务响应参数

stockin_batch_detail

名称	字段	类型	长度	必须	描述
单据类型	type	int	4	是	订单类型：1采购入库单，2其他入库，3调拨入库，4退货入库，5委外其他入库,，6盘点入库，7jit入库
源单据id	src_order_id	int	11	是	源单据唯一标识
源单据编码	src_order_no	varchar	40	是	源单据编码
入库单id	stockin_id	int	11	是	入库单唯一标识
入库单编码	stockin_no	varchar	40	是	入库单编码
商品规格id	spec_id	varchar	40	是	单品表主键，唯一标识单品
批次	batch	varchar	40	是	委外回传批次
商品数量	num	int	11	是	入库商品数量
生产日期	product_date	datetime		是	生产日期，默认yyyy-MM-dd HH:mm:ss
有效期	expire_date	datetime		是	有效期，即过期日期，默认yyyy-MM-dd HH:mm:ss
备注	remark	varchar	255	是	备注
最后修改时间	modified	datetime		是	最后修改时间，格式：yyyy-MM-dd HH:mm:ss
创建时间	created	datetime		是	创建时间，格式：yyyy-MM-dd HH:mm:ss
商家编码	spec_no	varchar	40	是	商家编码，通过spec_id连表获得，可以将货品的goods_no和spec_code拼在一起,由程序自动管理
仓库名称	warehouse_name	varchar	64	是	仓库名称，通过仓库编号连表获得
仓库类型	warehouse_type	tinyint	4	是	仓库类型：0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它）
货品编码	goods_no	varchar	40	是	货品编码，必须唯一，可以系统生成，通过goods_id连表获得

5.请求示例

<?php
    require_once("../WdtClient.php");
    $c = new WdtClient;
    $c->sid = '';
    $c->appkey = '';
    $c->appsecret = '';
    $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/stockin_batch_detail.php';
     
    $c->putApiParam('start_time', '2021-06-02 00:00:00');
        $c->putApiParam('end_time', '2021-06-30 23:59:59');
        $c->putApiParam('stockin_no', 'RK2106030050');
        $c->putApiParam('src_order_no', 'TK2106030011');
    $json = $c->wdtOpenApi();
    var_dump($json);
?>

package com.wangdian.api.basic;
 
import java.io.IOException;
import java.util.HashMap;
import java.util.Map;
 
import com.wangdian.api.WdtClient;
 
public class StockinBatchDetail {
 
    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("start_time", "2021-06-02 00:00:00");
                params.put("end_time", "2021-06-30 23:59:59");
                params.put("stockin_no", "RK2106030050");
                params.put("src_order_no", "TK2106030011");
 
        try {
            String response = client.execute("stockin_batch_detail.php", params);
            System.out.println(response);
        } catch (IOException e) {
            // TODO Auto-generated catch block
            e.printStackTrace();
        }
    }
 
}

using System;
using System.Collections.Generic;
using System.Linq;
using System.Text;
using System.Threading.Tasks;
using WdtSdk;
 
namespace StockinBatchDetail
{
    class StockinBatchDetail
    {
        static void Main(string[] args)
        {
            WdtClient client = new WdtClient();
            client.sid = "";
            client.appkey = "";
            client.appsecret = "";
            client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/stockin_batch_detail.php";
 
            client.putParams("start_time","2021-06-02 00:00:00");
                        client.putParams("end_time", "2021-06-30 23:59:59");
                        client.putParams("stockin_no", "RK2106030050");
                        client.putParams("src_order_no", "TK2106030011");
            string result = client.wdtOpenapi();
            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}

import WdtClient
 
t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/')
params = {}
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("stockin_batch_detail.php", params)
print(response)

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "success",
    "total_count": "1",
    "stockin_batch_detail": [{
        "type": "4",
        "src_order_id": "2343",
        "src_order_no": "TK2106030011",
        "stockin_id": "11908",
        "stockin_no": "RK2106030050",
        "spec_id": "111",
        "batch": "20150820",
        "num": "2",
        "product_date": "2021-03-02 00:00:00",
        "expire_date": "2021-06-30 00:00:00",
        "remark": "",
        "modified": "2021-06-03 17:20:33",
        "created": "2021-06-03 17:20:33",
        "spec_no": "qmzc1",
        "warehouse_name": "奇门挡板自测",
        "warehouse_type": "20",
        "goods_no": "qmzc1"
    }]
}

6.2 异常响应示例

JSON

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