Skip to content

4. 获取登录授权

企业信息获取完成以后就可以通过本接口完成登录税局授权。

4.1. 申报密码登录

通过普通的申报账号和密码获取授权后才可以调用后续的接口,授权后系统会自动处理授权时间,在授权时间内不需要再次调用,后续接口直接请求即可,出现登录失败或者授权失效就可以调用该接口。

注意:密码尝试总共5次,如果 5 次都错误,会锁定 2 小时。

"serviceid": "LOGIN"

请求:

{  
  "nsrsbh": "纳税人识别号",
  "appid": "APPID",
  "input": {
    "mm": "个税密码"
  }
}

获取:

{
  "code": "00000",
  "data": {
    "nsrsbh": "纳税人识别号",
    "token": "14e1b600b1fd579f47433b88e8d85291"
  },
  "msg": "获取成功",
  "serviceid": " LOGIN"
}

4.2. 实名登录

通过实名后的账号和密码获取授权后才可以调用后续的接口,授权后系统会自动处理授权时间,在授权时间内不需要再次调用,后续接口直接请求即可,出现登录失败或者授权失效就可以调用该接口。

"serviceid": "SMDL"

请求:

{  
  "nsrsbh": "纳税人识别号",
  "appid": "APPID",
  "input": {
    "mm": "实名后的登录密码",
    "zh": "实名后的登录账号"
  }
}

获取:

{
  "code": "00000",
  "data": {
    "nsrsbh": "纳税人识别号",
    "token": "14e1b600b1fd579f47433b88e8d85291"
  },
  "msg": "获取成功",
  "serviceid": " SMDL"
}

4.3. 实名授权校验

实名登录成功后,可以调用此接口查看授权关系是否可用。

如不可用,需要改用申报密码登录,或联系法人或财务负责人授权,否则无法使用后续接口。

"serviceid": "SMSQJY"

请求:

json
{
  "nsrsbh": "纳税人识别号",
  "appid": "APPID",
  "input": {}
}

返回:

json
{
  "msg": "授权关系校验通过",
  "nsrsbh": "纳税人识别号",
  "code": "00000",
  "data": true,
  "appid": "APPID",
  "serviceid": "SMSQJY",
  "sid": "123123123"
}
json
{
  "msg": "授权关系校验不通过",
  "nsrsbh": "纳税人识别号",
  "code": "10026",
  "data": false,
  "appid": "APPID",
  "serviceid": "SMSQJY",
  "sid": "123123123"
}

5.人员信息报送

"serviceid": "RYXXBS",

请求报文: {

  "nsrsbh": "914301117828806706",
  "appid": "123456",
  "input": {
    "jbrxm": "王五",
    "bmbh": "",
    "rymx": [
      {
        "zwxm": "李四",
        "ywxm": "",
        "sfzjlxdm": "201",
        "sfzjhm": "32132132132",
        "gjdqdm": "156",
        "sfkcjcfy": "0",
        "xbdm": "1",
        "sfcj": "0",
        "sfgl": "0",
        "sfls": "0",
        "sssydmlist": "10",
        "sfgy": "1",
        "csrq": "1988-11-01",
        "yddhhm": "15375271753",
        "rzsgrq": "2019-12-19",
        "lzrq": "2019-12-19",
        "rzsgcylxdm": "10",
        "rzndjyqxdm": ""
      },
      {
        "zwxm": "王五",
        "ywxm": "",
        "sfzjlxdm": "201",
        "sfzjhm": "32132132132112",
        "gjdqdm": "156",
        "xbdm": "1",
        "sfcj": "0",
        "sfgl": "0",
        "sfls": "0",
        "sfgy": "1",
        "csrq": "1988-11-01",
        "yddhhm": "15375271753",
        "rzsgrq": "",
        "lzrq": "2019-01-01",
        "rzsgcylxdm": "10",
        "rzndjyqxdm": ""
      }
    ]
  }
}
字段名称字段含义必填说明
jbrxm经办人姓名提交报送的人员
bmbh部门编号1-3位数字,存在分部门情况时可填写
zwxm中文姓名人员的中文名称
ywxm英文姓名人员的英文姓名
sfzjlxdm身份证件类型代码201 居民身份证 208外国护照 210港澳居民来往内地通行证 213台湾居民来往大陆通行证 216外交官证 219香港永久性居民身份证 220台湾身份证 221澳门特别行政区永久性居民身份证 227中国护照 233外国人永久居留身份证(外国人永久居留证) 237中华人民共和国港澳居民居住证 238中华人民共和国台湾居民居住证 239《中华人民共和国外国人工作许可证》(A类) 240《中华人民共和国外国人工作许可证》(B类) 241《中华人民共和国外国人工作许可证》(C类) 299其他个人证件
sfzjhm证件号码
gjdqdm国际地区代码156 中华人民共和国 158 中国台湾 643 俄罗斯联邦 840 美利坚合众国
xbdm性别代码1 男 2 女
csrq出生日期外籍人员必输 格式如1988-11-01
csddm出生地代码
yddhhm移动电话号码
rzsgrq任职受雇日期条件必录任职受雇从业类型非"其他"时必填 格式如2011-11-01
sfcj是否残疾0 否 1 是
cjzjlxdm残疾证件类型残疾时必填``11 残疾证 12 残疾军人证 13 伤残人民警察证 14 残疾消防救援人员证 15 伤残预备役人员、伤残民兵民工证 16 因公伤残人员证
cjzjhm残疾证件号码残疾时必填
sfls是否烈属0 否 1 是
lszjhm烈属证件号码烈属时必填
sfkcjcfy是否扣除减除费用系统默认为1 0 否 1 是
sfgl是否孤老0 否 1 是
sfgy是否雇员0 否 1 是 当rzsgcylxdm为10时,sfgy=1 ,其他状态sfgy=0
lzrq离职日期条件必输离职必填 格式如 2019-01-01
rzsgcylxdm任职类型代码10雇员 21保险营销员 22证券经纪人 23 实习学生(全日制学历教育) 29其他
yjljsj预计离境日期条件必输外籍人员必输 格式如: 2020-04-01
scrjsj首次入境日期条件必输外籍人员必输 格式如: 2020-04-01
sssydmlist涉税事项代码条件必输外籍人员必输 10 任职受雇 20 提供临时劳务 30 转让财产 40 从事投资和经营活动 90 其他 如果是多个,需要以逗号分隔如: 10,20,30
csdgjhdqszdm出生地国际地区代码条件必输外籍人员必输
rzndjyqxdm入职年度就业情形代码1 当年首次入职学生 99 当年首次入职其他人员
qtzjlxdm其他证件类型代码条件必输
qtzjhm其他证件号码条件必输

