全站导航

公共异常码

航税云开放平台公共异常码对照表:涵盖签名、鉴权、解密、流量、参数等常见异常,附处理建议。

公共异常码对照表

开放平台对接口非业务调用错误做统一处理,返回码如下,接入遇异常可按建议排查。

异常代码描述处理建议
0200API 签名异常服务异常,请联系开放平台管理员
0201必填项输入参数空请确认必填字段是否不为空
输入参数格式有误请确认数据格式是否填写正确
API 授权异常服务异常,请联系开放平台管理员
客户端传输格式与解析格式描述不相符请确认消息头 dataType 与请求数据格式匹配
0202API 计费异常服务异常,请联系开放平台管理员
0203API 处理异常服务异常,请联系开放平台管理员
040102API 服务异常,请稍后重试服务异常,请联系开放平台管理员
05请求编码异常URLDecoder 解码异常
0701解密异常请检查 appKey 是否填写正确
070101密钥空请检查 appKey 是否填写正确
获取 app 密钥失败或 appKey 无效请检查 appKey 是否填写正确
070102密钥长度不够请确认 appSecret 填写正确
070103无法识别加密算法请确认消息头 signMethod 值是否正确,目前仅支持 AES
070201超出 API 日流量限额当日免费调用次数超出限制,请联系开放平台运营增加(免费 API)
070204当前接口无剩余流量,请前往应用概况页增加接口调用量剩余调用次数已用完,请在平台购买(收费 API)
070301accessToken 不匹配 / 或 appKey 不匹配请检查 accessToken、appKey 是否填写正确及匹配
070302APP 未申请该资源请联系开放平台运营开通 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);
验签失败请检查服务器时间是否与北京时间保持一致
以上为接口调用公共异常码,业务层返回码以各接口文档为准。