## 接口说明
`[POST] https://api.fpapi.net/v1/{aid}/companies/{company_id}/task2`
该接口用于创建任务
请通过接口回调接收任务接口,请参考 [任务状态回调v2](https://www.kancloud.cn/shoottech/opentax/3023910)
## 请求参数
参数名 | 数据类型 | 参数类型 | 必填 | 描述
--- | --- | --- | --- | ---
aid | string | **path** | 必填 | 账号ID
company_id | string | **path** | 必填 | 公司ID
task_type | int | body | 必填 | 任务类型,参见下表 **任务类型对照表**
tax | array | body | task_type!=111 时必填 | 申报的税种列表,有序
tax.scope | string | body | task_type!=111 时必填 | 申报的税种,具体参见下表 **申报税种对照表**
tax.tax_type | string | body | | 申报类型 默认值:1 (正常申报),参见下表 **申报类型对照表**
tax.time | object | body | task_type!=111 时必填 | 所属期
tax.time.term | int | body | task_type!=111 时必填 | 报税期类型 1: 月 2: 季 3: 年 4: 其他,5: 半年
tax.time.year | int | body | term!=4 时必填 | 年份,year>=2022
tax.time.quarter | int | body | term=2 时必填 | 季度,quarter>=1 && quarter<=4
tax.time.month | int | body | term=1 时必填 | 月份,month>=1 && month<=12
tax.time.half | int | body | term=5 时必填 | 1:上半年,2:下半年
tax.report | array | body | 当 task_type = 111 或 tax_type = 4 或 tax_type=6 可不传 | 报表
tax.report.report_name | string | body | | 报表名称
tax.report.content | object | body | | 报表内容
extra | string | body | | 商户自定义参数,任务回调的时候会返回
task_param | object | body | | 任务参数
task_param.tax_rate_strict_mode | int | body | | 0:仅在有税额,才有税额确认过程;1:不管是否有税额,都有税额确认过程(暂用于个税申报任务)。默认值 0
* 任务类型对照表
task_type | 说明
--- | ---
101 | 电子税局申报任务
111 | 获取税种信息任务
201 | 个税申报任务
* 申报类型对照表
个税申报任务 tax_type
tax_type | 说明
--- | ---
1 | 正常申报,默认值
2 | 更正申报(重新申报)
3 | 确认税额,此类型用于确认税额申报并缴款
4 | 作废申报,是否能够运行作废申报取决于所在地区的扣缴费端是否支持
电子税局申报任务 tax_type
tax_type | 说明
--- | ---
1 | 正常申报,默认值,相当于保存报表并申报
3 | 税额缴款
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
}
```
* 电子税局申报任务
> [增值税(小规模纳税人)](https://www.kancloud.cn/shoottech/opentax/2561088)
> [增值税(一般纳税人)](https://www.kancloud.cn/shoottech/opentax/2795842)
> [企业所得税](https://www.kancloud.cn/shoottech/opentax/2463023)
> [财务报表](https://www.kancloud.cn/shoottech/opentax/2463031)
* 个税申报任务
> [工资薪金所得](https://www.kancloud.cn/shoottech/opentax/2499108)
电子税局任务可以多个税种组合一起申报,可参考如下例子
```json
{
"task_type":101,
"tax":
[
{
"scope":"zzs",
"tax_type":5,
"time":{
"term":2,
"year":2022,
"quarter":2
},
"report":[
...
]
},
{
"scope":"qysds",
"tax_type":1,
"time":{
"term":2,
"year":2022,
"quarter":2
},
"report":[
...
]
},
{
"scope":"cwbb",
"tax_type":1,
"time":{
"term":2,
"year":2022,
"quarter":2
},
"report":[
...
]
}
]
}
```
## 响应参数
参数 | 类型 | 描述
--- | --- | ---
code|int|200为正常,其他为错误代码
msg|string|返回信息
data|object|
data.task_id| string | 任务唯一id
<p class="align-center"><a href="https://beian.miit.gov.cn" target="_blank">粤ICP备18096044号</a></p>