API文档

trade_query.php（查询订单管理）

1.接口说明

1.1 接口描述：获取旺店通ERP销售订单信息

1.2 适用版本：客户端 V2.8.2.0及以上版本

1.3 增量获取：按照ERP订单的最后修改时间增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件。

1.4 时间跨度：start_time和end_time最大跨度为60分钟，开始时间和结束时间取值范围为闭区间取值，例如2018-11-01 00:00:00至2018-11-01 00:59:59，建议根据获取数据量的多少适当减小时间跨度。（请注意：订单查询是不同于其他接口，订单的数据量较大，无法按照时间段30天进行查询的）

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

2.调用场景

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

3.请求参数说明

3.1 请求地址

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/trade_query.php
正式环境	https://api.wangdian.cn/openapi2/trade_query.php

查询ERP已归档历史订单地址：

环境	HTTP地址
测试环境	https://sandbox.wangdian.cn/openapi2/his_trade_query.php
正式环境	https://api.wangdian.cn/openapi2/his_trade_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 业务请求参数

名称	字段	类型	长度	必须	描述
订单状态	status	tinyint	4	否	订单状态如果不传该字段则查询所有订单（传该字段：5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认(已审核) 95已发货 105部分打款 110已完成 113异常发货）
开始时间	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		否	每页返回的数据条数，输入值范围1~100，不传本参数，输入值默认为40，使用举例单击这里
页号	page_no	int		否	不传值默认从0页开始
原始单号	src_tid	varchar	40	否	如果使用原始单号，其余参数不起效。其余参数可以不传
订单编号	trade_no	varchar	40	否	系统订单编号，默认单号为JY开头，ERP内支持自定义（设置路径：设置——编码设置）如果使用订单编号，其余参数不起效，其余参数可以不传
店铺编号	shop_no	varchar	40	否	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），用于获取指定店铺单据数据信息
仓库编号	warehouse_no	varchar	40	否	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置），用于获取指定仓库单据数据信息(不支持一次推送多个仓库编码)
使用税率	goodstax	tinyint	1	否	0 使用订单中的税率 1 使用单品中的税率(默认0)
物流单号限制	has_logistics_no	tinyint	1	否	0 没有任何限制(默认值) 1 物流单号不为空才返回 2 只返回物流单号为空的
是否模糊查询	is_fuzzy	tinyint	1	否	0精确 1模糊默认为0 （仅在原始单号src_tid查询时生效）
是否返回交易流水号、付款状态、付款时间	src	tinyint	1	否	1 （返回）,0 (不返回)（不传默认值0）
物流单号	logistics_no	varchar	40	否	如果使用物流单号，其余参数不起效。其余参数可以不传
店铺编号（批量）	shop_nos	varchar		否	批量指定店铺获取（多个店铺编号之间用英文逗号隔开，最多指定20个店铺）

4.响应参数

4.1 公共响应参数

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

4.2 业务响应参数

trades