返回:

{
  "appid": "123456",
  "code": "00000",
  "data": [
    {
      "bsjg": "1",
      "gjdqdm": "",
      "sfzjlxdm": "201",
      "zrrxm": "万振宇",
      "nsrsbh": "12312312",
      "djsbyy": "",
      "zrrdjxh": "",
      "jdjg": "SUCCESS",
      "zrrdah": "2212",
      "sfzjhm": "2123123",
      "message": "",
      "sfyzzt": "1"
    }
  ],
  "msg": "报送成功",
  "serviceid": "RYXXBS",
  "sid": "123122123"
}
字段名称字段含义必填说明
zrrxm自然人姓名返回的人员名称
sfzjlxdm身份证件类型代码201 身份证
sfzjhm身份证件号码
gjdqdm国际地区代码156 中国
zrrdjxh自然人登记序号内部字段
zrrdah自然人档案号内部字段,个体工商户投资人需要此字段
jdjg登记结果SUCCESS 成功 其他状态失败,具体失败原因查看 message
message
sfyzzt身份验证状态0验证中 1验证成功 2验证失败,身份证可能不符合规则,需要到税局做核验。

**补充说明:人员信息报送需要确定jdjg 是SUCCESS,并且sfyzzt是1才可以进行申报。sfyzzt为0的情况是因为税局正在分批验证信息,如果姓名、证件号码和身份证一致,验证中是不影响经营所得以外报表申报的,可以不用管。 **

6. 开业设立日期查询

在登录成功后,可以通过调用此接口来获取企业的开业设立日期。

"serviceid": "KYSLRQCX"

请求:{

  "sid": "12312312333323",
  "nsrsbh": "333123",
  "appid": "123411156",
  "input": {}
}

参数说明:

字段名称字段含义必填说明

返回:

{
  "msg": "成功",
  "nsrsbh": "333123123",
  "code": "00000",
  "data": {
      "tzdwdjxh":"10000000000000000004",
      "kyslrq": "2015-09-01",
  },
  "appid": "123456",
  "serviceid": "KYSLRQCX",
  "sid": "1321333311231444"
}

字段说明:

字段名称字段含义必填说明
tzdwdjxh登记序号
kyslrq开业设立日期

7. 申报记录查询

7.1. 代扣代缴申报记录查询

"serviceid": "DKDJSBJLCX",

请求:

{
  "input": {
    "skssqq": "2022-01",
    "skssqz": "2022-12"
  },
  "nsrsbh": "914101000000000000",
  "appid": "APPID",
}

返回:

{
  "msg": "成功",
  "nsrsbh": "914101000000000000",
  "code": "00000",
  "data": [
    {
      "sblsh": "",
      "sbsj": "",
      "sbrs": "1109.0000",
      "bqsrhjhj": "200.98",
      "skssqz": "2022-12-31",
      "ybtsehj": "101.870000",
      "sbbmc": "",
      "mx": [
        {
          "sblsh": "2000000000000003",
          "sbsj": "2023-01-11",
          "sbrs": "1107",
          "bqsrhjhj": "100.68",
          "skssqz": "2022-12-31",
          "ybtsehj": "50.930000",
          "sbbmc": "综合所得预扣预缴表",
        "sbqdmc": "客户端",
          "sblx": "正常申报",
          "skssqq": "2022-12-01",
          "zcsbrq": "2023-01-11"
        },
        {
          "sblsh": "2000000000000004",
          "sbsj": "2023-01-10",
          "sbrs": "2.0000",
          "bqsrhjhj": "100.30",
          "skssqz": "2022-12-31",
          "ybtsehj": "50.940000",
          "sbbmc": "分类所得代扣代缴表",
      "sbqdmc": "客户端",
          "sblx": "正常申报",
          "skssqq": "2022-12-01",
          "zcsbrq": "2023-01-10"
        }
      ],
      "sblx": "",
      "skssqq": "2022-12-01",
      "zcsbrq": ""
    },
    {
      "sblsh": "",
      "sbsj": "",
      "sbrs": "1150.0000",
      "bqsrhjhj": "200.21",
      "skssqz": "2022-11-30",
      "ybtsehj": "101.170000",
      "sbbmc": "",
      "mx": [
        {
          "sblsh": "2000000000000001",
          "sbsj": "2022-12-14",
          "sbrs": "1148",
          "bqsrhjhj": "100.21",
          "skssqz": "2022-11-30",
          "ybtsehj": "50.460000",
          "sbbmc": "综合所得预扣预缴表",
"sbqdmc": "客户端",
          "sblx": "更正申报",
          "skssqq": "2022-11-01",
          "zcsbrq": "2022-12-12"
        },
        {
          "sblsh": "2000000000000002",
          "sbsj": "2022-12-14",
          "sbrs": "2.0000",
          "bqsrhjhj": "100.00",
          "skssqz": "2022-11-30",
          "ybtsehj": "50.710000",
          "sbbmc": "分类所得代扣代缴表",
        "sbqdmc": "客户端",
          "sblx": "正常申报",
          "skssqq": "2022-11-01",
          "zcsbrq": "2022-12-14"
        }
      ],
      "sblx": "",
      "skssqq": "2022-11-01",
      "zcsbrq": ""
    }
  ],
  "appid": "APPID",
  "serviceid": "DKDJSBJLCX",
  "sid": "SID"
}

