# Enquire about receivable information
Interface should be called on the server side, not in the front end (Weixin Mini Program, web pages, APP, etc.) directly called, specific reference interface call guide
Interface name: nontaxqueryfee
This interface is provided to the Commission for the purpose of querying incoming information
# 1. How to call
# HTTPS calls
POST https://api.weixin.qq.com/nontax/queryfee?access_token=ACCESS_TOKEN
# Cloud Calls
- This interface does not support cloud calls
# Third party invocation
- Third Party Platform calls are not supported by this interface.
# 2. Request parameters
# Query parametersQuery String parameters
Parameter Name | type | Required to fill in | Introductions |
---|---|---|---|
access_token | string | yes | Interface invoke credentials, using access_token |
# Request BodyRequest Payload
Parameter Name | type | Required to fill in | Introductions |
---|---|---|---|
appid | string | yes | appid |
service_id | number | yes | Service id |
bank_id | string | no | Bank ID (globally unique ID assigned by the WeChat non-tax platform), randomly selected from the list of configured banks when not specified |
payment_notice_no | string | yes | Payment Notice Number |
department_code | string | yes | Receipt unit code |
payment_notice_type | number | no | Type of notice, 1: General type of notice; 2: Type of penalty notice |
region_code | string | yes | Administrative division codes |
# 3. Return Parameters
# Response Payload
Parameter Name | type | Introductions |
---|---|---|
errcode | number | Return code |
errmsg | string | Return code description |
user_name | string | User Name |
fee | number | Total Amount (in units of units) |
items | object | Details of the sub-item of contributions |
payment_notice_no | string | Payment Notice Number |
department_code | string | Receipt unit code |
department_name | string | Name of receiving unit |
payment_notice_type | number | Type of notification |
region_code | string | Administrative division codes |
payment_notice_create_time | number | Payment Notice Creation Time (timestamp, in seconds) |
payment_expire_date | string | Payment Limit Date, Format YYYMMDD |
# Res.itemsObject Payload
Details of the sub-item of contributions
Parameter Name | type | Introductions |
---|---|---|
no | number | Item numbers, such as 1, 2, 3 |
item_id | string | Project coding |
item_name | string | Project Name |
overdue | number | Late payments (in units of units) |
penalty | number | Amount of additional penalty (in units of units) |
fee | number | Amount (inclusive of late fees and additional penalties, in units of decimal units) |
# 4. Note
There are no special considerations for this interface
# 5. Code examples
Example Requests
{
"appid":"wx5f6e43071809a9dd",
"service_id": 123,
"bank_id":"470690268",
"payment_notice_no":"440204190185356",
"department_code":"143605002004",
"payment_notice_type":1,
"region_code":"440000"
}
Return an example
{
"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. Error code
The following is a list of error codes for this interface, other error codes can refer to General error codes
Error code | Error Description | Solutions |
---|---|---|
40001 | invalid credential access_token isinvalid or not latest | AppSecret error while getting access_token, or access_token is invalid.Developers should check that AppSecret is correct, or that they are calling interfaces for the appropriate Official Account |
# 7. Scope of application
How this interface can be invoked under different account types:
Weixin Mini Program | Official Account | Service Account |
---|---|---|
Certification only | Certification only | Certification only |
- Authentication only: means that only authenticated accounts are allowed to be invoked by the enterprise entity, and accounts that are not authenticated or do not support authentication cannot be invoked.
- Other account types that are not expressly stated may not be called on this interface without special instructions;