API文档

trade_query.php（查询系统订单）

1.接口说明

1.1 接口描述：查询ERP内订单

1.2 时间跨度：start_time和end_time最大跨度为3天，开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-03 23:59:59，建议根据获取数据量的多少适当减小时间跨度。

1.5注意事项：权限校验：【店铺、仓库权限】

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

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

2.请求参数说明

2.1 请求地址

环境	HTTP地址
测试环境	https://openapi.ali.huice.cc/openapi/trade_query.php
正式环境	https://openapi.huice.com/openapi/trade_query.php

2.2 公共请求参数

名称	字段	类型	长度	必须	描述
卖家账号	sid	String		是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取2。
接口账号	appkey	String		是
时间戳	timestamp	int		是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值, 旺店通网页版API服务端允许请求最大时间误差为5min， date.timezone = Asia/Shanghai。
签名	sign	String		是	API输入参数签名结果，签名算法介绍文档中心

2.3 业务请求参数

名称	字段	类型	必须	描述
开始时间	start_time	String	可选必传	修改起始时间，若无订单号/物流单号，则为必填。示例：“ 2021-11-11 00:00:00”
结束时间	end_time	String	可选必传	修改结束时间，上同开始时间。示例：“ 2021-11-11 01:00:00” 开始时间和结束时间最大间隔为3天
仓库编号	warehouse_id	int	否	仓库编号
订单状态	status	int	否	若多个状态则以“，”隔开。订单状态: 4 已取消（可恢复） 5 已取消 25 特殊单 29 预订单 30 已支付 35 待财审 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货
订单编号	trade_no	String	可选必传	订单编号，多个订单编号之间使用英文逗号分隔,长度限制200
店铺编号	shop_id	int	否	店铺编号
物流单号	logistics_no	String	否	物流单号
原始单号	src_tid	String	可选必传	原始单号, 多个原始单号之间使用英文逗号分隔（字符长度不超过200）
订单来源	trade_from	int	否	1-平台抓单 2-手工建单 3-EXCEL导入 6-补发订单 7-展架下单 8-换货订单 9-现款销售 10-补寄订单 11-维修订单
系统订单id	trade_ids	String	可选必传	系统订单id, 多个系统订单id之间使用英文逗号分隔
标旗列表	remark_flags	String	否	查询对应标旗的数据，标旗取值为0到5,多个之间用逗号,分隔。传入 0 表示无标旗， 1 红色 2 黄色 3 绿色 4 蓝色 5 紫色
分页大小	page_size	int	否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100，使用举例
页号	page_no	int	否	页号，不传默认从0页开始

3.响应参数

3.1 公共响应参数

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

3.2 业务响应参数

trades

	trades		array[]
