企享云API
首页
公共能力
  • 鉴权
  • 订购
  • 通知
登录产品
  • 登录增强版
  • 办税人员管理
  • 办税小号
发票产品
  • 票据查验
  • 票据识别
  • 发票归集
  • 发票认证
  • 发票入账
  • 数电开票
  • 数电版式文件下载
申报产品
  • 智能申报
  • 个税申报
数据产品
  • 企业风险识别
  • 企业数据采集
  • 企业360度洞察
首页
公共能力
  • 鉴权
  • 订购
  • 通知
登录产品
  • 登录增强版
  • 办税人员管理
  • 办税小号
发票产品
  • 票据查验
  • 票据识别
  • 发票归集
  • 发票认证
  • 发票入账
  • 数电开票
  • 数电版式文件下载
申报产品
  • 智能申报
  • 个税申报
数据产品
  • 企业风险识别
  • 企业数据采集
  • 企业360度洞察
  1. 常见问题
  • 基本介绍
  • 快速开始
    • 开发必读
    • 对接地址
    • SDK集成
    • 认证鉴权
    • 接口调用
    • 加密说明
    • 调用模式
  • 平台基础服务
    • 接口调用鉴权
      • 获取access_token
    • 产品订购
      • 简介
      • 订购产品
      • 订购修改
      • 订购取消
      • 订购查询
      • 企业取消授权
      • 自然人获取企业列表
    • 平台查询
      • 发起企业基本信息
      • 回调通知-获取采集状态
      • 获取企业基本信息
    • 平台通知预警
      • 服务异常通知
      • 税局维护、停机消息推送接口说明
    • 附录
      • 地区代码
      • 产品码
  • 登录业务
    • 简介
    • 业务指引
    • 托管模式登录
      • 单账号登录
        • 账号管理
          • 通用账号创建/修改
          • 代理登录获取企业列表
        • 税务APP登录
          • 税务APP登录发送短信验证码
          • 税务APP登录上传短信验证码
          • 校验税务APP是否能快速登录
      • 多账号管理
        • 账号管理
          • 托管账号创建
          • 托管账号修改
          • 托管账号删除
          • 托管账号查询
          • 账号产品绑定
          • 账号产品解绑
          • 账号批量绑定产品
    • 自持模式登录
      • 单账号登录
        • 账密登录
          • 登录税局发送短信验证码
          • 登录税局上传短信验证码
          • 校验税局缓存是否有效
        • 扫码登录
          • 自然人登录
            • 无验证码登录税局
            • 登录税局发送短信验证码
            • 登录税局上传短信验证码
          • 获取登录税局二维码
          • 扫二维码登录税局
          • 校验税局缓存是否有效
        • 税务APP登录
          • 登录税局发送短信验证码
          • 登录税局上传短信验证码
          • 校验税局缓存是否有效
          • 校验税务APP是否可快速登录
        • 会话登录
          • 上传Cookie接口
        • 代账App登录
          • APP登录发送短信验证码
          • APP登录上传短信验证码
          • 校验税务APP是否可快速登录
          • 检查电票cookie是否有效
          • 获取缓存 cookie
        • 获取自持业务缓存 登录cookie
      • 多账号管理
        • 简介
        • 账密登录
          • 登录税局发送短信验证码
          • 登录税局上传短信验证码
          • 校验税局缓存是否有效
        • 扫码登录
          • 获取登录税局二维码
          • 扫二维码登录税局
          • 校验税局缓存是否有效
        • 会话登录
          • 上传Cookie接口
        • 税务APP登录
          • 登录税局发送短信验证码
          • 登录税局上传短信验证码
          • 校验税局缓存是否有效
          • 校验税务APP是否可快速登录
      • 登出
      • 账密检查接口
    • 自持登录增强版
      • 产品介绍
      • 企业登录
        • 企业登录接口
      • 代理登录
        • 代理登录发送验证码
        • 代理登录上传短信验证码
        • 校验税务APP是否可快速登录
      • 自然人登录
        • 自然人app登录
        • 自然人app登录上传短信验证码
        • 校验自然人APP是否可快速登录
      • 上传二维码登录
        • 上传税局二维码登录
    • 办税人员管理
      • 简介
      • 自然人管理
        • 自然人创建
        • 自然人修改
        • 自然人删除
        • 企业与自然人绑定
        • 企业与自然人解绑
      • 企业侧
        • 企业添加办税人员任务
        • 获取二维码
        • 二维码状态确认
        • 企业删除办税人员
        • 现有办税人员删除记录任务
        • 企业删除办税人员结果查询
        • 现有办税人员删除记录任务查询
        • 企业现有办税人员获取
        • 企业添加办税人员结果查询
        • 企业现有办税人员结果查询
      • 自然人侧
        • 自然人确认企业授权任务
        • 自然人确认企业授权任务结果查询
        • 自然人已授权企业查询
        • 自然人已授权企业结果查询
        • 自然人删除企业授权任务
        • 自然人删除企业授权任务结果查询
        • 自然人已删除企业查询
        • 自然人已删除企业结果查询
        • 获取二维码
        • 二维码状态确认
    • 办税小号
      • 小号申请指引
      • 申请小号
        • 申请小号订单
        • 查询小号订单详情
        • 配置小号订单开通通知地址
        • 小号订单开通通知回调
      • 小号管理
        • 绑定实名手机号与办税小号
        • 更换绑定的实名手机号
        • 解除实名手机号与办税小号绑定
        • 办税小号通话清单查询
      • 短信管理
        • 查询短信验证码
        • 配置小号短信通知地址
        • 小号短信通知回调
    • 登录公共
      • 账密检查接口
      • 停用账号启用
    • 附录
      • APP登录支持区域
      • 身份类型
  • 发票业务
    • 简介
    • 票据查验
      • 简介
      • 发票查验
        • 增值税(总局门户)
          • 税控发票查验
          • 数电票查验
          • 数电纸质发票查验
        • 增值税(电票平台)
          • 数电票查验
        • 非增值税
          • 简介
          • 财政票据查验
          • 财政票据查验(明细版)
          • 区块链发票查验(深圳)
          • 区块链发票查验(北京)
          • 区块链发票查验(云南)
          • 通用电子发票查验(浙江、宁波)
          • 通用电子发票查验(广东)
          • 车辆通行费发票查验(江苏)
      • 查验扩展
        • 上传文件查验
          • 上传文件查验
        • 获取版式文件(总局门户)
          • 按流量获取
            • 数电票查验及版式文件下载
          • 按税号获取
            • 数电票查验及版式文件下载
          • 发票查验版式文件下载结果查询
          • 查验版式文件下载任务执行结果回调接口说明
        • 获取版式文件(电票平台)
          • 简介
          • 按流量获取
            • 入账状态及用途标签查询
            • 获取数电票版式文件-同步
            • 获取数电票版式文件-异步
          • 按税号获取
            • 入账状态及用途标签查询
            • 获取数电票版式文件-同步
            • 获取数电票版式文件-异步
          • 数电票查验并获取版式文件
          • 发票查验版式文件下载结果查询
          • 查验版式文件下载任务执行结果回调接口说明
    • 发票识别
      • 简介
      • 普通票据识别
        • 普通票据识别
    • 发票认证
      • 简介
      • 业务流程
      • 综服平台认证
        • 获取税款所属期
        • 进项发票取数
        • 海关缴款书取数
        • 进项发票勾选
        • 进项发票勾选结果查询
        • 海关缴款书勾选
        • 海关缴款书勾选结果
        • 申请发票统计
        • 申请撤销发票统计/确认签名
        • 申请确认签名
        • 获取发票统计、确认签名和撤销申请结果
        • 获取最新统计确认结果
        • 季报企业切换税款所属期
        • 季报企业切换税款所属期的结果查询
        • 获取企业信息
        • 申请海关缴款书采集
        • 海关缴款书采集结果查询
        • 申请注销勾选
        • 获取注销勾选结果接口
      • 电票平台认证
        • 同步认证
          • 税款所属期采集
          • 进项发票采集
          • 海关缴款书采集
          • 代扣代缴完税凭证采集
          • 进项发票勾选
          • 海关缴款书勾选
          • 代扣代缴完税凭证勾选
          • 抵扣统计
          • 抵扣确认
          • 撤销抵扣统计确认
          • 最新统计确认信息采集
          • 退税用途确认
          • 注销勾选
          • 历史已抵扣信息采集
          • 红字发票采集
          • 退税用途确认采集
          • 转异步请求结果查询
        • 异步认证
          • 农产品相关
            • 简介
            • 申请待处理农产品发票采集
            • 待处理农产品发票采集结果查询
            • 申请农产品发票处理
            • 农产品发票处理结果查询
            • 申请加计扣除农产品采集
            • 加计扣除农产品采集结果查询
            • 申请农产品加计扣除
            • 农产品加计扣除结果查询
          • 账号托管模式认证
            • 获取税款所属期
            • 申请获取税款所属期
            • 获取税款所属期结果查询
            • 进项发票取数
            • 申请进项发票采集
            • 进项发票采集结果查询
            • 海关缴款书取数
            • 申请海关缴款书采集
            • 海关缴款书采集结果查询
            • 申请代扣代缴完税凭证采集
            • 代扣代缴完税凭证采集结果查询
            • 进项发票勾选
            • 进项发票勾选结果查询
            • 海关缴款书勾选
            • 海关缴款书勾选结果
            • 申请代扣代缴完税凭证勾选
            • 代扣代缴完税凭证勾选结果查询
            • 申请发票统计
            • 申请撤销发票统计/确认签名
            • 申请确认签名
            • 获取发票统计、确认签名和撤销申请结果
            • 获取最新统计确认结果
            • 申请最新统计确认信息采集
            • 最新统计确认信息采集结果查询
            • 申请注销勾选、撤销注销勾选
            • 注销勾选、撤销注销勾选申请结果查询
            • 申请历史已抵扣信息采集
            • 历史已抵扣信息采集结果查询
            • 申请红字发票采集
            • 红字发票采集结果查询
            • 申请退税已用途确认发票采集
            • 退税已用途确认采集结果查询
            • 申请海关缴款书录入
            • 海关缴款书录入结果查询
            • 申请录入海关缴款书采集
            • 录入海关缴款书采集结果查询
          • 账号自持模式认证
            • 申请获取税款所属期
            • 获取税款所属期结果查询
            • 申请进项发票采集
            • 进项发票采集结果查询
            • 申请海关缴款书采集
            • 海关缴款书采集结果查询
            • 申请代扣代缴完税证明发票采集
            • 代扣代缴完税证明采集结果查询
            • 进项发票勾选
            • 进项发票勾选结果查询
            • 海关缴款书勾选
            • 海关缴款书勾选结果
            • 申请代扣代缴完税凭证勾选
            • 代扣代缴完税凭证勾选结果查询
            • 申请发票统计
            • 申请撤销发票统计/确认签名
            • 申请确认签名
            • 获取发票统计、确认签名和撤销申请结果
            • 申请最新统计确认信息采集
            • 最新统计确认信息采集结果查询
            • 申请历史已抵扣信息采集
            • 历史已抵扣信息采集结果查询
            • 申请红字发票采集
            • 红字发票采集结果查询
            • 申请退税已用途确认发票采集
            • 退税已用途确认采集结果查询
      • 发票认证异步任务执行结果回调接口说明
    • 发票归集
      • 简介
      • 电票平台归集-异步
        • 发起归集任务
        • 查询归集任务状态
        • 获取发票数据
        • 发起发票作废和红冲状态归集任务
        • 发起已勾选归集任务
        • 查询已勾选归集状态
        • 查询已勾选归集数据
        • 申请全量发票汇总信息
        • 获取全量发票汇总信息
        • 撤销归集待执行任务
      • 电票平台归集-同步
        • 同步发起归集任务
        • 同步发起发票基础信息归集任务
      • 发票归集异步任务执行结果回调接口说明
    • 发票入账
      • 入账应用简介
      • 发票入账/调整入账
      • 发票入账信息查询
      • 异步请求结果查询
      • 业务请求回调通知
      • 发票入账信息更新
    • 数电开票
      • 简介
      • 接入指引
      • 基础资料接口
        • 商品管理
          • 商品管理-商品分类查询
          • 商品管理-商品分类新增
          • 商品管理-商品分类删除
          • 商品管理-商品分类更名
          • 商品管理-列表查询
          • 商品管理-商品新增
          • 商品管理-商品编辑
          • 商品管理-商品删除
          • 根据商品名搜索匹配的税收编码
          • 根据税收编码查询详情(含税率)
        • 客户管理
          • 客户分类查询
          • 客户分类新增
          • 客户分类删除
          • 客户信息查询
          • 客户信息新增
          • 客户信息修改
          • 客户信息删除
        • 附加信息维护
          • 附加信息维护-附加要素信息列表查询
          • 附加信息维护-附加要素信息添加
          • 附加信息维护-附加要素信息编辑
          • 附加信息维护-附加要素信息删除
          • 附加信息维护-场景模版列表查询
          • 附加信息维护-场景模版添加
          • 附加信息维护-场景模版编辑
          • 附加信息维护-场景模版删除
        • 获取人脸识别认证二维码(税务app)
        • 获取人脸识别认证结果(税务app)
        • 获取人脸识别认证二维码 (个税app)
        • 获取人脸识别认证结果( 个税app)
        • 办税(开票)人授信类别查询
        • 获取企业基本信息
        • 获取开票统计信息
        • 设置二维码有效时长
      • 发票开具与管理接口
        • 数电发票开具接口
        • 红字确认单列表查询
        • 红字确认单明细信息
        • 红字确认单申请与发票红冲
        • 红字确认单确认操作
        • 红字确认单撤销操作
        • 发票邮件交付接口
        • 红字发票概况统计查询
        • 红字发票开具
      • 发票查询接口
        • 成品油
          • 查询成品油库存汇总台账
          • 查询成品油换算标准(税收商品查询)
          • 查询成品油换算标准(海关商品查询)
          • 查询成品油授权编码
          • 查询成品油对应品目列表
        • 不动产
          • 不动产房源信息查询
        • 机动车
          • 查询车架号信息
        • 建筑服务
          • 跨区域涉税事项报验管理编号信息查询
        • 已开发票列表查询
        • 已开发票明细查询
        • 已开发票统计查询
        • 查询蓝字发票可红冲信息
        • 数电已开发票版式文件下载(单个)
        • 数电已开发票版式文件下载(多个)
        • 全量发票汇总信息查询
      • 业务回调接口
        • 异步请求结果查询
        • 业务请求回调通知
        • 扫脸认证回调通知
    • 数电票版式文件下载
      • 简介
      • 申请数电票版式文件下载
      • 获取数电票版式文件数据
      • 版式文件下载任务执行结果回调接口说明
      • 同步下载数电票版式文件
    • 发票附录
      • 发票附录
      • 数电票号码规则
  • 申报业务
    • 企业税申报
      • 简介
      • 上传申报报文规则说明
      • 上传excel文件常见填写规则
      • 申报 缴款部分请求业务参数说明
      • 企业信息
        • 简介
        • 发起采集企业税务信息
        • 查询企业税务信息状态
        • 查询企业信息
        • 批量设置会计准则制度
      • 应申报清册条目
        • 简介
        • 获取清册条目
          • 查询申报条目任务
          • 发起获取申报条目任务
      • 上传税报报表数据
        • 简介
        • 上传各税种申报表数据
        • 上传各税种申报表EXCEL数据
        • 查询上传并申报各税种申报表数据任务结果
      • 上传财报报表数据
        • 简介
        • 上传财报数据
        • 查询上传并申报财报数据任务结果
      • 简易申报
        • 发起简易申报任务
        • 查询简易申报任务结果
      • 申报初始化
        • 简介
        • 获取合同
          • 发起查询合同接口任务
          • 查询合同任务结果
        • 代扣代缴初始化
          • 发起代扣代缴初始化数据任务
        • 发起获取初始化数据任务
        • 初始化数据查询
      • 申报提交
        • 简介
        • 发起申报任务
        • 查询申报任务结果
        • 查询申报任务进度结果接口
      • 更正申报
        • 简介
        • 发起更正申报任务接口
        • 查询更正申报任务结果
      • 同步申报结果(旧版税局功能,新版已不需要,即将下线)
        • 发起同步申报状态任务接口
      • 申报作废
        • 简介
        • 发起作废申报任务
        • 查询作废申报任务结果
      • 税款缴纳
        • 简介
        • 发起税款缴纳任务
        • 查询税款缴纳任务结果
        • 查询缴款任务进度结果接口
      • 申报查询
        • 简介
        • 发起申报信息查询任务
        • 查询申报信息任务
      • 漏报检查
        • 简介
        • 发起漏报检查任务
        • 查询漏报检查任务
      • 税源采集/获取
        • 税源采集 (待优化)
          • 简介
          • 税源信息采集接口
          • 查询税源信息采集任务结果
        • 税源获取
          • 简介
          • 税源信息获取接口
          • 查询税源获取任务结果接口
      • 业务弹框
        • 简介
        • 保存申报辅助设置弹窗选项信息
        • 查询申报辅助设置弹窗信息
        • 查询全量申报辅助设置弹窗信息
      • 获取完税证明(表格式)
        • 简介
        • 发起下载完税证明任务
        • 查询下载完税证明任务结果
        • 发起下载完税证明并解析任务
        • 查询下载完税证明并解析任务的结果
      • 获取PDF
        • 简介
        • 发起下载当期PDF任务
        • 发起下载往期PDF任务
        • 查询往期PDF数据
        • 查询下载PDF任务结果
        • 查询PDF任务返回结构化数据
      • 申报辅助
        • 查询多个任务执行结果
        • 获取助手客户端下载地址
        • 查询税收优惠政策代码及名称
        • 任务终止接口
      • 申报附录
        • 申报附录
        • 重点税源附录
        • 减免性质代码码表
        • 各税种报文结构
          • ybData(一般纳税人增值税及附加税)
          • xgmData(小规模纳税人增值税及附加税)
          • sdsaData(企业所得税类预缴)
          • whsyjsfData(文化事业建设费报文)
          • yhsData(印花税新版报文)
          • ghjfData(通用申报-工会经费和水利建设基金联动申报报文)
          • fssrTysbData(非税收入通用申报表)
          • xfsData(消费税报文)
          • fcsData(房产税报文)
          • hbsData(环境保护税报文)
          • cztdsData(城镇土地使用税报文)
          • zysData(资源税税报文)
          • szyData(水资源报文)
          • cbjData(残疾人就业保障金)
          • hsqjData(汇算清缴)
          • 企业会计准则(未执行)财报
          • 企业会计准则(已执行)财报
          • 小企业会计准则财报
          • 企业会计制度财报
          • 企业会计准则新金融(已执行)财报
          • fcsSycjData(房产税税源采集报文)
          • cztdsSycjData(城镇土地使用税税源采集报文)
          • glywData(企业年度关联业务往来报告表)
          • jthbData(企业集团合并财务报表)
          • ccxwshbData(财产行为税合并纳税申报(房土))
          • cbnbData(财务报表年报文件上传报文)
          • zdsyData重点税源报文
          • ccsData(车船税报文)
          • 简易申报报文
          • 增值税预缴申报报文
          • 土地增值税申报报文
          • sdsDkdjData企业所得税(代扣代缴)报文
          • zzsDkdjData增值税代扣代缴、代收代缴税款报告表报文
      • 公共接口
        • 任务回调接口样例(忽略https://api.qixiangyun.com/这个地址前缀)
      • 查询我的待办和提醒
        • 发起获取我的待办
        • 发起获取我的提醒
        • 获取我的待办结果
        • 获取我的提醒结果
    • 个税申报
      • 个税简介
      • 业务指引
      • 代扣代缴
        • 企业登记及查询服务
          • 企业注册
            • 企业注册
          • 账户密码上传校验
            • 账号信息上传并校验(申报密码校验)
        • 人员信息登记报送服务
          • 人员报送
            • 人员信息报送
            • 人员信息报送反馈
          • 企业人员列表查询
            • 企业人员列表查询
          • 年收入不足6万元扣除名单
            • 扣除名单查询
            • 扣除名单确认
            • 扣除名单确认反馈
          • 人员验证状态更新
            • 人员验证状态更新
        • 个人养老金扣除管理
          • 个人养老金下载接口
          • 获取个人养老金下载反馈
        • 专项附加扣除管理
          • 人员专项扣除信息登记报送服务
          • 人员专项附加扣除信息接收反馈
          • 专项附加扣除查询
          • 专项附加扣除查询反馈
        • 个税算税服务
          • 异步算税
          • 异步算税反馈
        • 个税辅助申报服务
          • 申报数据报送
          • 申报数据报送反馈
          • 申报作废
          • 申报作废反馈
          • 申报内置算税结果查询
          • 申报状态查询
          • 申报更正
          • 撤销更正申报
        • 个税辅助缴款服务
          • 获取三方信息
          • 获取三方查询反馈
          • 三方协议缴款
          • 三方协议缴款反馈
          • 银联缴款
          • 缴款状态查询
          • 打印缴款凭证
          • 缴款凭证反馈
          • 缴款凭证作废
          • 欠费查询
          • 欠费查询反馈
          • 完税证明开具
      • 生产经营
        • 企业登记及查询服务
          • 企业注册
            • 企业注册
          • 账户密码上传校验
            • 账号信息上传并校验(申报密码校验)
        • 投资者信息报送服务
          • 投资者报送
            • 投资者信息报送
            • 投资者信息报送反馈
          • 投资者列表查询
            • 投资者列表查询
          • 投资者验证状态更新
            • 人员验证状态更新
          • 获取企业及投资者信息(生产经营)
        • 个税精准算税服务
          • 获取收入费用测算情况及预缴信息
          • 异步算税服务
          • 查询算税反馈结果
        • 个税辅助申报服务
          • 申报数据报送
          • 申报数据报送反馈结果
          • 查询内置算税反馈结果
          • 企业申报数据明细查询
          • 辅助申报-申报状态查询
          • 申报作废
          • 申报作废反馈
          • 更正申报
          • 撤销更正申报
        • 个税辅助缴款服务
          • 获取三方信息
            • 获取三方信息
            • 获取三方信息反馈
          • 三方协议缴款
          • 三方协议缴款反馈
          • 银联缴款
          • 扫码缴款
          • 缴款状态查询
          • 打印缴款凭证(生产经营)
          • 打印缴款凭证的缴款结果查询
          • 缴款凭证反馈(生产经营)
          • 缴款凭证作废(生产经营)
          • 完税证明开具(生产经营)
      • 回调接口
        • 个税回调接口
      • 个税附录
        • 个税附录
  • 数据业务
    • 企业数据采集
      • 简介
      • 解析版
        • 解析表结构详情附录
        • 发起企业数据采集
        • 获取采集状态信息
        • 获取采集状态-回调通知
        • 获取采集状态及全量数据
        • 获取税务数据
        • 获取发票数据
      • 文件版
        • 发起企业数据采集
        • 获取采集状态信息
        • 获取采集状态-回调通知
        • 获取采集状态及全量数据
      • 附录
        • 企业数据采集公共附录
    • 企业风险识别
      • 简介
      • 企业黑名单-风控明细
        • 企业风控明细接口
        • 经营异常风险接口
        • 严重违法风险接口
        • 重大税收违法风险接口
        • 非正常户接口
      • 企业黑名单-融合版A
        • 查询企业是否黑名单
      • 企业黑名单-融合版B
        • 查询企业是否黑名单(增强版)
    • 企业商事查询
      • 云抬头
        • 简介
        • 云抬头查询
        • 企业开票信息查询
      • 企业信息查询
        • 企业精准查询接口
      • 新增企业查询
        • 新增企业信息
      • 企业联系人信息查询
        • 企业联系人信息
        • 企业关键人联系信息
      • 企业360度数据洞察
        • 工商基本信息
        • 企业联系信息
        • 对外投资
        • 税务重大违法
        • 资质证书信息
        • 失信信息
        • 限制高消费信息
        • 限制高消费关联企业
        • 裁判文书
        • 欠税公告
        • 税务非正常户
        • 行政处罚信息
        • 行政许可信息
        • 列入经营异常名录信息
        • 列入严重违法失信企业名单
        • 商标信息
        • 专利信息
        • 专利关系信息
        • 专利法律状态信息
        • A类纳税人信息查询
        • 经营异常列入移出公告
      • 附录
        • 地区码
  • 版本发布
    • 登录产品升级说明
    • 发票产品升级说明
      • 2025年4月发布内容
      • 2025年3月发布内容
      • 2025年2月发布内容
      • 2025年1月发布内容
      • 2024年12月发布内容
      • 2024年11月发布内容
      • 2024年10月发布内容
      • 2024年9月发布内容
      • 2024年8月发布内容
      • 2024年7月发布内容
      • 2024年6月发布内容
      • 2024年5月发布内容
    • 企业风险识别升级说明
    • 企业数据采集升级说明
      • 2025年4月发布内容
      • 2025年3月发布的内容
      • 2025年2月发布内容
    • 企业商事查询升级说明
      • 2025年4月发布内容
      • 2025年3月发布内容
      • 2025年2月发布内容
    • 企业税申报升级说明
      • 2025年4月发布内容
      • 2025年3月发布内容
      • 2025年2月发布内容
      • 2025年1月发布内容
      • 2024年12月发布内容
      • 2024年11月发布内容
      • 2024年10月发布内容
      • 2024年9月发布内容
      • 2024年8月发布内容
      • 2024年7月发布内容
      • 2024年6月发布内容
      • 2024年5月发布内容
    • 个税升级说明
      • 2025年2月发布内容
      • 2025年3月发布内容
      • 2025年4月发布内容
  • 常见问题
    • 公共业务
    • 发票业务
    • 申报业务
    • 风控业务
    • 发票票样
  1. 常见问题

发票业务

查验#

1、增值税发票查验
纳税人依据取得的纸质发票或电子发票,需在页面中根据要求输入相关的查验项目信息。
根据纳税人查验的票种,其输入的校验项目也不相同,其中:
(1)增值税专用发票、增值税电子专用发票:发票代码、发票号码、开票日期和开具金额(不含税);
(2)增值税普通发票、增值税电子普通发票(含通行费发票)、增值税普通发票(卷票):发票代码、发票号码、开票日期和校验码后6位;
(3)机动车销售统一发票:发票代码、发票号码、开票日期和不含税价;
(4)二手车销售统一发票发票:发票代码、发票号码、开票日期和车价合计;
(5)电子发票(增值税专用发票)、电子发票(普通发票):发票号码、开票日期、价税合计;
(6)电子发票服务平台开具的纸质增值税专用发票:发票代码、发票号码、开票日期和开具金额(不含税);
(7)电子发票服务平台开具的纸质增值税普票发票:发票代码、发票号码、开票日期和校验码(密码区数电票号码后6位);
(8)电子发票(铁路电子客票):发票号码、开票日期和票价;
(9)电子发票(航空运输电子客票行程单):发票号码、开票日期、开票金额(价税合计)。
2、查验计费说明
(1)同一张发票(发票号码+发票代码)查询返回三种计费状态任意一种计次1次。三种计费状态:①查验成功返回票面信息;②查验成功所查发票不存在;③查验成功发票不⼀致,其余状态不计费。
(2)查验成功返回票面信息的,当日再次查验该票不计费,返回内容不发生变化。即t+1
(3)查验成功返回票面信息的,当日再次查验成功后依然计费,实时返回税局最新数据。即t+0
3、查验的并发是多少
(1)QPS 支持到200,TPS 根据查验接口的情况也是 200 左右
4、全额红冲、已红冲、部分红冲的区别是什么
(1)部分红冲和全额红冲是针对全电发票和ukey开具的会有这两种状态
5、发票查验可以返回源文件(版式文件)吗
(1)增值税目前我们查验接口支持ukey开具的电子专普票的版式文件下载,ofd和pdf都有。其他获取不到,因为只有ukey的版式生成是在局端。
6、全电发票查验成功返回,jym和fphm一样是什么原因
(1)全电纸质的发票查验,需要密码区中的全电发票号码后六位作为查验参数
(2)全电电子发票查验,是因为和纸质的发票做了统一处理
7、现在有些发票属于地税的发票,在国税上不能查验,如何区分地方票
(1)这个没法准确的区分出来的,查验我们会返回发票代码格式有误
(2)普通增值税发票和地方发票的区别主要体现在以下几个方面:
     开具机关不同:普通增值税发票由国家税务机关开具,而地方发票由地方税务机关开具。
     使用范围不同:普通增值税发票适用于全国范围内的交易和报销,而地方发票仅适用于地方税务机关所在地区的交易和报销。
     发票种类不同:普通增值税发票包括增值税专用发票和增值税普通发票,而地方发票包括增值税发票、普通发票、机动车销售发票等。
     税率和税额计算方式可能不同:普通增值税发票的税率和税额计算方式由国家税务机关统一规定,而地方发票的税率和税额计算方式可能会因地区而异。

     需要注意的是,具体的区别可能会因地区和具体税务政策的不同而有所差异。在实际操作中,纳税人需要根据自身的情况和所在地区的税务规定来选择合适的发票类型进行交易和报销。
8、总局发票查验次数有一天五次的上限,此时查验返回查无此票,这种“查无此票”的情况是否占用发票当天的查验次数?
(1)无此票的当天可以一直查,税局也没有限制
9、发票查验什么场景会出现查验中,这边重新查有频率要求吗?
(1)是的,批量也只能同步多张查验。查验中的这个code码,就是同一张发票,第一次发起查验还没有返回结果的时候又重复发起查验,我们会返回这个提示。这个需要咱们做好控制,前一个查验没返回结果不要重复发起。
10、各类型发票编码规则
- 增值税专用发票:
1)10位代码的时候,第8位为“1,2,5,7;
2)12位代码的时候,第1位为“0”,第11位和第12位为“13”;

