发票云(旗舰版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 单据开票接口(税控+数电)
  • 整体介绍
  • 快速开始
  • 加解密
  • 文件预览&文件上传&文件下载
  • 发票数据结构
  • 错误码
  • 常见接口错误
  • 场景指引
    • 概述
    • 直接开票
    • 单据开票
    • 扫码开票
  • 授权
    • 1.01.获取app_token
    • 1.02获取access_token
  • 开票
    • 单据开票接口(税控+数电)
      • 单据开票对接指引
      • 开票申请单错误码列表
      • 1.1.01 开票申请单生成及开票(支持拆分合并后,再开票)
        POST
      • 1.1.02 开票申请单撤回(对接方主动撤回)
        POST
      • 1.1.03 开票申请单发票查询
        POST
      • 1.1.04 开票申请单快速红冲(仅支持税控普票)
        POST
      • 1.1.05 开票申请单批量作废(作废单据的发票,仅支持税控纸票)
        POST
      • 1.1.06 开票申请单红冲单或作废单生成(星瀚发票云版本5.0.015支持,不支持数电票)
        POST
      • 1.1.07 开票申请单重开单生成(星瀚发票云版本5.0.015支持,不支持数电票)
        POST
      • 1.1.08 创建负数单匹配任务
        POST
      • 1.1.09 查询负数单匹配任务结果
        POST
      • 1.1.10 单据开票预览
        POST
    • 直接开票接口
      • 数电开票
        • 接入指引(必看)
        • 返回编码说明
        • FAQ
        • 电子税局操作
          • 2.1.30 电子税局登录检测
        • 2.1.01 数电票蓝字发票开具
        • 2.1.02 数电票回调
        • 2.1.03 红字确认单生成
        • 2.1.04 数电票红冲(直接红冲或通过红字确认单)
        • 2.1.05 授信额度查询
        • 2.1.08 红字确认单撤销
        • 2.1.09 红字确认单确认或拒绝
        • 2.1.12 红字确认单下载
        • 2.1.13 红字确认单编号查询
        • 2.1.14 发票用途状态查询(发票云版本6.0.11支持,暂只支持乐企)
      • 税控开票
        • 2.2.01税控开票(直接开票,不支持拆分合并)
        • 2.2.02税控发票快速红冲(仅支持全额红冲)
        • 2.2.03税控发票作废
        • 2.2.04税控红字信息表申请
        • 2.2.05税控红字信息表下载
        • 2.2.06税控发票库存查询
        • 2.2.07税控开票设备查询
        • 2.2.08税控发票打印发票打印(需安装套打打印组件,仅适用于局域网内的HTTP调用方式)
        • 2.2.09税控发票打印(仅适用于组件开票,托管无法使用)
        • 2.2.10邮件短信重发(数电票和税控发票都支持)
        • 2.2.11税控机动车发票开具
        • 2.2.12税控机动车发票作废
        • 2.2.13税控机动车发票红冲
        • 2.2.14税控机动车发票打印
        • 2.2.15机动车信息查询(数电专用)
    • 发票查询接口
      • 4.1.01已开发票查询
      • 4.1.02机动车发票查询(税控)
      • 4.1.03.数电票发票批量查询
      • 4.1.04.数电票发票单张查询
    • 回调接口(支持除数电票直接开票接口外的开票回调)
      • 5.1.01开票申请单回退接口(星瀚发起退回开票申请单)
      • 5.1.02回调接口-按票回调(一次回调一张发票信息)
      • 5.1.03回调接口-按单回调(单据对应的所有发票开票完毕后一起回调(包含开票成功和开票失败),不支持合并又拆分的场景)
    • 开票风控接口
      • 6.0.01 风控解除接口(星瀚发票云版本6.0.6支持)
    • 扫码开票接口(税控+数电)
      • 业务系统生成二维码链接模式
        • 3.1.01业务系统组装二维码链接格式
        • 3.1.02查询订单接口(由客户提供)
        • 3.1.03 扫码提交购方抬头规则
        • 3.1.04账单中心开票小程序短链接生成
      • 推单星瀚生成二维码链接模式
        • 3.2.01上传销售单获取二维码链接
  • 收票
    • 全票池引入
      • 5.01全票池导入
    • 收票报销
      • 发票助手对接流程
      • 3.01 打开发票采集页面获取eventCode
      • 3.02 查看发票获取eventCode
      • 3.03 保存单据
      • 3.04 删除单据
      • 3.05 保存凭证
      • 3.06 删除凭证
      • 3.07 长轮询获取发票信息
      • 3.08 发票验重
    • 查询全票池的发票
      • 1.01 发票查询
      • 1.02 发票查询(按流水号查询)
      • 1.03获取单据文件信息
      • 1.04 删除全票池发票
    • 税局下载发票和勾选认证
      • 4.01 税局登录
      • 4.02 进项发票表头归集
      • 4.03 进项发票表头归集结果查询
      • 4.04 获取税款所属期信息
      • 4.05 发票勾选&撤销勾选
      • 4.06 发票勾选结果查询
      • 4.07 当前统计查询
      • 4.08 生成&撤销统计表
      • 4.09 生成&撤销统计表结果查询
      • 4.10 确认统计表
      • 4.11 确认统计表结果查询
      • 4.12 变更税款所属期
      • 4.13 发票预勾选
      • 4.14 发票预勾选确认
      • 4.15 预勾选确认结果查询
      • 4.16 批量创建税局入账申请任务
      • 4.17 查询税局入账申请任务结果
    • 识别查验
      • 2.01 发票查验
      • 2.02 发票识别查验
      • 2.03 文件上传
      • 2.04 发票编辑
    • 微服务接口
  • 页面类
    • 基础设置页面
      • 基础设置相关页面
    • 开票页面
      • 开票相关页面
    • 收票页面
      • PC端打开选择发票页面
      • PC端打开查看发票页面
      • 移动端打开查看发票页面
      • 移动端打开选择发票页面
    • 数据统计页面
      • 销项发票统计页面
    • 2.1、退出登录API接口
  • 影像
    • 开发指南
    • 1.基础接口
      • 1.01获取eventCode
      • 1.02接收ERP单据推送接口
    • 2.影像页面
      • 2.01PC端影像调阅
      • 2.02移动端影像调阅
      • 2.03影像采集页面
      • 2.04影像匹配结果页面
    • 3.影像操作
      • 3.01影像退扫
      • 3.02影像取消退扫
      • 3.03影像删除
      • 3.04获取PC端影像调阅页面地址
      • 3.05获取移动端影像调阅页面地址
      • 3.06影像状态查询
    • 4.采集接口
      • 4.01影像文件采集
      • 4.02影像单据提交
  • 档案
    • 对接说明(电子档案云旗舰版)
    • 异构系统接口定义
  • 设置类
    • 3.1、切换组织
    • 3.2、新增组织(星空ERP专用)
    • 3.3、新增租户组织下的员工
    • 3.4、查询电子税局账号
  • 订单
    • 1.01 产品订阅(平台服务商专用)
    • 发票云创建组织
  1. 单据开票接口(税控+数电)

开票申请单错误码列表

【待完善】
0:开票申请单推送成功
10131:收票手机和收票邮箱不能同时为空
10223:单据编号[%s]金额大于发票可红冲金额
10223:单据编号[%s]税额大于发票可冲红税额
10302:单据编号[%s]自动开票原发票代码为空
10303:单据编号[%s]自动开票原发票号码为空
10701:单据数据未传入
10701:单据编号[%s]明细不能为空
10702:单批次推送超过超过处理最大值,当前最大值:%s。如需调整请,前往发票云开票设置页面进行配置。
10702:单据编号%s 明细推送超过处理最大值,当前最大值:%s。如需调整请,前往发票云开票设置页面进行配置。
10703:单据编号未传入
10703:单据编号只能包含字母、数字和下划线
10703:单据编号超过最大长度[50]
10704:单据编号[%s]购方名称未传入
10704:单据编号[%s]购方名称[%s]包含非GBK编码字符
10704:单据编号[%s]购方名称[%s]超过发票可开具最大长度[100]字节
10704:单据编号[%s]购方税号[%s]不正确:字母或数字; 只能15、17、18、20位
10704:单据编号[%s]身份证号码[%s]不正确:只能填写15或18位,且最后一位只能为数字或字母X
10704:单据编号[%s]购方银行账号[%s]包含非GBK编码字符
10704:单据编号[%s]购方银行账号[%s]超过发票可开具最大长度[100]字节
10704:单据编号[%s]开具专用发票购方银行账号不能为空
10704:单据编号[%s]购方地址电话[%s]包含非GBK编码字符
10704:单据编号[%s]购方地址电话[%s]超过发票可开具最大长度[100]字节
10704:单据编号[%s]开具专用发票购方地址电话不能为空
10705:发票种类错误
10705:不支持的发票种类[%s]
10705:单据编号[%s]为负数单据且发票类型不是[纸质普通发票或电子普通发票]不允许直接开票
10706:单据编号[%s]销方纳税人识别号[%s]未在平台维护
10706:单据编号[%s]销方纳税人识别号未传入
10706:单据编号[%s]销方纳税人识别号不能为空
10706:单据编号[%s]销方名称[%s]包含非GBK编码字符
10706:单据编号[%s]销方名称[%s]超过发票可开具最大长度[100]字节
10706:单据编号[%s]销方名称不能为空
10706:单据编号[%s]购方地址电话[%s]包含非GBK编码字符
10706:单据编号[%s]购方地址电话[%s]超过发票可开具最大长度[100]字节
10706:单据编号[%s]购方银行账户[%s]包含非GBK编码字符
10706:单据编号[%s]购方银行账户[%s]超过发票可开具最大长度[100]字节
10706:单据编号[%s]销方银行账号[%s]包含非GBK编码字符
10706:单据编号[%s]销方银行账号[%s]超过发票可开具最大长度[100]字节
10706:单据编号[%s]销方名称银行账号不能为空
10706:单据编号[%s]销方地址电话[%s]包含非GBK编码字符
10706:单据编号[%s]销方地址电话[%s]超过发票可开具最大长度[100]字节
10706:单据编号[%s]销方地址电话不能为空
10707:单据编号[%s]明细数据未传入
10707:单据编号[%s]金额为0,明细不能为空
10707:单据编号[%s]企业类型为'个人', 不允许开专票
10707:第%d行赠品行数量不能为0
10707:单据编号[%s]明细合计金额与传入合计金额不一致
10707:单据编号[%s]多行明细扣除额时,必须每行都填写扣除额
10711:单据编号[%s]收票人手机号[%s]格式不正确
10711:单据编号[%s]收票人邮箱[%s]最多支持传入3个邮箱
10711:单据编号[%s]收票人邮箱[%s]格式不正确
10713:单据编号[%s]原始价税合计与价税合计相差不能超过10
10713:单据编号[%s]已存在
10713:单据编号[%s]重复推送
10713:单据编号[%s]的待冲蓝票代码[%s]格式不正确
10713:单据编号[%s]的待冲蓝票号码[%s]格式不正确
10713:单据编号[%s]待冲发票已红冲或已作废
10713:单据编号[%s]待冲发票种类 或 待冲蓝票开票日期请补充完整
10713:单据编号[%s]待冲发票种类只能是普票或卷票
10713:单据编号[%s]卷票的待冲发票种类只能是卷票
10713:单据编号[%s]的待冲蓝票代码和待冲蓝票号码需同时填或者不填
10713:单据编号[%s]为负数单据,差额不允许大于0
10713:单据编号[%s]为正数单据,差额不允许小于0
10713:单据编号[%s]差额大于发票金额
10713:单据编号[%s]差额征税扣除额不能为0
10713:单据编号[%s]对应单据日期[%s]格式不正确(yyyy-MM-dd)
10713:单据编号[%s]对应合同日期[%s]格式不正确(yyyy-MM-dd)
10713:单据编号[%s]开票人[%s]不合法-包含非GBK编码或是超最大长度[%s]字节
10713:单据编号[%s]开票人必填
10713:单据编号[%s]收款人[%s]不合法-包含非GBK编码或是超最大长度[%s]字节
10713:单据编号[%s]复核人[%s]不合法-包含非GBK编码或是超最大长度[%s]字节
10713:单据编号[%s]发票备注包含非GBK编码字符
10713:单据编号[%s]发票备注超过发票可开具最大长度[230]字节
10713:单据编号[%s]合同编号超过最大长度[50]字节
10713:单据编号[%s]采购商名称超过最大长度[50]字节
10713:单据编号[%s]采购商联系人超过最大长度[%s]字节
10713:单据编号[%s]采购商联系电话超过最大长度[%s]字节
10713:单据编号[%s]开票说明超过最大长度[%s]字节
10713:单据编号[%s]对应汇率日期[%s]格式不正确(yyyy-MM-dd)
10713:单据编号[%s]对应待冲蓝票日期[%s]格式不正确(yyyy-MM-dd)
10714:单据编号[%s]红字发票备注长度超限,最大长度为%s
10717:单据编号[%s]的自动合并标志为合并时,自动开票标记需标记为自动开票状态
30001:存在风控的数据
9999:传入明细为空或明细格式不是billDetail
-10001:推送异常,请稍后重试 当前组织还未引入发票云,请先到“发票云-基础资料-企业管理”引入组织,或切换业务单元
-10001:组织编号[%s]与传入的销方税号不匹配
-10001:组织编号[%s]与传入的销方名称不匹配
-10001:税号未查询到组织信息或当前设备未绑定组织!
-10001:推送异常,请稍后重试 匹配开票抬头失败:%s
-10001:设备编号长度不正确:开票设备编号,12,14或20位;虚拟设备以及实体Ukey 20位,金税盘硬件设备编号12,14位
-10001:当前设备未找到关联设备,请维护!
-10001:您的税号或组织编号无法找到设备请校验是否已维护设备!
-10001:负数单据不能有整单折扣行
-10001:整单折扣金额填写有误,明细已有折扣行,无法整单折扣
-10001:单据编号 %s 整单折扣金额不能大于等于%s
-10001:创建人(制单人) %s 不存在,请前往'基础服务'-'人员管理'中新增
-10001:%s 单据存在明细超过税控尾差,请调整数据后开票。
上一页
单据开票对接指引
下一页
1.1.01 开票申请单生成及开票(支持拆分合并后,再开票)
Built with