字段说明:

字段名称字段含义必填说明
sblsh申报流水号
sbsj申报时间
sbrs申报人数
bqsrhjhj本期收入合计
skssqz税款所属期止
skssqq税款所属期起
ybtsehj应补退税额合计
sbbmc申报表名称
sbqdmc申报渠道名称
sblx申报类型正常申报/更正申报
zcsbrq最初申报日期

7.2. 综合所得单位申报记录查询

"serviceid": "SBJLCX"

请求:

{
  "nsrsbh": "纳税人识别号",
  "appid": "APPID",
  "input": {
    "skssqq": "2019-01",
    "skssqz": "2019-03"
  }
}

返回:

{
  "code": "00000",
  "data": [
    {
      "sbsj": "155244432400000",
      "sbrs": "13",
      "bqsrhjhj": "36785.0",
      "skssqz": "2019-02",
      "ybtsehj": "62.73",
      "sbbmc": "综合所得预扣预缴表",
      "sbqdmc": "客户端",
      "jylsh": "14319031310163006998",
      "sbzt": "",
      "jywysbh": "2019-02",
      "sblx": "0",
      "skssqq": "2019-02"
    },
    {
      "sbsj": "6323223434",
      "sbrs": "13",
      "bqsrhjhj": "3644785.0",
      "skssqz": "2019-02",
      "ybtsehj": "6442.73",
      "sbbmc": "汇总",
      "sbqdmc": "客户端",
      "jylsh": "",
      "sbzt": "",
      "jywysbh": "2019-02",
      "sblx": "",
      "skssqq": "2019-02"
    }
  ],
  "msg": "获取成功",
  "serviceid": "SBJLCX"
}

字段说明:

字段名称字段含义必填说明
sbsj申报时间时间戳方式
sbrs申报人数
bqsrhjhj本期收入合计
skssqz税款所属期止
skssqq税款所属期起
ybtsehj应补退税额合计
sbbmc申报表名称
sbqdmc申报渠道名称
jylsh交易流水号
sbzt申报状态
jywysbh交流网络流水号
sblx申报类型0正常申报 1 更正申报

7.3. 个人扣缴明细查询(代扣代缴)

"serviceid": "GRSBJLCX"

请求:{ "input": { "skssqq": "2023-01", "skssqz": "2023-12", "zrrdah": "110000000000000000", }, "nsrsbh": "900000000000000001", "appid": "xxxxxxxxxxxxxxxx" }

字段说明:

字段名称字段含义必填说明
skssqq税款所属期起格式如 2023-01 注意:查询的范围必须是一个年度内的属期
skssqz税款所属期止格式如 2023-12 注意:查询的范围必须是一个年度内的属期
zrrdah自然人档案号员工自然人档案号

返回:

{ "msg": "成功", "code": "00000", "data": { "fjmsdList": [], "hzList": [ { "bqjmse": 0, "syjkbx": 0, "sre": 6564, "sybxf": 0, "sdxmmc": "正常工资薪金", "ybtse": 0, "jbylbxf": 0, "qtkc": 0, "skssqq": "2023-12-01", "syylbx": 0, "zykcdjzje": 0, "ykjse": 0, "jbylbxf1": 0, "skssqz": "2023-12-31", "mssr": 0, "sdxmDm": "0101", "yjse": 0, "zfgjj": 0, "nj": 0, "jcfy": 5000 }, { "bqjmse": 0, "syjkbx": 0, "sre": 6564, "sybxf": 0, "sdxmmc": "正常工资薪金", "ybtse": 0, "jbylbxf": 0, "qtkc": 0, "skssqq": "2023-11-01", "syylbx": 0, "zykcdjzje": 0, "ykjse": 0, "jbylbxf1": 0, "skssqz": "2023-11-30", "mssr": 0, "sdxmDm": "0101", "yjse": 0, "zfgjj": 0, "nj": 0, "jcfy": 5000 } ], "xsgzrList": [], "zhsdList": [ { "zfzjzc": 0, "bqjmse": 0, "ljjmse": 0, "znjyzc": 0, "ljjxjyzc": 0, "yyezhzc": 0, "bqzxfjkchj": 0, "yxkcdsf": 0, "ljsre": 70000, "sylrzc": 0, "skssqq": "2023-12-01", "syylbx": 0, "syjkbx": 0, "sybxf": 0, "ljznjyzc": 0, "jxjyzc": 0, "bqsre": 3112, "ljzykcdjze": 0, "zfdklxzc": 0, "sskcs": 0, "skssqz": "2023-12-31", "bqqtkchj": 0, "zrrdah": "110000000000000000", "ljyyjse": 0, "nj": 0, "ljqtkchj": 0, "ljjbjcfy": 60000, "ybtse": 0, "bqfy": 0, "jbylbxf": 0, "jbylbxf1": 0, "ljmssr": 0, "bz": "", "sdxmDm": "0101", "ljzxkchj": 0, "ljzfzjzc": 0, "zfgjj": 0, "ljfy": 0, "ljynssde": 0, "bqzxkchj": 0, "sdxmmc": "正常工资薪金", "ljyyezhzc": 0, "bqmssr": 0, "ljykjse": 0, "bqyyjse": 0, "qtkcqt": 0, "sl1": 0.03, "ljzxfjkchj": 0, "bqzykcdjze": 0, "jbjcfy": 5000, "ljynse": 0, "ljzfdklxzc": 0, "ljsylrzc": 0 }, { "zfzjzc": 0, "bqjmse": 0, "ljjmse": 0, "znjyzc": 0, "ljjxjyzc": 0, "yyezhzc": 0, "bqzxfjkchj": 0, "yxkcdsf": 0, "ljsre": 63436, "sylrzc": 0, "skssqq": "2023-11-01", "syylbx": 0, "syjkbx": 0, "sybxf": 0, "ljznjyzc": 0, "jxjyzc": 0, "bqsre": 3112, "ljzykcdjze": 0, "zfdklxzc": 0, "sskcs": 0, "skssqz": "2023-11-30", "bqqtkchj": 0, "zrrdah": "110000000000000000", "ljyyjse": 0, "nj": 0, "ljqtkchj": 0, "ljjbjcfy": 55000, "ybtse": 0, "bqfy": 0, "jbylbxf": 0, "jbylbxf1": 0, "ljmssr": 0, "bz": "", "sdxmDm": "0101", "ljzxkchj": 0, "ljzfzjzc": 0, "zfgjj": 0, "ljfy": 0, "ljynssde": 0, "bqzxkchj": 0, "sdxmmc": "正常工资薪金", "ljyyezhzc": 0, "bqmssr": 0, "ljykjse": 0, "bqyyjse": 0, "qtkcqt": 0, "sl1": 0.03, "ljzxfjkchj": 0, "bqzykcdjze": 0, "jbjcfy": 5000, "ljynse": 0, "ljzfdklxzc": 0, "ljsylrzc": 0 } ], "flsdList": [] }, "nsrsbh": "900000000000000001", "appid": "xxxxxxxxxxxxxxxx", "serviceid": "GRSBJLCX", "sid": "ssssssss" }

