申报数据报送

接口描述

该接口是异步接口。
用于将申报表数据导入扣缴客户端进行报送。
注意:

解除劳动合同一次性补偿金、提前退休一次性补贴、全年一次性奖金所得，不能单独申报，需要同正常工资薪金一起申报。

解除劳动合同一次性补偿金、稿酬所得，由于税务规则需要，解除劳动合同一次性补偿金、稿酬所得必须填写免税附表。

综合所得、分类所得、非居民所得发起申报时，请至少传入一项收入申报。

错误码

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

请求参数

Header 参数

Content-Type

string

必需

示例值:

application/json

access_token

string

必需

通过调用access_token接口返回的access_token值

示例值:

req_date

string

必需

当前时间转为的毫秒数

示例值:

req_sign

string

签名算法得到的签名

必需

示例值:

Body 参数application/json

aggOrgId

string

维护企业信息接口返回的 aggOrgId

必需

accountId

string

账号ID

必需

skssq

string

所属期

必需

格式YYYYMM

rylb

array[object (人员报送-人员列表) {56}]

企业人员列表

必需

string

姓名

必需

zzlx

string

证件类型

必需

见证件类型枚举个税附录

zzhm

string

证件号码

必需

qtzzlx

string

其他证件类型

可选

qtzzhm

string

其他证件号码

可选

bmbh

string

部门编号

可选

部门编号已废弃，以账号密码上传接口为准

rybscl

string

人员报送策略

可选

默认逻辑“是”，仅当信息变化时才会报送信息到税局

若企业想要支持人员信息不变化的情况下，也能重新发起报送，覆盖局端信息，可修改传参为“否”

string

工号

可选

skssq

string

所属期

可选

格式YYYYMM年月

lxdh

string

电话号码

必需

11位中国大陆手机号码

nsrzt

string

人员状态

必需

默认为正常，可选择正常/非正常

sfgy

string

任职受雇类型

必需

可选择雇员、保险营销员、证券经纪人、其他、实习学生（全日制学历教育）；当任职受雇类型为“其他”时必须填写其他情况说明；

rzndjyqk

string

入职年度就业情形

可选

当雇员、保险营销员、证券经纪人时可选择：当年首次入职学生、当年首次入职其他人员。其他情况下填写默认为空

rzsgrq

string

受雇日期

必需

格式:YYYY-MM-DD,不能大于当前时间

string

性别

必需

男/女，可通过身份证号码中的第17位数字用于区分性别，奇数表示男性，偶数表示女性‌

csny

string

出生日期

必需

YYYY-MM-DD 需要和身份证上保持一致

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

邮箱

可选

string

学历

可选

默认为空，
大学本科以下
大学本科
研究生

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

户籍详细地址

可选

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类）时可填写，其他证件类型不可填写。如果有填写必须为中文。

qtqksm

string

其他情况说明

可选

当任职受雇类型为“其他”时必须填写；枚举值：扣缴申报利息股息红利所得；扣缴申报偶然所得；申报其他所得

zhsd

object

综合所得预扣预缴

可选

nsrc

string

纳税人次

可选

用于申报前校验，传值则会校验与申报计算出的人次是否一致，不一致则进行阻断

ykjse

string

应扣缴税额

可选

用于申报前校验，传值则会校验与申报计算出的应扣缴税额是否一致，不一致则进行阻断

jmfs

string

减免方式

可选

1:"比例减免方式" 2:"限额减免方式" 其他方式不传值，按照当地政策选择减免方式

jmbl

string

减免比例

可选

jmfs为1时必填，示例：10% 传0.1

jmxe

string

减免限额

可选

jmfs为2时必填，减免限额大于0

ybtse

number

应补退税额

可选

zcgzxj

object (报送-综合所得-正常工资薪金对象模型)

正常工资薪金对象

可选

qnycxjjsslb

array[object (报送-综合所得-全年一次性奖金收入模型) {12}]

全年一次性奖金收入列表

可选

gcsdlb

array[object (报送-综合所得-稿酬所得模型) {12}]