名称	Y字段	父级字段	类型	枚举及描述
系统订单id	trade_id		bigint(20)
系统订单编号	trade_no		varchar（64）
系统订单状态	trade_status		tinyint	4 已取消（可恢复） 5 已取消 25 特殊单 29 预订单 30 待审核（已支付） 35 待财审 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货
店铺id	shop_id		bigint(20)
店铺名称	shop_name		varchar(64)
订单类型	trade_type		varchar(64)
平台id	platform_id		bigint(20)	点击查看平台ID详情
仓库id	warehouse_id		bigint(20)
平台订单号	src_tids		varchar(1024)	合单后是多个平台单号用,分隔，受限于字段长度可能截取
出库单号	stockout_no		varchar(64)
订单来源	trade_from		tinyint	1、API抓单2、手工建单3、导入4、复制订单5、接口推送6、补发订单7、展架下单8、换货订单
支付时间	pay_time		datetime
数量	goods_count		decimal(19, 4)
邮费收入	post_amount		decimal(19, 4)
预估邮资成本	post_cost		decimal(19, 4)
退款状态	refund_status		tinyint	0、无退款1、申请退款2、部分退款3、全部退款
买家备注	buyer_message		varchar(1024)
客服备注	cs_remark		varchar(1024)
系统备注	sys_remark		varchar(1024)
标旗	remark_flag		tinyint
最后修改时间	modified		timestemp
物流单号	logistics_no		varchar（40）	返回其中一个
物流公司ID	logistics_id		bigint(20)
物流公司名称	logistics_name		varchar（128）
物流公司编号	sys_logistics_code		varchar（64）	响应值为代表物流方式的数字，数字对应的物流方式名称点击这里
物流公司类型	logistics_type		tinyint	响应值为代表物流方式的数字，数字对应的物流方式名称点击这里
物流公司类型名称	logistics_type_name		varchar（128）	物流品牌的名称
分销昵称	fenxiao_nick		varchar（255）
分销原始店铺	fenxiao_shop_name		varchar（255）	分销原始店铺
分销原始单号	fenxiao_tid		varchar(255)
分销平台ID	fenxiao_platform_id		bigint(20)
分销子平台ID	fenxiao_sub_platform_id		bigint(20)
收件人电话	receiver_telno		varchar（255）
推单时间	push_date		datetime
推单单号	push_no		string(40)
订单标签	tags		255	1,2,3
下单时间	trade_time
折扣	discount		decimal(19, 4)
应收金额	receivable		decimal(19, 4)
商家实收	real_amount		decimal(19, 4)
退款金额	refund_amount		decimal(19, 4)
买家实付	paid		decimal(19, 4)
是否打印	is_print		tinyint	0 未打印 1 已打印
发货时间	consign_time		datetime
创建时间	created		datetime	举例：2025-01-01 00:00:00
收件人省	receiver_province		bigint(20)	目前不返回，实际省市区信息查看receiver_area字段
收件人市	receiver_city		bigint(20)	目前不返回，实际省市区信息查看receiver_area字段
收件人区	receiver_district		bigint(20)	目前不返回，实际省市区信息查看receiver_area字段
收件人省市区拼接名称	receiver_area		string(128)
收件人手机号	receiver_mobile		string(128)
收件人地址	receiver_address		string(128)
收件人姓名	receiver_name		string(128)
业务员id	salesman_id		int(11)	业务员id
代发邮费	oms_post_amount		decimal	代发邮费
采购成本	oms_purchase_amount		decimal	采购成本
佣金	oms_employ_amount		decimal	佣金
物流单打印时间	print_time		datetime	物流单打印时间
收件人省名称	receiver_province_name		string	收件人省名称
收件人市名称	receiver_city_name		string	收件人市名称
收件人区名	receiver_district_name		string	收件人区名称
货品列表	goods_list		array[]
订单明细id	rec_id	goods_list	bigint
平台子单号	src_oid	goods_list	varchar(64)
平台id	platform_id	goods_list	bigint
平台单号	src_tid	goods_list	varchar(64)
货品明细id	spec_id	goods_list	bigint
商家编码	spec_no	goods_list	varchar(255)
货品编码	goods_no	goods_list	varchar(255)
规格码	spec_code	goods_list	varchar(255)
下单数量	num	goods_list	decimal(19, 4)
分摊邮费	share_post	goods_list	decimal(19, 4)
分摊单价	share_price	goods_list	decimal(19, 4)	分摊价格，扣减优惠之后，不加邮费收入的单价
分摊后总价	share_amount	goods_list	decimal(19, 4)
分摊优惠	share_discount	goods_list	decimal(19, 4)
调整金额，手工改价金额	adjust	goods_list	decimal(19, 4)	手工改价金额手工调整价,正数为加价,负数为减价
折扣金额	discount	goods_list	decimal(19, 4)	折扣金额
货品重量	weight	goods_list	decimal(19, 4)	单个货品重量
退款状态	refund_status	goods_list	tinyint	0-无退款,1-取消退款,2-已申请退款,3-等待退货,4-等待收货,5-退款成功
组合装编码	suite_no	goods_list	varchar(255)
组合装数量	suite_num	goods_list	decimal(19, 4)
赠品方式	gift_type	goods_list	tinyint	0、非赠品1、自动赠送 2、手工赠送 5 平台赠品
备注	remark	goods_list	varchar(255)
最后修改时间	modified	goods_list	timestemp
平台货品名称	api_goods_name	goods_list	varchar(255)
平台规格名称	api_spec_name	goods_list	varchar(255)
货品id	goods_id	goods_list	bigint
商品名称	goods_name	goods_list	varchar(255)
规格名称	spec_name	goods_list	varchar(255)
组合装名称	suite_name	goods_list	varchar(255)
组合装ID	suite_id	goods_list	bigint(20)
平台货品ID	platform_goods_id	goods_list	varchar(128)
平台货品编码	api_goods_no	goods_list	varchar(255)
平台规格ID	platform_spec_id	goods_list	varchar(128)
平台规格编码	api_spec_no	goods_list	varchar(255)
买家实付	paid	goods_list	decimal(19, 4)
商品单价	price	goods_list	decimal(19, 4)
组合装价格	suite_amount	goods_list	decimal(19, 4)
主播Id	anchor_id	goods_list	varchar(64)
主播名称	anchor_name	goods_list	varchar(64)
组合装拆合标识	suit_flag	goods_list	tinyint	0标识无拆合，其他标识有拆分合并换货
订单明细发货状态	trade_status	goods_list	tinyint	0 未发货 1 已发货
订单明细发货类型	trade_status_type	goods_list	tinyint	0：无 1 平台发货 2 erp系统发货
是否包装	is_package	goods_list	tinyint	0 否 1 是包装
异常列表	abnormal_list		array[]
异常Code值	abnormal_code	abnormal_list	int	异常的Code值
异常名称	abnormal_name	abnormal_list	string(64)	异常名称
异常类型	abnormal_type	abnormal_list	tinyint	异常类型 1 系统异常 2 客户自定义异常
代发邮费	oms_post_amount		decimal	代发邮费
采购成本	oms_purchase_amount		decimal	采购成本
物流列表	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/trade_query.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,
    "trades": [
        {
            "trade_id": "2728573853566500879",
            "trade_no": "JY2508130003",
            "trade_status": 5,
            "shop_id": "12",
            "shop_name": "发得快小店",
            "platform_id": "1",
            "warehouse_id": "55",
            "src_tids": "4681654344550320724",
            "stockout_no": "",
            "trade_from": 1,
            "pay_time": "2025-08-13 10:16:46",
            "goods_count": "0.0000",
            "post_amount": "0.0000",
            "post_cost": "0.0000",
            "refund_status": 3,
            "buyer_message": "",
            "cs_remark": "",
            "sys_remark": "",
            "remark_flag": 6,
            "modified": "2025-08-13 19:04:21",
            "logistics_no": "",
            "logistics_id": "2626440244207026183",
            "logistics_name": "中通快运",
            "logistics_type": "2110",
            "logistics_type_name": "中通快运",
            "sys_logistics_code": "55",
            "tags": "",
            "fenxiao_nick": "",
            "fenxiao_tid": "",
            "trade_time": "2025-08-13 10:16:43",
            "order_type": 0,
            "receiver_name": "",
            "receiver_address": "",
            "receiver_mobile": "",
            "receiver_telno": "",
            "receiver_area": "北京 北京市 大兴区",
            "receiver_province": 110000,
            "receiver_city": 110100,
            "receiver_district": 110115,
            "receiver_province_name": "北京",
            "receiver_city_name": "北京市",
            "receiver_district_name": "大兴区",
            "receiver_street_name": "西红门镇",
            "paid": "0.0000",
            "print_time": "0000-00-00 00:00:00",
            "is_print": 0,
            "consign_time": "0000-00-00 00:00:00",
            "push_date": "0000-00-00 00:00:00",
            "push_no": "",
            "trade_type": "",
            "discount": "0.0000",
            "receivable": "0.0100",
            "real_amount": "0.0000",
            "refund_amount": "0.0100",
            "salesman_id": 0,
            "created": "2025-08-13 10:18:21",
            "goods_list": [
                {
                    "rec_id": "2728573853566501903",
                    "src_oid": "4681654344550320724",
                    "platform_id": "1",
                    "src_tid": "4681654344550320724",
                    "spec_id": "2723646637904757778",
                    "suite_no": "",
                    "goods_no": "LO032891382",
                    "spec_code": "",
                    "num": "1.0000",
                    "share_post": "0.0000",
                    "share_amount": "0.0100",
                    "share_discount": "0.0000",
                    "weight": "0.0000",
                    "refund_status": 5,
                    "spec_no": "BY00004",
                    "suite_num": "0.0000",
                    "gift_type": 0,
                    "remark": "",
                    "modified": "2025-08-13 19:04:21",
                    "api_goods_name": "测试标签排序",
                    "api_spec_name": "绿色",
                    "goods_id": "2722778421208809478",
                    "goods_name": "试下批量修改",
                    "spec_name": "绿",
                    "suite_name": "",
                    "suite_id": "0",
                    "platform_goods_id": "956524534051",
                    "api_goods_no": "LO032891382",
                    "platform_spec_id": "5885638088496",
                    "api_spec_no": "BY00004",
                    "commission": "0",
                    "paid": "0.0100",
                    "adjust": "0.0000",
                    "discount": "0.0000",
                    "price": "0.0100",
                    "suite_amount": "0.0000",
                    "anchor_id": "",
                    "anchor_name": "",
                    "suit_flag": 0,
                    "trade_status": 0,
                    "trade_status_type": 0,
                    "is_package": 0,
                    "shipment_box": ""
                }
            ],
            "abnormal_list": [
                {
                    "abnormal_code": 6,
                    "abnormal_name": "物流同步失败",
                    "abnormal_type": 1
                }
            ],
            "logistics_list": [
                {
                    "logistics_no": "b62d8408-6279-4634-9fc3-14056542312b",
                    "related_logistics_no": "b28a0734-6019-47c2-8d98-f4d16669fd1d",
                    "logistics_name": "中通快递-换行符测试",
                    "weight": "0.0000",
                    "post_cost": "0.0000",
                    "print_status": 0,
                    "created": "2025-10-17 13:37:23",
                    "parent_child_flag": 1
                }
            ]
        }
    ]
}

6.2 异常响应示例

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