## 接口说明
当任务执行完毕时,会根据创建公司时提供的回调地址发送POST请求,需要你根据[签名认证](https://www.kancloud.cn/shoottech/opentax/2457405)进行参数校验
## 回调参数
参数名 | 数据类型 | 描述
--- | --- | ---
task_id | string | 任务id
notify_type | string | 回调类型,参考下面说明
task_state | int | 任务状态,参考下面说明
task_code | int | 任务代码
task_msg | string | 任务信息
img_url | string | 任务执行结果截图地址
tax_price | object | 税额信息
content | array | 回调内容,不同的回调类型返回不同内容
#### * 任务状态
task_state | 任务状态说明
--- | ---
-1 | 执行错误
-2 | 任务已中止
0 | 准备执行
1 | 成功
2 | 执行中
3 | 等待验证码,可通过 [验证码上传](https://www.kancloud.cn/shoottech/opentax/2649470) 接口,上传验证码信息
4 | 税额待确认,可通过 [确认税额](https://www.kancloud.cn/shoottech/opentax/2536980) 接口直接申报;也可以通过 [中止任务](https://www.kancloud.cn/shoottech/opentax/2463021) 接口中止任务,待修改报表后,重新提交任务
5 | 税额已确认
6 | 更正申报
#### * 回调类型
notify_type | 描述
--- | ---
tax_category_state | 税种状态,回调内容是当月需申报的税种以及申报状态,字段说明请参考 [需申报税种信息](https://www.kancloud.cn/shoottech/opentax/2457411)
task_state_change | 报税任务状态发送改变
wage_tax_report | 工资薪金所得信息回调,相关字段说明参考 [工资薪金所得报表](https://www.kancloud.cn/shoottech/opentax/2591449)
### 回调例子
1. 税种状态回调内容 `notify_type = tax_category_state`
~~~
{
"task_id": "1655434272zxmtqiyj",
"task_state": 1,
"task_code": 0,
"task_msg": "",
"tax_type": 1,
"notify_type": "tax_category_state",
"extra": "",
"content": [
{
"tax_category": [
{
"tax_category_id": 27,
"tax_category_name": "增值税",
"option_name": "文化服务",
"term": "月",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0.03",
"rate": "0.06"
},
{
"tax_category_id": 22,
"tax_category_name": "城市维护建设税",
"option_name": "县城、镇(增值税附征)",
"term": "月",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0.05"
},
{
"tax_category_id": 23,
"tax_category_name": "教育费附加",
"option_name": "增值税教育费附加",
"term": "月",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0.03"
},
{
"tax_category_id": 24,
"tax_category_name": "地方教育附加",
"option_name": "增值税地方教育附加",
"term": "月",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0.02"
}
],
"time": {
"term": 1,
"year": 2022,
"month": 5,
"quarter": 2
},
"scope": "zzs",
"report": [
"zzsjfzsfsbb_yb"
],
"tax": {
"img_url": "https://res.aihouyi.com/pro_tax_report/202206/91310230MA9JUC5321_4353.jpg?t=1655798499",
"tax_time": 1655222400,
"begin_time": 1651334400,
"end_time": 1653926400,
"tax_money": 0,
"category_name": "增值税及附加税费申报表(一般纳税人适用)",
"rate": [
{
"name": "增值税",
"rate": null,
"tax": "0.00"
},
{
"name": "城市维护建设税",
"rate": 0.05,
"tax": "0.00"
},
{
"name": "教育费附加",
"rate": 0.03,
"tax": "0.00"
},
{
"name": "地方教育附加",
"rate": 0.02,
"tax": "0.00"
}
]
}
},
{
"tax_category": [
{
"tax_category_id": 8,
"tax_category_name": "个人所得税",
"option_name": "工资薪金所得",
"term": "月",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0.03"
}
],
"time": {
"term": 1,
"year": 2022,
"month": 5,
"quarter": 2
},
"scope": "gzxjsd",
"report": [
"gzxjsdsbb"
]
},
{
"tax_category": [
{
"tax_category_id": 28,
"tax_category_name": "财务报表",
"option_name": "小企业会计准则",
"term": "季",
"begin_time": 1625068800,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0"
}
],
"time": {
"term": 2,
"year": 2022,
"month": 5,
"quarter": 2
},
"scope": "cwbb",
"report": [
"cb_zcfzb_yb",
"cb_lrb_yb",
"cb_xjllb_yb"
]
},
{
"tax_category": [
{
"tax_category_id": 13,
"tax_category_name": "企业所得税",
"option_name": "应纳税所得额",
"term": "季",
"begin_time": 1569859200,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0.25"
}
],
"time": {
"term": 2,
"year": 2022,
"month": 5,
"quarter": 2
},
"scope": "qysds",
"report": [
"qysdsalyj"
]
},
{
"tax_category": [
{
"tax_category_id": 29,
"tax_category_name": "财务报表",
"option_name": "小企业会计准则",
"term": "年",
"begin_time": 1625068800,
"end_time": 253402185600,
"collect_rate": "0",
"rate": "0"
}
],
"time": {
"term": 3,
"year": 2022,
"month": 5,
"quarter": 2
},
"scope": "cwbb",
"report": [
"cb_zcfzb_yb",
"cb_lrb_yb",
"cb_xjllb_yb"
]
}
]
}
~~~
2. 报税任务状态发送改变 `notify_type=task_state_change` 个税申报有税额产生的情况下
~~~
{
"task_id": "1646818360saahdtwz",
"task_state": 4,
"task_code": -108,
"task_msg": "本次任务申报类型=1, 用户默认税额=0, 实际税额=10.95",
"tax_price": {
"gzxjsdsbb": 10.95
},
"img_url": "https://res.aihouyi.com/pro_person_tax_task/xxx.jpg?t=1646821594",
"notify_type": "task_state_change",
"content": [
{
"month": 1643644800,
"gh": "1723",
"xm": "小明",
"zjlx": "居民身份证",
"zjhm": "44002619901010513X",
"skssqq": "2022-02-01",
"skssqz": "2022-02-28",
"sdxm": "正常工资薪金",
"bqsr": 6000,
"bqfy": 0,
"bqmssr": 0,
"bqjbpbxf": 484,
"bqjbmbxf": 121,
"bqsybxf": 30.25,
"bqzfgjj": 0,
"bqqyzynj": 0,
"bqsyjkbxf": 0,
"bqsyylbxf": 0,
"bqqtkcqt": 0,
"ljsre": 12000,
"ljmssr": 0,
"ljjcfy": 10000,
"ljzxkc": 1270.5,
"ljznjyzckc": 0,
"ljjxjyzckc": 0,
"ljzfdklxzckc": 0,
"ljzfzjzckc": 0,
"ljsylrzckc": 0,
"ljqtkc": 0,
"ljzykcdjz": 0,
"ljynssde": 729.5,
"sl": "0.03",
"sskcs": 0,
"ljynse": 21.89,
"ljjmse": 0,
"ljykjse": 21.89,
"ljyyjse": 10.94,
"ljybtse": 10.95,
"bz": ""
}
]
}
~~~
3. 报税任务完成,工资薪金所得信息回调 `notify_type=wage_tax_report` 个税申报且没有税额产生的情况下
~~~
{
"task_id": "1647239222aagvnfqw",
"task_state": 1,
"task_code": 1,
"task_msg": "",
"tax_price": {
"gzxjsdsbb": 0
},
"img_url": "https://res.aihouyi.com/pro_person_tax_task/tax/xxx.jpg?t=1647239484",
"notify_type": "wage_tax_report",
"content": [
{
"month": 1643644800,
"gh": "3490",
"xm": "狄仁杰",
"zjlx": "居民身份证",
"zjhm": "330022196306044327",
"skssqq": "2022-02-01",
"skssqz": "2022-02-28",
"sdxm": "正常工资薪金",
"bqsr": 3800,
"bqfy": 0,
"bqmssr": 0,
"bqjbpbxf": 0,
"bqjbmbxf": 0,
"bqsybxf": 0,
"bqzfgjj": 0,
"bqqyzynj": 0,
"bqsyjkbxf": 0,
"bqsyylbxf": 0,
"bqqtkcqt": 0,
"ljsre": 3800,
"ljmssr": 0,
"ljjcfy": 5000,
"ljzxkc": 0,
"ljznjyzckc": 0,
"ljjxjyzckc": 0,
"ljzfdklxzckc": 0,
"ljzfzjzckc": 0,
"ljsylrzckc": 0,
"ljqtkc": 0,
"ljzykcdjz": 0,
"ljynssde": 0,
"sl": "0.03",
"sskcs": 0,
"ljynse": 0,
"ljjmse": 0,
"ljykjse": 0,
"ljyyjse": 0,
"ljybtse": 0,
"bz": ""
},
{
"month": 1643644800,
"gh": "1283",
"xm": "王小二",
"zjlx": "居民身份证",
"zjhm": "44002119790104314X",
"skssqq": "2022-02-01",
"skssqz": "2022-02-28",
"sdxm": "正常工资薪金",
"bqsr": 5132,
"bqfy": 0,
"bqmssr": 0,
"bqjbpbxf": 340,
"bqjbmbxf": 85,
"bqsybxf": 29.75,
"bqzfgjj": 0,
"bqqyzynj": 0,
"bqsyjkbxf": 0,
"bqsyylbxf": 0,
"bqqtkcqt": 0,
"ljsre": 10264,
"ljmssr": 0,
"ljjcfy": 10000,
"ljzxkc": 853.75,
"ljznjyzckc": 0,
"ljjxjyzckc": 0,
"ljzfdklxzckc": 0,
"ljzfzjzckc": 0,
"ljsylrzckc": 0,
"ljqtkc": 0,
"ljzykcdjz": 0,
"ljynssde": 0,
"sl": "0.03",
"sskcs": 0,
"ljynse": 0,
"ljjmse": 0,
"ljykjse": 0,
"ljyyjse": 0,
"ljybtse": 0,
"bz": ""
}
]
}
~~~
<p class="align-center"><a href="https://beian.miit.gov.cn" target="_blank">粤ICP备18096044号</a></p>