- 增值税普通发票:
1)10位代码的时候,第8位“3、6”;
2)12位代码的时候,第1位“0”,第11位和第12位为“04、05、06、07、11、12“;

- 增值税电子普通发票:
发票代码为12位,第1位为0,第11位和第12位为“11”;发票号码为8位;

- 增值税电子专用发票:
发票代码为12位,第1位为0,第11-12位为“13”,发票号码为8位;

- 二手车发票: 12位代码的时候,第1位“0”,第11位和第12位为“17“;

- 机动车销售统一发票:12位代码的时候,第1位不是“0”,第8位为“2“;

- 数电票号码编码规则:
1)发票号码为20位,前两位代表年度后2位;
2)三四位代表区域,省级税务机关沿用行政区划代码前2位,计划单列市单独的编码而不是原来用4位的行政区划代码;
3)计划单列市区域编码分别是大连(91)、青岛(92)、宁波(93)、厦门(94)、深圳(95),规律是91到95从北到南;

- 云南区块链发票编码规则
发票代码为12位,编码规则为:第1位1代表税务,第2-5位代表云南省行政区代码5300,第6-7位代表年份(如:2020年用20表示),第8-9位代表专属种类(09代表云南省通用电子发票;19代表云南省××企业电子发票,即企业自行设计版面,并符合法律规定的发票,如景区、景点、公园门票),第10位代表批次,第11-12位为00。

