当前位置: 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

platNameString平台名称淘宝
businessTypeString[]类型,可以批量["收款","收款退款"]
expenseItemNameString[]费用项名称["收款项目"]

shopNo

String[]

店铺编码,可以批量

["Db001"]

响应数据

公共响应数据

参数名称参数类型是否必选参数描述参数示例
resultCodeString业务响应码200
messageString业务响应码描述success
sub_resultCodeString二级响应码""
sub_detailString二级响应码描述""
solutionString解决方案""
nextRequestIdString默认一页200条。每次查询返回一个值,客户需要用这个值再查,如果返回 false 说明查询结束1760506606618202114
dataObject[]返回结果数据[]

业务响应数据: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"
    }
}


常用工具