稿酬所得列表

可选

lwbclb

array[object (报送-综合所得-一般劳务报酬所得模型) {14}]

一般劳务报酬所得列表

可选

jcldhtycxbcjlb

array[object (报送-综合所得-解除劳动合同一次性补偿金) {13}]

解除劳动合同一次性补偿金列表

可选

bxyxy

object (报送-综合所得-保险营销员薪金对象)

保险营销员

可选

zqjjr

object (报送-综合所得-证券经纪人薪金对象)

证券经纪人

可选

qtlxlwbc

object (报送-综合所得-其他连续劳务报酬所得对象)

其他连续劳务报酬所得

可选

txq

array[object (报送-综合所得-特许权所得) {11}]

特许权所得

可选

qynj

array[object (报送-综合所得-企业年金) {19}]

企业年金

可选

ntycxbcjlb

array[object (报送-综合所得-内退一次性补偿金) {14}]

内退一次性补偿金

可选

syjkbxfblb

array[object (商业健康保险附表) {8}]

商业健康险附表列表

可选

工资薪金所得的商业健康险或劳务报酬的商业健康险有值时必填

jmfblb

array[object (减免附表) {7}]

减免附表列表

可选

当任一所得有减免金额时必填

syylbxfblb

array[object (税延养老保险附表) {9}]

税延养老保险附表列表

可选

综合所得中正常工资薪金或劳务报酬的税延养老保险

msfblb

array[object (免税收入附表) {7}]

免税附表列表

可选

当任一所得的免税收入有值时必填

zykcjzefb

array[object (准予扣除捐赠额附表) {11}]

准予扣除捐赠额附表

可选

当任一所得的准予扣除捐赠额有值时必填

tqtxycxbt

array[object (报送-综合所得-提前退休一次性补贴) {13}]

提前退休一次性补贴

可选

yqfzrsrhjl

array[object (报送-综合所得-央企负责人绩效薪金延期兑现收入和任期奖励) {12}]

央企负责人绩效薪金延期兑现收入和任期奖励

可选

flyzlwbclb

array[object (报送-综合所得-法律援助补贴劳务报酬) {13}]

法律援助劳务报酬所得列表

可选

flsd

object

分类所得

可选

nsrc

string

纳税人次

可选

用于申报前校验，传值则会校验与申报计算出的人次是否一致，不一致则进行阻断

ykjse

string

应扣缴税额

可选

用于申报前校验，传值则会校验与申报计算出的应扣缴税额是否一致，不一致则进行阻断

lxgxhllb

array[object (报送-分类所得-其他利息股息红利所得) {10}]

其他利息股息红利所得列表

可选

见分类所得-其他利息股息红利所得

qtcczrlb

array[object (报送-分类所得-其他财产转让所得) {14}]

其他财产转让所得列表

可选

见分类所得-其他财产转让所得

orsdlb

array[object (报送-分类所得-其他偶然所得) {10}]

其他偶然所得列表

可选

见分类所得-其他偶然所得

qtcczllb

array[object (报送-分类所得-其他财产租赁所得) {11}]

其他财产租赁列表

可选

见分类所得-其他财产租赁所得

ccpmsdjhlwwpmsdlb

array[object (报送-分类所得-财产拍卖所得及回流文物拍卖所得) {14}]

财产拍卖所得及回流文物拍卖所得

可选

见分类所得-财产拍卖所得及回流文物拍卖所得

ssgsgxhllb

array[object (报送-分类所得-上市公司股息红利所得（沪市、深市、创业板）) {11}]

上市公司股息红利所得（沪市、深市、创业板）列表

可选

见分类所得-上市公司股息红利所得（沪市、深市、创业板）

grfwczsdlb

array[object (报送-分类所得-个人房屋出租所得) {12}]

个人房屋出租所得

可选

见分类所得-个人房屋出租所得

sjzslplb

array[object (报送-分类所得-随机赠送礼品) {10}]

随机赠送礼品列表

可选

见分类所得-随机赠送礼品

sbscgxhllb

array [object {10}]