- 广东区块链发票编码规则
发票代码为144001809010,其中第6-7位为年份,第8位“0”代表发票种类为通用类、第9位“9”是区别其他开票软件,标记由区块链电子发票平台开具,第10-11位代表批次,第12位代表无限制金额版。发票号码为8位,按年度、分批次编制。

- 北京区块链发票编码规则
发票代码为12位,编码规则为:第1位1代表税务,第2─5位代表北京市行政区代码1100,第6─7位代表年份(如:2020年用20表示),第8位0代表行业种类为通用类、第9位9代表北京电子普通发票专属种类类别,第10位代表批次,第11位代表联次,第12位0代表无限制金额版。

归集#

1、发票归集任务状态的接口,如果连续调用两次,两次接口都是一样的参数,包括这个addjob字段两次都是传的true,是不是就相当于发起了两次任务
(1)不会第二次会返回你在进行中的状态,连续的话。
2、归集可以归集几年内的发票
(1)归集可以到五年内的发票的。
3、发票归集下的三个分类:税局登录归集、数字证书归集、数字账户归集,有什么不同吗
(1)税局登录归集:是指创建企业需要传递税局有效登录信息,其中包含登录税局跳转综服平台获取进销项或已勾选发票全票面数据(非全电企业)和登录税局发票云平台获取进销项或已勾选发票全票面数据(针对全电企业)这两种
(2)数字证书归集:申请数字证书的形式登录到综服平台获取进销项或已勾选发票全票面数据(全电的推广,后面逐渐会被发票云替代)
(3)数字账户归集:金融场景产品,基于登录税局跳转综服平台一次性获取24月的进销项或已勾选发票全票面数据,非全电企业正常可用(全电企业暂不可用),由于税局全电升级,这个产品目前正在重新规划中,全电企业适配到发票云平台获取,计划是6月初先适配江苏、厦门、河南三个地区,后续根据客户需求优先适配其他地区。

