Skip to content

10.分次获取专项扣除信息(支持员工数超过50人的企业)

"serviceid": "FCHQZXKCXX"

请求:

{
  "nsrsbh": "企业税号",
  "appid": "123456",
  "input": {
    "skssqq": "2019-01-01",
    "skssqz": "2019-12-31",
    "zrrdah": "12312423141234,123412341234,12341234"
  }
}

请求字段说明:

字段名称字段含义必填说明
zrrdah要获取的专项附加扣除的自然人档案号多个自然人档案号以逗号分隔,最大不能超过50个,超过50个,可以分批次进行请求
skssqq税款所属期起格式YYYYMMDD
skssqz税款所属期止格式YYYYMMDD

返回字段说明同第8节说明

11.分次获取属期专项扣除(包含当前属期专项扣除金额信息)

此接口获取专项附加扣除信息的同时,会自动计算前属期的专项扣除金额,拿到当前属期专项扣除金额以后,可以再调用" 获取综合所得申报累计数据"接口,将上期专项扣除累计和当前属期的扣除金额相加,即可得出累计专项附加扣除。

  "serviceid": "FCHQLJZXKCXX"

请求:

{
  "nsrsbh": "企业税号",
  "appid": "123456",
  "input": {
    "skssq ": "201912",
    "zrrdah": "12312423141234,123412341234,12341234"
  }
}

请求字段说明:

字段名称字段含义必填说明
zrrdah要获取的专项附加扣除的自然人档案号多个自然人档案号以逗号分隔,最大不能超过50个,超过50个,可以分批次进行请求
skssq当前申报属期格式YYYYMM

返回同第9节说明

返回明细中新增字段:

bqzfdkzxfjkcje (本期住房专项附加扣除金额)

bqznjyzxfjkcje (本期子女教育专项附加扣除金额)

bqsylrzxfjkcje (本期赡养老人专项附加扣除金额)

bqzfzjzxfjkcje(本期租房租金专项附加扣除金额)

bqxljxjyzxfjkcje(本期学历继续教育专项附加扣除金额)

12. (CJT)分次获取属期专项扣除(包含当前属期专项扣除金额信息)

此接口获取专项附加扣除信息的同时,会自动计算前属期的专项扣除金额,拿到当前属期专项扣除金额以后,可以再调用" 获取综合所得申报累计数据"接口,将上期专项扣除累计和当前属期的扣除金额相加,即可得出累计专项附加扣除。

"serviceid": "CJTFCHQLJZXKCXX"

请求:

{
  
  "nsrsbh": "企业税号",
  "appid": "123456",
  "input": {
    "skssq ": "201912",
    "skssqq": "2019-12-01",
    "skssqz": "2019-12-31",
    "zrrdah": "12312423141234,123412341234,12341234"
  }
}

请求字段说明:

字段名称字段含义必填说明
zrrdah要获取的专项附加扣除的自然人档案号多个自然人档案号以逗号分隔,最大不能超过50个,超过50个,可以分批次进行请求
skssq当前申报属期格式YYYYMM
skssqq税款所属期起格式YYYY-MM-DD
skssqz税款所属期止格式YYYY-MM-DD

返回同第9节说明

返回明细中新增字段:

bqzfdkzxfjkcje (本期住房专项附加扣除金额)

bqznjyzxfjkcje (本期子女教育专项附加扣除金额)

bqsylrzxfjkcje (本期赡养老人专项附加扣除金额)

bqzfzjzxfjkcje(本期租房租金专项附加扣除金额)

bqxljxjyzxfjkcje(本期学历继续教育专项附加扣除金额)

bqfxljxjyzxfjkcje(本期非学历继续教育专项附加扣除金额)

bqjxjyzxfjkcje(本期继续教育专项附加扣除金额)

bqyyezhhlfyzxfjkcje(本期婴幼儿照护费用专项附加扣除金额)

bqljzfdkzxfjkcje (本期累计住房专项附加扣除金额)

bqljznjyzxfjkcje (本期累计子女教育专项附加扣除金额)

bqljsylrzxfjkcje (本期累计赡养老人专项附加扣除金额)

bqljzfzjzxfjkcje(本期累计租房租金专项附加扣除金额)

bqljxljxjyzxfjkcje(本期累计学历继续教育专项附加扣除金额)

bqljfxljxjyzxfjkcje(本期累计非学历继续教育专项附加扣除金额)

bqljjxjyzxfjkcje(本期累计继续教育专项附加扣除金额)

bqljyyezhhlfyzxfjkcje(本期累计婴幼儿照护费用专项附加扣除金额)

13. 个人养老金

13.1. 获取个人养老金名单

获取填写了个人养老金的员工名单

  "serviceid": "HQGRYLJMD"

请求:

{
  "nsrsbh": "企业税号",
  "appid": "123456",
  "sid": "",
  "input": {
    "dknd": "抵扣年度,格式yyyy"
  }
}

请求字段说明:

字段名称字段含义必填说明
dknd抵扣年度当前抵扣的年度

返回:

{
  "appid": "123456",
  "code": "00000",
  "data":  {
    "zxbgsj": "最新变更时间",
    "zrrdahs": ["123412342134","555555555555555","1234125555234","423412341234","123234214124"]
  },
  "msg": "报送成功",
  "serviceid": "HQGRYLJMD",
  "sid": "123122123"
}
  1. 2获取个人养老金信息
获取养老金详细信息,一次请求最多查询50人
  "serviceid": "HQGRYLJXX"

请求:

{
  "nsrsbh": "企业税号",
  "appid": "123456",
  "sid": "",
  "input": [{
    "zrrdah":"自然人档案号",
    "dknd": "抵扣年度,格式yyyy"
  }]
}

请求字段说明:

字段名称字段含义必填说明
dknd抵扣年度当前抵扣的年度
zrrdah自然人档案号需要获得的自然人档案号
 
返回:
{
  "appid": "123456",
  "code": "00000",
  "data": [{
    "dknd": "2023",
    "zrrdah": "232333333321",
    "mxList": [{
      "dknd": "2023",
      "zrrdah": "33333333333332323",
      "sypzbh": "236533934001",
      "pzlbDm": "01",
      "jcje": 12000.00,
      "jcsj": "202301",
      "hyztDm": "1",
      "cjrlxDm": "01",
      "xgrq": "2023-02-11"
    }]
  }],
  "msg": "报送成功",
  "serviceid": "HQGRYLJXX",
  "sid": "123122123"
}

返回字段说明:

字段名称字段含义必填说明
dknd抵扣年度当前抵扣的年度
zrrdah自然人档案号需要获得的自然人档案号
xgrq修改日期
sypzbh使用凭证编号
jcje缴费金额
pzlbDm凭证类型代码01 月度
jcsj缴存时间

14. 代扣代缴

14.1. 提交综合所得申报(正常工资薪金所得、全年一次性奖金收入、劳务报酬、个人股权激励收入)

"serviceid": "TJZHSDSB"

