发票云(旗舰版)API文档
旗舰版标准版智能特性
旗舰版标准版智能特性
🤖 AI Support​​
  1. 数电开票
  • 整体介绍
  • 快速开始
  • 加解密
  • 文件预览&文件上传&文件下载
  • 发票数据结构
  • 错误码
  • 常见接口错误
  • 场景指引
    • 概述
    • 直接开票
    • 单据开票
    • 扫码开票
  • 授权
    • 1.01.获取app_token
    • 1.02获取access_token
  • 开票
    • 单据开票接口（税控+数电）
      • 单据开票对接指引
      • 开票申请单错误码列表
      • 1.1.01 开票申请单生成及开票（支持拆分合并后，再开票）
      • 1.1.02 开票申请单撤回（对接方主动撤回）
      • 1.1.03 开票申请单发票查询
      • 1.1.04 开票申请单快速红冲（仅支持税控普票）
      • 1.1.05 开票申请单批量作废（作废单据的发票，仅支持税控纸票）
      • 1.1.06 开票申请单红冲单或作废单生成（星瀚发票云版本5.0.015支持，不支持数电票）
      • 1.1.07 开票申请单重开单生成（星瀚发票云版本5.0.015支持，不支持数电票）
      • 1.1.08 创建负数单匹配任务
      • 1.1.09 查询负数单匹配任务结果
      • 1.1.10 单据开票预览
    • 直接开票接口
      • 数电开票
        • 接入指引（必看）
        • 返回编码说明
        • FAQ
        • 电子税局操作
          • 2.1.30 电子税局登录检测
        • 2.1.01 数电票蓝字发票开具
          POST
        • 2.1.02 数电票回调
          POST
        • 2.1.03 红字确认单生成
          POST
        • 2.1.04 数电票红冲（直接红冲或通过红字确认单）
          POST
        • 2.1.05 授信额度查询
          POST
        • 2.1.08 红字确认单撤销
          POST
        • 2.1.09 红字确认单确认或拒绝
          POST
        • 2.1.12 红字确认单下载
          POST
        • 2.1.13 红字确认单编号查询
          POST
        • 2.1.14 发票用途状态查询（发票云版本6.0.11支持，暂只支持乐企）
          POST
      • 税控开票
        • 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：成功
-10001：数据传入为空
-10001：单据编号：%s,机动车增值税发票的发票类型必须专票
-10001：单据编号：%s,机动车增值税发票数量必须为正整数
-10001：单据编号：%s,机动车增值税发票单价必须为正数
-10001：单据编号：%s,单位栏必须为:辆
-10001：您的税号或组织编号无法找到设备请校验是否已维护设备！
-10001：当前设备已经被禁用！
-10001：创建折扣行失败
-10001：全电发票账号自动登录失败，无法自动开票：
10101：单据编号不能为空，且不能超过50
10127：单据编号重复
10164：税号未查询到组织信息或当前设备未绑定组织！
10120：销方名称不正确：GBK长度至多100
10121：购方名称不正确：GBK长度至多100
10122：销方开户行及账号不正确：GBK长度至多100
10123：购方开户行及账号不正确：GBK长度至多100
10124：销方地址电话不正确：GBK长度至多100
10125：购方地址电话不正确：GBK长度至多100
10131：收票手机和收票邮箱不能同时为空
10126：邮箱格式不正确：GBK长度至多100，最多3个邮箱用；分隔
10130：收票号码格式有误
10102：销方税号不正确:字母或数字； 只能15、17、18、20位
10104：发票性质不正确：0 正数发票（蓝票）、1 负数发票（红票）
10105：发票种类不正确：004纸质专用发票、007纸质普通发票、028电子专用发票、026电子普通发票
10106：企业性质为个人时，不允许开具专票
10107：红字信息表编号:需要直接开具专用红字发票时，必填
10109：购方名称不能为空
10110：购方税号不正确:字母或数字； 只能15、17、18、20位
10111：含税标识错误：0,不含税 1,含税
10112：发票明细行只能传一行
10113：开票人不正确
10114：收款人不正确
10115：复核人不正确
10108：对应蓝票代码,对应蓝票代码:需要直接开红票时必填
10108：红字信息表未提交
10108：红字信息表审核失败
10108：蓝票已作废，不能进行红冲
10108：蓝票已红冲，不能进行红冲
10507：对应蓝票类型和原蓝票开票时间:普票直接开红票时必填
10508：对发票类型为卷票:普票直接开红票时对应蓝票类型也必须为卷票
10116：当前销方纳税人识别号未在本系统中找到，请先维护企业信息
10116：销售方名称与税号不一致
10150：明细行编号不正确：长度至多32位
10151：开红票时发票商品明细金额不能大于0，且不能有折扣行
10151：蓝票明细行金额不能小于0
10151：蓝票折扣行金额不能大于0
10152：商品编号、商品名称：如果在本系统已维护，商品编号、商品名称二选一必填；未维护，则名称必填
10153：商品名称长度不能大于92，GBK格式
10154：规格型号:长度最多为40
10155：单位：长度最多22
10157：税率不合法
10156：当商品金额为空或为0时，单价和数量皆不能为空为0
10158：税额不合法
10159：折扣率不正确:支持格式：0.，%
10160：税收分类编码与商品编码不能同时为空
10161：税收分类编码为汇总项或不存在
10153：商品名称长度不能大于92，GBK格式
10162：优惠政策标识为【享受优惠】,优惠政策内容不能为空
10163：优惠政策标识为【不享受优惠】,优惠政策内容必须为空
9999：第%s行明细是被折扣行，下一行必须为折扣行
9999：第%s行明细是折扣行，上一行必须为被折扣行
9999：折扣行数量,单价都应为空
10503：蓝票合计金额不能小于0
10504：蓝票合计税额不能小于0
10505：红票合计金额不能大于0
10506：红票合计税额不能大于0
30001：存在风控的数据(当前接口的响应消息字段(errorMsg)会返回具体的风控内容)，发票云版本6.0.6支持，如需解除风控，请调用6.0.01 风控解除接口。
上一页
接入指引（必看）
下一页
FAQ
Built with