API文档

stockout_order_query_trade.php（销售出库单）

奇门接口url wdt.stockout.order.query.trade

¥增值

1.接口说明

1.1 接口描述：查询销售出库单// Y目前没有走销售出库流程目前没有，直接使用已发货的订单作为替代

1.2 时间跨度：时间跨度：start_time和end_time最大跨度为30天。建议根据获取数据量的多少适当减小时间跨度。

1.5注意事项：为了达到保护用户隐私数据安全的目的，本接口不返回淘系、拼多多及系统供销平台订单数据，相关平台规则点击这里，淘系及系统供销平台数据获取办法点击这里，拼多多请自行对接平台获取。

本接口中涉及到用户隐私的字段数据仅有自有平台及线下平台订单返回。

2.调用场景

2.1 查询平台原始订单

3.请求参数说明

3.1 请求地址

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

名称	Y字段	描述	必须
开始时间	start_time	修改起始时间，若无订单号/物流单号，则为必填。示例：“ 2021-11-11 00:00:00”	时间开始和结束和系统单号不能同时为空
结束时间	end_time	修改结束时间，上同开始时间。示例：“ 2021-11-11 01:00:00”
店铺编码	shop_no	代表店铺所有属性的唯一编码，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
仓库编码	warehouse_no	代表仓库所有属性的唯一编码，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
时间类型	time_type	时间类型默认不填为修改时间 1 修改时间 2 发货时间	否
系统订单号	src_order_no	系统订单号，多个用,分隔	传入系统订单号可以不传时间
原始单号	tid	原始单号	否
状态类型	status_type	1-已发货及以后 2-已审核及以后默认已发货及以后	传入原始单号可以不传时间
是否仅获取库存数据	fetch_stock_only	1-是, 0-否, 默认为否
分页大小	page_size	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100，使用举例单击这里	否
页号	page_no	页号，不传默认从0页开始	否

4.响应参数

4.1 公共响应参数

名称	字段	类型	长度	必须	描述
错误码	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	varchar	255	是	错误描述
条数	total_count	varchar	255	是	符合查询条件的总数量，只有page_no = 0 时才有值。
原始单节点	stockout_list	data[]		是	业务数据的一级节点，数组形式的订单数据，需要循环读取。

4.2 业务响应参数

stockout_list

