API文档

接口说明

使用费用项备注来区分：备注里包含有标识“收款接口数据”字样。

调用场景

财务软件对接生成收款单。

请求地址

环境	奇门地址	服务名
测试环境	http://332wh0cyoi.api.taobao.com/router/qmtest	wdt.hjy.report.zdsk.month.summary.query
生产环境	http://332wh0cyoi.api.taobao.com/router/qm	wdt.hjy.report.zdsk.month.summary.query

请求方式

POST

请求参数

参数名称	参数类型	是否必选	参数描述	示例
hjySign	String	是	慧经营参数签名	e549e097f97123bc7fa3cfc1354796b2
appId	String	是	租户应用标识	b018b1134f854fb48019d47dd424e5f9
sid	String	是	卖家账号	hjy001
nextRequestId	String	否	每页200条，用于分页，查询时返回，下一页查询时传入，返回false，说明查询结束	1760506606618202114
billYear	String	是	账单结算年份	2023
billMonth	String	是	账单结算月份	01
platName	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	是	店铺名称	第一个店铺
billYear	String	是	账单结算年份	2023
billMonth	String	是	账单结算月份	01
summaryNo	String	是	汇总单号，唯一编码	HZBH0001
accountNo	String	是	账号	**@.com
billType	String	是	交易账户名	***@com.cn
expenseClassifyName	String	是	费用分类名称	收款项目
expenseClassifyNo	String	是	费用分类编码	90290125
expenseClassifyRemark	String	是	费用分类备注	这是一个费用项
expenseItemNo	String	是	费用项编码	10290125
expenseItemRemark	String	是	费用项备注	费用接口数据
expenseItemName	String	是	费用项名称	这是一个收款项
subjectId	String	是	科目编码	123
subjectName	String	是	科目名称	aaa
businessAmount	String	是	金额	100.0009
amountChannel	String	是	资金渠道	支付宝
businessType	String	是	类型	收款

请求demo

{
    "billMonth": "11",
    "appId": "fa330697b64a49a9a4f6fe6b7fef57a7",
    "platName": "淘宝1",
    "billYear": "2023",
    "shopNo": [
        "01000011801"
    ],
    "expenseItemName": [
        "发货超时1"
    ],
    "sid": "hjytest41"
}

响应demo

{
    "response": {
        "data": [
            {
                "billType": "资金账单",
                "platName": "淘宝",
                "shopName": "峰米天猫店",
                "expenseItemNo": "00030002",
                "billYear": "2023",
                "expenseItemName": "销售收入-运费",
                "billMonth": "11",
                "expenseItemRemark": "账单预置分类项",
                "expenseClassifyRemark": "其他服务费",
                "accountNo": "0100001180",
                "expenseClassifyName": "121",
                "amountChannel": "1",
                "businessType": "费用",
                "summaryNo": "1726548713329188865",
                "businessAmount": "3000.0",
                "shopNo": "0100001180",
                "expenseClassifyNo": "1212"
            }
        ],
        "message": "接口调用成功",
        "nextRequestId": "false",
        "resultCode": "200",
        "solution": "",
        "sub_detail": "业务处理成功",
        "sub_resultCode": "SUCCESS"
    }
}