API文档

jit_delivery_order_query.php（查询JIT出仓单）

1.接口说明

1.1 接口描述：获取旺店通网页版ERP-唯品JIT-出仓单数据

1.2 适用版本：网页版

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.调用场景

2.1 数据分析、SAP、财务系统等系统对接

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/jit_delivery_order_query.php
正式环境	https://openapi.huice.com/openapi/jit_delivery_order_query.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 业务请求参数

名称	字段	类型	长度	必须	描述
出仓单状态	delivery_status	int	4	否	出库单状态待出仓:10 已上传:50 已出库:100 已取消:120
开始时间	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	10	否	每页返回数据条数，参数输入值范围1~100，不传此参数默认page_size=40，使用举例单击这里
页号	page_no	int	10	否	不传值默认从0页开始

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
数据条数	total_count	int	10	否	符合条件的数据条数，用来分页当page_no = 0时返回
出仓单列表节点	data	data[ ]		否	响应参数的1级数据节点，包含当前页的JIT出库单及其明细的数据节点,节点下数据字段详见下述“data”和" details_list"

4.2 业务响应参数

data

名称	字段	类型	长度	必须	描述
出仓单主键id	id	int	11	是	出仓单主键id
出仓单号	delivery_no	varchar	40	是	出仓单号
店铺编号	shop_no	varchar	40	是	店铺编号
唯品入库单号	jit_stockin_no	varchar	40	是	唯品入库单号
收货仓名称	jit_warehouse_name	varchar	40	否	收货仓名称
推单单号	push_no	varchar	40	是	推单单号
发货仓编码	warehouse_id	int	11	是	代表仓库所有属性的唯一id，用于仓库区分
预计发货时间	delivery_time	datetime		是	预计发货时间
预计到货时间	out_time	datetime		是	预计到货时间
物流单号	logistics_no	varchar	255	是	物流单号
状态	delivery_status	int		是	出库单状态待出仓:10 已上传:50 已出库:100 已取消:120
货品列表节点	detail_list	data[ ]		是	响应参数的2级数据节点，包含出库单所有货品属性信息的数据节点，节点下数据字段详见下述“detail_list”列表

details_list

名称	字段	类型	长度	必须	描述
商家编码	spec_no	varchar	40	是	商家编码
数量	num	decimal	(19,4)	是	数量

5.请求示例

PHP	<?php require_once ('../WdtClient.php'); $c = new WdtClient(); $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'https://openapi.huice.com/openapi/jit_delivery_order_query.php'; $c->putApiParam('start_time', '2026-02-01 15:38:55'); $c->putApiParam('end_time', '2026-02-30 15:38:55'); $c->putApiParam('page_size', '100'); $c->putApiParam('page_no', '0'); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 17,
    "data": [
        {
            "id": "2848171296557105156",
            "delivery_no": "JPO2607090004",
            "delivery_status": 10,
            "push_no": "test1111",
            "jit_stockin_no": "12345",
            "jit_warehouse_name": "华北仓",
            "warehouse_id": "54",
            "delivery_time": "2026-07-09 20:00:00",
            "out_time": "2026-07-10 20:00:00",
            "logistics_no": "test1111test1111test1111",
            "detail_list": [
                {
                    "num": "1",
                    "sku_no": "Y29262022S16004"
                },
                {
                    "num": "1",
                    "sku_no": "Y332821009S14001"
                },
                {
                    "num": "1",
                    "sku_no": "Y332821009S17001"
                }
            ]
        }
    ]
}

6.2 异常响应示例

JSON	{ "code": 2160, "message": "start_time和end_time为空或不是有效的时间格式" }