# 查询应收信息
接口应在服务器端调用,不可在前端(小程序、网页、APP等)直接调用,具体可参考接口调用指南
接口英文名:nontaxqueryfee
本接口提供给委办局用于查询应收信息
# 1. 调用方式
# HTTPS 调用
POST https://api.weixin.qq.com/nontax/queryfee?access_token=ACCESS_TOKEN
# 云调用
- 本接口不支持云调用
# 第三方调用
- 本接口不支持第三方平台调用。
# 2. 请求参数
# 查询参数 Query String parameters
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
access_token | string | 是 | 接口调用凭证,可使用 access_token |
# 请求体 Request Payload
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
appid | string | 是 | appid |
service_id | number | 是 | 服务id |
bank_id | string | 否 | 银行id(由微信非税平台分配的全局唯一id),不指定时在已配置的银行列表中随机选择 |
payment_notice_no | string | 是 | 缴费通知书编号 |
department_code | string | 是 | 执收单位编码 |
payment_notice_type | number | 否 | 通知书类型,1:普通通知书类型;2:处罚通知书类型 |
region_code | string | 是 | 行政区划代码 |
# 3. 返回参数
# 返回体 Response Payload
参数名 | 类型 | 说明 |
---|---|---|
errcode | number | 返回码 |
errmsg | string | 返回码描述 |
user_name | string | 用户姓名 |
fee | number | 总金额(单位是分) |
items | object | 缴费子项目详情 |
payment_notice_no | string | 缴费通知书编号 |
department_code | string | 执收单位编码 |
department_name | string | 执收单位名称 |
payment_notice_type | number | 通知书类型 |
region_code | string | 行政区划代码 |
payment_notice_create_time | number | 缴费通知书创建时间(时间戳,单位是秒 |
payment_expire_date | string | 限缴日期,格式YYYYMMDD |
# Res.items Object Payload
缴费子项目详情
参数名 | 类型 | 说明 |
---|---|---|
no | number | 项目号,如1,2,3 |
item_id | string | 项目编码 |
item_name | string | 项目名称 |
overdue | number | 滞纳金(单位是分) |
penalty | number | 加罚金额(单位是分) |
fee | number | 金额(包含滞纳金和加罚金额,单位是分) |
# 4. 注意事项
本接口无特殊注意事项
# 5. 代码示例
请求示例
{
"appid":"wx5f6e43071809a9dd",
"service_id": 123,
"bank_id":"470690268",
"payment_notice_no":"440204190185356",
"department_code":"143605002004",
"payment_notice_type":1,
"region_code":"440000"
}
返回示例
{
"department_code":"143605002004",
"department_name":"韶关市公安局交警支队市区一大队",
"errcode":0,
"errmsg":"通知书未缴款",
"fee":20000,
"items":[
{
"fee":20000,
"item_id":"103050101200",
"item_name":"交通违法罚款",
"no":1,
"overdue":0
}
],
"payment_notice_create_time":1508806661,
"payment_notice_no":"440204190185356",
"payment_notice_type":1,
"region_code":"440000",
"user_name":"叶*梅"
}
# 6. 错误码
以下是本接口的错误码列表,其他错误码可参考 通用错误码
错误码 | 错误描述 | 解决方案 |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | 获取 access_token 时 AppSecret 错误,或者 access_token 无效。请开发者认真比对 AppSecret 的正确性,或查看是否正在为恰当的公众号调用接口 |
# 7. 适用范围
本接口在不同账号类型下的可调用情况:
小程序 | 公众号 | 服务号 |
---|---|---|
仅认证 | 仅认证 | 仅认证 |
- 仅认证:表示仅允许企业主体已认证账号调用,未认证或不支持认证的账号无法调用
- 其他未明确声明的账号类型,如无特殊说明,均不可调用此接口;