请求{
  "nsrsbh": "914301111111111111",
  "appid": "123456",
  "input": {
    "skssqq": "2019-04-01",
    "skssqz": "2019-04-30",
    "tbrq": "2019-05-15",
    "fddbrfzrxm": "李四",
    "jbrxm": "张三",
    "bmbh": "",
    "zhsdykyjbgbljmx": [
      {
        "xh": "1",
        "sfmxsb": "1",
        "nsrxm": "张三",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "341222199001011111",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "551235134521345",
        "zrrdah": "43513451345",
        "sdxmdm": "0101",
        "sdxmmc": "正常工资薪金",
        "bqsre": "0",
        "ljsre": "0",
        "bqmssr": "0",
        "ljmssr": "0",
        "yjbjcfy": "100",
        "ljjbjcfy": "000000",
        "jbylbxf": "0",
        "jbyilbxf": "0",
        "sybxf": "0",
        "zfgjj": "0",
        "bqzxkchj": "0",
        "ljzxkchj": "0",
        "nj": "0",
        "syjkbx": "0",
        "syylbx": "0",
        "qtje": "0",
        "bqqtkchj": "0",
        "ljqtkchj": "0",
        "znjyzc": "0",
        "sylrzc": "0",
        "zfdklxzc": "0",
        "zfzjzc": "0",
        "jxjyzc": "0",
        "bqzxfjkchj": "0",
        "ljznjyzc": "0",
        "ljsylrzc": "0",
        "ljzfdklxzc": "0",
        "ljzfzjzc": "0",
        "ljjxjyzc": "0",
        "ljzxfjkchj": "0",
        "bqzykcdjze": "0",
        "ljzykcdjze": "0",
        "ljynssde": "0",
        "sl1": "0.03",
        "sskcs": "0",
        "ljynse": "0",
        "bqjmse": "0",
        "ljjmse": "0",
        "ljyingkjse": "0",
        "bqyiyujse": "0",
        "ljyiyujse": "0",
        "ybtse": "0",
        "bqsbsjbz": "0",
        "ljfy": "0",
        "yxkcdsf": "0",
        "yyezhzc": "0",
        "ljyyezhzc": "0",
        "ljgrylj": "0",
        "baxh": "",
        "babh": "",
        "bars": "0",
        "barq": "",
        "qtdwljsr": "",
        "qtdwljkc": "",
        "qtdwljjmse": "",
        "qtdwljyijse": ""
      },
      {
        "xh": "2",
        "sfmxsb": "1",
        "nsrxm": "李四",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "341222199001011111",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "44423412341234",
        "zrrdah": "3412341213542135",
        "sdxmdm": "0401",
        "sdxmmc": "一般劳务报酬所得",
        "bqsre": "1200",
        "ljsre": "1200",
        "bqfy": "100",
        "bqmssr": "0",
        "ljmssr": "0",
        "yjbjcfy": "0",
        "ljjbjcfy": "0",
        "jbylbxf": "0",
        "jbyilbxf": "0",
        "sybxf": "0",
        "zfgjj": "0",
        "bqzxkchj": "0",
        "ljzxkchj": "0",
        "nj": "0",
        "syjkbx": "0",
        "syylbx": "0",
        "qtje": "0",
        "bqqtkchj": "0",
        "ljqtkchj": "0",
        "znjyzc": "0",
        "sylrzc": "0",
        "zfdklxzc": "0",
        "zfzjzc": "0",
        "jxjyzc": "0",
        "bqzxfjkchj": "0",
        "ljznjyzc": "0",
        "ljsylrzc": "0",
        "ljzfdklxzc": "0",
        "ljzfzjzc": "0",
        "ljjxjyzc": "0",
        "ljzxfjkchj": "0",
        "bqzykcdjze": "0",
        "ljzykcdjze": "0",
        "ljynssde": "1000",
        "sl1": "0.2",
        "sskcs": "0",
        "ljynse": "1920",
        "bqjmse": "0",
        "ljjmse": "0",
        "ljyingkjse": "100",
        "bqyiyujse": "0",
        "ljyiyujse": "0",
        "ybtse": "1920",
        "bqsbsjbz": "0",
        "ljfy": "2400",
        "yxkcdsf": "0",
        "yyezhzc": "0",
        "ljyyezhzc": "0",
        "ljgrylj": "0",
        "baxh": "",
        "babh": "",
        "bars": "0",
        "barq": "",
        "qtdwljsr": "",
        "qtdwljkc": "",
        "qtdwljjmse": "",
        "qtdwljyijse": ""
      }
    ],
    "zhsdykyjbgbljmxhj": {
      "hjbqsre": "3332323.00",
      "hjljsre": "21341234.00",
      "hjbqfy": "12341234.60",
      "hjljfy": "1234123.60",
      "hjbqmssr": "0.00",
      "hjljmssr": "0.00",
      "hjljjbjcfy": "11123412.00",
      "hjjbylbxf": "0.00",
      "hjjbyilbxf": "0.00",
      "hjsybxf": "0.00",
      "hjzfgjj": "0.00",
      "hjbqzxkchj": "0.00",
      "hjljzxkchj": "0.00",
      "hjnj": "0.00",
      "hjsyjkbx": "0.00",
      "hjsyylbx": "0.00",
      "hjyxkcdsf": "0.00",
      "hjqtje": "0.00",
      "hjbqqtkchj": "0.00",
      "hjljqtkchj": "0.00",
      "hjznjyzc": "0.00",
      "hjsylrzc": "0.00",
      "hjzfdklxzc": "0.00",
      "hjzfzjzc": "0.00",
      "hjjxjyzc": "0.00",
      "hjbqzxfjkchj": "0.00",
      "hjljznjyzc": "0.00",
      "hjljsylrzc": "0.00",
      "hjljzfdklxzc": "0.00",
      "hjljzfzjzc": "0.00",
      "hjljjxjyzc": "0.00",
      "hjljzxfjkchj": "0.00",
      "hjbqzykcdjze": "0.00",
      "hjljzykcdjze": "0.00",
      "hjljynssde": "324.40",
      "hjljynse": "234.28",
      "hjbqjmse": "0.00",
      "hjljjmse": "0.00",
      "hjljyingkjse": "151153.28",
      "hjbqyiyujse": "0.00",
      "hjljyiyujse": "0.00",
      "hjybtse": "5151.28",
      "hjyyezhzc": "0",
      "hjljyyezhzc": "0",
      "hjljgrylj": "0"
    },
    "jmsxxlb": [
      {
        "xh": "1",
        "xm": "李四",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "341222199001011111",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "",
        "zrrdah": "200000000111111111",
        "ssyhlx": "2",
        "sdxmdm": "0101",
        "sdxmmc": "正常工资薪金",
        "jmsxdm": "SXA031900643",
        "jmsxmc": "高级专家延长离退休期间工薪免征个人所得税",
        "jmxzdm": "0005129999",
        "jmxzmc": "其他",
        "jmse": "3"
      }
    ],
    "gyjzkcmxlb": [
      {
        "mxxh": "1",
        "xm": "李四",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "341222199001011111",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "",
        "zrrdah": "200000000111111111",
        "sdxmdm": "0101",
        "sdxmmc": "正常工资薪金",
        "skssqq": "2024-07-01",
        "skssqz": "2024-07-31",
        "szdwszsfDm": "",
        "szdwszsfmc": "",
        "szdwnsrsbh": "91110222XXXXXXXXXX",
        "szdwmc": "有限公司",
        "szdwdjxh": "",
        "jzpzh": "123123123",
        "jzrq": "2024-07-10",
        "jzje": "50",
        "kcbl": "1",
        "kcje": "50",
        "bz": "eee"
      }
    ],
    "syjkbxmxlb": [
      {
        "mxxh": "1",
        "xm": "李四",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "341222199001011111",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "",
        "zrrdah": "200000000111111111",
        "sysbh": "202400100066222841",
        "ndbf": "240",
        "ydbf": "20",
        "bdsxrq": "2024-06-01",
        "bqkcje": "10"
      }
    ]
  }
}
字段名称字段含义必填说明
skssqq税款所属期起格式如 2019-03-01
skssqz税款所属期止格式如 2019-03-31
tbrq填报日期当前的日期 格式如 2019-04-10
fddbrfzrxm法人姓名
jbrxm经办人姓名
bmbh部门编号默认为空即可,针对分部门的情况,需要传部门编号
xh序号从1开始,每次增加1
sfmxsb为1即可
nsrxm纳税人姓名人员姓名
sfzjlxdm身份证件类型代码201 居民身份证 202 军官证 203 武警警官证 203 士兵证 208外国护照 210港澳居民来往内地通行证 213台湾居民来往大陆通行证 216外交官证 219香港永久性居民身份证 220台湾身份证 221澳门特别行政区永久性居民身份证 227中国护照 223外国人永久居留身份证(外国人永久居留证) 237中华人民共和国港澳居民居住证 238中华人民共和国台湾居民居住证 239《中华人民共和国外国人工作许可证》(A类) 240《中华人民共和国外国人工作许可证》(B类) 241《中华人民共和国外国人工作许可证》(C类) 299其他个人证件
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号人员报送时返回的登记序号
zrrdah自然人档案号人员报送时返回的自然人档案号
sdxmdm所得项目代码代码详见 【所得项目字典】
sdxmmc所得项目名称名称详见 【所得项目字典】
bqsre本期收入额[一次性补偿收入]也填写
ljsre累计收入额[一次性补偿收入]也填写
bqfy本期费用
bqmssr本期免税收入当本期免税收入大于0时,必须填写附表 jmsxxlb,对应《个人所得税减免税事项报告表》
ljmssr累计免税收入
yjbjcfy月基本减除费用
ljjbjcfy累计减除费用
jbylbxf基本养老保险费
jbyilbxf基本医疗保险费
sybxf失业保险费
zfgjj住房公积金
bqzxkchj本期专项扣除合计
ljzxkchj累计专项扣除合计
nj年金
syjkbx商业健康保险
syylbx税延养老保险
qtje其他
bqqtkchj本期其他扣除合计
ljqtkchj累计其他扣除合计
znjyzc子女教育支出
sylrzc赡养老人支出
zfdklxzc住房贷款利息支出
zfzjzc住房租金支出
jxjyzc继续教育支出
bqzxfjkchj本期专项附加扣除合计
ljznjyzc累计子女教育支出
ljsylrzc累计赡养老人支出
ljzfdklxzc累计住房贷款利息支出
ljzfzjzc累计住房租金支出
ljjxjyzc累计继续教育支出
ljzxfjkchj累计专项附加扣除合计
bqzykcdjze本期准予扣除的捐赠额
ljzykcdjze累计准予扣除的捐赠额
ljynssde累计应纳税所得额
sl1税率一般 0.03
sskcs速算扣除数
ljynse累计应纳税额
bqjmse本期减免税额当本期免税收入大于0时,必须填写附表 jmsxxlb,对应《个人所得税减免税事项报告表》
ljjmse累计减免税额
ljyingkjse累计应扣缴税额
bqyiyujse本期已预缴税额
ljyiyujse累计已预缴税额当前值取往期累计已预缴+上期应补退税额
ybtse应补退税额
bz备注如果是一次性扣除60000的情况,需要填入: 上年各月均有申报且全年收入不超过6万元
bqsbsjbz填0即可
ljfy累计费用
yxkcdsf允许扣除的税费
yyezhzc婴幼儿照护支出
ljyyezhzc累计婴幼儿照护支出
ljgrylj累计个人养老金
baxh备案序号
babh备案编号
bars备案人数默认传0
barq备案日期
qtdwljsr其他单位累计收入
qtdwljkc其他单位累计扣除
qtdwljjmse其他单位累计减免税额
qtdwljyijse其他单位累计已缴税额
hjbqsre合计本期收入额
hjljsre合计累计收入额
hjbqfy合计本期费用
hjbqmssr合计本期免税收入
hjljjbjcfy合计累计基本减除费用
hjjbylbxf合计基本养老保险费
其他全是对应明细项的合计
jmsxxlb减免事项附表:
字段名称字段含义必填说明
xh序号从1开始,每次增加1
xm姓名姓名
sfzjlxdm身份证件类型代码201 居民身份证
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号人员报送时返回的登记序号
zrrdah自然人档案号人员报送时返回的自然人档案号
ssyhlx所属优惠类型1 减税 2 免税
sdxmdm所得项目代码代码详见 【所得项目字典】
sdxmmc所得项目名称名称详见 【所得项目字典】
jmsxdm减免事项代码
jmsxmc减免事项名称
jmxzdm减免性质代码
jmxzmc减免性质名称
jmse减免税额减免税额
gyjzkcmxlb准予扣除的捐赠附表:
字段名称字段含义必填说明
mxxh序号从1开始,每次增加1
xm姓名姓名
sfzjlxdm身份证件类型代码201 居民身份证
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号传空串
zrrdah自然人档案号人员报送时返回的自然人档案号
sdxmdm所得项目代码代码详见 【所得项目字典】
sdxmmc所得项目名称名称详见 【所得项目字典】
skssqq税款所属期起格式如 2019-03-01
skssqz税款所属期止格式如 2019-03-31
szdwszsfDm受赠单位受赠身份代码传空串
szdwszsfmc受赠单位受赠身份名称传空串
szdwnsrsbh受赠单位纳税人识别号
szdwmc受赠单位名称
szdwdjxh受赠单位登记序号传空串
jzpzh捐赠凭证号
jzrq捐赠日期
jzje捐赠金额
kcbl扣除比例
kcje实际扣除金额
bz备注
 