名称	字段	类型	是否必须	默认值	是否可变更
销售出库单id	stockout_id	bigint(20)	是		否
销售出库单号	order_no	string	是		否
订单状态	status	tinyint(4)	是	4 已取消（可恢复） 5 已取消 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货	是
订单退款状态	refund_status	tinyint(4)	是	订单退款状态 0-无退款 1-申请退款 2-部分退款 3-全部退款
订单类型	trade_type	string	是	订单类型
系统订单号	src_order_no	string	是		否
仓库id	warehouse_id	int(11)	是	代表仓库所有属性的唯一id，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看	是
仓库编码	warehouse_no	string	是	代表仓库所有属性的唯一编码，用于仓库区分，在旺店通ERP【仓库信息维护】界面查看
仓库类型	warehouse_type	string	是	仓库类型
仓库名称	warehouse_name	string
出库时间	consign_time	datetime	是		是
邮资成本	post_fee	string	是		是
物流公司id	logistics_id	int(11)	是		是
客户网名	buyer_nick	string		客户网名
物流单号	logistics_no	string	是	物流单号	是
平台Id	platform_id	int(11)		点击查看平台ID详情
供应商编码	provider_nick_no	string	是	供应商编码	是
店铺名称	shop_name	string		店铺名称
店铺编码	shop_no	string	是	代表店铺所有属性的唯一编码，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
审核时间	check_time	datetime		审核时间
货品总数	goods_count	decimal(19, 4)		货品总数
仓库名称	warehouse_name	string		仓库名称
物流公司	logistics_name	string		物流公司
订单来源	trade_from	tinyint(4)	是	订单来源1:平台抓单 2:手工建单 3:EXCEL导入 6:补发 7:展架下单 8:换货 9:现款销售 10:补寄 11:维修 12:达人寄样
订单标签	tag_names	string	是	订单标签
供应商名称	provider_name	string	是	供应商名称	是
分销商编码	fenxiao_nick_no	string	是	分销商编码	是
分销商名称	fenxiao_nick_name	string	是	分销商名称	是
分销原始店铺名称	fenxiao_shop_name	string	是	分销原始店铺名称
收件人姓名	receiver_name	string	是	收件人姓名
收件人国家	receiver_country	string	是	收件人国家
收件人省份	receiver_province	string	是	收件人省份
物流类型	logistics_type	string	是	物流类型，点击这里	是
物流类型名称	logistics_type_name	string	是	物流类型名称	是
收件人城市	receiver_city	string	是	收件人城市
收件人区	receiver_district	string	是	收件人区
货品数量	goods_count	decimal(19, 4)	是	货品数量
代发邮费	oms_post_amount	decimal(19, 4)	是	代发邮费，供销给分销代发的邮费，只有这类订单需要
采购成本	oms_purchase_amount	decimal(19, 4)	是	采购成本
佣金	oms_employ_amount	decimal(19, 4)	是	佣金
分拣单号	pick_no	string	是	分拣单号
推单单号	push_no	string	是	推送给委外仓时的推单单号
平台单号	src_tids	string	是
店铺id	shop_id	int(11)	是	代表店铺所有属性的唯一id，用于店铺区分，在旺店通ERP【绑定店铺】界面查看
店铺名称	shop_name	string	是	店铺名称
客服备注	remark	string	是	客服备注	是
买家备注	buyer_message	string	是	买家备注
最后修改时间	modified	datetime	是		是
称重重量	weight	decimal(19, 4)	是		是
快递重量	post_weight	decimal(19, 4)	是		是
是否本系统发货	trade_status_type	tinyint(4)		1 平台发货 2 erp发货
打单员姓名	printman_name	string	是
审单员姓名	auditman_name	string	是
买家实付	paid	decimal(19, 4)	是
货品总额	goods_amount	decimal(19, 4)	是
货品列表	details_list		是
销售出库明细id	rec_id	bigint(20)	是		否
货品明细id	spec_id	int(11)	是		否
原始子订单号	src_oid	string
子单原始单号	src_tid	string
子单退款状态	refund_status	tinyint(4)	是	子单退款状态 0-无退款,1-取消退款,2-已申请退款,3-等待退货,4-等待收货,5-退款成功
出库单主键Id	stockout_id	bigint(20)
出库单明细id 关联系统订单id	src_order_detail_id	bigint(20)
系统订单明细id	stockin_detail_id	bigint(20)	是		否
数量	num	decimal(19, 4)	是		是
分摊邮费	share_post	decimal(19, 4)	否	null	是
已付	paid	decimal(19, 4)	是
分摊后总价	share_amount	decimal(19, 4)	是		是
零售价	retail_price	decimal(19, 4)	是	零售价	是
商家编码	spec_no	string	是		是
sku主条码	barcode	string	是	sku主条码
货品编号	goods_no	string	是		是
规格编号	spec_code	string	是		是
预估重量	weight	decimal(19, 4)	是		是
成本价	cost_price	decimal(19, 4)	是		是
销售价	sell_price	decimal(19, 4)	是	平台的销售价	是
商品名称	goods_name	string	是		是
规格名称	spec_name	string	是		是
最后修改时间	modified	datetime	是		是
单位id	base_unit_id	bigint(20)	是		是
赠品方式	gift_type	tinyint(4)	是	0、非赠品1、自动赠送 2、手工赠送 5 平台赠品	是
单位名称	base_unit_name	string	是		是
出库批次号	batch_no	string	否		否
平台售卖单价	price	decimal(19, 4)	是	平台售卖单价	是
单品自定义属性1	prop1	string	是	单品自定义属性1	是
单品自定义属性2	prop2	string	是	单品自定义属性2	是
单品自定义属性3	prop3	string	是	单品自定义属性3	是
单品自定义属性4	prop4	string	是	单品自定义属性4	是
单品自定义属性5	prop5	string	是	单品自定义属性5	是
单品自定义属性6	prop6	string	是	单品自定义属性6	是
单品自定义属性7	prop7	string	是	单品自定义属性7	是
单品自定义属性8	prop8	string	是	单品自定义属性8	是
单品自定义属性9	prop9	string	是	单品自定义属性9	是
单品自定义属性10	prop10	string	是	单品自定义属性10	是
货品自定义属性1	goods_prop1	string	是	货品自定义属性1	是
货品自定义属性2	goods_prop2	string	是	货品自定义属性2	是
货品自定义属性3	goods_prop3	string	是	货品自定义属性3	是
货品自定义属性4	goods_prop4	string	是	货品自定义属性4	是
货品自定义属性5	goods_prop5	string	是	货品自定义属性5	是
货品自定义属性6	goods_prop6	string	是	货品自定义属性6	是
组合装id	suite_id	bigint(20)	是	组合装id
组合装编码	suite_no	string	是	组合装编码
组合装数量	suite_num	decimal(19, 4)	是	组合装数量
分摊邮资成本	post_cost	decimal(19, 4)	是	分摊邮资成本
是否是完整组合装	is_complete_suite	tinyint(4)	是	1-是，0-否
主播id	anchor_id	bigint(20)	否		否
主播名称	anchor_name	string	否		否
分摊单价	share_price	decimal(19, 4)	是	分摊价格，扣减优惠之后，不加邮费收入的单价	是
组合装拆分合并标识	suit_flag	int	否		是
供应商编号	provider_nick_no	string	是
供应商昵称	provider_name	string	是
是否包装	is_package	int	是
货品成本	goods_cost	decimal(19, 4)	是
代发邮费	oms_post_amount	decimal(19, 4)	是	代发邮费
采购成本	oms_purchase_amount	decimal(19, 4)	是	采购成本
组合装ID	suite_id	bigint(20)	否	0	是
序列号列表	sn_list		是
序列号	sn	string	否	序列号
辅助序列号	second_sn	string	否	辅助序列号
货位批次明细数据	position_list		否		是
出库单明细或者订单明细Id	stockout_order_detail_id	bigint(20)	否		是
入库单号明细id	stock_spec_detail_id	bigint(20)	否		是
货位主键id	rec_id	bigint(20)	否		是
货位ID	position_id	bigint(20)	否		是
货位编号	position_no	string	是	货位编号
批次号	batch_no	string	否		是
有效期	expire_date	datetime	否		是
生产日期	production_date	datetime	否		是
出库数量	num	decimal(19, 4)	否		是
成本价	cost_price	decimal(19, 4)	否		是
最后修改时间	modified	datetime	否		是
物流列表	logistics_list	array[]
物流单号	logistics_no	logistics_list	string	物流单号
关联物流单	related_logistics_no	logistics_list	string	若parent_child_flag=1，则该字段为母单号
物流公司名称	logistics_name	logistics_list	string	物流公司名称
重量	weight	logistics_list	decimal(19, 4)	重量
邮资	post_cost	logistics_list	decimal(19, 4)	邮资
打印状态	print_status	logistics_list	int	0-未打印 1-已打印
创建时间	created	logistics_list	datetime	创建时间
子母单标识	parent_child_flag	logistics_list	int	0-普通单 1-子母单

