# 返回状态码说明

# 全局返回码

返回码 返回码描述 解决方法
0000 操作成功
1001 数据不合法
1002 数据不存在
1004 数据已存在
9999 异常错误
3001 发票已经存在
3002 发票解析出错
3003 发票查验不合法
3004 发票状态不正确
3005 发票pdf文件上传失败
3006 发票pdf文件下载失败
3010 无电子签章
3011 电子签名被篡改
3012 证书链不通过
3013 购买方纳税人识别号为空
3014 无销货清单
3015 个人用户查验面试次数超上限
3016 供应商黑名单
3018 发票连号
3019 发票已经作废(查验)
3020 发票excel导入校验错误
4001 密码不匹配,登录失败
4002 用户不存在
4003 用户状态不正确
4004 用户类型不正确
5001 税盘当前不可进行签名
5002 税盘当前不可进行签名取消
5010 税盘不在线
5011 税盘会话超时
5012 税局限流
5020 税局同步结果warning,比如同步数据为0,警告但不是错误
5060 助手websocket通道掉线
5030 发票下载-文件无效
9405 请求方法不正确
9417 超过限流数
5001 微信小程序获取token不成功
6101 发票状态检查
9001 查验上传到疑票管理
9006 合规校验失败
9007 数电长软token过期
9008 数电实名认证过期
9009 数电-未检测到登录配置信息

# 签名验签

返回码 返回码描述 解决方法
8001 签名失败 参照其他代返回码描述
8002 非法的api调用 请联系appid颁发者
8003 请求身份不合法 请联系appid颁发者
8004 appid为空 情确认url参数是否包含appid
8005 无法获取appid对应的key 请确认appid是否正确以及确认appid对应的域名地址是测试环境或者生产环境
8006 请求头缺少sign值 请检查请求头是否包含sign
8007 签名验证配置信息错误 请联系appid颁发者
8008 签名数据缺少requestdatas jwt签名payload缺少requestdatas部分,请参照示例代码对requestdatas 进行处理
8009 签名数据被篡改 请检查网络是否被攻击
8010 过期的调用 请确认服务器时间是否为标准时间
8011 签名值不正确 请确认使用的证书是否与appid匹配
A10001 发票没有退回url 销项开票管理专用错误码

# 开具发票

返回码 返回码描述 解决方法
2001 未找到相应税控组织 请确认报文XSF_NSRSBH或者ORGCODE是否正确
2002 未找到相应纳税主体 请确认组织管理菜单对应组织纳税信息是否维护
2003 销售方纳税人识别号与税控组织对应的纳税人识别号不匹配 报文XSF_NSRSBH字段与ORGCODE对应的组织纳税人识别号不一致,请确认报文XSF_NSRSBH或者ORGCODE是否正确
2004 开票组织不匹配 请确认报文XSF_NSRSBH或者ORGCODE是否属于appid 对应的公司
2005 未找到相应纳税信息 请确认报文XSF_NSRSBH或者ORGCODE是否正确
2006 不能唯一确定纳税主体信息 请检查ORGCODE是否为空,此问题原因在于一个税号对应多个开票点,此时必须传ORGCODE
2007 缺少发票明细数据 请检查报文items字段是否为空
2008 对应开票请求未找到相应税控设备 请检查报文FPLX字段对应的票种是否存在于“组织管理”菜单中“税控设备”列表
Last Updated: 5/15/2023, 3:53:46 PM