航税云开放平台公共异常码对照表:涵盖签名、鉴权、解密、流量、参数等常见异常,附处理建议。
开放平台会对开发者的接口非业务调用错误做统一处理,返回码如下。接入过程中如遇异常,可按表内建议排查。
| 异常代码 | 描述 | 处理建议 |
|---|---|---|
| 0200 | API 签名异常 | 服务异常,请联系开放平台管理员 |
| 0201 | 必填项输入参数空 | 请确认必填字段是否不为空 |
| 输入参数格式有误 | 请确认数据格式是否填写正确 | |
| API 授权异常 | 服务异常,请联系开放平台管理员 | |
| 客户端传输格式与解析格式描述不相符 | 请确认消息头 dataType 指定数据格式是否与请求数据格式匹配 | |
| 0202 | API 计费异常 | 服务异常,请联系开放平台管理员 |
| 0203 | API 处理异常 | 服务异常,请联系开放平台管理员 |
| 040102 | API 服务异常,请稍后重试 | 服务异常,请联系开放平台管理员 |
| 05 | 请求编码异常 | URLDecoder 解码异常 |
| 0701 | 解密异常 | 请检查 appKey 是否填写正确 |
| 070101 | 密钥空 | 请检查 appKey 是否填写正确 |
| 获取 app 密钥失败或 appKey 无效 | 请检查 appKey 是否填写正确 | |
| 070102 | 密钥长度不够 | 请确认 appSecret 填写正确 |
| 070103 | 无法识别加密算法 | 请确认消息头 signMethod 值是否正确,目前仅支持 AES |
| 070201 | 超出 API 日流量限额 | API 当日免费调用次数超出限制,请联系开放平台运营增加调用次数(免费 API) |
| 070204 | 当前接口无剩余流量,请前往应用概况页面增加接口调用量 | API 剩余调用次数已用完,请自行在平台上购买(收费 API) |
| 070301 | accessToken 不匹配 / 或 appKey 不匹配 | 请检查 accessToken、appKey 是否填写正确及匹配 |
| 070302 | APP 未申请该资源 | 请联系开放平台运营开通 API 权限 |
| 请联系服务商开通 API 权限 | 请联系服务商开通 API 权限 | |
| 请联系服务商调整 API 使用期限 | 请联系服务商调整 API 使用期限 | |
| 请联系服务商调整 API 日流量限额 | 请联系服务商调整 API 日流量限额 | |
| 0704 | 解压异常 | 请确认是否使用 GZIP 压缩及压缩、数据加密和 URL 编码顺序是否正确 |
| 压缩方式无法识别 | 请确认消息头 compress 字段是否填写正确,目前仅支持 GZIP | |
| 070401 | 调用用户身份不匹配 | 请检查商户税号 taxnum 和 token 是否匹配 |
| 070501 | 请求的 API 不存在 | 请检查 API 编码是否填写正确,再次重试 |
| 070601 | 密钥获取失败 | 请检查 appKey 是否填写正确 |
| 签名不匹配 | 请使用官方 SDK 调用 API,尽量保证服务器编码为 UTF-8;如果是 Windows 服务器默认编码为 GBK,可通过 SDK 中的 convertToUtf8 方法转换报文体,如 body = sdk.convertToUtf8(body); | |
| 验签失败 | 请检查服务器时间是否与北京时间保持一致 |
请留下您的联系方式,我们将在一个工作日内与您联系