按收费项目汇总查询账单¶
功能说明¶
- 按收费项目汇总查询账单；
接口地址¶
- 测试环境: https://openapi.guanaitong.tech/bill/chargeItem
- 生产环境: https://openapi.guanaitong.com/bill/chargeItem
HTTP请求方式¶
- Method: POST
- Content-Type: application/x-www-form-urlencoded
参数说明¶
-
公有参数
发送请求是必须传入公共参数，详见公共参数
-
私有参数
| 参数名称 | 是否必须 | 参数类型 | 长度限制 | 描述 |
|---|---|---|---|---|
| bill_period | 是 | string | {6,8} | 账期；月对账格式如：yyyyMM |
| product_category | 是 | int | {1} | 产品类型；参考企业额度账户查询接口返回的product_category：https://open.guanaitong.com/doc/enterprise/account-enterprise-limit-get/ |
| enterprise_code | 否 | string | [1,20] | 企业编号（集团和运营商必填,企业不填） |
请求示例¶
POST /bill/chargeItem HTTP/1.1
Host: openapi.guanaitong.tech
Content-Type: application/x-www-form-urlencoded
Cache-Control: no-cache
access_token=ed7ea86cad31aa2fe4e4fc7183922cc2&sign=b83e4926fd4fa771895fb01a401c235a9825d4d4
timestamp=1492669228&product_category=2&bill_period=202309
返回参数说明¶
| 参数名称 | 描述 |
|---|---|
| code | 返回码。详见错误代码。 |
| msg | 如果错误，返回错误信息。 |
| data | 账单数据 |
| data.product_category | 产品类型，同入参 |
| data.product_category_name | 产品类型名称，同入参 |
| data.taxpayer_name | 纳税人名称 |
| data.service_fee | 服务费金额 |
| data.diff_service_fee | 服务费调差金额 |
| data.settlement_amount | 结算金额 |
| data.bill_amount | 交易金额 |
| data.diff_amount | 调差金额 |
| data.cost_center_name | 成本中心名称 |
| data.cost_center_code | 成本中心code |
正确返回示例¶
{
"code": 0,
"msg": "OK",
"data": [
{
"product_category_name": "员工午餐",
"bill_amount": "0",
"taxpayer_id": 0,
"service_fee": "0",
"diff_amount": "0",
"settlement_amount": "0.0",
"cost_center_name": "",
"taxpayer_name": "",
"diff_service_fee": "0",
"product_category": 2,
"cost_center_code": ""
}
]
}