字段说明:

字段名称字段含义必填说明
hzList汇总
zhsdList综合所得申报表
flsdList分类所得申报表
fjmsdList非居民所得申报表
xsgzrList限售股所得申报表
skssqq税款所属期起
skssqz税款所属期止
sdxmmc所得项目名称
sdxmDm所得项目代码
sre收入
mssr免税收入
jcfy减除费用
jbylbxf基本养老保险费
jbylbxf1基本医疗保险费
sybxf失业保险费
zfgjj住房公积金
nj年金
syjkbx商业健康保险
syylbx税延养老保险
qtkc其他扣除
bqjmse减免税额
ykjse应扣缴税额
yjse已缴税额
ybtse应补退税额
bqsre本期收入额
bqfy本期费用
bqmssr本期免税收入
jbjcfy本期减除费用
jbylbxf本期专项扣除基本养老保险费
jbylbxf1本期专项扣除基本医疗保险费
sybxf本期专项扣除基本失业保险费
zfgjj本期专项扣除住房公积金
nj本期其他扣除年金
syjkbx本期其他扣除商业健康保险
syylbx本期其他扣除税延养老保险
yxkcdsf本期允许扣除的税费
qtkcqt本期其他扣除其他
bqzykcdjze本期准予扣除的捐赠额
ljsre累计收入
ljjbjcfy累计减除费用
ljzxkchj累计专项扣除
ljznjyzc累计专项附加扣除子女教育
ljsylrzc累计专项附加扣除赡养老人
ljzfdklxzc累计专项附加扣除住房贷款利息
ljzfzjzc累计专项附加扣除租房租金
ljjxjyzc累计专项附加扣除继续教育
ljyyezhzc累计专项附加扣除3岁一下婴幼儿照护
ljzxfjkchj累计专项附加扣除合计
累计个人养老金
ljqtkchj累计其他扣除
ljzykcdjze累计准予扣除的捐赠额
ljynssde应纳税所得额
sl1税率/预扣率
sskcs速算扣除数
ljynse应纳税额
ljjmse减免税额
ljykjse应扣缴税额
ljyyjse已缴税额
ybtse应补退税额
bz备注

7.4. 员工汇算申报状态查询

"serviceid": "YGHSSBZTCX"

请求:{ "input": { "zrrdahList": [ "110000000000000005", "110000000000000008" ], "skssnd": "2022", "sbzt": "" }, "nsrsbh": "900000000000000001", "appid": "xxxxxxxxxxxxxxxx" }

字段说明:

字段名称字段含义必填说明
zrrdahList自然人档案号员工自然人档案号
skssnd税款所属年度格式如 2023
sbzt申报状态YSB已申报,WSB未申报,空所有

返回:

{ "msg": "成功", "code": "00000", "data": [ { "code": "WSB", "xm": "张三", "skssnd": "2022", "zrrdah": "110000000000000005", "sfzjhm": "5000000000000000", "message": "该人员2022年综合所得年度汇算【未申报】,请与员工确认是否需申报。", "sfzjlxmc": "居民身份证" }, { "code": "WSB", "xm": "李四", "skssnd": "2022", "zrrdah": "110000000000000008", "sfzjhm": "5000000000000000", "message": "该人员2022年综合所得年度汇算【未申报】。", "sfzjlxmc": "居民身份证" } ], "nsrsbh": "900000000000000001", "appid": "xxxxxxxxxxxxxxxx", "serviceid": "YGHSSBZTCX", "sid": "ssssssss" }

字段说明:

字段名称字段含义必填说明
code汇算申报状态WSB未申报,YSB已申报
xm姓名
skssnd税款所属年度
zrrdah自然人档案号
sfzjhm身份证件号码
message消息提示
sfzjlxmc身份证件类型名称