认证#

1、综服认证发票数据和发票云认证数据,同步定时任务时间
(1)综服同步:6,7,8,9,10,11,12,13,14,15,17,19。
(2)发票云同步: 7,12,16,23。
2、认证的定时任务都会获取哪些信息(数据)
(1)认证状态、已勾选发票、未勾选发票、税款所属期、统计确认信息
3、发票状态异常一般是是什么情况下会出现,什么是失控/异常发票
(1)是纳税人开票系统丢失被盗后,开出但未上传的增值税专用发票。
(2)是税务机关发票稽核系统稽核时通不过的发票,包括“比对不符”“缺联”等。
(3)评估有虚开可能。
(4)丢失空白的发票。
(5)开票方非正常户、走逃等情况下开出来的某些增值税专票  
(6)商贸企业购进、销售货物名称严重背离的;生产企业无实际生产加工能力且无委托加工,或生产能耗与销售情况严重不符,或购进货物并不能直接生产其销售的货物且无委托加工的,所对应属期开具的增值税专用发票。
(7)异常凭证进项税额累计占同期全部增值税专用发票进项税额70%(含)以上的,其对应开具的增值税专用发票。
(8)异常凭证进项税额累计超过5万元的,其对应开具的增值税专用发票。

识别#

1、识别并发数
(1)并发票QPS是3,3张/s,这个可以增加,最大到20。
2、识别大小限制是多少.识别支持的格式有哪些.
(1)图片大小限制为5M以内,PDF页数不超过30页,默认60秒超时;
(2)图片格式:jpg, jpeg, png   文件格式:pdf,ofd,XML

