企享云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/这个地址前缀)
      • 查询我的待办和提醒
        • 发起获取我的待办
        • 发起获取我的提醒
        • 获取我的待办结果
        • 获取我的提醒结果
    • 个税申报
      • 个税简介
      • 业务指引
      • 代扣代缴
        • 企业登记及查询服务
          • 企业注册
            • 企业注册
          • 账户密码上传校验
            • 账号信息上传并校验(申报密码校验)
        • 人员信息登记报送服务
          • 人员报送
            • 人员信息报送
              POST
            • 人员信息报送反馈
              POST
          • 企业人员列表查询
            • 企业人员列表查询
          • 年收入不足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
https://api.qixiangyun.com/v2/iit/declare/declareEmployeeInfo

接口描述#

该接口是异步接口。
1.企业有新增人员,需要将人员进行信息采集并报送登记。税局会接受报送信息并验证人员的真实性,并返回报送状态和验证状态。报送状态是税局是否成功接收报送信息的状态,验证状态是验证人员是否真实的状态。
2.若员工原来是报送成功的,然后填写离职日期,离职后,需要重新报送人员,告知税局该人员的离职时间。
3.若变更员工的其他信息,如任职受雇类型、任职受雇时间、手机号码、联系地址等,都需要重新报送人员,告知税局人员信息变更后的情况。
4.进行生产经营所得申报前需通过该接口获取股东投资人信息。

错误码#

错误代码错误信息解决方案
4003没有找到对应的企业!
4002aggOrgId请求参数不能为空!

