慧穗云—税收违法信息查询（tax-illegal-info）

概述

慧穗云税收违法信息查询

调用慧穗云同步接口 POST /api/v2/agent/cdk/obtainIllegalInfo。使用随 skill 提供的脚本，不要自行拼接鉴权请求。先将本 SKILL.md 所在目录解析为 <skill-dir>，从任何工作目录都通过该绝对路径执行脚本。

配置

要求 Python 3、requests，以及以下环境变量：

HSY_AK=慧穗云或 ISV 的 AK
HSY_SK=对应的 SK
HSY_TYPE=2
HSY_API_URL=https://huisuiyun.com

HSY_TYPE 取 2 表示慧穗云 AK/SK。ISV AK/SK 必须改为以下配置：

HSY_TYPE=1
HSY_TAX_NO=被操作公司的税号

也可用 --operator-tax-no 代替 HSY_TAX_NO。查询目标税号是请求体中的查询对象；ISV 操作税号表示当前代表其操作并扣减流量的公司，两者可能不同，不要混用。不得要求用户在对话中粘贴 SK；引导其在本机配置环境变量。秘钥管理地址：https://huisuiyun.com/account/conf/secretkey。

查询

python "<skill-dir>/scripts/tax_illegal_info.py" query "91310117MA1J30X297"

ISV 调用示例：

python "<skill-dir>/scripts/tax_illegal_info.py" query "目标纳税人识别号" --operator-tax-no "操作公司税号" --serial-no risk-1001

解读结果

仅当顶层 code 为字符串 "200" 时按成功处理。按案件总结企业名称、税号、案件性质、主要违法详情、所属省份和公布日期。法人、财务负责人、实际负责人及中介机构属于相关责任主体信息；证件号码默认脱敏展示，只有用户明确要求且有正当用途时才完整输出。

成功响应中的空 data 表示未返回违法案件。非 200、HTTP 错误或非 JSON 响应属于调用失败，必须保留并报告 message 和 serialNo，不得解释为“无违法记录”。查询结果用于风险提示，不替代法律、税务或合规意见。

依据

接口契约来自当前慧穗云 CDK 文档 辅助功能接口/obtain-illegal-info.md。Token 有效期为 30 天；脚本使用 MD5(AK + SK) 获取访问令牌，并支持 X-Tax-Token 与 X-Serial-Token。

如需了解更多欢迎扫码联系