开票#

1、扫脸认证
(1)可以用接口拉取二维码来认证,也可以提前在电票平台上认证,使用当地的国税APP扫码进行身份认证。开票都要扫脸认证的。开票操作是税局严管的操作。全电开票24小时都要刷脸认证一次。这里有个设置,建议设置成24小时刷脸一次(最大值)
2、调用刷脸二维码,这个二维码信息怎么用
(1)接口返回的是二维码内容,可以用zxing或一些第三方现成的生成接口来生成图片。使用当地的国税APP扫码进行身份认证。
3、客户并发开票(短时间内开具多张发票10张+),响应结果是分为两种?还是三种? a.请求成功,发票开具中; b.请求成功,发票开具失败or成; c: a 或者 b同时存在
(1)同步模式只有a;  异步模式a、b同时存在
4、税局升级、网络波动、或者其他未知原因引发伪开票失败(实际开票成功),是如何保证数据唯一性,以及准确性的呢?对应的处理策略是什么?
    目前无法解决网络波动问题,现在能解决的是:
(1)在企享云采用唯一订单号确保一个订单批次号只能开具一次
(2)用户可以主动查询一间段的发票明细,通过附加信息来确定是否已经开具过
5、同步模式撞上开票高峰期,产生超时问题如何解决
    超时后的重试,分两种情况:
 (1)如果局端超时,暂时没有很好的办法,要参考网络波动处理办法(问题4)
 (2)如果是发起端到企享云超时,那么下次同一订单批号请求开票,会返回开票结果,而不会再次请求开票。