请求参数

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
bizNo
string 
外部业务编号
可选
aggOrgId
string 
企业ID
必需
accountId
string 
账号ID
必需
传入accountId就免传登录信息
skssq
string 
所属期
必需
格式YYYYMM年月
rylb
array[object (人员报送-人员列表) {55}] 
企业人员列表
必需
xm
string 
姓名
必需
zzlx
string 
证件类型
必需
zzhm
string 
证件号码
必需
qtzzlx
string 
其他证件类型
可选
qtzzhm
string 
其他证件号码
可选
bmbh
string 
部门编号
可选
部门编号已废弃
rybscl
string 
人员报送策略
可选
1.
默认逻辑“是”,仅当信息变化时才会报送信息到税局
2.
若企业想要支持人员信息不变化的情况下,也能重新发起报送,覆盖局端信息,可修改传参为“否”
gh
string 
工号
可选
skssq
string 
所属期
可选
格式YYYYMM年月
lxdh
string 
电话号码
必需
11位中国大陆手机号码
nsrzt
string 
人员状态
必需
默认为正常,可选择正常/非正常
sfgy
string 
任职受雇类型
必需
可选择雇员、保险营销员、证券经纪人、其他、实习学生(全日制学历教育)
rzndjyqk
string 
入职年度就业情形
可选
当雇员、保险营销员、证券经纪人时可选择:当年首次入职学生、当年首次入职其他人员。其他情况下填写默认为空
rzsgrq
string 
受雇日期
可选
格式:YYYY-MM-DD,不能大于当前时间任职受雇类型选择:雇员、保险营销员、证券经纪人、实习学生(全日制学历教育)时必录
xb
string 
性别
必需
男/女,可通过身份证号码中的第17位数字用于区分性别,奇数表示男性,偶数表示女性‌
csny
string 
出生日期
必需
YYYY-MM-DD 需要和身份证上保持一致
gj
string 
国籍
必需
见国籍字典
rydq
string 
人员地区
必需
境内/境外
lzrq
string 
离职日期
可选
格式:YYYY-MM-DD,不能大于当前时间,离职日期不能大于入职日期
人员状态非正常时必填
注:清空离职时间传入空字符串,不能是null
grgbze
string 
个人投资总额
可选
当为股东投资者时必填,投资额大于0
grgbbl
string 
个人投资比例
可选
投资额填写时必填,范围为0~100,不包含0
sfcj
string 
是否残疾
可选
默认为否,可选择是/否
sfls
string 
是否烈属
可选
默认为否,可选择是/否
sfgl
string 
是否孤老
可选
默认为否,可选择是/否
sfzdw
string 
是否扣除减除费用
可选
默认为是,可选择是/否,传null或者空值都会默认为是,当填了否后, 如果后续还需要保持否的状态还需传否,不填则会默认为是
cjzjlx
string 
残疾证件类型
可选
当【是否残疾】为“是”时,必填
可填项:
“残疾证”
“残疾军人证”
“伤残人民警察证”
“残疾消防救援人员证”
“伤残预备役人员、伤残民兵民工证”
“因公伤残人员证”
cjzh
string 
残疾证号
可选
当为残疾时必填
lszh
string 
烈属证号
可选
当为烈属时必填
dzyx
string 
邮箱
可选
xl
string 
学历
可选
默认为空,
大学本科以下
大学本科
研究生
zw
string 
职务
可选
1是高层;3是普通
khyh
string 
开户银行
可选
见银行字典
khyhsfmz
string 
开户银行省份
可选
见开户银行省份字典
yhzh
string 
银行账号
可选
如果khyh,khyhsfmz,yhzh 有一项选择填写了那么其他两项也需要填写
lxdz_sheng
string 
居住省份
可选
中文,例如浙江省
lxdz_shi
string 
居住城市
可选
中文,例如杭州市
lxdz_qx
string 
居住区县
可选
中文,例如滨江区
lxdz_jd
string 
居住街道
可选
中文,浦沿街道
lxdz
string 
居住详细地址
可选
hjszd_sheng
string 
户籍省份
可选
中文,例如浙江省
hjszd_shi
string 
户籍城市
可选
中文,例如杭州市
hjszd_qx
string 
户籍区县
可选
中文,例如滨江区
hjszd_jd
string 
户籍街道
可选
中文,浦沿街道
hjszd_xxdz
string 
户籍详细地址
可选
bz
string 
备注
可选
csd
string 
出生地
可选
外籍人员必填,填写出生地国家(地区),见国籍字典
sssx
string 
涉税事由
可选
外籍人员必填,多个时用逗号分割;
任职受雇
提供临时劳务
转让财产
从事投资和经营活动
其他
scrjsj
string 
首次入境时间
可选
当【人员地区】为“境外”且【任职受雇类型】选择“雇员”时,必填。格式YYYY-MM-DD
yjljsj
string 
预计离境时间
可选
当【人员地区】为“境外”且【任职受雇类型】选择“雇员”时,必填。格式YYYY-MM-DD
wjrlxdz_sheng
string 
联系地省份
可选
wjrlxdz_shi
string 
联系地城市
可选
wjrlxdz_qx
string 
联系地区县
可选
wjrlxdz_jd
string 
联系地街道
可选
wjrlxdz_xxdz
string 
联系地详细地址
可选
xmzw
string 
中文名
可选
证件类型为外国护照、外国人永久居留身份证、外国人工作许可证(A类)、外国人工作许可证(B类)、外国人工作许可证(C类)时可填写,其他证件类型不可填写。如果有填写必须为中文。
示例
{
  "aggOrgId": "4539696148287232",
  "accountId": "4539696148287232",
  "skssq": "202412",
  "rylb": [
    {
      "xm": "姓名",
      "zzlx": "证件类型",
      "zzhm": "证件号码",
      "qtzzlx": "其他证件类型",
      "qtzzhm": "其他证件号码",
      "rybscl": "人员报送策略",
      "gh": "工号",
      "skssq": "所属期",
      "lxdh": "电话号码",
      "nsrzt": "人员状态",
      "sfgy": "任职受雇类型",
      "rzndjyqk": "入职年度就业情形",
      "rzsgrq": "受雇日期",
      "xb": "性别",
      "csny": "出生日期",
      "gj": "国籍",
      "rydq": "人员地区",
      "lzrq": "离职日期",
      "grgbze": "1",
      "grgbbl": "2",
      "sfcj": "是否残疾",
      "sfls": "是否烈属",
      "sfgl": "是否孤老",
      "sfzdw": "是否扣除减除费用",
      "cjzjlx": "残疾证件类型",
      "cjzh": "残疾证号",
      "lszh": "烈属证号",
      "dzyx": "邮箱",
      "xl": "学历",
      "zw": "职务",
      "khyh": "开户银行",
      "khyhsfmz": "开户银行省份",
      "yhzh": "银行账号",
      "lxdz_sheng": "居住省份",
      "lxdz_shi": "居住城市",
      "lxdz_qx": "居住区县",
      "lxdz_jd": "居住街道",
      "lxdz": "居住详细地址",
      "hjszd_sheng": "户籍省份",
      "hjszd_shi": "户籍城市",
      "hjszd_qx": "户籍区县",
      "hjszd_jd": "户籍街道",
      "hjszd_xxdz": "户籍详细地址",
      "bz": "备注",
      "csd": "出生地",
      "sssx": "涉税事由",
      "scrjsj": "首次入境时间",
      "yjljsj": "预计离境时间",
      "wjrlxdz_sheng": "联系地省份",
      "wjrlxdz_shi": "联系地城市",
      "wjrlxdz_qx": "联系地区县",
      "wjrlxdz_jd": "联系地街道",
      "wjrlxdz_xxdz": "联系地详细地址",
      "xmzw": "中文名"
    }
  ]
}

返回响应

🟢200成功
application/json
Body
reqId
string 
请求id
必需
由服务器端生成的唯一标识,对应每次请求。排查接口异常时,可提供该字段方便定位
code
string  | null 
错误码
必需
错误码
success
boolean 
是否成功标记
必需
接口是否成功(是否发生业务异常)
message
string  | null 
错误信息
必需
data
object 
任务信息
必需
taskId
string 
任务ID
必需
示例
{
  "code": "2000",
  "success": true,
  "reqId": "1065591abf904b3d92d2d747cc561ec8",
  "data": {
    "taskId": "1000000000000001304"
  }
}
上一页
账号信息上传并校验(申报密码校验)
下一页
人员信息报送反馈
Built with