概述
对公共请求参数以及各个接口返回的code以及处理建议进行说明
公共请求参数
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 0000 | 处理成功 | ||
| 9999 | 处理失败 | ||
| 9998 | CA加解密失败 | 联系平台处理 | |
| 3503 | 服务请求异常 | 税局服务异常，请稍后重试 | |
| 2005 | 参数错误 | 接口代码不正确 | 检查公共请求参数接口编码是否为空或错误 |
| 3502 | 参数错误 | 税号不存在 | 检查公共请求参数企业税号是否为空或格式错误 |
| 3505 | 参数错误 | 压缩标识不正确 | 检查公共请求参数压缩标识是否为空或错误 |
| 3506 | 参数错误 | 加密标识不正确 | 检查公共请求参数加密标识是否为空或错误 |
| 3507 | 参数错误 | 用户名不正确 | 检查公共请求参数用户名是否为空 |
| 3509 | 参数错误 | 签名方式不正确 | 检查公共请求参数签名方式是否为空或错误 |
| 3510 | 参数错误 | 签名值不正确 | 检查公共请求参数签名值是否为空 |
| 3511 | 参数错误 | 请求流水号为空 | 检查公共请求参数请求流水号否为空 |
| 3512 | 参数错误 | 身份令牌不正确 | 检查公共请求参数身份令牌信息是否正确或过期 |
| 3520 | 参数错误 | 签名校验未通过 | 检查公共请求参数签名值是否为空或按规则生成 |
| 3523 | 参数错误 | 业务报文解密失败 | 检查内层报文是否按照规则加密或加密密钥是否正确 |
| 3524 | 参数错误 | 业务数据异常 | 检查内层报文数据是否规范 |
业务参数
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 9007 | 业务错误 | 权限校验失败 | 检查当前企业有无使用该接口权限 |
| 1101 | 业务错误 | 参数错误 | |
| 1102 | 业务错误 | 信任链错误 | |
| 1103 | 业务错误 | 证书错误 | |
| 1104 | 业务错误 | 证书验证错误（包括过期） | |
| 1105 | 业务错误 | 内存错误 | |
| 1106 | 业务错误 | 密文错误 | |
| 1107 | 业务错误 | 没有初始化 | |
| 1108 | 业务错误 | 密钥错误 | |
| 1109 | 业务错误 | PFX文件错误 | |
| 1110 | 业务错误 | 加密错误 | |
| 1111 | 业务错误 | 解密错误 | |
| 1112 | 业务错误 | 签名错误 | |
| 1113 | 业务错误 | 验证错误 | |
| 3002 | 业务错误 | 网络异常或请求超时，验签用户请重试或联系服务商； 盘签用户请检查税盘插入情况，详情参看客户端日志 |
|
| 3003 | 业务错误 | 接口调用超限 | |
| 3006 | 业务错误 | 未提交该批次请求 | |
| 3007 | 业务错误 | 日期不能为空或格式错误 | |
| 3014 | 业务错误 | 该批次号已经提交过请求，请勿重复提交 | |
| 3016 | 业务错误 | 无此批次号信息 | |
| 3017 | 业务错误 | 校验码不能为空或格式有误 | |
| 3018 | 业务错误 | 同一批次号勾选发票重复提交或该发票认证中，请稍后重试 | |
| 3019 | 业务错误 | 该发票不支持查验或发票代码有误 | |
| 3020 | 业务错误 | 相同批次号的请求必须完全一致 | |
| 3024 | 业务错误 | 会话已超时，请重新登录 | |
| 3025 | 业务错误 | 请求过于频繁，请稍后重试 | |
| 3026 | 业务错误 | 当月已认证数据只允许签名后查询 | |
| 3027 | 业务错误 | 税款所属期为当前月，不能查询未到期发票 | |
| 3028 | 业务错误 | 税局服务器异常 | |
| 3029 | 业务错误 | 税盘密码为空或格式错误 | |
| 3030 | 业务错误 | 主管机构代码为空或格式有误 | |
| 3038 | 业务错误 | 非验签用户，请核实 | |
| 3039 | 业务错误 | 确认密码为空或格式错误 | |
| 3040 | 业务错误 | 盘签使用中请关闭开票软件 | |
| 3041 | 业务错误 | 税盘密码标记错误，请检查税盘登录密码 | |
| 3042 | 业务错误 | 不支持该盘的读取 | |
| 3043 | 业务错误 | 未传入税盘密码 | |
| 3044 | 业务错误 | 盘签交互流程缺失信息 | |
| 3045 | 业务错误 | 设备已锁死，联系税局解锁 | |
| 3046 | 业务错误 | 设备登录密码错误，为防止锁死请核实后再试 | |
| 3050 | 业务错误 | 不存在可确认的退税数据 | |
| 3051 | 业务错误 | 该企业没有退税权限 | |
| 3098 | 业务错误 | 请求参数不合法 | |
| 3099 | 业务错误 | 处理失败 |
发票查验
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 0002 | 业务错误 | 超过该张票当天查验次数（5次） | |
| 0005 | 数据错误 | 请求参数不合法 | |
| 0006 | 数据错误 | 发票信息不一致，核对参数 | |
| 0009 | 数据错误 | 所查发票不存在 | |
| 1005 | 数据错误 | 发票查询不规范，发票信息有误 | |
| 1006 | 业务错误 | 查验异常 | |
| 1008 | 数据错误 | 必传参数不能为空 | |
| 1009 | 数据错误 | 参数长度不正确 | |
| 1015 | 业务错误 | 超过5年不能查验 | |
| 1021 | 业务错误 | 网络超时，请稍后重试 | |
| 4000 | 业务错误 | 该用户发票查验次数超限 | 用户查验次数用尽，联系平台处理 |
| 4001 | 业务错误 | 查验中断 | 税局服务异常，请稍后重试 |
| 4002 | 数据错误 | 发票代码不能为空 | |
| 4003 | 数据错误 | 发票代码长度只能为12或者10 | |
| 4004 | 数据错误 | 发票号码不能为空 | |
| 4005 | 数据错误 | 发票号码长度只能8 | |
| 4006 | 数据错误 | 发票类型不能为空 | |
| 4007 | 数据错误 | 发票类型内容错误 | |
| 4008 | 数据错误 | 开票日期不能为空 | |
| 4009 | 数据错误 | 开票日期格式不对 | |
| 4010 | 数据错误 | 发票类型为01，02，03，15时，金额不能为空 | |
| 4011 | 数据错误 | 发票类型为04，10，11，14时，校验码不能为空 | |
| 4012 | 数据错误 | 校验码长度必须为6 |
发票信息下载
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 4101 | 数据错误 | 发票类型不能为空 | |
| 4102 | 数据错误 | 发票采集开始时间不能为空 | |
| 4103 | 数据错误 | 发票采集开始时间格式错误 | |
| 4104 | 数据错误 | 发票采集结束时间不能为空 | |
| 4105 | 数据错误 | 发票采集结束时间格式错误 | |
| 4106 | 数据错误 | 当前页码不能为空 | |
| 4107 | 数据错误 | 当前页码格式错误 | |
| 4108 | 数据错误 | 状态标识不能为空 | |
| 4109 | 数据错误 | 日期格式不一致 | |
| 5009 | 数据错误 | 日期格式不正确 |
发票状态下载
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 4101 | 数据错误 | 发票类型不能为空 | |
| 4102 | 数据错误 | 发票采集开始时间不能为空 | |
| 4103 | 数据错误 | 发票采集开始时间格式错误 | |
| 4104 | 数据错误 | 发票采集结束时间不能为空 | |
| 4105 | 数据错误 | 发票采集结束时间格式错误 | |
| 4106 | 数据错误 | 当前页码不能为空 | |
| 4107 | 数据错误 | 当前页码格式错误 | |
| 4108 | 数据错误 | 状态标识不能为空 | |
| 4109 | 数据错误 | 日期格式不一致 | |
| 5009 | 数据错误 | 日期格式不正确 |
发票勾选申请
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 3513 | 数据错误 | 本次提交的勾选发票数量不正确 | 检查contentRows的值是否合法 |
| 3514 | 数据错误 | 发票代码不正确 | |
| 3515 | 数据错误 | 发票号码不正确 | |
| 3516 | 数据错误 | 发票类型不正确 | |
| 3517 | 数据错误 | 开票日期不正确 | |
| 3522 | 数据错误 | 认证类型不正确 | |
| 4300 | 数据错误 | 勾选发票为空 | |
| 4301 | 数据错误 | 本次提交的勾选发票数量与实际发票数量不相等 | 检查实际勾选的发票数量是否等于contentRows的值 |
| 4302 | 数据错误 | 勾选状态不正确 | |
| 4303 | 数据错误 | 有效税额为空或格式错误 | |
| 4304 | 数据错误 | 税额为空或格式错误 | |
| 4305 | 数据错误 | 申请税款所属期为空或格式错误 | |
| 4306 | 数据错误 | 缴款书号码为空或错误 | |
| 4307 | 数据错误 | 用途为空或错误 | |
| 4308 | 数据错误 | 海关缴款书勾选一次请求只支持同一种操作 | 检查yt字段内容是否相同 |
| 4309 | 数据错误 | 该批次号发票勾选申请接口调用异常，请检查 | 检查batchNo |
| 4310 | 数据错误 | 不抵扣原因为空或错误 | 检查bdkyy字段 |
发票勾选结果查询
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 3519 | 业务错误 | 请求批次号不存在 | 检查批次号是否已经调用发票勾选申请接口或者调用发票勾选申请接口返回结果是否正常 |
| 4309 | 业务错误 | 该批次号发票勾选申请接口调用异常，请检查 | 检查使用该批次号调用发票勾选申请接口时返回结果 |
发票申请统计
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 4500 | 数据错误 | 统计所属期不正确 | |
| 4501 | 数据错误 | 统计标识不正确 |
发票统计结果查询
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 3519 | 业务错误 | 请求批次号不存在 | 检查批次号是否已经调用发票申请统计接口或者调用发票申请统计接口返回结果是否正常 |
| 4601 | 业务错误 | 该批次号发票申请统计接口调用异常，请检查 | 检查使用该批次号调用发票申请统计接口时返回结果 |
企业认证请求
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 4700 | 数据错误 | 认证所属期不正确 | |
| 4701 | 数据错误 | 确认标识不正确 | |
| 4702 | 数据错误 | 统计时间不正确 |
企业认证结果查询
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 2006 | 数据错误 | 批次号必须以税号开始并且为32位 | 必须以税号开始，建议由税号+时间戳+随机数生成32位唯一码 |
| 3519 | 业务错误 | 请求批次号不存在 | 检查是否已使用该批次号进行企业认证请求 |
| 4800 | 业务错误 | 该批次号企业认证请求接口调用异常，请检查 | 检查使用该批次号调用企业认证请求接口时返回结果 |
单张发票查询
字段说明
| 错误码 | 错误类型 | 错误描述 | 处理建议 |
|---|---|---|---|
| 4901 | 数据错误 | 发票代码不能为空 | |
| 4902 | 数据错误 | 发票代码长度只能为12或者10 | |
| 4903 | 数据错误 | 发票号码不能为空 | |
| 4904 | 数据错误 | 发票号码长度只能8 | |
| 4905 | 数据错误 | 缴款书号码不能为空 | |
| 4907 | 数据错误 | 发票类型不能为空 | |
| 4908 | 数据错误 | 发票类型有误 |