## 接口说明
> [GET] https://api.fpapi.net/v1/{aid}/companies/{company_id}/tax-category/state
查询所属期里面，需申报税种、申报状态，以及所需报表
此接口需要在 [获取税种信息任务](https://www.kancloud.cn/shoottech/opentax/3009848) 调用成功后可用
## 请求参数
当 `year` 和 `month` 都不填时，默认当前需申报税种
参数名 | 数据类型 | 参数类型 | 必填 | 描述
--- | --- | --- | --- | ---
aid | string | **path** | 必填 | 账号ID
company_id | String | **path** | 必填 | 企业在平台对应的唯一标识
year|int|query| |查询年份（默认值，上月所在的年份）
month|int|query| 当查询月份不为空时必填 |查询年份（默认值，上月）
## 响应参数
参数 | 类型 | 描述
--- | --- | ---
scope | string | 申报的税种，参见下表 **申报税种对照表**
tax_category | array | 税种信息
tax_category.tax_category_name | string | 税种名称
tax_category.option_name | string | 征收项目
tax_category.term | string | 所属期类型
tax_category.begin_time | string | 所属期起时间戳（秒）
tax_category.end_time | string | 所属期止时间戳（秒）
tax_category.collect_rate | float | 征收率，0.01=1%
tax_category.rate | float | 税率，0.01=1%
tax_category.tax_tag|string|主附税标志，主税；附税 （部分地区电子税局没提供相关信息，可能为空）
time | object | 所属期信息
report_name | string | 对应的报表名称
tax_history | object | 申报结果，仅当申报成功返回，可通过此字段判断是否需要申报
tax_history.tax_time | int | 申报时间戳（10位，秒级）
tax_history.img_url | string | 申报结果截图地址
tax_rate | object | 税额信息，仅当有税额情况返回
tax_rate.paid_tax_sum | float | 已缴税额，元
tax_rate.paid_tax_detail | array| 已缴税额详情
tax_rate.paid_tax_detail.type | string | 税种中文名称
tax_rate.paid_tax_detail.tax | string | 税额，元
tax_rate.paid_tax_detail.rate | float | 税率，0.01=1%，无税率情况是 0
tax_rate.unpaid_tax_sum | float | 需缴税额，元
tax_rate.unpaid_tax_detail | array | 需缴税额详情
tax_rate.unpaid_tax_detail.type | string | 税种中文名称
tax_rate.unpaid_tax_detail.tax | string | 税额，元
tax_rate.unpaid_tax_detail.rate | float | 税率，0.01=1%，无税率情况是 0
* 申报税种对照表
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
## 返回例子
```json
{
"msg":"ok",
"code":200,
"data":[
{
"tax_category":[
{
"tax_category_name":"个人所得税",
"option_name":"工资薪金所得",
"term":"月",
"begin_time":1546272000,
"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":"研发服务",
"term":"季",
"begin_time":1633017600,
"end_time":253402185600,
"collect_rate":"0.03",
"rate":"0.06"
},
{
"tax_category_name":"增值税",
"option_name":"商业(3%)",
"term":"季",
"begin_time":1640966400,
"end_time":253402185600,
"collect_rate":"0.03",
"rate":"0.03"
},
{
"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":1640966400,
"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":1640966400,
"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":1640966400,
"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_history":{
"tax_time":1657706885,
"img_url":""
},
"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"
}
]
}
},
{
"tax_category":[
{
"tax_category_name":"财务报表",
"option_name":"小企业会计准则",
"term":"季",
"begin_time":1601481600,
"end_time":2556028800,
"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":1483200000,
"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_history":{
"tax_time":1657766107,
"img_url":"https:\/\/res.aihouyi.com\/pro_tax_report\/202207\/91310000MA1F7R.jpg?t=1657814895"
},
"tax_rate":{
"paid_tax_sum":0,
"unpaid_tax_sum":1678.65,
"paid_tax_detail":[
],
"unpaid_tax_detail":[
{
"type":"企业所得税",
"rate":"0",
"tax":"1678.65"
}
]
}
},
{
"tax_category":[
{
"tax_category_name":"财务报表",
"option_name":"小企业会计准则",
"term":"年",
"begin_time":1601481600,
"end_time":2556028800,
"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"
]
}
]
}
```
<p class="align-center"><a href="https://beian.miit.gov.cn" target="_blank">粤ICP备18096044号</a></p>