三板市场股息红利所得列表

可选

见分类所得-三板市场股息红利所得

zjzjlxlb

array[object (报送-分类所得-证券资金利息所得) {10}]

证劵资金利息所得列表

可选

见分类所得-证劵资金利息所得

sjbjjjjjlb

array[object (报送-分类所得-省级、部级、军级奖金) {10}]

省级、部级、军级奖金列表

可选

见分类所得-省级、部级、军级奖金

wgzzhgjzzjjlb

array[object (报送-分类所得-外国组织和国际组织奖金) {10}]

外国组织和国际组织奖金列表

可选

见分类所得-外国组织和国际组织奖金

jyywjjlb

array[object (报送-分类所得-见义勇为奖金) {10}]

见义勇为奖金列表

可选

见分类所得-见义勇为奖金

jbxcwffzjjlb

array[object (报送-分类所得-举报、协查违法犯罪奖金) {10}]

举报、协查违法犯罪奖金列表

可选

见分类所得-举报、协查违法犯罪奖金

yjfpjjlb

array[object (报送-分类所得-有奖发票奖金) {10}]

有奖发票奖金列表

可选

见分类所得-有奖发票奖金

shflmjjjtcjjlb

array[object (报送-分类所得-社会福利募捐奖金、体彩奖金) {13}]

社会福利募捐奖金、体彩奖金列表

可选

见分类所得-社会福利募捐奖金、体彩奖金

fjmsd

object

非居民所得代扣代缴

可选

nsrc

integer

纳税人次

可选

用于申报前校验，传值则会校验与申报计算出的人次是否一致，不一致则进行阻断

ykjse

number

应扣缴税额

可选

用于申报前校验，传值则会校验与申报计算出的应扣缴税额是否一致，不一致则进行阻断

wjgzxjlb

array[object (报送-非居民所得-无住所个人正常工资薪金) {17}]

正常工资薪金（外籍人工资薪金）列表

必需

见非居民所得-无住所个人正常工资薪金

wjrysyjjlb

array[object (报送-非居民所得-无住所个人数月奖金) {17}]

无住所个人数月奖金列表

必需

见非居民所得-无住所个人数月奖金

lwbclb

array[object (报送-非居民所得-一般劳务报酬所得) {12}]

一般劳务报酬列表

必需

见非居民所得-一般劳务报酬所得

gcsdlb

array[object (报送-非居民所得-稿酬所得) {10}]

稿酬所得列表

必需

见非居民所得-外稿酬所得

lxgxhllb

array[object (报送-非居民所得-其他利息、股息、红利所得) {10}]

其他利息股息红利列表

必需

见非居民所得-其他利息、股息、红利所得

gqzrlb

array[object (报送-非居民所得-股权转让列表) {14}]

股权转让列表

必需

见非居民所得-股权转让所得

qtcczrlb

array[object (报送-非居民所得-其他财产转让所得) {14}]

其他财产转让所得列表

必需

见非居民所得-其他财产转让所得

jcldhtycxbcjlb

array[object (报送-非居民所得-解除劳动合同一次性补偿金所得) {12}]

解除劳动合同一次性补偿金列表

必需

见非居民所得-解除劳动合同一次性补偿金所得

bxyxy

array[object (报送-非居民所得-保险营销员) {13}]

保险营销员

必需

见非居民所得-保险营销员

zqjjr

array[object (报送-非居民所得-证券经纪人) {13}]

证卷经纪人

必需

见非居民所得-证券经纪人

grgqjl

array[object (报送-非居民所得-非居民股权激励所得) {19}]

股权激励所得

必需

见非居民所得-股权激励所得

flyzlwbclb

array[object (报送-非居民所得-法律援助补贴劳务报酬) {12}]

法律援助补贴劳务报酬

可选

见非居民所得-法律援助补贴劳务报酬

ccpmsdjhlwwpmsd

array[object (报送-非居民所得-财产拍卖所得及回流文物拍卖所得) {16}]

财产拍卖所得及回流文物拍卖所得

可选

ybtse

number