4.请求示例

PHP	<php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'https://openapi.ali.huice.cc/openapi/stockout_order_query_trade.php'; //添加查询参数 $c->putApiParam('start_time','2018-08-01 00:00:00'); $c->putApiParam('end_time','2018-08-11 00:00:00'); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA
C#
python

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 1,
    "stockout_list": [
        {
            "trade_from": 1,
            "stockout_id": "2756286207594856469",
            "order_no": "JY2510282687",
            "status": 95,
            "src_order_no": "JY2510282687",
            "warehouse_id": "1",
            "warehouse_type": 2,
            "consign_time": "2025-10-28 22:01:21",
            "platform_id": "1",
            "shop_id": "12",
            "post_fee": "0.0000",
            "logistics_id": "0",
            "logistics_no": "78858955625465",
            "remark": "1",
            "modified": "2025-11-03 09:59:21",
            "weight": "0.0000",
            "post_weight": "0.0000",
            "src_tids": "4842818029414320724",
            "goods_count": "1.0000",
            "trade_status_type": 1,
            "goods_total_amount": null,
            "receiver_name": null,
            "receiver_country": null,
            "receiver_province": 110000,
            "receiver_city": 110100,
            "receiver_district": 110115,
            "logistics_type": "5",
            "logistics_type_name": "中通快递",
            "oms_post_amount": "0.0000",
            "oms_purchase_amount": "0.0000",
            "oms_employ_amount": "0.0000",
            "refund_status": 3,
            "pick_no": "",
            "fenxiao_nick_name": "",
            "fenxiao_nick_no": "",
            "provider_nick_no": "74caf04",
            "provider_name": "y_qiyeban2",
            "details_list": [
                {
                    "rec_id": "2756286207594858517",
                    "stockout_id": "2756286207594856469",
                    "spec_id": "2720289868889456644",
                    "stockin_detail_id": "2756286207594858517",
                    "src_order_detail_id": "2756286207594858517",
                    "num": "1.0000",
                    "share_amount": "0.0100",
                    "share_post": "0.0000",
                    "spec_no": "pc_xq1",
                    "goods_no": "pc_xq_ceshi",
                    "spec_code": "",
                    "weight": "3.0000",
                    "cost_price": "0.5000",
                    "sell_price": "0.0100",
                    "retail_price": "0.1200",
                    "goods_name": "试下批量修改",
                    "spec_name": "粉红",
                    "modified": "2025-10-28 23:16:02",
                    "src_oid": "4842818029414320724",
                    "src_tid": "4842818029414320724",
                    "base_unit_id": "0",
                    "base_unit_name": "",
                    "batch_no": "",
                    "anchor_id": null,
                    "anchor_name": null,
                    "share_price": "0.0100",
                    "suit_flag": 0,
                    "suite_id": "0",
                    "is_package": 0,
                    "goods_cost": "0.5000",
                    "oms_post_amount": "0.0000",
                    "oms_purchase_amount": "0.0000",
                    "position_list": [],
                    "sn_list": [],
                    "refund_status": 5,
                    "provider_nick_no": "74caf04",
                    "provider_name": "y_qiyeban2"
                }
            ]
        }
    ]
}

6.2 异常响应示例

JSON	{ "code": 2900, "message": "时间范围与订单编号不能全部为空" }