syjkbxmxlb商业健康保险附表:
字段名称字段含义必填说明
mxxh序号从1开始,每次增加1
xm姓名姓名
sfzjlxdm身份证件类型代码201 居民身份证
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号传空串
zrrdah自然人档案号人员报送时返回的自然人档案号
sysbh税优识别码
ndbf年度保费
ydbf月度保费
bxsxrq保险生效日期格式如 2019-03-31
bqkcje本期扣除金额

返回:

申报失败:

{
  "appid": "554352341",
  "code": "49999",
  "msg": "申报失败,当前税款所属期已申报,请勿重复申报",
  "nsrsbh": "553545345",
  "serviceid": "TJZHSDSB",
  "sid": "5551"
}

处理中:

{
  "appid": "123456",
  "code": "00002",
  "data": "",
  "msg": "您发送的申报正在处理,请稍候获取反馈信息,谢谢!",
  "serviceid": "TJZHSDSB",
  "sid": "fad55a2da3be49e4942dae1836d91b75"
}

申报成功:

{
  "appid": "123456",
  "code": "00000",
  "data": {
    "sblsh": "66456456456",
    "skssqz": "2019-08-31",
    "sfxyjk": "N",
    "bblb": "SB0701",
    "sbjg": "1",
    "sbxh": "4444555",
    "fkxx": "申报成功",
    "skssqq": "2019-08-01"
  },
  "msg": "申报成功",
  "nsrsbh": "55555345111",
  "serviceid": "TJZHSDSB",
  "sid": "66456222y44yy33"
}

字段说明:

字段名称字段含义必填说明
sblsh申报流水号
skssqz税款所属期止
sfxyjk
bblb报表类别
sbjg申报结果
fkxx反馈信息
sbxh申报序号
skssqq税款所属期起

14.2. 更正综合所得申报

请求和返回报文同14.1提交综合所得,需要将提交的serviceid修改为:BGZHSDSB,

input 里面增加 ysblsh(原申报流水号)对正常申报成功返回的sblsh

14.3. 作废综合所得申报

"serviceid": "ZFZHSDSB"

请求:

{
  "nsrsbh": "6666",
  "appid": "123456",
  "input": {
    "zfsid": "3344"
  }
}

字段说明:

字段名称字段含义必填说明
zfsid对应申报提交成功使用的sid

返回:

{
  "appid": "123456",
  "code": "00000",
  "data": {
    "sblsh": "55543",
    "zfjg": "1",
    "djxh": "534511"
  },
  "msg": "作废成功",
  "nsrsbh": "55345345111",
  "serviceid": "ZFZHSDSB",
  "sid": "55553"
}

14.4. 提交分类所得申报

  "serviceid": "TJFLSDSB"

请求

