企享云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数据
        • 查询上传并申报各税种申报表数据任务结果
      • 上传财报报表数据
        • 简介
        • 上传财报数据
        • 查询上传并申报财报数据任务结果
      • 简易申报
        • 发起简易申报任务
        • 查询简易申报任务结果
      • 申报初始化
        • 简介
        • 获取合同
          • 发起查询合同接口任务
            POST
          • 查询合同任务结果
            POST
        • 代扣代缴初始化
          • 发起代扣代缴初始化数据任务
        • 发起获取初始化数据任务
          POST
        • 初始化数据查询
          POST
      • 申报提交
        • 简介
        • 发起申报任务
        • 查询申报任务结果
        • 查询申报任务进度结果接口
      • 更正申报
        • 简介
        • 发起更正申报任务接口
        • 查询更正申报任务结果
      • 同步申报结果(旧版税局功能,新版已不需要,即将下线)
        • 发起同步申报状态任务接口
      • 申报作废
        • 简介
        • 发起作废申报任务
        • 查询作废申报任务结果
      • 税款缴纳
        • 简介
        • 发起税款缴纳任务
        • 查询税款缴纳任务结果
        • 查询缴款任务进度结果接口
      • 申报查询
        • 简介
        • 发起申报信息查询任务
        • 查询申报信息任务
      • 漏报检查
        • 简介
        • 发起漏报检查任务
        • 查询漏报检查任务
      • 税源采集/获取
        • 税源采集 (待优化)
          • 简介
          • 税源信息采集接口
          • 查询税源信息采集任务结果
        • 税源获取
          • 简介
          • 税源信息获取接口
          • 查询税源获取任务结果接口
      • 业务弹框
        • 简介
        • 保存申报辅助设置弹窗选项信息
        • 查询申报辅助设置弹窗信息
        • 查询全量申报辅助设置弹窗信息
      • 获取完税证明(表格式)
        • 简介
        • 发起下载完税证明任务
        • 查询下载完税证明任务结果
        • 发起下载完税证明并解析任务
        • 查询下载完税证明并解析任务的结果
      • 获取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. 获取合同

查询合同任务结果

POST
/v2/tax/qys/queryContractTaskInfo

接口描述#

查询已发起的获取合同任务的执行结果。

错误码#

错误代码错误信息解决方案
PARAMETER_ERROR企业Id(aggOrgId)不能为空!
PARAMETER_ERROR任务信息taskId不能为空!
PARAMETER_ERROR参数格式不合法!
INTERFACE_ERROR接口异常,请联系管理员

请求参数

Header 参数
Content-Type
string 
必需
示例值:
application/json
access_token
string 
必需
通过调用access_token接口返回的access_token值
示例值:
{{access_token}}
req_date
string 
必需
当前时间转为的毫秒数
示例值:
{{req_date}}
req_sign
string 
签名算法得到的签名
必需
示例值:
{{req_sign}}
Body 参数application/json
aggOrgId
string 
企业id
必需
taskId
string 
任务id
必需
示例
{
  "aggOrgId": 452681066557440,
  "taskId": "454760922049792"
}

返回响应

🟢200成功
application/json
Body
code
string 
必需
success
boolean 
是否成功标记
必需
接口是否成功(是否发生业务异常)
message
string 
错误码
必需
reqId
string 
请求id
必需
data
object 
必需
aggOrgId
string 
企业id
必需
taskId
string 
任务Id
必需
serviceCode
string 
服务代码
必需
serviceName
string 
服务名称
必需
businessStatus
integer 
任务执行状态
必需
0未开始 1任务执行中 2执行失败 3执行成功 4撤销成功
businessStatusName
string 
任务执行状态名称
必需
yzpzzlDm
string 
应征凭证种类代码
必需
detail 
array [object {9}] 
必需
增值税代扣代缴返回参数
detail
array [object {7}] 
必需
企业所得税代扣代缴返回参数
示例
{
  "code": "SUCCESS",
  "data": {
    "businessStatusName": "已成功",
    "serviceCode": "tax-contract",
    "businessStatus": 3,
    "detail": [
      {
        "htmc": "合同名称",
        "htje": "合同金额",
        "xthtbh": " 系统合同编号",
        "cjrq": "采集日期",
        "fjmNsrsbh": "非居民纳税识别号",
        "fjmqyzwmc": "非居民企业名称"
      }
    ],
    "aggOrgId": 482734358988800,
    "serviceName": "查询合同",
    "taskId": 571709195744768
  },
  "success": true,
  "message": "",
  "reqId": "073ef7d312a843a680a1aba4007cd5bf"
}
修改于 2025-04-30 01:38:25
上一页
发起查询合同接口任务
下一页
发起代扣代缴初始化数据任务
Built with