技能介绍

要解决什么问题

增值税纳税人身份不是从企业名称能看出来的信息，但它直接影响税率适用、发票开具资格和合规义务。当你在做供应商准入、开票前置校验或信用评估时，拿到的通常只是工商登记数据，里面并没有纳税人类型这一字段。人工去税务局网站逐个查又慢且容易出错，批量场景下基本不可行。这个 Skill 就是给程序化查询补上这一环。

核心能力

查询企业增值税纳税人类型：一般纳税人 或 小规模纳税人
返回纳税人识别号、主管税务机关、资格状态与起止时间等字段
支持企业开票合规核查，可作为供应商准入流程的一个校验节点

需要说明的是，它只覆盖企业纳税人类型查询这一个接口，不做工商信息、司法风险等其他维度的数据查询。

工作流程

查询通过 Skill 根目录下的脚本执行：

在购买页注册并获取专属 API Key，免费调试额度为 0 元 / 3 次
把 Key 直接交给 AI，并说明要查询的公司名全称、注册号或统一社会信用代码
AI 在 Skill 根目录执行 python scripts/query_taxpayer_type.py --keyword 阿里巴巴 这样的命令发起查询
若已自行配置环境变量 CHINAZ_TAXPAYER_TYPE_API_KEY，可以省略 --api-key 参数
脚本解析返回的 JSON，AI 依据实际返回字段作答，不会编造数据

返回结果中，code 为 200 表示查询成功，qualification 给出资格类型，tax_num 是纳税人识别号，manage_organ 是主管税务机关，has_qualific 标识是否具备一般纳税人资格。

适用边界

一次只查询单条记录，批量任务需要逐条执行，再自行汇总
数据来源于第三方，可能存在更新延迟，仅供参考，最终以官方渠道为准
API Key 不会被输出、复述或保存
常见失败包括 missing_api_key、invalid_input、network_error 等，缺少 Key 时需引导用户提供，额度不足时需引导前往购买页检查