{
  "nsrsbh": "9143011178288036706",
  "appid": "123456",
  "input": {
    "skssqq": "2019-04-01",
    "skssqz": "2019-04-30",
    "tbrq": "2019-05-15",
    "fddbrfzrxm": "李四",
    "jbrxm": "张三",
    "bmbh": "",
    "flsddkdjbgbmx": [
      {
        "xh": "1",
        "sfmxsb": "1",
        "nsrxm": "张三",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "33333231412421341234",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "djxh": "551235134521345",
        "zrrdah": "43513451345",
        "sdxmdm": "0101",
        "sdxmmc": "正常工资薪金",
        "sre": "0",
        "mssr": "0",
        "ccyz": "0",
        "yxkcdsf": "0",
        "tzdk": "100",
        "qtje": "000000",
        "sqkcxmhj": "0",
        "jcfy": "0",
        "zykcdjze": "0",
        "ynssde": "0",
        "sl1": "0",
        "ynse": "0",
        "jmse": "0",
        "yingkjse": "0",
        "yikjse": "0",
        "ybtse": "0",
        "bz": "0",
        "jjbl": "0"
      }
    ],
    "flsddkdjbgbmxhj": {
      "hjsre": "3332323.00",
      "hjmssr": "21341234.00",
      "hjjcfy": "12341234.60",
      "hjccyz": "1234123.60",
      "hjyxkcdsf": "0.00",
      "hjtzdk": "0.00",
      "hjqtje": "11123412.00",
      "hjsqkcxmhj": "0.00",
      "hjzykcdjze": "0.00",
      "hjynssde": "0.00",
      "hjynse": "0.00",
      "hjjmse": "0.00",
      "hjyingkjse": "0.00",
      "hjyikjse": "0.00",
      "hjybtse": "0.00"
    }
  }
}
字段名称字段含义必填说明
skssqq税款所属期起格式如 2019-03-01
skssqz税款所属期止格式如 2019-03-31
tbrq填报日期当前的日期 格式如 2019-04-10
fddbrfzrxm法人姓名
jbrxm经办人姓名
bmbh部门编号默认为空即可,针对分部门的情况,需要传部门编号
xh序号从1开始,每次增加1
sfmxsb是否明细申报 1明细申报 0汇总申报
nsrxm纳税人姓名人员姓名 明细申报时传具体人员姓名 汇总申报时传空串
sfzjlxdm身份证件类型代码201 居民身份证 202 军官证 203 武警警官证 203 士兵证 208外国护照 210港澳居民来往内地通行证 213台湾居民来往大陆通行证 216外交官证 219香港永久性居民身份证 220台湾身份证 221澳门特别行政区永久性居民身份证 227中国护照 223外国人永久居留身份证(外国人永久居留证) 237中华人民共和国港澳居民居住证 238中华人民共和国台湾居民居住证 239《中华人民共和国外国人工作许可证》(A类) 240《中华人民共和国外国人工作许可证》(B类) 241《中华人民共和国外国人工作许可证》(C类) 299其他个人证件
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号人员报送时返回的登记序号
zrrdah自然人档案号人员报送时返回的自然人档案号
sdxmdm所得项目代码代码详见 【所得项目字典】
sdxmmc所得项目名称名称详见 【所得项目字典】
sre收入额
mssr免税收入
tzdk投资抵扣
ccyz财产原值
sqkcxmhj扣除及减除项目合计
jcfy减除费用
zykcdjze准允扣除的捐赠额
ynssde应纳税所得额
sl1税率
ynse应纳税额
jmse减税税额
yingkjse应扣缴税额
yikjse已扣缴税额
ybtse应补退税额
bz备注
jjbl减按计税比例
hjsre合计收入额
hjmssr合计免税收入
hjjcfy合计减除费用
hjjcyz继续教育支出
hjsqkcxmhj合计扣除及减除项目合计
hjzykcdjze合计准予扣除的捐赠额
hjynssde合计应纳税所得额
hjynse合计应纳税额
hjjmse合计减免税额
hjccyz合计财产原值
hjtzdk合计投资抵扣
hjyingkjse合计应扣除税额
ljynssde累计应纳税所得额
hjyikjse合计已缴税额
hybtse合计应补退税额

返回:

申报失败:

{
  "appid": "554352341",
  "code": "49999",
  "msg": "申报失败,当前税款所属期已申报,请勿重复申报",
  "nsrsbh": "553545345",
  "serviceid": "TJFLSDSB",
  "sid": "5551"
}

处理中:

{
  "appid": "123456",
  "code": "00000",
  "data": "",
  "msg": "您发送的申报正在处理,请稍候获取反馈信息,谢谢!",
  "serviceid": "TJFLSDSB",
  "sid": "fad55a2da3be49e4942dae1836d91b75"
}

申报成功:

{
  "appid": "123456",
  "code": "00000",
  "data": {
    "sblsh": "66456456456",
    "skssqz": "2019-08-31",
    "sfxyjk": "N",
    "bblb": "SB0701",
    "sbjg": "1",
    "sbxh": "4444555",
    "fkxx": "申报成功",
    "skssqq": "2019-08-01"
  },
  "msg": "申报成功",
  "nsrsbh": "55555345111",
  "serviceid": "TJFLSDSB",
  "sid": "66456222y44yy33"
}

字段说明:

字段名称字段含义必填说明
sblsh申报流水号
skssqz税款所属期止
sfxyjk
bblb报表类别
sbjg申报结果
fkxx反馈信息
skssqq税款所属期起

14.5更正分类所得申报

请求和返回报文同14.7提交限售股所得申报,需要将提交的serviceid修改为:BGFLSDSB,

input 里面增加 ysblsh(原申报流水号)对正常申报成功返回的sblsh

14.6. 作废分类所得申报

"serviceid":"ZFFLSDSB"

请求:

{"nsrsbh":"6666","appid":"123456","input":{"zfsid":"3344"}}

字段说明:

字段名称字段含义必填说明
zfsid对应申报提交成功使用的sid

返回:

{"appid":"123456","code":"00000","data":{"sblsh":"55543","zfjg":"1","djxh":"534511"},"msg":"作废成功","nsrsbh":" 55345345111","serviceid":"ZFFLSDSB","sid":"55553"}

14.7提交非居民所得申报

  "serviceid": "TJFJMSDSB"
请求{
  "nsrsbh": "3333333333333333333",
  "appid": "123456",
  "input": {
    "skssqq": "2019-04-01",
    "skssqz": "2019-04-30",
    "tbrq": "2019-05-15",
    "fddbrfzrxm": "李四",
    "jbrxm": "张三",
    "bmbh": "",
    "fjmdkdjbgbmx": [{
      "xh": "1",
      "sfmxsb": "1",
      "nsrxm": "MR WANG",
      "sfzjlxdm": "208",
      "sfzjlxmc": "外国护照",
      "sfzjhm": "W20222200330000",
      "gjhdqszdm": "124",
      "gjhdqmc": "加拿大",
      "djxh": "551235134521345",
      "zrrdah": "43513451345",
      "sdxmdm": "0102",
      "sdxmmc": "无住所个人正常工资薪金",
      "sre": "0",
      "fy": "0",
      "mssr": "0",
      "ccyz": "0",
      "yxkcdsf": "0",
      "tzdk": "100",
      "qtje": "000000",
      "sqkcxmhj": "0",
      "jcfy": "5000",
      "zykcdjze": "0",
      "ynssde": "0",
      "sl1": "0.25",
      "ynse": "0",
      "jmse": "0",
      "yingkjse": "0",
      "yikjse": "0",
      "ybtse": "0",
      "bz": "外出",
      "jjbl": "0",
    },
    ],
    "fjmdkdjbgbmxhj": {
      "hjsre": "3332323.00",
      "hjmssr": "21341234.00",
      "hjfy": "12341234.60",
      "hjccyz": "1234123.60",
      "hjyxkcdsf": "0.00",
      "hjyzdk": "0.00",
      "hjqtje": "11123412.00",
      "hjsqkcxmhj": "0.00",
      "hjjcfy": "0.00",
      "hjyzdk": "0.00",
      "hjzykcdjze": "0.00",
      "hjynssde": "0.00",
      "hjynse": "0.00",
      "hjymse": "0.00",
      "hjybtse": "0.00",
      "hjyikjse": "0.00"
    }
  }
}
字段名称字段含义必填说明
skssqq税款所属期起格式如 2019-03-01
skssqz税款所属期止格式如 2019-03-31
tbrq填报日期当前的日期 格式如 2019-04-10
fddbrfzrxm法人姓名
jbrxm经办人姓名
bmbh部门编号默认为空即可,针对分部门的情况,需要传部门编号
xh序号从1开始,每次增加1
sfmxsb为1即可
nsrxm纳税人姓名人员姓名
sfzjlxdm身份证件类型代码201 居民身份证 202 军官证 203 武警警官证 203 士兵证 208外国护照 210港澳居民来往内地通行证 213台湾居民来往大陆通行证 216外交官证 219香港永久性居民身份证 220台湾身份证 221澳门特别行政区永久性居民身份证 227中国护照 223外国人永久居留身份证(外国人永久居留证) 237中华人民共和国港澳居民居住证 238中华人民共和国台湾居民居住证 239《中华人民共和国外国人工作许可证》(A类) 240《中华人民共和国外国人工作许可证》(B类) 241《中华人民共和国外国人工作许可证》(C类) 299其他个人证件
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
gjhdqszdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
djxh登记序号人员报送时返回的登记序号
zrrdah自然人档案号人员报送时返回的自然人档案号
sdxmdm所得项目代码代码详见 【所得项目字典】
sdxmmc所得项目名称名称详见 【所得项目字典】
sre收入额
mssr免税收入
sqkcxmhj扣除及减除项目合计
jcfy减除费用
zykcdjze准允扣除的捐赠额
ynssde应纳税所得额
sl1税率
ynse应纳税额
jmse减税税额
yingkjse应扣缴税额
yikjse已扣缴税额
ybtse应补退税额
bz备注
jjbl减按计税比例
hjsre合计收入额
hjmssr合计免税收入
hjjcfy合计减除费用
hjjcyz继续教育支出
hjsqkcxmhj合计扣除及减除项目合计
hjzykcdjze合计准予扣除的捐赠额
hjynssde合计应纳税所得额
hjynse合计应纳税额
hjymse合计减免税额
hjyingkjse合计应扣除税额
ljynssde累计应纳税所得额
hjyikjse合计已缴税额
hybtse合计应补退税额