7.5. 代开发票信息查询

"serviceid": "DKFPXXCX"

请求:

{
  "nsrsbh": "900000000000000001",
  "appid": "xxxxxxxxxxxxxxxx",
  "input": {
    "pageNumber": 1,
    "pageSize": 1000,
    "kprqq": "2024-09-01",
    "kprqz": "2024-09-30"
  }
}

字段说明:

字段名称字段含义必填说明
pageNumber页码默认1
pageSize条数默认1000,最大10000
kprqq开票日期起格式如 2024-09-01
kprqz开票日期止格式如 2024-09-30 开票日期起止跨度不超过12个月

返回:

{
  "data": {
    "total": "1",
    "mxList": [
      {
        "sfzjlxDm": "201",
        "gjhdqszDm": "156",
        "fpDm": "033001111111",
        "hwlwmc": "*运输服务*冰箱",
        "sdxmmc": "劳务报酬所得",
        "se": "50.00",
        "xm": "张三",
        "kprq": "2024-09-09",
        "sl": "0.01",
        "sdxmDm": "101060400",
        "jshj": "5050.00",
        "sfzjhm": "410111111111111111",
        "bhsje": "5000.00",
        "sfzjlxmc": "居民身份证",
        "fphm": "43311111"
      }
    ]
  },
  "nsrsbh": "900000000000000001",
  "appid": "xxxxxxxxxxxxxxxx",
  "sid": "ssssssss",
  "serviceid": "DKFPXXCX",
  "msg": "成功",
  "code": "00000"
}

字段说明:

字段名称字段含义必填说明
total总条数
mxList明细信息
xm代开人姓名
sfzjlxDm身份证件类型代码
sfzjlxmc身份证件类型名称
sfzjhm身份证件号码
fphm发票号码
fpDm发票代码
kprq开票日期
hwlwmc货物劳务服务名称
bhsje金额
sl税率
se税额
jshj价税合计
sdxmDm所得项目代码
sdxmmc所得项目名称
gjhdqszDm国际地区代码

8.获取综合所得申报累计数据

获取申报累计数据(用来算税),入参的属期是当前申报的属期,比如属期入参是3月份,此时返回的是针对3月份算税所需要的累计数据。(请在调用前咨询服务商这里的规则)

"serviceid": "HQWQSBSJ2"

请求:{

  "nsrsbh": "企业纳税人识别号",
  "appid": "123456",
  "input": {
    "skssqq": "2019-04-01",
    "skssqz": "2019-04-30",
    "bmbh": "01",
"jcfyyg": "0"
  }
}

请求字段说明:

字段名称字段含义必填说明
skssqq税款所属期起格式yyyy-MM-dd
skssqz税款所属期止格式yyyy-MM-dd
bmbh部门编号默认为空即可,针对分部门的情况,需要传部门编号
jcfyyg减除费用预估1使用预估 0不预估 使用预估时,返回值会根据人员的任职受雇日期计算累计基本减除费用的估值

返回:

{
  "msg": "成功",
  "code": "00000",
  "nsrsbh": "915100000000000000",
  "data": {
    "wqsbjlmx": [
      {
        "ljqtkcHj": "0",
        "ljjmse": "0",
        "sfzjlxdm": "",
        "ljfy": "0",
        "zrrdjxh": "",
        "ljjxjyzc": "",
        "ljyiyujse": "104",
        "ljznjyzc": "",
        "ljjbjcfy": "10000",
        "ybtse": "4",
        "ljsre": "14200",
        "ljzykcdjze": "0",
        "xh": "1",
        "xm": "",
        "ljmssr": "0",
        "gjhdqDm": "",
        "sdxmDm": "0101",
        "ljzxkcHj": "0",
        "ljzxfjkcHj": "",
        "zrrdah": "110000000000000006",
        "ljzfzjzc": "",
        "sfzjhm": "",
        "ljzfdklxzc": "",
        "ljsylrzc": ""
      }
    ]
  },
  "appid": "aaaabbbbccccdddd",
  "serviceid": "HQWQSBSJ2",
  "sid": "123456e"
}
*字段名称**字段含义**必填**说明*
xh序号1开始
xm人员姓名废弃 需要通过RYXXBS报送关联
gjhdqdm国际地区代码156 中国 废弃 需要通过RYXXBS报送关联
ljqtkcHj累计其他扣除合计
ljjmse累计减免税额
sfzjlxdm身份证件类型代码废弃 需要通过RYXXBS报送关联
ljfy累计费用
ljjbjcfy累计基本减除费用
ljjbjcfyyg累计基本减除费用预估入参jcfyyg1时会返回该字段
ljsre累计收入额
ljzykcdjze累计准予扣除的捐赠额
zrrdjxh自然人登记序号
ljmssr累计免税收入
sdxmDm所得项目代码0101
ljzxkcHj累计专项扣除合计
ljzxfjkcHj累计专项附加扣除额废弃 ,可以自己通过所属期期数*****每次专项附加扣除金额算得累计
zrrdah自然人档案号人员报送时返回的自然人档案号
sfzjhm身份证件号码
ybtse应补退税额
ljyiyujse累计已预缴税额

9.获取专项扣除信息(针对员工数少于50人,兼容老版本**)*

"serviceid": "HQZXKCXX"

请求:

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

返回:

{ "code": "00000", "data": [ { "sbzxfjkcfcxxdtos": [ { "sfypo": "Y", "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 2153246, "sbkcnd": "2019", "fwzslxdm": "02", "fwszddm": "143123", "zsh": "", "yxbz": "Y", "zxfjkclxdm": "0204", "kcyxqq": 13451435, "sfgzkc": "N", "sbzxfjkcfdxxdtos": [ { "fdlxdm": "2", "kcyxqz": 12341234, "schkrq": 435647654, "dkjsrq": 34563, "kcyxqq": 5634, "dkys": 240 } ], "jzdxxdz": "", "nsrposfzjlxdm": "201", "cjlsh": 452345, "kcyxqz": 23452345, "nsrpoxm": "张三", "fpbl": 100, "ywzy": "7823", "slswjgdm": "23452345", "dkrsfbr": "Y", "nsrposfzjhm": "643734******", "jyqddm": "11", "requestid": "56785678", "kjywrdah": "8567856", "cjxh": 4568, "zrrdah": 53675467, "cjrdah": "6745" } ], "sbzxfjkcznjyfydtos": [ { "sfypo": "Y", "csrq": 5674567, "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 7456745, "sbkcnd": "2019", "jdgjhdqszdm": "156", "jdxx": "", "sjyjddm": "40", "yxbz": "Y", "zxfjkclxdm": "0201", "kcyxqq": 674567, "sfzjhm": "45674567", "sjyrqq": 1654, "nsrposfzjlxdm": "201", "cjlsh": 134513, "kcyxqz": 135134, "sfzjlxdm": "201", "gjhdqszdm": "156", "nsrpoxm": "张三", "fpbl": 100, "ywzy": "13451345", "slswjgdm": "1345134", "nsrposfzjhm": "13451******", "jyqddm": "11", "xm": "子女姓名", "requestid": "13451345", "kjywrdah": "451345", "cjxh": 3451345, "zrrdah": 451345, "cjrdah": "1345" } ], "sbzxfjkcsylrxxdtos": [ { "csrq": -1251345, "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 12541345, "sbkcnd": "2019", "nsrsjhm": "1374748", "yxbz": "Y", "zxfjkclxdm": "0206", "kcyxqq": 13451345, "sfzjhm": "430103**", "cjlsh": 341513451345, "ynsrgxdm": "5", "kcyxqz": 125125, "sfzjlxdm": "201", "gjhdqszdm": "156", "nsrsf": "20", "ywzy": "1435134", "ftfsdm": "1", "slswjgdm": "13451345", "sbzxfjkcgtsyrxxdtos": [ { "sfzjlxdm": "201", "gjhdqszdm": "156", "xm": "王五", "ywzy": "1235125", "sfzjhm": "34551345******" } ], "jyqddm": "11", "xm": "李四", "requestid": "531513451", "kjywrdah": "45134", "cjxh": 13451345, "ftje": 1000, "zrrdah": 34123431, "cjrdah": "12341234" } ], "sbzxfjkcfxljxjydtos": [], "zrrdah": 324645634563456, "sbzxfjkcxljxjydtos": [], "clzt": "SUCCESS", "sbzxfjkcdbylfydtos": [], "sbzxfjkczfzjfydtos": [] }, { "sbzxfjkcfcxxdtos": [], "sbzxfjkcznjyfydtos": [], "sbzxfjkcsylrxxdtos": [ { "csrq": -1451234, "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 145345, "sbkcnd": "2019", "nsrsjhm": "1341234", "yxbz": "Y", "zxfjkclxdm": "0206", "kcyxqq": 123412345, "sfzjhm": "430321******", "cjlsh": 345634, "ynsrgxdm": "5", "kcyxqz": 2345666645, "sfzjlxdm": "201", "gjhdqszdm": "156", "nsrsf": "20", "ywzy": "23452345", "ftfsdm": "2", "slswjgdm": "23452345", "jyqddm": "11", "xm": "测试", "requestid": "23452345", "kjywrdah": "23452345", "cjxh": 324523452345, "ftje": 1000, "zrrdah": 234562456, "cjrdah": "542352345" } ], "sbzxfjkcfxljxjydtos": [], "zrrdah": 5123412341235, "sbzxfjkcxljxjydtos": [], "clzt": "SUCCESS", "sbzxfjkcdbylfydtos": [], "sbzxfjkczfzjfydtos": [] }, { "sbzxfjkcfcxxdtos": [ { "sfypo": "Y", "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 4567456745671, "sbkcnd": "2019", "fwzslxdm": "01", "fwszddm": "430111", "zsh": "", "yxbz": "Y", "zxfjkclxdm": "0204", "kcyxqq": 34563456, "sfgzkc": "N", "sbzxfjkcfdxxdtos": [ { "fdlxdm": "2", "zfdkhtbh": "", "kcyxqz": 563456, "schkrq": 45634567456, "dkjsrq": 34563456, "kcyxqq": 345634, "dkyhmc": "", "dkys": 240 } ], "jzdxxdz": "", "nsrposfzjlxdm": "201", "cjlsh": 2345234523466, "kcyxqz": 4523452345, "nsrpoxm": "测试2", "fpbl": 100, "ywzy": "345234523452", "slswjgdm": "23452345234", "dkrsfbr": "Y", "nsrposfzjhm": "2345234532******", "jyqddm": "11", "requestid": "234523452345", "kjywrdah": "523452345234", "cjxh": 234523452, "zrrdah": 453523452345, "cjrdah": "5324523452345" } ], "sbzxfjkcznjyfydtos": [ { "sfypo": "Y", "csrq": 345634561234, "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 3246234564356, "sbkcnd": "2019", "jdgjhdqszdm": "156", "jdxx": "", "sjyjddm": "40", "yxbz": "Y", "zxfjkclxdm": "0201", "kcyxqq": 45634577, "sfzjhm": "563456", "sjyrqq": 563456, "nsrposfzjlxdm": "201", "cjlsh": 52345, "kcyxqz": 32452345, "sfzjlxdm": "201", "gjhdqszdm": "156", "nsrpoxm": "配偶姓名", "fpbl": 4563456, "ywzy": "674567", "slswjgdm": "45674567", "nsrposfzjhm": "34563456******", "jyqddm": "11", "xm": "子女名称", "requestid": "4523454235", "kjywrdah": "452345", "cjxh": 452345, "zrrdah": 52345, "cjrdah": "234523452" } ], "sbzxfjkcsylrxxdtos": [ { "nsrtxdz": "通信地址", "csrq": -12341234, "cjrlxdm": "01", "kjywrlbdm": "1", "cjrq": 23432145235, "sbkcnd": "2019", "nsrsjhm": "1253424652345", "yxbz": "Y", "zxfjkclxdm": "0206", "kcyxqq": 12345463456, "sfzjhm": "430124******", "cjlsh": 324523456645, "ynsrgxdm": "5", "kcyxqz": 234523452345, "nsrdzyx":"电子邮箱", "sfzjlxdm": "201", "gjhdqszdm": "156", "nsrsf": "20", "ywzy": "234664563456", "ftfsdm": "1", "slswjgdm": "5543252345", "sbzxfjkcgtsyrxxdtos": [ { "sfzjlxdm": "201", "gjhdqszdm": "156", "xm": "测试", "ywzy": "12341234", "sfzjhm": "553453******" } ], "jyqddm": "11", "xm": "测试的子女名称", "requestid": "664563456", "kjywrdah": "5634563456", "cjxh": 44445, "ftje": 1112, "zrrdah": 3452345, "cjrdah": "2345234" } ], "sbzxfjkcfxljxjydtos": [ { "zsbh": "******", "slswjgdm": "5543252345", "cjrq": 1676390400000, "sbkcnd": "2023", "yxbz": "y", "jyqddm": "11", "kcyxqq": 1672502400000, "xgrq": 1676449511000, "zsqdsj": 1675872000000, "fxljxjylxdm": "22", "cjlsh": 1000001752534121, "fzjg": "发证机关", "kcyxqz": 1703952000000, "cjrlxdm": "01", "ywzy": "2b8ae20bf30crf675ed131633er9303a", "kjywrlbdm": "1", "zxfjkclxdm": "0202", "requestid": "773aa89e222288672fbbee1111c72c45", "zsmc": "xxxx专业技术资格", "kjywrdah": "5634563456", "xxxx": "xxxxxxxxxx", "cjxh": 1000000000000088, "zrrdah": 110000000000111222, "cjrdah": "110000000000111222", "zsdm": "12400" } ], "zrrdah": 534523452345, "sbzxfjkcxljxjydtos": [], "clzt": "SUCCESS", "sbzxfjkcdbylfydtos": [], "sbzxfjkczfzjfydtos": [] } ], "msg": "获取成功", "serviceid": "HQZXKCXX" }