应补退税额

可选

xsgsd

object (报送-限售股所得)

限售股所得税

可选

xsgsdlb

array[object (报送-限售股所得-限售股所得薪资) {10}]

限售股所得薪资列表

必需

nsrc

number

纳税人次

可选

用于申报前校验，传值则会校验与申报计算出的人次是否一致，不一致则进行阻断

ykjse

enum<string>

应扣缴税额

可选

用于申报前校验，传值则会校验与申报计算出的应扣缴税额是否一致，不一致则进行阻断

<= 1 字符

枚举值:

默认值:

示例

{
    "aggOrgId": "string",
    "accountId": "string",
    "skssq": "string",
    "rylb": [{
            "xm": "string",
            "zzlx": "string",
            "zzhm": "string",
            "qtzzlx": "string",
            "qtzzhm": "string",
            "bmbh": "string",
            "rybscl": "string",
            "gh": "string",
            "skssq": "string",
            "lxdh": "string",
            "nsrzt": "string",
            "sfgy": "string",
            "rzndjyqk": "string",
            "rzsgrq": "string",
            "xb": "string",
            "csny": "string",
            "gj": "string",
            "rydq": "string",
            "lzrq": "string",
            "grgbze": "string",
            "grgbbl": "string",
            "sfcj": "string",
            "sfls": "string",
            "sfgl": "string",
            "sfzdw": "string",
            "cjzh": "string",
            "lszh": "string",
            "dzyx": "string",
            "xl": "string",
            "zw": "string",
            "khyh": "string",
            "khyhsfmz": "string",
            "yhzh": "string",
            "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",
            "yjljsj": "string",
            "wjrlxdz_sheng": "string",
            "wjrlxdz_shi": "string",
            "wjrlxdz_qx": "string",
            "wjrlxdz_jd": "string",
            "wjrlxdz_xxdz": "string",
            "xmzw": "string"
        }
    ],
    "zhsd": {
        "nsrc": "string",
        "yingkjse": "string",
        "jmfs": "string",
        "jmbl": "string",
        "jmxe": "string",
        "zcgzxj": {
            "zcgzxjlb": [{
                    "xm": "string",
                    "zzlx": "string",
                    "zzhm": "string",
                    "sre": 0,
                    "sygs": "string",
                    "jngzts": 0,
                    "jwgzts": 0,
                    "jnzf": 0,
                    "jwzf": 0,
                    "mssd": 0,
                    "jbylaobxf": 0,
                    "jbylbxf": 0,
                    "sybxf": 0,
                    "zfgjj": 0,
                    "nj": 0,
                    "syjkbx": 0,
                    "syylbx": 0,
                    "qt": "string",
                    "bz": "string",
                    "zykcjze": 0,
                    "jmse": 0,
                    "sdxm": "string",
                    "znjyzc": 0,
                    "jxjyzc": 0,
                    "zfzjzc": 0,
                    "zfdklxzc": 0,
                    "sylrzc": 0,
                    "yyezhzc": 0,
                    "ljznjyzc": 0,
                    "ljjxjyzc": 0,
                    "ljzfzjzc": 0,
                    "ljzfdklxzc": 0,
                    "ljsylrzc": 0,
                    "ljyyezhzc": 0,
                    "ljgrylj": 0,
                    "ljgryljjym": "string"
                }
            ]

        }

    }

}

返回响应

🟢200成功

application/json

Body

reqId

string

请求id

必需

由服务器端生成的唯一标识，对应每次请求。排查接口异常时，可提供该字段方便定位

code

string | null

错误码

必需

错误码

success

boolean

是否成功标记

必需

接口是否成功（是否发生业务异常）

message

string | null

错误信息

必需

data

object

任务信息

必需

taskId

string

任务ID

必需

示例

成功示例异常示例

{
    "code": "2000",
    "data": {
        "taskId": "1000000000000001318"
    },
    "success": true,
    "reqId": "c3d9741cc9b145fca76f3411cfff672e"
}

接口描述#

错误码#

请求参数

返回响应

接口描述

错误码