6、发票开具成功后,版式文件是否可以直接下载?会不会存在发票开具成功,版式文件尚未生成的情况
(1)可以直接下载
7、全电开票后如果这个订单号开票失败了,可以重新使用之前失败的订单号,重新发起吗
(1)如果失败了,可以重新发起。
8、全电开票时返回的,开票流水号,是入参时的订单号吗。
(1)不是的,流水号每个请求都是不同的,我们平台自动生成的。
9、调用【发票邮件交付接口】返回失败原因:“访问局端错误:未设置发件邮箱”
邮箱设置指引
原因是税局没有设置发件邮箱,可以按照税局的《邮箱设置指引》先设置邮箱,再调用接口。
10、请问红字确认单哪些状态下能撤销?
撤销具体规则参考如下:
(1)无需确认的情况。销方发起无需确认的红字确认单,未开具红字发票前,允许销方撤回;
(2)对方尚未确认的情况。红字确认信息发起方在提交红字确认单后,对方尚未确认前,不允许修改,发起方可撤销红字确认单;
(3)对方已确认的情况。购销双方任意一方发起且对方已确认的红字确认单,发起方不允许撤销红字确认单,确认方可在确认后且未开具红字发票前撤销确认单;
(4)红字发票已开具的情况。已开具红字发票的红字确认单不允许撤销;
(5)异常凭证的情况。发起红字确认单后、开具红字发票前,原蓝字发票被认定异常凭证的,系统自动作废红冲流程。
11、红冲接口报:确认单商品服务编码全为3开头的,开具红字发票原因不能选择 “销货退回”!
在选择“开具红字发票原因”时,假如蓝字发票商品服务编码是1或者2开头的,红冲的原因是不能选择“服务中止的”因为以1开头的编码为货物,2开头的为劳务,这两项的红冲不可能对应“服务中止”。

如果商品服务的编码为3开头的,红冲的原因是不允许选择“销售退回”的。因为以3开头的为服务,不存在“销售退回”。
12、关于大额开票的提醒
纳税人收到单张大额提示提醒
纳税人首次开票额度大于发票额度的50%,且开票金额大于50万,会触发大额发票提醒。
系统弹出“纳税人单张发票金额达到月初发票额度50%及以上且金额达到50万及以上时,给开
票人员进行风险提醒,确认是否继续开票;若继续开票,则给网格员发送风险提醒。"可以继
续开票。
13、特定要素类型代码关于三个农产品的区别
image.png
12:自产农产品销售发票; 比如那种合作社, 把蔬菜供应给超市, 开的就是这种票
16:农产品收购发票; 购方发起开具, 就是反向开票模式, 用于向农户收购
20:农产品; 只要开票的产品里面带有农产品相关的项目, 就会自动带上农产品这个特定要素
14、税局的开票扫脸规则和设置扫脸时长操作指引
参考:https://anhui.chinatax.gov.cn/art/2024/9/20/art_10641_1207075.html
注意:以法人或者财务负责人的身份登录电子税务局
上一页
公共业务
下一页
申报业务
Built with