返回:

申报失败:

{"appid":"554352341","code":"49999","msg":"申报失败,当前税款所属期已申报,请勿重复申报","nsrsbh":"553545345"," serviceid":"TJFJMSDSB","sid":"5551"}

处理中:

{"appid":"123456","code":00000,"data":"","msg":"您发送的申报正在处理,请稍候获取反馈信息,谢谢!","serviceid":"TJFJMSDSB"," sid":"fad55a2da3be49e4942dae1836d91b75"}

申报成功:

{

"appid": "123456",

"code": "00000",

"data": {

​ "sblsh": "66456456456",

​ "skssqz": "2019-08-31",

​ "sfxyjk": "N",

​ "bblb": "SB0701",

​ "sbjg": "1",

​ "sbxh": "4444555",

​ "fkxx": "申报成功",

​ "skssqq": "2019-08-01"

},

"msg": "申报成功",

"nsrsbh": "55555345111",

"serviceid": "TJFJMSDSB",

"sid": "66456222y44yy33"

}

字段说明:

字段名称字段含义必填说明
sblsh申报流水号
skssqz税款所属期止
sfxyjk
bblb报表类别
sbjg申报结果
fkxx反馈信息
skssqq税款所属期起

14.8. 提交限售股所得申报

  "serviceid": "TJXSGSDSB"
 
请求{
  "sid": "99fl9912",
  "nsrsbh": "924100000000000000",
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "input": {
    "skssqz": "2023-01-31",
    "skssqq": "2023-01-01",
    "tbrq": "2023-02-08",
    "jbrxm": "张三",
"bmbh": "",
    "xsgzrsdkjgrsdsbgbmx": [
      {
        "xh":"1",
        "nsrxm": "娃哈哈",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "110101198801010000",
        "nsrsbh": "110101198801010000",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "zrrdah": "110000000000000001",
        "zqzhh":"0246838828",//证券账户号
        "gpdm":"301031",//股票代码
        "gpmc":"中熔电气",//股票名称
        "mgjsjg":"167.000000",//每股计税价格(元/股)
        "zrgs":"100",//转让股数
        "zrsre":"16700.00",//转让收入额(每股计税价格*转让股数)
        "xsgyz":"2505.00",//限售股原值,
        "hlsf":"300.00",//合理税费,
        "xj":"2805.00",//小计(限售股原值+合理税费)
        "ynssde":"13895.00",//应纳税所得额(转让收入额-小计)
        "sl1":"0.2",//税率
        "kjse":"2779.00"//扣缴税额(应纳税所得额*税率)
      },
      {
        "xh":"2",
        "nsrxm": "娃哈哈",
        "sfzjlxdm": "201",
        "sfzjlxmc": "居民身份证",
        "sfzjhm": "110101198801010000",
        "nsrsbh": "110101198801010000",
        "gjhdqszdm": "156",
        "gjhdqmc": "中华人民共和国",
        "zrrdah": "110000000000000001",
        "zqzhh":"0246838828",
        "gpdm":"301031",
        "gpmc":"中熔电气",
        "mgjsjg":"177.360000",
        "zrgs":"100",
        "zrsre":"17736.00",
        "xsgyz":"2505.40",
        "hlsf":"0.00",
        "xj":"2505.40",
        "ynssde":"15230.60",
        "sl1":"0.2",
        "kjse":"3046.12"
      }
    ],
    "xsgzrsdkjgrsdsbgbhj": {
      "xjhj":"5310.40",//小计合计
      "ynssdehj":"29125.6",//应纳税所得额合计
      "kjsehj":"5825.12"//扣缴税额合计
    }
  }
}

字段说明:

字段名称字段含义必填说明
xh序号从1开始,每次增加1
nsrxm纳税人姓名姓名
sfzjlxdm身份证件类型代码201 居民身份证 202 军官证 203 武警警官证 203 士兵证 208外国护照 210港澳居民来往内地通行证 213台湾居民来往大陆通行证 216外交官证 219香港永久性居民身份证 220台湾身份证 221澳门特别行政区永久性居民身份证 227中国护照 223外国人永久居留身份证(外国人永久居留证) 237中华人民共和国港澳居民居住证 238中华人民共和国台湾居民居住证 239《中华人民共和国外国人工作许可证》(A类) 240《中华人民共和国外国人工作许可证》(B类) 241《中华人民共和国外国人工作许可证》(C类) 299其他个人证件
sfzjlxmc身份证件名称一般为 居民身份证 无特殊情况固定死即可
sfzjhm证件号码
nsrsbh纳税人识别号一般同sfzjhm
gjhdqszdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
gjhdqmc国际地区名称一般为 中华人民共和国 无特殊情况固定死即可
zrrdah自然人档案号人员报送时返回的自然人档案号
zqzhh证券账户号
gpdm股票代码
gpmc股票名称
mgjsjg每股计税价格元/股
zrgs转让股数
zrsre转让收入额每股计税价格*转让股数
xsgyz限售股原值
hlsf合理税费
xj小计限售股原值+合理税费
ynssde应纳税所得额转让收入额-小计
sl1税率
kjse扣缴税额应纳税所得额*税率

申报成功:

{
  "msg": "申报成功",
  "nsrsbh": "924100000000000000",
  "code": "00000",
  "data": {
    "sblsh": "200000000000004",
    "skssqz": "2023-01-31",
    "sfxyjk": "Y",
    "sbjg": "1",
    "ywlxDm": "A061005002",
    "sbxh": "1000000000000074",
    "fkxx": "申报成功",
    "skssqq": "2023-01-01"
  },
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "serviceid": "TJXSGSDSB",
  "sid": "99fl9912"
}

字段说明:

字段名称字段含义必填说明
sblsh申报流水号
skssqz税款所属期止
sfxyjk
sbjg申报结果
fkxx反馈信息
sbxh申报序号
skssqq税款所属期起

14.9. 更正限售股所得申报

请求和返回报文同14.7提交限售股所得申报,需要将提交的serviceid修改为:BGXSGSDSB,

input 里面增加 ysblsh(原申报流水号)对正常申报成功返回的sblsh

14.10. 作废限售股所得申报

 "serviceid": "ZFXSGSDSB"

请求:

{
   "nsrsbh": "924100000000000000",
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "input": {
    "zfsid": "99fl9914"
  }
}

字段说明:

字段名称字段含义必填说明
zfsid对应申报提交成功使用的sid

返回:

{
  "msg": "作废成功",
  "nsrsbh": "924100000000000000",
  "code": "00000",
  "data": {
    "sblsh": "2000002555000000",
    "zfjg": "1",
    "djxh": "10114106000000000007"
  },
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "serviceid": "ZFXSGSDSB",
  "sid": "99fl994"
}

