API文档

Y_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”
时间类型	time_type	时间类型默认不填为修改时间 1 修改时间 2 发货时间	否
系统订单号	src_order_no	系统订单号，多个用,分隔	传入系统订单号可以不传时间
状态类型	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

名称	Y字段	Y父级字段	是否必须	默认值	是否可变更
销售出库单id	stockout_id		是		否
销售出库单号	order_no		是		否
订单状态	status		是	4 已取消（可恢复） 5 已取消 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货	是
订单退款状态	refund_status		是	订单退款状态 0-无退款 1-申请退款 2-部分退款 3-全部退款
系统订单号	src_order_no		是		否
仓库id	warehouse_id		是		是
仓库类型	warehouse_type		是	仓库类型
出库时间	consign_time		是		是
邮资成本	post_fee		是		是
物流公司id	logistics_id		是		是
客户网名	buyer_nick			客户网名
物流单号	logistics_no		是	物流单号	是
平台Id	platform_id			点击查看平台ID详情
供应商编码	provider_nick_no		是	供应商编码	是
订单来源	trade_from		是	订单来源1、API抓单2、手工建单3、导入4、复制订单5、接口推送6、补发订单7、PDA选货开单8、分销补发订单
供应商名称	provider_name		是	供应商名称	是
分销商编码	fenxiao_nick_no		是	分销商编码	是
分销商名称	fenxiao_nick_name		是	分销商名称	是
分销原始店铺名称	fenxiao_shop_name		是	分销原始店铺名称
收件人姓名	receiver_name		是	收件人姓名
收件人国家	receiver_country		是	收件人国家
收件人省份	receiver_province		是	收件人省份
物流类型	logistics_type		是	物流类型，点击这里	是
物流类型名称	logistics_type_name		是	物流类型名称	是
收件人城市	receiver_city		是	收件人城市
收件人区	receiver_district		是	收件人区
货品数量	goods_count		是	货品数量
代发邮费	oms_post_amount		是	代发邮费
采购成本	oms_purchase_amount		是	采购成本
佣金	oms_employ_amount		是	佣金
分拣单号	pick_no		是	分拣单号
平台单号	src_tids		是
店铺id	shop_id
备注	remark		是		是
最后修改时间	modified		是		是
称重重量	weight		是		是
快递重量	post_weight		是		是
是否本系统发货	trade_status_type			1 平台发货 2 erp发货
打单员姓名	printman_name		是
审单员姓名	auditman_name		是
货品总额	goods_amount		是
货品列表	details_list		是
销售出库明细id	rec_id	details_list	是		否
货品明细id	spec_id	details_list	是		否
原始子订单号	src_oid	details_list
子单原始单号	src_tid	details_list
子单退款状态	refund_status	details_list	是	子单退款状态 0-无退款,1-取消退款,2-已申请退款,3-等待退货,4-等待收货,5-退款成功
出库单主键Id	stockout_id	details_list
出库单明细id 关联系统订单id	src_order_detail_id	details_list
系统订单明细id	stockin_detail_id	details_list	是		否
数量	num	details_list	是		是
分摊邮费	share_post	details_list	否	null	是
分摊后总价	share_amount	details_list	是		是
零售价	retail_price	details_list	是	零售价	是
商家编码	spec_no	details_list	是		是
货品编号	goods_no	details_list	是		是
规格编号	spec_code	details_list	是		是
预估重量	weight	details_list	是		是
成本价	cost_price	details_list	是		是
销售价	sell_price	details_list	是	平台的销售价	是
商品名称	goods_name	details_list	是		是
规格名称	spec_name	details_list	是		是
最后修改时间	modified	details_list	是		是
单位id	base_unit_id	details_list	是		是
单位名称	base_unit_name	details_list	是		是
出库批次号	batch_no	details_list	否		否
平台售卖单价	price	details_list	是	平台售卖单价	是
单品自定义属性1	prop1	details_list	是	单品自定义属性1	是
单品自定义属性2	prop2	details_list	是	单品自定义属性2	是
单品自定义属性3	prop3	details_list	是	单品自定义属性3	是
单品自定义属性4	prop4	details_list	是	单品自定义属性4	是
单品自定义属性5	prop5	details_list	是	单品自定义属性5	是
单品自定义属性6	prop6	details_list	是	单品自定义属性6	是
单品自定义属性7	prop7	details_list	是	单品自定义属性7	是
单品自定义属性8	prop8	details_list	是	单品自定义属性8	是
单品自定义属性9	prop9	details_list	是	单品自定义属性9	是
单品自定义属性10	prop10	details_list	是	单品自定义属性10	是
货品自定义属性1	goodsProp1	details_list	是	货品自定义属性1	是
货品自定义属性2	goodsProp2	details_list	是	货品自定义属性2	是
货品自定义属性3	goodsProp3	details_list	是	货品自定义属性3	是
货品自定义属性4	goodsProp4	details_list	是	货品自定义属性4	是
货品自定义属性5	goodsProp5	details_list	是	货品自定义属性5	是
货品自定义属性6	goodsProp6	details_list	是	货品自定义属性6	是
主播id	anchor_id	details_list	否		否
主播名称	anchor_name	details_list	否		否
分摊单价	share_price	details_list	是	分摊价格，扣减优惠之后，不加邮费收入的单价	是
组合装拆分合并标识	suit_flag	details_list	否		是
供应商编号	provider_nick_no	details_list	是
供应商昵称	provider_name	details_list	是
是否包装	is_package	details_list	是
货品成本	goods_cost	details_list	是
代发邮费	oms_post_amount	details_list	是	代发邮费
采购成本	oms_purchase_amount	details_list	是	采购成本
组合装ID	suite_id	details_list	否	0	是
序列号列表	sn_list	details_list	是
序列号	sn	sn_list	否	序列号
辅助序列号	second_sn	sn_list	否	辅助序列号
货位批次明细数据	position_list	details_list	否		是
出库单明细或者订单明细Id	stockout_order_detail_id	position_list	否		是
入库单号明细id	stock_spec_detail_id	position_list	否		是
货位主键id	rec_id	position_list	否		是
货位ID	position_id	position_list	否		是
货位编号	position_no	position_list	是	货位编号
批次号	batch_no	position_list	否		是
有效期	expire_date	position_list	否		是
生产日期	production_date	position_list	否		是
出库数量	num	position_list	否		是
成本价	cost_price	position_list	否		是
最后修改时间	modified	position_list	否		是
物流列表	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://openapitest.huice.com/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": "时间范围与订单编号不能全部为空" }