发票云(标准版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 查验识别
  • 整体介绍
  • 对接约定
  • 授权
    • 获取AccessToken
      POST
  • 开票
    • 产品介绍
    • 开发指南
    • 税控&数电同步开票
      • 业务场景下接口调用顺序
      • 1.01.读取税盘信息(czlx-7)
      • 1.02 .读取票种信息(czlx-30)
      • 1.03.发票开具(czlx-3)
      • 1.04.发票作废(czlx-6)
      • 1.05.发票查询(czlx-5)
      • 1.06.发票打印(czlx-4)
      • 1.07.专用发票申请红字信息表(czlx-20)
      • 1.08.查询专用发票申请红字信息表(czlx-18)
      • 1.09.批量打印(czlx-32)
      • 1.11.机动车销售统一发票开具(czlx-40)
      • 1.12.机动车销售统一发票查询(czlx-41)
      • 1.13.机动车销售统一发票红冲(czlx-42)
      • 1.15.核定票种查询(czlx-51)
      • 1.21.二手车-发票开具(czlx-43)
      • 1.22.二手车-发票查询(czlx-44)
      • 1.23.二手车-发票红冲(czlx-45)
      • 1.30 .查询授信额度接口(czlx-122)
      • 2.01.电子发票开具(czlx-110) ,【注】开数电票请对接:1.03.发票开具(czlx-3)
      • 2.02.电子发票信息查询(czlx-113)
      • 2.03.电子发票红冲 (只支持全额红冲)(czlx-114)
      • 2.04.刷新PDF(czlx-115)
      • 2.05.查询电子发票余量(czlx-116)
      • 3.01.查询税收分类编码信息(czlx-504)
      • 3.03.获取打印机列表(czlx-901)
    • 数电异步开票
      • 异步开票-v4
      • 查询异步开票结果-v4
    • 扫码开票
      • 上传销售单模式扫码开票
        • 接入指南
        • 1.token获取
        • 2.上传发票销售单接口
        • 3.回推接口地址
      • 自定义扫码开票
        • 接入指南
        • 1.对接方按规则组装二维码链接
        • 2.查询开票明细
        • 3.回推接口地址
    • 企业级-发票云销项查询
      • 根据业务条件查询当前企业的销项发票
  • 收票
    • 开发指南
    • 发票数据规范
    • 发票数据
      • 机动车发票数据
      • 火车票数据
      • 火车票退票凭证数据
      • 财政电子票据数据
      • 客运票/轮船票数据
      • 其他发票数据
      • 完税证明数据
      • 飞机票数据
      • 数电票(铁路电子客票)数据
      • 数电票(航空运输电子客票行程单)数据
      • 数电票(专票/普票)数据
      • 的士票数据
      • 定额发票数据
      • 通用机打(纸质/电子)发票数据
      • 过路过桥费数据
      • 二手车票数据
      • 专票和普票数据
      • 通行费发票数据
      • 海关缴款书数据
      • 发票文件数据
    • 企业级-发票云进项查询
      • 根据业务条件查询当前企业采集的发票
      • 根据代码号码查询当前企业采集的发票
      • 根据开票时间范围和采集时间范围查询当前企业采集的发票
      • 根据发票流水号或者发票代码号码查询当前企业采集的发票
      • 根据业务条件查询指定用户采集的发票
    • 税盘&数电票下载
      • 开发指南
      • 1、获取税款所属期信息
      • 2、进项发票表头采集
      • 3、发票不抵扣勾选
      • 4、海关缴款书抵扣勾选(税盘模式不支持)
      • 5、海关缴款书不抵扣勾选(税盘模式不支持)
      • 6、海关缴款书表头采集(税盘模式不支持)
      • 7、全量发票查询
      • 8、当前统计查询
      • 9、历史统计查询
      • 10、生成统计表
      • 11、撤销统计表
      • 12、确认统计表
      • 13、获取当前已勾选或往期已认证发票(税盘模式不支持)
      • 14、当期已勾选或往期已认证缴款书(税盘模式不支持)
      • 15、发票抵扣勾选
    • 电子凭证解析
      • billTypeCode表
      • 解析 + 验签 指定文件的xbrl信息
      • xbrl字符串转json
      • json转xbrl字符串
    • 发票异步下载
      • 进项全量发票采集-异步申请
      • 进项全量发票采集-异步结果查询
    • 发票数据规范
  • 查验识别
    • 开发指南
    • 发票查验(单张)
    • 发票查验(多张异步)
    • 发票识别+查验(单张)
    • 发票识别(多张)
    • 发票识别+查验(多张)
    • 数电票文件识别+查验
    • 返回状态码
  • 报销
    • 发票助手移动端-h5对接
    • 发票助手移动端-小程序对接
    • 第三方发票报销查询
    • 发票助手PC端对接
      • 对接流程
      • JS建立连接通道
      • 采集发票
      • 后端建立通道
      • 查看发票
      • 编辑单张发票
      • 分录操作
      • 常见问题
      • 获取userKey
      • 获取linkKey
      • 缓存单据
      • 保存单据
      • 更新单据状态
      • 根据发票流水号获取发票详细数据
      • 根据userkey查询单据下所有发票列表
      • 删除单据
      • 再次查验
      • 回写入账信息
      • 删除入账信息
  • 影像
    • 开发指南
    • 对接约定
    • 影像系统对接
    • 授权
      • 获取AccessToken(影像系统)
  • 档案
    • 异构系统接口定义
    • 发票返结构体
  1. 查验识别

返回状态码

附录1:Api返回码描述#

区段描述
代码段描述
0000-1000操作成功段代码
1300-1399操作失败段代码
1100-1199操作异常段代码
1200-1299传递参数错误段代码
10001-20000自定义区段
代码详细描述
代码数据类型描述
成功
0000字符串通用操作成功代码
失败
1300字符串通用操作失败代码
1301字符串操作失败代码
异常
1100字符串服务器异常代码
参数错误
1200字符串参数错误代码
字符串代码

附录2:同步查验返回码详细描述#

errcodedescription
0000操作成功
0001该应用没有查验权限
0002该应用查验权限过期
1101接口服务异常
1119运行时异常
1200参数格式不正确
1214抱歉,参数错误,请传递正确参数
1132抱歉,接口服务异常
1301抱歉,参数错误,请传递正确参数
9999API调用失败
0005请求不合法
0006发票信息不一致,例如:号码、代码、校验码位数不符合规范;
0009所查发票不存在
1001超过该张票当天查验次数
1002查验超时。例:网络问题、税局网站响应(偏远省份网络问题)
1004已超过最大查验量
1005查询发票不规范,例如:号码、代码、校验码位数不符合规范;
1006查验异常
1007鉴权失败
1008参数不能为空
1009参数长度不正确
1014日期当天的不能查验
1015超过一年的不能查验
1020没有查验权限
3109查验失败,请联系管理员
3110发票查验地区税局服务暂停
0313传入日期格式不正确
0314校验码与金额不能同时为空

附录3:批量异步查验返回码详细描述#

errcodedescription
0000查询成功
0001该应用没有查验权限
0002该应用查验权限过期
1110系统内部错误,请联系开发人员!
1200参数格式不正确
1119运行时异常
1301抱歉,参数错误,请传递正确参数
1307发票批量查验错误,例:服务异常
1001超过该张发票当日查验次数(请于次日再次查验)!
1002查询超时。例:网络问题、税局网站响应(偏远省份网络问题)
1003查无此票,例:1、发票不存在;2、开票方数据没有上传税局
1004未知错误,税局返回错误码
1005不一致,例:号码、代码、校验码位数不符合规范;

附录4:图片识别查验返回码详细描述#

errcodedescription
0000查询成功
0001该应用没有查验权限
1221数据读取失败
1222传入参数为空
1214抱歉,参数错误,请传递正确参数
1213抱歉,参数文件读取失败
1212抱歉,请求参数获取失败
1132抱歉,接口服务异常
1133抱歉,调用接口服务异常
1101请求数据超时
1119运行时异常
1001超过该张发票当日查验次数(请于次日再次查验)!
1002查询超时, 例:网络问题、税局网站响应(偏远省份网络问题)
1003查无此票,例:1、发票不存在;2、开票方数据没有上传税局
1004未知错误,税局返回错误码
1005发票信息不一致,例:号码、代码、校验码位数不符合规范;
1110系统内部错误,请联系开发人员!
3100您上传的图像文件为空文件
3101您上传的文件不是图像文件
3102您上传的图像文件太小,请上传大图
3103请您上传有效且清晰彩色增值税发票图像
3104未找到目标发票区域,请您将发票置于纯色背景中并拍全
3105请您确认上传了有效且清晰的增值税发票图像,请将发票置于纯色背景中并拍全
3106发票识别内部错误,请联系管理员
3107部分发票信息识别有误
3108已超过最大查验量
1224识别关键参数为空(代码、号码、日期)
1225发票金额与校验码不能同时为空!

附录5:合规性校验详细描述#

errcodedescription
1错误原因:查验不通过,禁止导入
2错误原因:被其他单据在用或已用,禁止导入
3错误原因:电子发票未上传源文件,禁止导入
4错误原因:发票抬头与企业名称不一致,禁止导入
5错误原因:发票税号与企业税号不一致,禁止导入
6错误原因:个人抬头的发票,禁止导入
7错误原因:作废发票,禁止导入
8错误原因:红冲发票,禁止导入
9错误原因:手工修改,禁止导入
10错误原因:串号发票,禁止导入
11错误原因:无印章发票,禁止导入
12错误原因:含敏感词发票,禁止导入
13错误原因:销方名称在黑名单,禁止导入
14错误原因:超过报销期限,禁止导入
15错误原因:超过跨年期限,禁止导入
16错误原因:发票连号,禁止导入
17错误原因:VERIFYNAME,禁止导入
18错误原因:校验出租车监制章不通过,禁止导入
19错误原因:销方为税局公示的重大税收违法失信纳税人,禁止导入
20错误原因:专票地址电话与当前企业不一致,禁止导入
21错误原因:专票开户行账号与当前企业不一致,禁止导入
22错误原因:不允许导入的发票类型,禁止导入
上一页
数电票文件识别+查验
下一页
发票助手移动端-h5对接
Built with