14.11. 作废限售股所得申报

 "serviceid": "ZFXSGSDSB"

请求:

{
   "nsrsbh": "924100000000000000",
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "input": {
    "zfsid": "99fl9914"
  }
}

字段说明:

字段名称字段含义必填说明
zfsid对应申报提交成功使用的sid

返回:

{
  "msg": "作废成功",
  "nsrsbh": "924100000000000000",
  "code": "00000",
  "data": {
    "sblsh": "2000002555000000",
    "zfjg": "1",
    "djxh": "10114106000000000007"
  },
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "serviceid": "ZFXSGSDSB",
  "sid": "99fl994"
}

14.12. 确认减除费用扣除员工

确认扣除以后查询接口返回的sfqrkc 值就会变成报送时传递的值,如果确认一次性扣除,综合所得工资薪金所得申报时,ljjbjcfy值为60000,bz 需要传 上年各月均有申报且全年收入不超过6万元。此接口必须再1月份属期调用,其他月份调用可能不生效。

  "serviceid": "JCFYKC6WBS"

请求:

{
  "input": {
    "xskcnd": "2021",
    "mxList": [{
      "sfxskc": "Y",
      "zrrdah": "34532452345"
    }]
  },
  "nsrsbh": "234523453245",
  "appid": "45-7eb0-345-4534-8d05ad7b4300"
}

字段说明

字段名称字段含义必填说明
xskcnd享受扣除年度YYYY格式,例如2021
sfxskc确认是否享受扣除Y确认扣除 N确认不扣除

返回:

{
  "msg": "成功",
  "nsrsbh": "4234555",
  "code": "00000",
  "data": {
    "total": "1",
    "errorList": []
  },
  "appid": "34234-7eb0-42-a866-234234",
  "serviceid": "JCFYKC6WBS",
  "sid": "234234234"
}

字段说明

字段名称字段含义必填说明
total报送总数报送的数量
errorList报送错误列表

15. 三方协议扣款(兼容代扣代缴和经营所得)

15.1. 待缴款信息查询

  "serviceid": "CXQSXX"

请求:

{
  "nsrsbh": "445345",
  "appid": "123456",
  "input": {
    "sbxh": "44444",
    "nsrlxdm": "",
    "zrrdah": "自然人档案号"
  }
}
字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
zrrdah自然人档案号个体户需要传投资人的档案号

查询不到欠税信息时:

{ "msg": "成功", "code": "00000", "nsrsbh": "123124124123123", "data": [], "appid": "123456", "serviceid": "CXQSXX", "sid": "777777116" }

有欠税信息:

{
  "msg": "成功",
  "nsrsbh": "123124124123123",
  "code": "00000",
  "data": [
    {
      "sfxyh": "三方协议号(可能为空)",
      "skssswjgdm": "税款所属税务机关代码",
      "ybtskxh": "应补退税款序号",
      "znj": "滞纳金",
      "ybtye": "税额",
      "sbrq": "申报日期",
      "skssqq": "税款所属期",
      "sbxh": "申报序号",
      "version": "版本号"
    }
  ],
  "appid": "123456",
  "serviceid": "CXQSXX",
  "sid": "777777116"
}

15.2. 三方协议下载(代扣代缴)

  "serviceid": "CXSFXY"

请求:

{
  "nsrsbh": "555666",
  "appid": "123456",
  "input": {}
}

返回:

{
  "appid": "123456",
  "code": "00000",
  "data": [
    {
      "xzqhszdm": "",
      "khyhhh": "",
      "skssswjgdm": "税款所属机关代码",
      "pkbz": "0",
      "sfxyyztgrq": "",
      "sfxyh": "",
      "qsyhhh": "",
      "yhyywddm": "",
      "yhhbdm": "",
      "jkzhmc": "",
      "sfxyztdm": "02",
      "jkzh": "",
      "sfxyyzxx": "验证通过,协议已可以使用"
    }
  ],
  "msg": "成功",
  "nsrsbh": "445345",
  "serviceid": " CXSFXY",
  "sid": "2234234"
}

字段说明:

字段名称字段含义必填说明
sfxyh三方协议号
jkzhmc缴款账号名称
jkzh缴款账号
xzqhszdm行政区划数字代码
khyhhh开户行行号
pkbz批扣标志批扣标志,0非批扣户,1 批扣户
qsyhhh清算银行行号
yhyywddm银行营业网点代码
sfxyyztgrq三方协议验证通过日期
yhyywdmc扣款银行名称

15.3. 三方协议下载(个体户经营所得)

  "serviceid": "CXGTHSFXY"

请求:

{
  "nsrsbh": "555666",
  "appid": "123456",
  "input": {
    "xm": "",
    "zjlxdm": "",
    "gjdqdm": "",
    "zjhm": ""
  }
}

字段说明:

字段名称字段含义必填说明
xm姓名个体户老板的名称
zjlxdm证件类型代码身份证201 其他详见附录字典表
gjdqdm国际地区代码默认156 中国
zjhm证件号码身份证号码

返回:

{
  "appid": "123456",
  "code": "00000",
  "data": [
    {
      "xzqhszdm": "",
      "khyhhh": "",
      "skssswjgdm": "税款所属机关代码",
      "pkbz": "0",
      "sfxyyztgrq": "",
      "sfxyh": "",
      "qsyhhh": "",
      "yhyywddm": "",
      "yhhbdm": "",
      "jkzhmc": "",
      "sfxyztdm": "02",
      "jkzh": "",
      "sfxyyzxx": "验证通过,协议已可以使用",
      "yhyywdmc": "",
      "yhhbmc": ""
    }
  ],
  "msg": "成功",
  "nsrsbh": "445345",
  "serviceid": " CXGTHSFXY",
  "sid": "2234234"
}

字段说明:

字段名称字段含义必填说明
sfxyh三方协议号
jkzhmc缴款账号名称
jkzh缴款账号
qsyhhh银行行号
xzqhszdm行政区划数字代码
khyhhh开户行行号
pkbz批扣标志批扣标志,0非批扣户,1 批扣户
qsyhhh清算银行行号
yhyywddm银行营业网点代码
sfxyyztgrq三方协议验证通过日期
yhyywdmc银行营业网点名称
yhhbmc银行名称

15.4. 缴款记录查询(代扣代缴)

  "serviceid": "CXJKXX"

请求:

{
  "nsrsbh": "2312323423412341234",
  "appid": "123456",
  "input": {
    "jkrqq": "2020-01-02",
    "jkrqz": "2021-01-01"
  }
}

字段说明:

字段名称字段含义必填说明
jkrqq缴款日期起查询的起始日期
jkrqz缴款日期止查询的截止日期

返回值:

{
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "22332323",
  "data": [
    {
      "sbxh": "申报序号",
      "skssqq": "税款所属期起",
      "skssqz": "税款所属期止",
      "yzpzzldm": "应征凭证种类代码",
      "skzldm": "税款种类代码",
      "dzsphm": "电子税票号码",
      "jkrq": "缴款日期",
      "sjje": "税金金额",
      "skjnfsmc": "税款缴纳方式名称"
    }
  ],
  "appid": "123456",
  "serviceid": "CXJKXX",
  "sid": "88900906"
}

字段说明:

字段名称字段含义必填说明
code缴款状态SUCCESS缴款成功
sbxh申报序号
dzsphm电子税票号码
skssqq税款所属期起
skssqz税款所属期止
yzpzzldm应征凭证种类代码BDA0611062:综合所得预扣预缴表 BDA0611065:分类所得代扣代缴表 BDA0611068:非居民所得代扣代缴报告表
skzldm税款种类代码10:正税 20:滞纳金
jkrq缴款日期
sjje税金金额
skjnfsmc税款缴纳方式名称

15.5. 三方协议扣款

  "serviceid": "SFXYKK"

请求:

