当前位置: API文档
接口说明
查询慧经营每日账单分类结果收款+退款汇总数据。
使用费用项分类名称来区分:费用项分类名称为以下 4 个
交易收款、交易补贴 分类 到收款
交易退款、补贴退款 分类 到收款退款
调用场景
财务软件对接生成收款单、收款退款单。
请求地址
环境 | 奇门地址 | 服务名 |
---|---|---|
测试环境 | http://332wh0cyoi.api.taobao.com/router/qmtest | wdt.hjy.recon.sktk.summary.query |
生产环境 | http://332wh0cyoi.api.taobao.com/router/qm |
请求方式
POST
请求参数
参数名称 | 参数类型 | 是否必选 | 参数描述 | 示例 |
---|---|---|---|---|
hjySign | String | 是 | 慧经营参数签名 | e549e097f97123bc7fa3cfc1354796b2 |
appId | String | 是 | 租户应用标识 | b018b1134f854fb48019d47dd424e5f9 |
sid | String | 是 | 卖家账号 | hjy001 |
nextRequestId | String | 否 | 每页200条,用于分页,查询时返回,下一页查询时传入,返回false,说明查询结束 | 1760506606618202114 |
businessDate | String | 是 | 账单结算日期 | 2023-03-01 |
platName | String | 否 | 平台名称 | 淘宝 |
businessType | String[] | 否 | 类型,可以批量 | ["收款","收款退款"] |
expenseItemName | String[] | 否 | 费用项名称 | ["收款项目"] |
shopNo | String[] | 否 | 店铺编码,可以批量 | ["Db001"] |
响应数据
公共响应数据
参数名称 | 参数类型 | 是否必选 | 参数描述 | 参数示例 |
---|---|---|---|---|
resultCode | String | 是 | 业务响应码 | 200 |
message | String | 是 | 业务响应码描述 | success |
sub_resultCode | String | 是 | 二级响应码 | "" |
sub_detail | String | 是 | 二级响应码描述 | "" |
solution | String | 是 | 解决方案 | "" |
nextRequestId | String | 否 | 默认一页200条。每次查询返回一个值,客户需要用这个值再查,如果返回 false 说明查询结束 | 1760506606618202114 |
data | Object[] | 是 | 返回结果数据 | [] |
业务响应数据:data
参数名称 | 参数类型 | 是否必选 | 参数描述 | 参数示例 |
---|---|---|---|---|
platName | String | 是 | 平台名称 | 淘宝 |
shopNo | String | 是 | 店铺编码 | Db001 |
shopName | String | 是 | 店铺名称 | 第一个店铺 |
businessDate | String | 是 | 账单结算日期 | 2023-03-21 |
summaryNo | String | 是 | 汇总单号,唯一编码 | HZBH0001 |
accountNo | String | 是 | 账号 | **@.com |
billType | String | 是 | 交易账户名 | ***@com.cn |
expenseClassifyName | String | 是 | 费用分类名称 | 收款项目 |
expenseItemNo | String | 是 | 费用项编码 | 10290125 |
expenseItemName | String | 是 | 费用项名称 | 这是一个收款项 |
businessAmount | String | 是 | 金额 | 100.0009 |
amountChannel | String | 是 | 资金渠道 | alipay_money |
businessType | String | 是 | 类型 | 收款 |
请求demo
{ "businessDate": "2023-11-03", "appId": "fa330697b64a49a9a4f6fe6b7fef57a7", "platName": "淘宝1", "businessType": [ "收款退款1" ], "shopNo": [ "0100001180" ], "expenseItemName": [ "发货超时1" ], "sid": "hjytest41" }
响应demo
{ "response": { "data": [ { "billType": "自定义淘宝", "platName": "淘宝", "shopName": "峰米天猫店", "expenseItemNo": "00040012", "expenseItemName": "发货超时", "businessDate": "2023-11-03", "accountNo": "0100001180", "expenseClassifyName": "交易退款", "amountChannel": "1", "businessType": "收款退款", "summaryNo": "1726548610551963649", "businessAmount": "250.0", "shopNo": "0100001180" } ], "message": "接口调用成功", "nextRequestId": "false", "resultCode": "200", "solution": "", "sub_detail": "业务处理成功", "sub_resultCode": "SUCCESS" } }