API文档

查询邮费汇总数据

¥标准

1.接口说明

1.1 接口描述：获取结算中心—邮费汇总数据

1.2 适用版本：任何版本

1.3 增量获取：按照中台单据的汇总日期增量获取数据，请求时输入start_time和end_time作为时间跨度的筛选条件。

1.4 时间跨度：start_time和end_time建议不超过30天

1.5注意事项：淘系数据需要通过奇门接口获取。

2.调用场景

2.1 举例说明：用于第三方系统进行邮费汇总同步

3.请求参数说明

3.1 请求地址

环境	奇门访问地址	访问地址
测试环境	http://6vzhpmj261.api.taobao.com/router/qmtest	http://39.100.141.5:30002/openapi/post_collect_query.php
正式环境	http://6vzhpmj261.api.taobao.com/router/qm	http://zt.common.wdtdata.com/openapi/post_collect_query.php
接口名	method: wdt.post.collect.query	post_collect_query.php

环境

奇门访问地址

访问地址

测试环境

正式环境

接口名

method: wdt.post.collect.query

post_collect_query.php

3.2 SDK下载地址：

奇门SDK下载：结算中心—奇门接口SDK.rar

公共请求参数

名称	奇门接入参数	奇门参数说明	常规接入参数	常规参数说明	必须	描述
卖家账号	sid	卖家账号	sid	卖家账号	是	购买ERP时由旺店通分配给ERP购买方，请从ERP购买方获取。
接口账号	app_key	奇门授权应用	appkey	旺店通授权应用	是	需线下联系工作人员进行授权。
时间戳	timestamp	格式化后的时间戳2019-12-06 10:37:00	timestamp	时间戳（1575599760）	是	北京时间1970-01-01 08:00:00起至现在的总秒数，10位int值,旺店通企业版API服务端允许请求最大时间误差为5min，date.timezone = Asia/Shanghai。
签名	sign	奇门签名计算规则	sign	wdt签名计算规则	是	API输入参数签名结果，签名算法介绍单击这里
方法名	method	方法名				奇门接入必传参数
目标appkey	target_app_key	旺店通在奇门授权应用				奇门接入必传参数

业务请求参数

名称	字段	类型	长度	必须	描述
开始时间	start_time	date		是	按汇总日期增量获取数据,start_time作为开始时间(包含当天)，格式： YYYY-MM-DD
结束时间	end_time	date		是	按汇总日期增量获取数据,end_time作为结束时间(包含当天)，格式： YYYY-MM-DD
分页大小	page_size	int		否	每页返回的数据条数，输入值范围1~100，不传本参数输入值默认为30，使用举例单击这里
页号	page_no	int		否	需要查询第page_no页的数据，不传值默认从第1页开始
店铺编号	shop_no	varchar	20	否	店铺编号

4.响应参数

4.1 正确响应参数

名称	奇门响应	常规响应	类型	长度	必须	描述
错误码	errorcode	code	int	11	是	状态码:0表示成功,其他表示失败
错误描述	message	message	varchar	255	是	错误描述
数据条数	total_count	total_count	int	11	否	只有page_no = 1 时才返回的符合条件的数据总条数，用来分页
数据节点	order_list	order_list	data[]		是	响应参数的1级数据节点

4.2 错误响应参数

4.3 业务响应参数

order_list[]

名称	字段	类型	长度	必须	描述
店铺名称	shop_name	varchar	128	是	店铺名称信息
店铺编号	shop_no	varchar	20	是	代表店铺所有属性的唯一编码，用于店铺区分，ERP内支持自定义（ERP店铺界面设置），可通过shop.php获取
退货类型	is_aftersale	int	11	是	退货类型 0售中，1售后
邮费	post_amount	decimal	(19,4)	是	邮费
类型	type	tinyint	4	是	类型 1发货，2退货
汇总日期	collect_date	date		是	汇总日期

5.响应示例

JSON

暂无

JSON

暂无