个税接口代扣代缴对接流程
流程示意图:
![](img/gs_flow_picture.png)
流程示意图说明:
第一种、企业初次对接时,从第1步【创建企业】开始对接到第13步【批量完税证明地址下载】接口整体流程对接。
第二种、企业已经对接过【创建企业】接口,并且已经有aggOrgId,从第2步【企业信息注册】开始对接到第13步【批量完税证明地址下载】流程进行对接。
第三种、企业已经对接过【企业信息注册】接口,并且当月有人员变动时从第3步【人员信息登记采集】进行对接到第13步【批量完税证明地址下载】流程进行对接。
第四种、企业已经对接过【企业信息注册】接口,并且当月没有人员变动时从第5步【专项附加扣除更新】进行对接到第13步【批量完税证明地址下载】流程进行对接。
第1步、创建企业
调用【创建企业接口】,创建企业同时维护个税账号密码信息。该接口用于创建一个企业到AGG平台。
接口 |
地址 |
说明 |
创建企业 |
v1/AGG/org/create |
创建成功后会返回唯一标识aggOrgId, 此aggOrgId作为双方平台企业关联的唯一标识, 在之后的接口中都要用到,所以应该保存起来 |
第2步、企业基本信息准备
调用【企业基本信息准备】,新增企业扣缴义务人信息,用于实例RPA机器人客户端服务,支持新增修改企业信息。
接口 |
地址 |
说明 |
企业基本信息准备 |
/v1/GS/kjywr/save |
保存个税企业基本信息,根据个税登录方式不同,必填字段有所不同 |
第3步、人员信息登记采集
调用【人员信息登记采集】,主要用于采集:人员基础信息、任职受雇从业信息、联系方式、投资信息等
接口 |
地址 |
说明 |
人员信息登记采集 |
/v1/GS/nsrjcxx/saveBatchRyxx |
主要用于采集:人员基础信息、任职受雇从业信息、联系方式、投资信息等 |
第4步、人员报送
调用【人员报送】,将已采集的人员信息进行报送和人员的验证。
接口 |
地址 |
说明 |
人员报送 |
/v1/GS/nsrjcxx/sendRyxxTkhd |
该接口用于个税人员报送 |
第5步、专项附加扣除更新
调用【专项附加扣除更新】,更新客户端专项附加扣除最新数据。
接口 |
地址 |
说明 |
专项附加扣除更新 |
/v1/GS/zxfjkc/xzZxfjkc |
更新客户端专项附加扣除最新数据。 |
第6步、申报表填写
调用【申报表填写】,根据各附表计税规则进行填写
接口 |
地址 |
说明 |
申报表填写 |
/v1/GS/dkdj/sbxx/receiveSbb |
该接口用于个税申报表填写 |
第7步、申报数据专项附加扣除预填写
调用【申报数据专项附加扣除预填写】,维护专项附加扣除预数据
接口 |
地址 |
说明 |
申报数据专项附加扣除预填写 |
/v1/GS/dkdj/sbxx/ytzxfjkc |
该接口用于个税申报数据专项附加扣除预填写 |
第8步、申报发送
调用【申报发送】,将个税信息进行申报发送接口
接口 |
地址 |
说明 |
申报发送 |
/v1/GS/dkdj/sbxx/apiSendSbb |
该接口用于个税进行申报发送接口 |
第9步、税款缴纳
调用【税款缴纳】,该接口用于个税税款缴纳
接口 |
地址 |
说明 |
税款缴纳 |
/v1/GS/dkdj/sbjs/plskjn |
该接口用于个税税款缴纳 |
第10步、个税申报情况查询
调用【个税申报情况查询】,获取个税已申报的数据进行验证
接口 |
地址 |
说明 |
个税申报情况查询 |
/v1/GS/dkdj/sbxx/getSbxx |
该接口用于个税申报情况查询 |
第11步、个税扣缴明细查询
调用【个税扣缴明细查询】,获取个税扣缴明细数据进行验证
接口 |
地址 |
说明 |
个税扣缴明细查询 |
/v1/GS/dkdj/sbxx/grkjmxcx |
该接口用于个税扣缴明细查询 |
第12步、批量完税证明开具
调用【批量完税证明开具】,个税批量完税证明开具
接口 |
地址 |
说明 |
批量完税证明开具 |
/v1/GS/com/dkdj/kjwszm |
该接口用于个税批量完税证明开具 |
第13步、批量完税证明下载
调用【批量完税证明地址下载】,获取个税批量完税证明地址
接口 |
地址 |
说明 |
批量完税证明地址下载 |
/v1/GS/com/dkdj/getWszmUrl |
该接口用于获取个税批量完税证明地址 |