9.1.房产贷款专项附加扣除信息

sbzxfjkcfcxxdtos

字段名称字段含义必填说明
sfypo是否有配偶Y是 N否
cjrlxdm采集人类型代码01
kjywrlbdm扣缴义务人类别代码1
cjrq采集日期格式 1548086400000
sbkcnd申报扣除年度例如:2019
fwzslxdm房屋证书类型代码[{ "dm": "01", "mc": "房屋所有权证" }, { "dm": "02", "mc": "不动产权证" }, { "dm": "03", "mc": "房屋买卖合同" }, { "dm": "04", "mc": "房屋预售合同" }]
fwszddm房屋所在地代码
zsh房屋证书号
yxbz有效标志Y是 N否
zxfjkclxdm专项附加扣除类型代码0204 房产
kcyxqq扣除有效期起例如:1546272000000
jzdxxdz
nsrposfzjlxdm配偶证件类型代码201 身份证
cjlsh采集流水号
kcyxqz扣除有效期止
nsrpoxm配偶姓名
fpbl分配比例
slswjgdm受理税务机关代码
ywzy
dkrsfbr贷款人是否本人Y是 N否
nsrposfzjhm配偶证件号码
jyqddm交易渠道代码11
requestid
kjywrdah扣缴义务人档案号
cjxh采集序号
zrrdah自然人档案号
cjrdah采集人档案号
fdlxdm房贷类型代码2 商业贷款 1 公积金贷款
zfdkhtbh住房贷款合同编号
kcyxqz扣除有效期止
schkrq首次还款日格式如 1183132800000
dkjsrq贷款
kcyxqz扣除有效期止1546272000000
dkyhmc贷款银行名称***
dkys贷款月数240

9.2子女教育专项附加扣除信息

sbzxfjkcznjyfydtos

字段名称字段含义必填说明
sfypo是否有配偶Y是 N否
csrq出生日期例如853948800000
cjrlxdm采集人类型代码01
kjywrlbdm扣缴义务人类别代码1
cjrq采集日期
sbkcnd申报扣款年度
jdgjhdqszdm国际地区代码156
jdxx就读学校
sjyjddm受教育阶段代码10:学前教育阶段 20:义务教 30:高中阶段教育 40:高等教育 41:专科 42:本科 43:硕士研究生 44:博士研究 90:其他
yxbz有效标志Y有效 N无效
zxfjkclxdm专项附加扣除类型代码0201
kcyxqq扣除有效期起1546272000000
sfzjhm身份证件号码***
sjyrqq受教育日期起
ynsrgxdm子女与员工的关系1 配偶 2 子 3 女 5 父母 6 祖(外祖)父母 8 其他
nsrposfzjlxdm配偶身份证件类型代码201 身份证
cjlsh采集流水号
kcyxqz扣除有效期止
sfzjlxdm身份证类型代码
gjhdqszdm国际地区代码
nsrpoxm配偶姓名
fpbl分配比例
slswjgdm受理税务机关代码
nsrposfzjhm配偶证件号码
xm子女姓名
kjywrdah扣缴义务人档案号
cjxh采集序号
zrrdah自然人档案号
cjrdah采集人档案号

