多应用+插件架构,代码干净,二开方便,首家独创一键云编译技术,文档视频完善,免费商用码云13.8K 广告
## 接口说明 > [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>