## 接口说明
`[POST] https://api.fpapi.net/v1/{aid}/companies/{company_id}/task`
该接口用于创建任务
## 请求参数
参数名 | 数据类型 | 参数类型 | 必填 | 描述
--- | --- | --- | --- | ---
aid | string | path | 必填 | 账号ID
company_id | string | path | 必填 | 公司ID
task_type | int | body | 必填 | 任务类型,当前接口仅支持 task_type=201
time | object | body | task_type!=111 时必填 | 所属期
time.term | int | body | task_type!=111 时必填 | 报税期类型 1: 月 2: 季 3: 年 4: 其他,5: 半年
time.year | int | body | term!=4 时必填 | 年份,year>=2022
time.quarter | int | body | term=2 时必填 | 季度,quarter>=1 && quarter<=4
time.month | int | body | term=1 时必填 | 月份,month>=1 && month<=12
time.half | int | body | term=5 时必填 | 半年,1:上半年,2:下半年
tax_type | string | body | | 申报类型 默认值:1 (正常申报),参见下表 **申报类型对照表**
extra | string | body | | 商户自定义参数,任务回调的时候会返回
* 申报类型对照表
tax_type | 说明
--- | ---
1 | 正常申报,默认值。(对于电子税局任务,相当于保存报表并申报 )
2 | 更正申报(重新申报),暂只支持个税更正申报
4 | 作废申报,暂只支持个税作废申报
## 请求例子
* 个税申报任务
(2022年1月,工资薪金所得申报任务)
```
{
"task_type": 201,
"time":
{
"term": 1,
"year": 2022,
"month": 1
}
}
```
## 响应参数
参数 | 类型 | 描述
--- | --- | ---
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>