9.3. 赡养老人专项附加扣除信息

sbzxfjkcsylrxxdtos

字段名称字段含义必填说明
nsrtxdz通信地址
csrq出生日期例如853948800000
cjrlxdm采集人类型代码01
kjywrlbdm扣缴义务人类别代码1
cjrq采集日期
sbkcnd申报扣款年度
nsrsjhm手机号码
yxbz有效标志Y有效 N无效
zxfjkclxdm专项附加扣除类型代码0206
kcyxqq扣除有效期起1546272000000
sfzjhm身份证件号码***
sjyrqq受教育日期起
ynsrgxdm被赡养人与员工的关系1 配偶 2 子 3 女 5 父母 6 祖(外祖)父母 8 其他
xm共同赡养人姓名
nsrdzyx电子邮箱
nsrsf纳税人身份10 独生子女 20 非独生子女
ftfsdm分摊方式代码1 赡养人平均分摊 2 赡养人约定分摊 3 被赡养人指定分摊
cjlsh采集流水号
kcyxqz扣除有效期止
sfzjlxdm身份证类型代码
gjhdqszdm国际地区代码
nsrpoxm配偶姓名
ftje分摊金额
slswjgdm受理税务机关代码
nsrposfzjhm配偶证件号码
xm被赡养人姓名
kjywrdah扣缴义务人档案号
cjxh采集序号
zrrdah自然人档案号
cjrdah采集人档案号

9.4.继续教育专项附加扣除信息

9.4.1. 学历(学位)继续教育

sbzxfjkcxljxjydtos

字段名称字段含义必填说明
yjbysj预计毕业时间
kcyxqz扣除有效期止
cjrlxdm采集人类型代码
kjywrlbdm扣缴业务人类别代码
slswjgdm受理税务机关代码
cjrq采集日期
rxsj入学时间
sbkcnd申报扣除年度
yxbz有效标志
zxfjkclxdm专项扣除类型代码
jyqddm交易渠道代码
kcyxqq扣除有效期起
xljxjyjd学历教育阶段11 博士研究生 14 硕士研究生 20 大学本科 30 大学专科 91 其他
kjywrdah扣缴义务人档案号
cjxh采集序号
zrrdah自然人档案号
cjrdah采集人档案号
cjlsh采集流水号

9.4.2. 职业资格继续教育(非学历)

sbzxfjkcfxljxjydtos

字段名称字段含义必填说明
zsbh证书编号******已脱敏
slswjgdm受理税务机关代码
cjrq采集日期
sbkcnd申报扣除年度
yxbz有效标志
jyqddm渠道代码
kcyxqq扣除有效期起
xgrq更新日期
zsqdsj发证(批准)日期
fxljxjylxdm继续教育类型21 技能人员职业资格 22 专业技术人员职业资格
cjlsh采集流水号
fzjg发证机关
kcyxqz扣除有效期止
cjrlxdm采集人类型代码
kjywrlbdm扣缴业务人类别代码
zxfjkclxdm专项扣除类型代码0202
zsmc证书名称
kjywrdah扣缴义务人档案号
cjxh采集序号
zrrdah自然人档案号
cjrdah采集人档案号
zsdm证书代码

9.5. 住房租金专项附加扣除信息

sbzxfjkczfzjfydtos

字段名称字段含义必填说明
sfypo是否有配偶Y是N 否
zlrqz租赁日期止格式如1572537700000
czrsfzjhm出租人身份证件号码
slswjgdm受理税务机关代码
cjrq采集日期
sbkcnd申报扣除年度例如2019
zlrqq租赁日期起格式如1509465700000
nsrsjhm纳税人手机号码
yxbz有效标志
jyqddm交易渠道代码
kcyxqq扣缴有效期起
jzdxxdz
gzcsxzqhdm工作城市现在区号代码格式如320100
kcyxqz扣除有效期止
cjrlxdm采集人类型代码
nsrpoxm配偶姓名
fwszddm房屋所在地代码
zxfjkclxdm专项扣除类型代码0205
nsrposfzjhm配偶证件号码
czrsfzjlxdm出租人证件号码
czrxm出租人姓名***
nsrposfzjlxdm配偶身份证件类型代码

9.6.婴幼儿照护费用专项附加扣除信息

sbzxfjkcyyezhfydtos

字段名称字段含义必填说明
cjlsh采集流水号
cjxh采集序号
zrrdah自然人档案号
zxfjkclxDm专项附加扣除类型代码0207
cjrlxDm采集人类型代码01
cjrq采集日期格式如1648569600000
xgrq修改器日格式如1648607220000
cjrdah采集人档案号
kjywrlbDm扣缴业务人类别代码
kjywrdah扣缴义务人档案号
sbkcnd申报扣除年度格式如 2022
kcyxqq扣除有效期起格式如1640966400000
kcyxqz扣除有效期止格式如1651248000000
yxbz有效标志
slswjgDm受理税务机关代码
jyqdDm交易渠道代码
requestid
mxbglxDm
ywzy
kzztDm
nsrsjhm纳税人手机号码
nsrdzyx电子邮箱
nsrtxdz通信地址
zndah
xm婴幼儿姓名
sfzjlxDm身份证件类型代码
sfzjhm身份证件号码
gjhdqszDm国际地区代码
csrq出生日期格式如1557331200000
fpbl分配比例格式如100
jtcyxh
jtcyJybz
swbz
swbzgxsj
ynsrgxDm与纳税人关系代码1 配偶 2 子 3 女 5 父母 6 祖(外祖)父母 8 其他