{
  "nsrsbh": "91610139MA6TXTFE3A",
  "appid": "123456",
  "input": {
    "sfxyxx": {
      "sfxyyztgrq": "2019-11-12 00:00:00",
      "skssswjgdm": "1612322212",
      "sfxyyzxx": "",
      "sfxyztdm": "",
      "xzqhszdm": "",
      "yhyywddm": "",
      "qsyhhh": "",
      "jkzhmc": "",
      "khyhhh": "",
      "yhhbdm": "",
      "sfxyh": "",
      "jkzh": "",
      "pkbz": ""
    },
    "kkxx": [
      {
        "skssswjgdm": "",
        "ybtskxh": "",
        "sbxh": "",
        "sjje": "",
        "version": "",
        "znj": ""
      }
    ],
    "nsrlxdm": "1",
    "zrrdah": "110000000000000004"
  }
}

字段说明:

字段名称字段含义必填说明
znj滞纳金待缴款信息获取
sjje税金金额待缴款信息获取,对应ybtye
version扣款版本号根据待缴款信息查询的返回值version 直接带入,解决应补退税额发生变化的问题。
其他字段值需要直接从三方协议下载结果信息和待缴款信息获取,直接带入即可, 三方协议信息需要选择一个带入
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
zrrdah自然人档案号个体户需要传投资人的档案号

返回值:

{
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "22332323",
  "data": [
    {
      "code": "SUCCESS",
      "message": "",
      "sbxhs": [
        "1232341234"
      ],
      "dzsphm": "123412341234"
    }
  ],
  "appid": "123456",
  "serviceid": "SFXYKK",
  "sid": "88900906"
}

字段说明:

字段名称字段含义必填说明
code缴款状态SUCCESS缴款成功
message信息描述错误说明
sbxhs申报序号
dzsphm电子税票号码

15.6. 三方协议扣款

  "serviceid": "SFXYKK"

请求:

{
  "nsrsbh": "91610139MA6TXTFE3A",
  "appid": "123456",
  "input": {
    "sfxyxx": {
      "sfxyyztgrq": "2019-11-12 00:00:00",
      "skssswjgdm": "1612322212",
      "sfxyyzxx": "",
      "sfxyztdm": "",
      "xzqhszdm": "",
      "yhyywddm": "",
      "qsyhhh": "",
      "jkzhmc": "",
      "khyhhh": "",
      "yhhbdm": "",
      "sfxyh": "",
      "jkzh": "",
      "pkbz": ""
    },
    "kkxx": [
      {
        "skssswjgdm": "",
        "ybtskxh": "",
        "sbxh": "",
        "sjje": "",
        "version": "",
        "znj": ""
      }
    ],
    "nsrlxdm": "1",
    "zrrdah": "110000000000000004"
  }
}

字段说明:

字段名称字段含义必填说明
znj滞纳金待缴款信息获取
sjje税金金额待缴款信息获取,对应ybtye
version扣款版本号根据待缴款信息查询的返回值version 直接带入,解决应补退税额发生变化的问题。
其他字段值需要直接从三方协议下载结果信息和待缴款信息获取,直接带入即可, 三方协议信息需要选择一个带入
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
zrrdah自然人档案号个体户需要传投资人的档案号

返回值:

{
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "22332323",
  "data": [
    {
      "code": "SUCCESS",
      "message": "",
      "sbxhs": [
        "1232341234"
      ],
      "dzsphm": "123412341234"
    }
  ],
  "appid": "123456",
  "serviceid": "SFXYKK",
  "sid": "88900906"
}

字段说明:

字段名称字段含义必填说明
code缴款状态SUCCESS缴款成功
message信息描述错误说明
sbxhs申报序号
dzsphm电子税票号码

解码后完税证明样张: dsfkk.png

16. 扫码缴款(兼容代扣代缴和经营所得)

16.1. 扫码缴款信息查询

  "serviceid": "QRCXQSXX"

请求:

{
  "input": {
    "sbxh": "223234123412341234",
    "nsrlxdm": "0",
    "nsrdah": "32323"
  },
  "nsrsbh": "3332323",
  "appid": "11d6a2f3-1212341324123433"
}

字段说明:

字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
nsrdah纳税人档案号

返回成功:

{
  "appid": "11d6a2f3-7eb0-963333378",
  "code": "00000",
  "data": [
    {
      "ybtye": "348.110000",
      "sbjkqx": "2022-01-19",
      "skssswjgdm": "11330000",
      "sbxh": "103333866",
      "znts": "0",
      "version": "3",
      "skssqq": "2021-01-01",
      "sfxyh": "",
      "skssqz": "2021-12-31",
      "ybtskxh": "173341",
      "znj": "0.00",
      "jkqx": "2022-01-19",
      "sbrq": "2022-01-16"
    }
  ],
  "msg": "成功",
  "nsrsbh": "1329301333285801",
  "serviceid": "QRCXQSXX",
  "sid": "1642233333332569191HTJS"
}

字段说明:

字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
ybtye应补退税额对应获取扫码二维码提交时传值
version版本号对应获取扫码缴款二维码提交时需要传的version
ybtskxh应补退税款序号

16.2. 获取支付二维码

**注意:每次在成功获取扫码缴款信息以后,只能调用此方法一次,再次调用会返回缴款信息不存在,需要调用缴款凭证信息作废接口进行作废,再调用扫码缴款信息查询接口才能继续调用该接口。 **

  "serviceid": "QRCODEPAY"

请求:

{
  "input": {
    "skssswjgDm": "12341234213",
    "ybtskxh": "12341234123",
    "version": "12",
    "sbxh": "12342342134",
    "sjje": "644.79",
    "nsrlxdm": "0",
    "nsrdah": "12341234",
    "znj": "11"
  },
  "nsrsbh": "323412312312",
  "appid": "11444866-8d05ad744378"
}

字段说明:

字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
sjje税金金额从扫码缴款信息查询返回结果获取
znj滞纳金如果有滞纳金
version版本号从扫码缴款信息查询返回结果获取
ybtskxh应补退税款序号从扫码缴款信息查询返回结果获取
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0

返回:

成功

{
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "132912341234285801",
  "data": [
    {
      "nsrdah": "1101234125132478",
      "sfcg": "SUCCESS",
      "failCode": null,
      "failMsg": null,
      "fhjgList": [
        {
          "skssswjgDm": "11123412300",
          "sbxhs": [
            "1032466"
          ],
          "sjzje": "348.130000",
          "dzsphm": "电子税票号码",
          "qrcodeBase64Str": "二维码base64",
          "sxsj": "599415"
        }
      ]
    }
  ],
  "appid": "11d612341234744378",
  "serviceid": "QRCODEPAY",
  "sid": "164231234123H2TJS"
}
 
失败(数据发生变化,需要作废才能继续获取):
{
  "appid": "11d6a2f123518",
  "code": "00000",
  "data": [
    {
      "nsrdah": "11055512348",
      "sfcg": "FAIL",
      "failCode": "LC_YBTSK_DATA_ZSYBTSK_DATA_CHANGE",
      "failMsg": "LC_YBTSK_DATA_ZSYBTSK_DATA_CHANGE",
      "fhjgList": null
    }
  ],
  "msg": "成功",
  "nsrsbh": "13291341324801",
  "serviceid": "QRCODEPAY",
  "sid": "16423112343H2TJS"
}

失败(不存在待缴款信息)

{
  "appid": "448ae0d5-8e07-47a8-8275-73b1f20b80d3",
  "code": "00000",
  "data": [
    {
      "nsrdah": "101112341000123579",
      "sfcg": "FAIL",
      "failCode": "LC_YBTSK_DATA_ZSYBTSK_NOT_EXIST",
      "failMsg": "LC_YBTSK_DATA_ZSYBTSK_NOT_EXIST",
      "fhjgList": null
    }
  ],
  "msg": "成功",
  "nsrsbh": "132930191234285801",
  "serviceid": "QRCODEPAY",
  "sid": "164212341235523H2TJS"
}

字段说明:

字段名称字段含义必填说明
nsrdah纳税人档案号
sfcg是否成功SUCCESS 成功 FAIL 失败
failCode错误代码
failMsg错误消息
skssswjgDm税款所属税务机关代码
sbxhs申报序号
sjzje上缴总金额
dzsphm电子税票号码
qrcodeBase64Str二维码base64

