## 接口说明
当任务执行完毕时,会根据创建公司时提供的回调地址发送POST请求,需要你根据[签名认证](https://www.kancloud.cn/shoottech/opentax/2457405)进行参数校验
## 回调参数
参数名 | 数据类型 | 描述
--- | --- | ---
task_id | string | 任务id
task_type | int | 任务类型,参见下表 **任务类型对照表**
task_state | int | 任务状态,参见下表 **任务状态**
task_msg | string | 任务提示信息,task_state != 1 时需要参考此信息
img_url | string | 任务截图
api_ver | int | 当使用 [创建任务v2](https://www.kancloud.cn/shoottech/opentax/3009848) 接口创建时,此值为 2
extra | string | 创建任务时的extra信息,原样返回
content | array | 回调内容
content.scope | string | 申报的税种,参见下表 **申报税种对照表**
content.tax_category | array | 税种信息
content.tax_category.tax_category_name | string | 税种名称
content.tax_category.option_name | string | 征收项目
content.tax_category.term | string | 所属期类型
content.tax_category.begin_time | string | 所属期起时间戳(秒)
content.tax_category.end_time | string | 所属期止时间戳(秒)
content.tax_category.collect_rate | float | 征收率,0.01=1%
content.tax_category.rate | float | 税率,0.01=1%
content.time | object | 所属期信息
content.report_name | string | 对应的报表名称
content.tax_history | object | 申报结果,仅当申报成功返回
content.tax_history.tax_time | int | 申报时间戳(秒)
content.tax_history.img_url | string | 申报结果截图地址
content.tax_rate | object | 税额信息,仅当有税额情况返回
content.tax_rate.paid_tax_sum | float | 已缴税额,元
content.tax_rate.paid_tax_detail | array| 已缴税额详情
content.tax_rate.paid_tax_detail.type | string | 税种中文名称
content.tax_rate.paid_tax_detail.tax | string | 税额,元
content.tax_rate.paid_tax_detail.rate | float | 税率,0.01=1%,无税率情况是 0
content.tax_rate.unpaid_tax_sum | float | 需缴税额,元
content.tax_rate.unpaid_tax_detail | array | 需缴税额详情
content.tax_rate.unpaid_tax_detail.type | string | 税种中文名称
content.tax_rate.unpaid_tax_detail.tax | string | 税额,元
content.tax_rate.unpaid_tax_detail.rate | float | 税率,0.01=1%,无税率情况是 0
content.report | array | 相关报表
content.report.report_name | string | 报表名称
content.report.content | array | 报表内容
origin_tax_history | array | 电子税局申报历史列表,此信息所在位置在电子税局 「税费申报及缴纳」> 「申报结果查询」
origin_tax_history.tax_name | string | 税种全称,如 《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》
origin_tax_history.begin_time | int | 所属时期起(秒)
origin_tax_history.end_time | int | 所属时期止(秒)
origin_tax_history.tax_time | int | 申报日期(秒)
origin_tax_history.tax_money | float | 税额,元
* 任务类型对照表
task_type | 说明
--- | ---
101 | 电子税局申报任务
111 | 获取税种信息任务
201 | 个税申报任务
* 任务状态
task_state | 任务状态说明
--- | ---
-1 | 执行错误
-2 | 任务已中止
0 | 准备执行
1 | 成功
2 | 执行中
3 | 等待验证码,可通过 [验证码上传](https://www.kancloud.cn/shoottech/opentax/2649470) 接口,上传验证码信息
4 | 税额待确认
5 | 税额已确认
6 | 更正申报
* 申报税种对照表
scope | 说明
--- | ---
gzxjsd | 工资薪金所得,task_type = 201
zzs | 增值税,task_type = 101
cwbb | 财务报表,task_type = 101
qysds | 企业所得税,task_type = 101
cbj | 残保人就业保障金,task_type = 101
yhs | 印花税,task_type = 101
whsyjsf | 文化事业建设费,task_type = 101
## 回调例子
* 获取税种回调例子 task_type=111
```json
{
"task_id":"1657709728marojmph",
"task_type":111,
"task_state":1,
"task_code":0,
"task_msg":"",
"api_ver":2,
"extra":"",
"content":[
{
"tax_category":[
{
"tax_category_name":"个人所得税",
"option_name":"工资薪金所得",
"term":"月",
"begin_time":1575129600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.03"
}
],
"time":{
"term":1,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"gzxjsd",
"report_name":[
"gzxjsdsbb"
]
},
{
"tax_category":[
{
"tax_category_name":"增值税",
"option_name":"商业(17%、16%、13%)",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0.03",
"rate":"0.13"
},
{
"tax_category_name":"增值税",
"option_name":"咨询服务",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0.03",
"rate":"0.06"
},
{
"tax_category_name":"城市维护建设税",
"option_name":"县城、镇(增值税附征)",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.05"
},
{
"tax_category_name":"城市维护建设税",
"option_name":"县城、镇(增值税附征)",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.05"
},
{
"tax_category_name":"教育费附加",
"option_name":"增值税教育费附加",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.03"
},
{
"tax_category_name":"教育费附加",
"option_name":"增值税教育费附加",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.03"
},
{
"tax_category_name":"地方教育附加",
"option_name":"增值税地方教育附加",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.02"
},
{
"tax_category_name":"地方教育附加",
"option_name":"增值税地方教育附加",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.02"
}
],
"time":{
"term":2,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"zzs",
"report_name":[
"zzsjfzsfsbb_xgm"
]
},
{
"tax_category":[
{
"tax_category_name":"财务报表",
"option_name":"小企业会计准则",
"term":"季",
"begin_time":1569859200,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0"
}
],
"time":{
"term":2,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"cwbb",
"report_name":[
"cb_zcfzb",
"cb_lrb",
"cb_xjllb"
]
},
{
"tax_category":[
{
"tax_category_name":"企业所得税",
"option_name":"应纳税所得额",
"term":"季",
"begin_time":1569859200,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.25"
}
],
"time":{
"term":2,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"qysds",
"report_name":[
"qysdsalyj"
]
},
{
"tax_category":[
{
"tax_category_name":"财务报表",
"option_name":"小企业会计准则",
"term":"年",
"begin_time":1569859200,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0"
}
],
"time":{
"term":3,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"cwbb",
"report_name":[
"cb_zcfzb",
"cb_lrb",
"cb_xjllb"
]
}
],
"origin_tax_history":[
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":29.85
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1654012800,
"end_time":1656518400,
"tax_time":1656604800,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1651334400,
"end_time":1653926400,
"tax_time":1654185600,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1648742400,
"end_time":1651248000,
"tax_time":1652198400,
"tax_money":0
},
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
}
]
}
```
* 电子税局申报回调例子 task_type=101
例一:增值税
```json
{
"task_id":"1657607790kwdzhtpj",
"task_type":101,
"task_state":1,
"task_code":0,
"task_msg":"",
"api_ver":2,
"extra":"",
"content":[
{
"tax_category":[
{
"tax_category_name":"增值税",
"option_name":"咨询服务",
"term":"季",
"begin_time":1601481600,
"end_time":253402185600,
"collect_rate":"0.03",
"rate":"0.06"
},
{
"tax_category_name":"城市维护建设税",
"option_name":"县城、镇(增值税附征)",
"term":"季",
"begin_time":1601481600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.05"
},
{
"tax_category_name":"教育费附加",
"option_name":"增值税教育费附加",
"term":"季",
"begin_time":1601481600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.03"
},
{
"tax_category_name":"地方教育附加",
"option_name":"增值税地方教育附加",
"term":"季",
"begin_time":1601481600,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.02"
}
],
"time":{
"term":2,
"year":2022,
"month":4,
"quarter":2,
"half":1
},
"scope":"zzs",
"report_name":[
"zzsjfzsfsbb_xgm"
],
"tax_rate":{
"paid_tax_sum":0,
"unpaid_tax_sum":0,
"paid_tax_detail":[
],
"unpaid_tax_detail":[
{
"type":"增值税",
"rate":"0",
"tax":"0.0"
},
{
"type":"城市维护建设税",
"rate":0.05,
"tax":"0.00"
},
{
"type":"教育费附加",
"rate":0.03,
"tax":"0.00"
},
{
"type":"地方教育附加",
"rate":0.02,
"tax":"0.00"
}
]
}
}
],
"origin_tax_history":[
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":29.85
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1654012800,
"end_time":1656518400,
"tax_time":1656604800,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1651334400,
"end_time":1653926400,
"tax_time":1654185600,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1648742400,
"end_time":1651248000,
"tax_time":1652198400,
"tax_money":0
},
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
}
]
}
```
例二:企业所得税,财务报表
```json
{
"task_id":"1657765641aybxgmuq",
"task_type":101,
"task_state":1,
"task_code":0,
"task_msg":"",
"api_ver":2,
"extra":"",
"content":[
{
"tax_category":[
{
"tax_category_name":"财务报表",
"option_name":"小企业会计准则",
"term":"季",
"begin_time":1601481600,
"end_time":2556028800,
"collect_rate":"0",
"rate":"0"
}
],
"time":{
"term":2,
"year":2022,
"quarter":2
},
"scope":"cwbb",
"report_name":[
"cb_zcfzb",
"cb_lrb",
"cb_xjllb"
]
},
{
"tax_category":[
{
"tax_category_name":"企业所得税",
"option_name":"应纳税所得额",
"term":"季",
"begin_time":1483200000,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0.25"
}
],
"time":{
"term":2,
"year":2022,
"quarter":2
},
"scope":"qysds",
"report_name":[
"qysdsalyj"
],
"tax_history":{
"tax_time":1657766107,
"img_url":"https://res.aihouyi.com/pro_tax_report/202207/91310000MA1KF7R_76f.jpg?t=1657810012"
},
"tax_rate":{
"paid_tax_sum":0,
"unpaid_tax_sum":1678.65,
"paid_tax_detail":[
],
"unpaid_tax_detail":[
{
"type":"企业所得税",
"rate":"0",
"tax":"1678.65"
}
]
}
}
],
"origin_tax_history":[
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":29.85
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1654012800,
"end_time":1656518400,
"tax_time":1656604800,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1651334400,
"end_time":1653926400,
"tax_time":1654185600,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1648742400,
"end_time":1651248000,
"tax_time":1652198400,
"tax_money":0
},
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
}
]
}
```
* 工资薪金所得回调例子
```json
{
"task_id":"1658128402vszswnvl",
"task_type":201,
"task_state":1,
"task_code":1,
"task_msg":"",
"api_ver":1,
"extra":"",
"content":[
{
"tax_category":[
{
"tax_category_name":"个人所得税",
"option_name":"工资薪金所得",
"term":"月",
"begin_time":1654012800,
"end_time":253402185600,
"collect_rate":"0",
"rate":"0",
"tax_tag":"主税"
}
],
"time":{
"term":1,
"year":2022,
"month":6,
"quarter":2,
"half":1
},
"scope":"gzxjsd",
"report_name":[
"gzxjsdsbb"
],
"tax_history":{
"tax_time":1658128888,
"img_url":"https:\/\/res.aihouyi.com\/pro_person_tax_task\/tax\/20220718_152127\/911305K5J.jpg?t=1658386451"
},
"tax_rate":{
"paid_tax_sum":0,
"unpaid_tax_sum":0,
"paid_tax_detail":[
],
"unpaid_tax_detail":[
]
},
"report":[
{
"report_name":"gzxjsdsbb",
"content":[
{
"month":1654012800,
"xm":"小明",
"zjlx":"居民身份证",
"zjhm":"130526199210071234",
"skssqq":"2022-06-01",
"skssqz":"2022-06-30",
"sdxm":"正常工资薪金",
"bqsr":0,
"bqfy":0,
"bqmssr":0,
"bqjbpbxf":0,
"bqjbmbxf":0,
"bqsybxf":0,
"bqzfgjj":0,
"bqqyzynj":0,
"bqsyjkbxf":0,
"bqsyylbxf":0,
"bqqtkcqt":0,
"ljsre":0,
"ljmssr":0,
"ljjcfy":30000,
"ljzxkc":0,
"ljznjyzckc":0,
"ljjxjyzckc":0,
"ljzfdklxzckc":0,
"ljzfzjzckc":0,
"ljsylrzckc":0,
"ljssyxyyezhkc":0,
"ljqtkc":0,
"ljzykcdjz":0,
"ljynssde":0,
"sl":"0.03",
"sskcs":0,
"ljynse":0,
"ljjmse":0,
"ljykjse":0,
"ljyyjse":0,
"ljybtse":0,
"jajsbl":"100",
"jcfy":5000,
"yxkcdsf":0,
"ccyz":0,
"bz":""
}
]
}
]
}
],
"origin_tax_history":[
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":29.85
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1648742400,
"end_time":1656518400,
"tax_time":1657814400,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1654012800,
"end_time":1656518400,
"tax_time":1656604800,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1651334400,
"end_time":1653926400,
"tax_time":1654185600,
"tax_money":0
},
{
"tax_name":"个人所得税-工资薪金所得",
"begin_time":1648742400,
"end_time":1651248000,
"tax_time":1652198400,
"tax_money":0
},
{
"tax_name":"《A200000中华人民共和国企业所得税月(季)度预缴纳税申报表(A类,2021年版)》",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"增值税及附加税费申报表(小规模纳税人适用)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
},
{
"tax_name":"小企业会计准则财务会计报告报送(季报)",
"begin_time":1640966400,
"end_time":1648656000,
"tax_time":1648742400,
"tax_money":0
}
]
}
```