API文档

trade_query.php（查询系统订单）

¥标准

1.接口说明

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

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

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

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

2.请求参数说明

2.1 请求地址

环境	HTTP地址
测试环境	http://openapitest.huice.com/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	修改起始时间，若无订单号/物流单号，则为必填。示例：“ 2021-11-11 00:00:00”
结束时间	end_time	修改结束时间，上同开始时间。示例：“ 2021-11-11 01:00:00” 开始时间和结束时间最大间隔为3天
仓库编号	warehouse_id	仓库编号
订单状态	status	若多个状态则以“，”隔开。订单状态: 4 已取消（可恢复） 5 已取消 25 特殊单 29 预订单 30 已支付 35 待财审 50 待发货 51 待推送 52 推送中 53 推送失败 55 已推送 95 已发货
订单编号	trade_no	订单编号，多个订单编号之间使用英文逗号分隔
店铺编号	shop_id	店铺编号
物流单号	logistics_no	物流单号
原始单号	src_tid	原始单号, 多个原始单号之间使用英文逗号分隔
订单来源	trade_from	订单来源1、API抓单2、手工建单3、导入4、复制订单5、接口推送6 、补发订单7、PDA选货开单8、分销补发订单
系统订单id	trade_ids	系统订单id, 多个系统订单id之间使用英文逗号分隔
标旗列表	remark_flags	查询对应标旗的数据，标旗取值为0到5,多个之间用逗号,分隔。传入 0 表示无标旗， 1 红色 2 黄色 3 绿色 4 蓝色 5 紫色
分页大小	page_size	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为100，使用举例
页号	page_no	页号，不传默认从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_tid		varchar(255)
收件人电话	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)
货品列表	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_amount	goods_list	decimal(19, 4)
分摊优惠	share_discount	goods_list	decimal(19, 4)
调整金额，手工改价金额	adjust	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)
商品单价	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 客户自定义异常