名称	字段	类型	长度	必须	描述
erp订单表的主键	trade_id	int	11	是	erp订单表的主键
订单编号	trade_no	varchar	40	是	系统订单编号，默认单号为JY开头，ERP内支持自定义订单编号生成规则（设置路径：设置——编码设置）
平台ID	platform_id	smallint	6	是	响应值为代表平台的ID数字，ID对应的平台名称单击这里
店铺平台ID	shop_platform_id	smallint	6	是	响应值为代表平台的ID数字，ID对应的平台名称单击这里
店铺编号	shop_no	varchar	20	是	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置）
店铺名称	shop_name	varchar	128	是	店铺名称
店铺备注	shop_remark	varchar	255	是	店铺备注
仓库类型	warehouse_type	tinyint	4	是	（0不限 1普通仓库 2自动流传外部 3京东仓储 4科捷 5百世物流 6SKU360 7通天晓 8中联网仓 9顺丰仓储 10网仓2号 11奇门仓储 12旺店通仓储 13心怡仓储 14力威仓储 15京东沧海 16云集仓储 17POS 18虎符 20外部链路型 22抖店云仓 126分销委外仓 127其它）
仓库编号	warehouse_no	varchar	40	是	代表仓库所有属性的唯一编码，用于仓库区分，ERP内支持自定义（ERP仓库界面设置）（根据编号可查询仓库名称）
原始单号	src_tids	varchar	255	是	商城或电商平台的订单编号,合并订单的多个订单编号有逗号隔开
订单状态	trade_status	tinyint	4	是	订单状态 5已取消 10待付款 12待尾款 13待选仓 15等未付16延时审核 19预订单前处理 20前处理(赠品，合并，拆分)21委外前处理22抢单前处理 25预订单 27待抢单 30待客审 35待财审 40待递交仓库 45递交仓库中 50已递交仓库 53未确认 55已确认（已审核）90发货中 95已发货 105部分打款 110已完成 113异常发货
发货状态	consign_status	int	11	是	出库状态：0表示无出库状态，1验货 2称重 4出库 8物流同步16分拣 32档口 64拣货 128供销回传成功 256供销回传失败（注意：如果是3，则表示完成了验货和称重“1+2”，如果是15，则表示四个过程都完成了“1+2+4+8”，其他数字以此类推）
订单类型	trade_type	tinyint	1	是	1网店销售 2线下零售 3售后换货 4批发业务 5保修换新 6保修完成 7订单补发 8供销补发 101自定义类型1 102自定义类型2 103自定义类型3 104自定义类型4 105自定义类型5 106自定义类型6 107自定义属性7 108自定义属性8
发货条件	delivery_term	tinyint	4	是	发货条件 1款到发货 2货到付款(包含部分货到付款)，4挂账
冻结原因	freeze_reason	smallint	6	是	冻结原因
退款状态	refund_status	tinyint	1	是	退款状态 0无退款 1申请退款 2部分退款 3全部退款 4未付款关闭或手工关闭
分销类别	fenxiao_type	tinyint	4	是	0非分销订单 1转供销 2代销 3经销
分销商信息	fenxiao_nick	varchar	40	是	分销商信息，不同平台单据分销商会存不同格式情况，具体以返回信息为准
下单时间	trade_time	datetime		是	下单时间时间格式：yyyy-MM-dd HH:mm:ss
付款时间	pay_time	datetime		是	付款时间时间格式：yyyy-MM-dd HH:mm:ss
客户名称	customer_name	varchar	100	是	客户名称
客户编码	customer_no	varchar	40	是	客户编码
买家付款账号	pay_account	varchar	128	是	买家付款账号
客户网名	buyer_nick	varchar	100	是	客户网名
收件人	receiver_name	varchar	100	是	收件人
收件人省份	receiver_province	int	11	是	收件人的省份,按照城市代码表中对应城市代码进行返回
收件人城市	receiver_city	int	11	是	收件人的城市,按照城市代码表中对应城市代码进行返回
收件人地区	receiver_district	int	11	是	收件人的地区,按照城市代码表中对应城市代码进行返回
地址	receiver_address	varchar	256	是	地址
手机	receiver_mobile	varchar	40	是	手机
电话	receiver_telno	varchar	100	是	电话
邮编	receiver_zip	varchar	20	是	收件人邮编
省市县	receiver_area	varchar	128	是	省市县空格分隔
区域	receiver_ring	varchar	20	是	收件人区域
大头笔	receiver_dtb	varchar	128	是	大头笔
派送时间	to_deliver_time	varchar	20	是	派送时间如周一至周五，上午
异常订单	bad_reason	int	11	是	异常订单(bit位)， 2地址变化 8仓库变化 16客服备注变化 128拦截赠品 64退款 2048买家留言发生变更
物流公司ID	logistics_id	smallint	6	是	物流公司ID（系统自增主键id）
物流公司名称	logistics_name	varchar	40	是	物流公司名称
物流公司编号	logistics_code	varchar	20	是	代表物流所有属性的唯一编码，用于物流区分，ERP内支持自定义（ERP物流界面设置）
物流方式	logistics_type	smallint	6	是	响应值为代表物流方式的数字，数字对应的物流方式名称单击这里
物流单号	logistics_no	varchar	40	是	物流单号
店铺id	shop_id	smallint	6	是	店铺列表主键
仓库id	warehouse_id	smallint	6	是	仓库ID
审核步骤	check_step	tinyint	4	是	用于多级审核,特殊值：-100根据预售策略自动转入特殊单，-101人工转入
未合并标记	unmerge_mask	tinyint	1	是	未合并标记,1有未付款订单,2有同名未合并订单
延迟处理	delay_to_time	varchar	11	是	延时此进一步处理，等未付或延时审核激活时间秒级时间戳格式返回
客户类型	customer_type	tinyint	4	是	0普通客户1经销商
买家id	customer_id	varchar	11	是	买家ID
收件人国家	receiver_country	smallint	6	是	收件人国家
预配送时间	pre_charge_time	varchar	20	是	配送中心,未使用
公司主体id	corp_entity_id	varchar	128	是	公司主体id
公司主体名称	corp_entity_name	varchar	40	是	公司主体名称
是否京配	is_prev_notify	tinyint	4	是	是否京配(为1时,只能发京邦达）
便签条数	note_count	smallint	6	是	便签条数
买家留言条数	buyer_message_count	tinyint	4	是	买家留言条数
客服备注条数	cs_remark_count	tinyint	4	是	客服备注条数
客服备注变化	cs_remark_change_count	smallint	6	是	客服备注变化 0,未变化1平台变化,2手工修改,4发票手工修改
优惠变化金额	discount_change	decimal	19,4	是	优惠变化金额,更新货品和数量
使用的预存款	trade_prepay	decimal	19,4	是	客户使用的预存款
分期付款金额	pi_amount	decimal	19,4	是	分期付款金额
其它成本	other_cost	decimal	19,4	是	其它成本(目前用作记录货到付款单据的物流佣金）
体积	volume	decimal	19,4	是	体积（单位：cm³）
销售积分	sales_score	varchar	11	是	销售积分,未使用
标记id	flag_id	smallint	6	是	背景色标记
不可合并拆分	is_sealed	tinyint	1	是	不可合并拆分
赠品标记	gift_mask	tinyint	4	是	赠品标记1已处理过赠品,但没有匹配任何策略2自动赠送4手工赠送6即有自动也有手工
拆分订单，原单ID	split_from_trade_id	varchar	11	是	拆分订单，原单ID，用于避免自动合并,大件拆分为（原订单的id值），自动拆分为负值（原订单的-id值）
物流单模板ID	logistics_template_id	varchar	11	是	未使用
发货单模板id	sendbill_template_id	varchar	11	是	未使用
驳回原因	revert_reason	smallint	6	是	驳回原因
取消原因	cancel_reason	smallint	6	是	取消原因
催未付款订单消息发送标记	is_unpayment_sms	tinyint	1	是	催未付款订单消息发送标记
包装id	package_id	varchar	11	是	包装id
订单标记位	trade_mask	varchar	11	是	订单标记位 1使用智选物流 2 航空禁运 4 预订单自动转审核失败 8 预占用待发货库存 16 订单货品指定批次 32 自动流转仓库 64 部分发货 128 全部发货 256 已发过签收消息 512 大单锁定仓库 1024 人工转入预订单 2048因配置先占用待发货库存 4096 顺丰前置发货 8192订单批量合并后标记 16384 达到原始单最大合并限制 32768 物流升级原始单指定物流订单 65536 BIC订单标记 131072 标记货品指定物流 3554432前N有礼订单 67108864预售下沉
保留	reserve	varchar	40	是	保留
大件类型	large_type	tinyint	4	是	包含大件类型，1普通套件2独立套件3分组单发,未使用-1非单发件取子单中的最大值
买家留言	buyer_message	varchar	1024	是	买家留言
客服备注	cs_remark	varchar	1024	是	客服备注
标旗	remark_flag	tinyint	4	是	标旗 0至5对应的标旗颜色依次为灰（无标旗）、红、黄、绿、蓝、紫
打印备注	print_remark	varchar	255	是	打印备注
货品种类数	goods_type_count	smallint	6	是	货品种类数
货品总数	goods_count	decimal	19,4	是	货品总数
货品总额	goods_amount	decimal	19,4	是	货品总额（未扣除优惠），sum（share_amount+discount）所得
邮资	post_amount	decimal	19,4	是	邮费
其它费用	other_amount	decimal	19,4	是	其它从买家的收费（非订单支付金额以及服务费），从原始订单列表继承
折扣	discount	decimal	19,4	是	订单优惠，系统子订单“优惠”求合所得
应收金额	receivable	decimal	19,4	是	应收金额，系统订单的（“货品总额”+“邮资”-“折扣”）所得
款到发货金额	dap_amount	decimal	19,4	是	款到发货金额,paid>=dap_amount才可发货
COD金额	cod_amount	decimal	19,4	是	货到付款订单金额，系统子订单的（“分摊后总价”+“分摊邮费”-“已付”）再求和
买家COD费用	ext_cod_fee	decimal	19,4	是	货到付款非订单金额，从原始订单继承
货品预估成本	goods_cost	decimal	19,4	是	货款预估成本
邮资成本	post_cost	decimal	19,4	是	预估邮费成本
已付金额	paid	decimal	19,4	是	已付金额，系统子订单“已付”求合所得
预估重量	weight	decimal	19,4	是	预估重量（单位：kg）
预估毛利	profit	decimal	19,4	是	预估毛利
税额	tax	decimal	19,4	是	税额
税率	tax_rate	decimal	19,4	是	税率
佣金	commission	decimal	19,4	是	佣金
发票类型	invoice_type	tinyint	4	是	发票类别 0 不需要，1普通发票，2增值普通税发票，3增值专用税发票
发票抬头	invoice_title	varchar	255	是	发票抬头
发票内容	invoice_content	varchar	255	是	发票内容
业务员	salesman_id	int	11	是	业务员ID
审核人	checker_id	int	11	是	审核员工ID
业务员姓名	fullname	varchar	40	是	业务员姓名
审核人	checker_name	varchar	40	是	审核员工姓名
财审人	fchecker_id	int	11	是	财审操作员ID
签出人	checkouter_id	int	11	是	签出员工id
出库单号	stockout_no	varchar	40	是	出库单号,内部或外部仓库的订单号
标记名称	flag_name	varchar	40	是	背景色标记名称
订单来源	trade_from	tinyint	1	是	订单来源 1API抓单，2手工建单 3excel导入 4现款销售
货品商家编码	single_spec_no	varchar	40	是	货品商家编码
原始货品数量	raw_goods_count	decimal	19,4	是	原始货品数量
原始货品种类数	raw_goods_type_count	int	6	是	原始货品种类数
币种	currency	varchar	20	是	币种
线上包裹拆分数	split_package_num	int	11	是	已拆分包裹数
发票ID	invoice_id	int	11	是	0表示未开发票，＞0表示已开发票
版本号	version_id	smallint	6	是	订单每修改一次，版本号做一次变更
最后修改时间	modified	datetime		是	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
订单生成时间	created	datetime		是	系统单生成时间时间格式：yyyy-MM-dd HH:mm:ss
证件类别	id_card_type	tinyint	4	是	证件类别
证件号码	id_card	varchar	40	是	淘系平台不返回，其他平台正常返回
财审人名称	fchecker_name	varchar	40	是	财审人名称
签出人名称	checkouter_name	varchar	40	是	签出人名称
冻结原因名称	freeze_reason_info	varchar	40	是	冻结原因名称
分销原始单号	fenxiao_tid	varchar	255	是	分销原始单号
分销商编号	fenxiao_nick_no	varchar	255	是	分销商编号
订单标签/异常	tags	varchar	1024	是	订单标签/异常id，具体标签/异常名称查询，需使用查询标签/异常名称接口
货品列表节点	goods_list	data[]		是	响应参数的2级数据节点，包含系统订单货品明细所有属性信息的数据节点,节点下数据字段详见下述"goods_list"

goods_list

名称	字段	类型	长度	必须	描述
erp子订单主键	rec_id	int	11	是	erp子订单主键
erp订单主键	trade_id	int	11	是	erp订单主键
erp内商品主键	spec_id	int	11	是	erp内商品主键
平台	platform_id	smallint	6	是	平台ID
子订单编号	src_oid	varchar	40	是	原始子订单号
平台货品ID	platform_goods_id	varchar	40	是	平台货品ID
平台商品ID	platform_spec_id	varchar	40	是	平台商品ID
组合装ID	suite_id	int	11	是	如果货品是由组合装拆分的，这里组合装ID
区分子单拆分的唯一性标记	flag	int	11	是	子单拆分时，单品明细都一致，用来区分子单的唯一性
原始订单编号	src_tid	varchar	40	是	原始订单号
赠品方式	gift_type	tinyint	1	是	是否是赠品 0非赠品 1自动赠送 2手工赠送 3回购自动送赠品 4前N有礼送赠品 5平台赠送 6天猫优仓赠品 7淘宝CRM会员送赠
退款状态	refund_status	tinyint	4	是	退款状态 0无退款,1取消退款,2已申请退款,3等待退货,4等待收货,5退款成功 6已关闭
担保方式	guarantee_mode	tinyint	4	是	1担保 2非担保 3在线非担保
发货条件	delivery_term	tinyint	4	是	1款到发货 2货到付款(包含部分货到付款) 3分期付款
关联发货	bind_oid	varchar	40	是	关联发货
下单数量	num	decimal	19,4	是	货品数量
标价	price	decimal	19,4	是	销售单价，手工新建时使用货品属性中的“零售价”
实发数量	actual_num	decimal	19,4	是	实发数量,此数量为发货数量,删除操作等于将此值设置为0
	refund_num	decimal	19,4	是	无实际含义
成交价	order_price	decimal	19,4	是	成交价,原始单折扣及分摊之后的价格
分摊后价格	share_price	decimal	19,4	是	进入ERP后再次调整的价格，默认值与order_price一致
手工调整价	adjust	decimal	19,4	是	手工调整价,正数为加价,负数为减价
平台标签	from_mask_ext	varchar	20	是	平台标签 1集运订单(京东) 2小时达(淘宝) 4小时达平台运力(淘宝) 8以旧换新 16国补订单
总折扣金额	discount	decimal	19,4	是	总折扣金额
分摊后总价	share_amount	decimal	19,4	是	分摊后合计应收=share_price * num , share_price 是根据share_amount反推的,因此share_price可能有精度损失
分摊邮费	share_post	decimal	19,4	是	分摊邮费
已付	paid	decimal	19,4	是	已支付金额
货品名称	goods_name	varchar	255	是	货品名称
分类名称	class_name	varchar	32	是	分类名称
自定义属性2	prop2	varchar	255	是	自定义属性2
分销商id	tc_order_id	varchar	40	是	分销商id
主条码	barcode	varchar	40	是	主条码
货品id	goods_id	int	11	是	货品id
货品编号	goods_no	varchar	40	是	代表货品(spu)所有属性的唯一编号，用于系统货品区分，，SPU概念介绍单击这里
规格名	spec_name	varchar	100	是	规格名
商家编码	spec_no	varchar	40	是	代表单品(sku)所有属性的唯一编码，用于系统单品区分，SKU概念介绍,单击这里
规格码	spec_code	varchar	40	是	规格码
组合装编码	suite_no	varchar	40	是	代表组合装商品所有属性的唯一编码，用于系统组合装商品的区分
拆自组合装	suite_name	varchar	255	是	如果是组合装拆分的，此为组合装名称
组合装数量	suite_num	decimal	19，4	是	组合装数量
组合装分摊后总价	suite_amount	decimal	19，4	是	组合装分摊后总价
组合装优惠	suite_discount	decimal	19，4	是	组合装优惠
share_amount备份值	share_amount2	decimal	19，4	是	share_amount备份值,退款恢复使用,!可回收目前会存放分销订单发货回传的分销价
是否打印组合装	is_print_suite	tinyint	4	是	0:组合装明细/1:组合装以及明细/2:组合装
是否允许0成本	is_zero_cost	tinyint	1	是	是否允许0成本
库存保留情况	stock_reserved	tinyint	4	是	库存保留情况 0未保留（取消的订单或完成）1无库存记录 2未付款 3已保留待审核 4待发货 5预订单库存
平台已发货	is_consigned	tinyint	4	是	平台已发货
是否打款	is_received	tinyint	4	是	线上订单，标记是否打款
是否为主子订单	is_master	tinyint	1	是	是否主子订单,为发货算法使用
平台货品名称	api_goods_name	varchar	255	是	平台货品名称
平台规格名称	api_spec_name	varchar	100	是	平台规格名称
估重	weight	decimal	19,4	是	预估单个货品重量（单位：kg）
佣金	commission	decimal	19,4	是	佣金
货品类别	goods_type	tinyint	4	是	1销售商品 2原材料 3包装 4周转材料5虚拟商品 0其它
大件类型	large_type	tinyint	1	是	大件类型 0非大件 1普通大件 2独立大件
发票类别	invoice_type	tinyint	4	是	发票类别，0 不需要，1普通发票，2增值税发票
发票内容	invoice_content	varchar	255	是	发票内容
原始单标记	from_mask	int	11	是	订单内部来源1手机，2聚划算，4服务子订单，8家装，16二次付款，32开具电子发票，128指定批次，2048当日达，4096次日达，8192预计时效，262144天猫直送/唯品仓中仓，524288‘3PL时效/jitx’，2097152区域零售，4194304预售单，8388608周期购，16777216 同城购(淘宝)，268435456 物流升级，536870912 抖店抽奖订单
类目id	cid	int	11	是	类目id
备注	remark	varchar	1024	是	货品明细备注
最后修改时间	modified	datetime		是	最后修改时间时间格式：yyyy-MM-dd HH:mm:ss
创建时间	created	datetime		是	创建时间时间格式：yyyy-MM-dd HH:mm:ss
税率	tax_rate	decimal	8,4	否	税率（根据条件使用订单中或单品中税率）
基本单位	base_unit_id	smallint	6	否	基本单位ID
基本单位名称	unit_name	varchar	20	否	基本单位名称
交易流水单号	pay_id	varchar	40	否	交易流水单号请求参数src传为1时返回
子单付款状态	pay_status	tinyint	4	否	0(未付款),1(部分付款),2(已付款)如需响应该字段，请将ERP升级到V2.3.8.3及以上。请求参数src传为1时返回
子单付款时间	pay_time	datetime		否	时间格式：yyyy-MM-dd HH:mm:ss，如需响应该字段，请将ERP升级到V2.3.8.3及以上。请求参数src传为1时返回

5.请求示例

PHP	<?php require_once("../WdtClient.php"); $c = new WdtClient; $c->sid = ''; $c->appkey = ''; $c->appsecret = ''; $c->gatewayUrl = 'http://sandbox.wangdian.cn/openapi2/trade_query.php'; $c->putApiParam('start_time','2018-01-01 00:00:00'); $c->putApiParam('end_time','2018-01-01 01:00:00'); $json = $c->wdtOpenApi(); var_dump($json); ?>
JAVA	package com.wangdian.api.trade; import java.io.IOException; import java.util.HashMap; import java.util.Map; import com.wangdian.api.WdtClient; public class TradeQuery { public static void main(String[] args) { // TODO Auto-generated method stub WdtClient client = new WdtClient("传入sid", "传入appkey", "传入appsecret", "传入url"); //测试环境sid、appkey、密钥请到旺店通开放平台-自助对接-申请测试环境内查看，测试环境url=https://sandbox.wangdian.cn/openapi2/ //调用正式环境时请将sid、appkey、appsecret切换为实际参数，参数在旺店通开放平台-自助对接-应用管理内应用状态为已上线的应用中查看，调用正式环境注意切换正式环境url=https://api.wangdian.cn/openapi2/ Map<String, String> params = new HashMap<String, String>(); params.put("start_time", "2018-12-11 12:00:00"); params.put("end_time", "2018-12-11 13:00:00"); params.put("page_size", "30"); params.put("page_no", "0"); try { String response = client.execute("trade_query.php", params); System.out.println(response); } catch (IOException e) { // TODO Auto-generated catch block e.printStackTrace(); } } }
C#	using System; using System.Collections.Generic; using System.Linq; using System.Text; using System.Threading.Tasks; using WdtSdk; namespace TradeQuery { class TradeQuery { static void Main(string[] args) { WdtClient client = new WdtClient(); client.sid = ""; client.appkey = ""; client.appsecret = ""; client.gatewayUrl = "http://sandbox.wangdian.cn/openapi2/trade_query.php"; client.putParams("start_time", "2018-12-23 06:02:02"); client.putParams("end_time", "2018-12-23 06:05:02"); string result = client.wdtOpenapi(); Console.WriteLine(result); Console.ReadKey(); } } }
python	import WdtClient t = WdtClient.WdtClient('appkey', 'appsecret', 'sid', 'http://sandbox.wangdian.cn/openapi2/') params = {} params.update({"start_time": '2021-08-27 13:47:40'}) params.update({"end_time": '2021-08-27 13:47:48'}) params.update({"page_size": '30'}) params.update({"page_no": '0'}) response = t.execute("trade_query.php", params) print(response)

6.响应示例

6.1 正常响应示例

JSON

{
    "code": 0,
    "message": "",
    "total_count": 1,
    "trades": [{
        "trade_id": "168498",
        "trade_no": "JY201905180001",
        "platform_id": "0",
        "warehouse_type": "1",
        "src_tids": "115580935277840368-1",
        "pay_account": "默认账户",
        "trade_status": "30",
        "consign_status": "0",
        "trade_type": "2",
        "delivery_term": "1",
        "freeze_reason": "0",
        "refund_status": "0",
        "fenxiao_type": "0",
        "fenxiao_nick": "",
        "trade_time": "2019-05-18 00:25:17",
        "pay_time": "2019-05-18 00:25:17",
        "buyer_nick": "ffasdasd",
        "receiver_name": "小鹏",
        "receiver_province": "310000",
        "receiver_city": "310100",
        "receiver_district": "310109",
        "receiver_address": "龙茗路9号",
        "receiver_mobile": "13456554333",
        "receiver_telno": "01000860086",
        "receiver_zip": "10089",
        "receiver_area": "上海 上海市 虹口区",
        "receiver_ring": "",
        "receiver_dtb": "上海市 虹口区",
        "to_deliver_time": "",
        "bad_reason": "0",
        "logistics_no": "",
        "buyer_message": "请发顺丰",
        "cs_remark": "发顺丰快递",
        "remark_flag": "0",
        "print_remark": "",
        "goods_type_count": "1",
        "goods_count": "2.0000",
        "goods_amount": "198.0000",
        "post_amount": "0.0000",
        "other_amount": "0.0000",
        "discount": "0.0000",
        "receivable": "198.0000",
        "dap_amount": "198.0000",
        "cod_amount": "0.0000",
        "ext_cod_fee": "0.0000",
        "goods_cost": "0.0000",
        "post_cost": "0.0000",
        "paid": "198.0000",
        "weight": "0.0000",
        "profit": "198.0000",
        "tax": "0.0000",
        "tax_rate": "0.0000",
        "commission": "0.0000",
        "invoice_type": "0",
        "invoice_title": "",
        "invoice_content": "",
        "salesman_id": "1",
        "checker_id": "0",
        "fchecker_id": "0",
        "checkouter_id": "0",
        "stockout_no": "",
        "flag_name": "VIP",
        "trade_from": "2",
        "single_spec_no": "WDTPDA-BLACK006",
        "raw_goods_count": "2.0000",
        "raw_goods_type_count": "1",
        "currency": "",
        "split_package_num": "0",
        "invoice_id": "0",
        "version_id": "1",
        "modified": "2019-05-18 00:31:00",
        "created": "2019-05-18 00:30:59",
        "id_card_type": "0",
        "id_card": "",
        "shop_no": "xyp2test",
        "shop_name": "小鹏测试店铺",
        "shop_remark": "勿更改本店铺内容",
        "warehouse_no": "xyp2test",
        "customer_name": "h",
        "customer_no": "KH201905170008",
        "logistics_id": "1",
        "logistics_name": "顺丰快递",
        "logistics_code": "SF001",
        "logistics_type": "8",
        "fullname": "admin",
        "checker_name": "系统",
        "goods_list": [{
            "rec_id": "294491",
            "trade_id": "168498",
            "spec_id": "1",
            "platform_id": "0",
            "src_oid": "AD201905180001",
            "suite_id": "0",
            "src_tid": "115580935277840368-1",
            "gift_type": "0",
            "refund_status": "0",
            "guarantee_mode": "2",
            "delivery_term": "1",
            "bind_oid": "",
            "num": "2.0000",
            "price": "99.0000",
            "actual_num": "2.0000",
            "refund_num": "0.0000",
            "order_price": "99.0000",
            "share_price": "99.0000",
            "adjust": "0.0000",
            "discount": "0.0000",
            "share_amount": "198.0000",
            "share_post": "0.0000",
            "paid": "198.0000",
            "goods_name": "旺店通手持终端",
            "goods_id": "1",
            "goods_no": "WDTPDA",
            "spec_name": "旺店通手持终端黑色006型",
            "spec_no": "WDTPDA-BLACK006",
            "spec_code": "BLACK006",
            "suite_no": "",
            "flag": "0",
            "suite_name": "",
            "suite_num": "0.0000",
            "suite_amount": "0.0000",
            "suite_discount": "0.0000",
            "api_goods_name": "旺店通手持终端",
            "api_spec_name": "旺店通手持终端黑色006型",
            "weight": "0.0000",
            "commission": "0.0000",
            "goods_type": "1",
            "large_type": "0",
            "invoice_type": "0",
            "invoice_content": "",
            "from_mask": "131072",
            "cid": "0",
            "remark": "",
            "modified": "2019-05-18 00:31:00",
            "created": "2019-05-18 00:31:00",
            "platform_goods_id": "",
            "platform_spec_id": "1",
            "prop2": "",
            "tax_rate": "0.0000"
        }]
    }]
}

6.2 异常响应示例

JSON	{ "code": 2104, "message": "start_time与end_time时间跨度不能超过最大范围60分钟" }