16.3. 缴款凭证信息查询

  "serviceid": "QRJSPZXXCX"

请求:

{
  "input": {
    "kjrqz": "2022-01-31",
    "kjrqq": "2021-11-01",
    "nsrlxdm": "0",
    "nsrdah": "32323"
  },
  "nsrsbh": "3332323",
  "appid": "11d6a2f3-7eb0-9632-a866-333231233"
}
字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
kjrqz扣缴日期止
kjrqq扣缴日期起
nsrdah纳税人档案号

返回成功:

{
  "msg": "成功",
  "nsrsbh": "2345234523451234",
  "code": "00000",
  "data": [
    {
      "nsrdah": "110000000313802462",
      "jkrq": "",
      "yzpzzlDTOS": [
        {
          "yzpzzlDm": "BDA0610753",
          "yzpzzlmc": null
        }
      ],
      "sfjzsbjk": "N",
      "nsrlxDm": "0",
      "spXjqx": "2022-01-19",
      "sjzje": "644.790000",
      "dzsphm": "622011210371380164",
      "jkzt": "01",
      "skjnfs": "A4",
      "kjrq": "2022-01-12"
    }
  ],
  "appid": "11d6a2f3412341234134378",
  "serviceid": "QRJSPZXXCX",
  "sid": "5234523452345"
}
字段名称字段含义必填说明
nsrdah纳税人档案号
yzpzzlDm应征凭证种类代码
yzpzzlmc应征凭证种类名称
nsrlxDm纳税人类型代码
dzsphm电子凭证序号
jkzt缴款状态01 未支付 02 已支付
skjnfs税控缴纳方式A4 扫码支付 51 税库联网缴税
kjrq扣缴日期

16.4缴款凭证信息查询

  "serviceid": "QRJSPZXXCX"

请求:

{
  "input": {
    "kjrqz": "2022-01-31",
    "kjrqq": "2021-11-01",
    "nsrlxdm": "0",
    "nsrdah": "32323"
  },
  "nsrsbh": "3332323",
  "appid": "11d6a2f3-7eb0-9632-a866-333231233"
}
字段名称字段含义必填说明
sbxh对应申报提交成功后返回的申报序号
nsrlxdm纳税人类型代码默认是综合所得欠税信息查询,如果是个体户经营所得需要传0
kjrqz扣缴日期止
kjrqq扣缴日期起
nsrdah纳税人档案号

返回成功:

{
  "msg": "成功",
  "nsrsbh": "2345234523451234",
  "code": "00000",
  "data": [
    {
      "nsrdah": "110000000313802462",
      "jkrq": "",
      "yzpzzlDTOS": [
        {
          "yzpzzlDm": "BDA0610753",
          "yzpzzlmc": null
        }
      ],
      "sfjzsbjk": "N",
      "nsrlxDm": "0",
      "spXjqx": "2022-01-19",
      "sjzje": "644.790000",
      "dzsphm": "622011210371380164",
      "jkzt": "01",
      "skjnfs": "A4",
      "kjrq": "2022-01-12"
    }
  ],
  "appid": "11d6a2f3412341234134378",
  "serviceid": "QRJSPZXXCX",
  "sid": "5234523452345"
}
字段名称字段含义必填说明
nsrdah纳税人档案号
yzpzzlDm应征凭证种类代码
yzpzzlmc应征凭证种类名称
nsrlxDm纳税人类型代码
dzsphm电子凭证序号
jkzt缴款状态01 未支付 02 已支付
skjnfs税控缴纳方式A4 扫码支付 51 税库联网缴税
kjrq扣缴日期

16.5.缴款记录查询

参见 三方协议扣款 中 缴款记录查询说明

16.6. 完税证明开具

参见 三方协议扣款 中 完税证书开具说明

17. 银行端查询缴税

17.1. 银行端查询缴税凭证信息

"serviceid": "YHDJKPZ"

请求:

{
  "input": {
    "yhyywdDm": "",
    "qsxxs": [
      {
        "skssswjgDm": "13701050000",
        "ybtskxh": "4000000018",
        "version": "3",
        "sbxh": "1000000000000036",
        "sjje": "80.00",
        "znj": "0.00"
      }
    ],
    "nsrlxDm": "1",
    "nsrdah": "10000000000000000005",
    "jyqdDm": "13",
    "yhhbDm": "",
    "yhzh": ""
  },
  "nsrsbh": "900000000000000001",
  "appid": "xxxxxxxxxxxxxxxx"
}
字段名称字段含义必填说明
yhyywdDm银行营业网点代码
nsrlxDm纳税人类型代码1代扣代缴 0个体户经营所得
nsrdah纳税人档案号个体户需要传法人的档案号
jyqdDm申报渠道代码13 客户端
yhhbDm银行代码
yhzh银行帐号
qsxxs欠税信息
skssswjgDm税款所属税务机关代码
ybtskxh应补退税款序号
version版本号
sbxh申报序号
sjje税金金额
znj滞纳金

返回:

{
  "data": {
    "nsrdah": "10000000000000000005",
    "yhyywdDm": null,
    "zsswjgDm": "13701050000",
    "yhzh": null,
    "yhhbDm": null,
    "spXjqx": "2024-10-24",
    "sjzje": "80.000000",
    "spxh": "1050000002",
    "dzsphm": "624000000000000696",
    "swjgMc": "国家税务总局xxxxx税务局",
    "spMxInfoDTOs": [
      {
        "sbxh": "1000000000000036",
        "hyDm": "5174",
        "skssqq": "2024-09-01",
        "zspmMc": "工资薪金所得",
        "ysfpblDm": "13710128",
        "jkqx": "2024-10-24",
        "jssr": "76000.00",
        "sl": "0.100000",
        "yjse": null,
        "zsxmMc": "个人所得税",
        "nsrdah": "10000000000000000005",
        "spmxxh": "4656108615",
        "yskmDm": "101060109",
        "skssswjgDm": "13701050000",
        "zspmDm": "101060100",
        "sjje": "80.000000",
        "zszmDm": null,
        "skzlDm": "10",
        "zsxmDm": "10106",
        "sksxDm": "0107",
        "yzpzzlDm": "BDA0611062",
        "skgkDm": "1370100010",
        "skssqz": "2024-09-30",
        "spxh": "1054179842",
        "djzclxDm": null,
        "jdxzDm": "370105013"
      }
    ]
  },
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "900000000000000001",
  "appid": "xxxxxxxxxxxxxxxx",
  "serviceid": "YHDJKPZ",
  "sid": "ssssssss"
}
字段名称字段含义必填说明
nsrdah纳税人档案号
yhyywdDm银行营业网点代码
zsswjgDm税务机关代码
yhzh银行账号
yhhbDm银行代码
spXjqx缴税期限
sjzje税金总金额
spxh税票序号
dzsphm电子税票号码银行端查询缴税凭证序号
swjgMc税务机关名称
spMxInfoDTOs税票明细信息
sbxh申报序号
hyDm行业代码
skssqq税款所属期起
zspmMc征收品目名称
ysfpblDm预算分配比例代码
jkqx缴款期限
jssr
sl税率
yjse
zsxmMc征收项目名称
nsrdah纳税人档案号
spmxxh税票明细序号
yskmDm
skssswjgDm税款所属税务机关代码
zspmDm征收品目代码
sjje税金金额应缴税额
zszmDm
skzlDm税款种类代码
zsxmDm征收项目代码
sksxDm
yzpzzlDm应征凭证种类代码BDA0611062:综合所得预扣预缴表 BDA0611065:分类所得代扣代缴表 BDA0611068:非居民所得代扣代缴报告表
skgkDm收款国库代码
skssqz税款所属期止
spxh税票序号
djzclxDm
jdxzDm街道乡镇代码

17.2. 银行端查询缴税扣款

此接口可以未开通三方协议,二维码缴款扫码缴款量大不方便的客户,提供接口批量代扣的业务。此接口会对接银行端查询缴款扣款接口,对接接口为另外一套,可以咨询服务商提供。