【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。
SKILL.md 为准;安装则去 SkillHub 对应页面 →。装到本地即可离线运行,数据不出电脑。[出口退税, 出口退税率, 退税率查询, HS编码, 商品代码, 征税税率, 外贸财税]
> **本地运行,零网络请求、免 API Key、不主动外发数据。** > 四项诚实承诺:① 查不到就说查不到,绝不编造税率;② 高危动作强制人工确认;③ 幂等断点,绝不重复副作用;④ 全程留痕可审计。 > 边界说明:本包脚本自身不联网、不外发;若你把内容贴进 AI 对话,内容是否离开本机由你所使用的客户端决定,不由本包决定。 > 数据说明:内置码表为**离线快照**(国家税务总局《出口退税率文库》CMCODE-2026B),按季更新,跨季使用请核对版本号。 <!-- WB-CLAIM-BOUNDARY v1 --> # 出口退税率速查 出口退税率是外贸财税里**问得最多、也最容易记错**的一个数。 它按商品代码(HS/海关商品编码)逐条定,不是按大类。同一个大类里,13%、9%、0% 可能并存; 《出口退税率文库》按季更新,今年 6 月的税率到 10 月可能已经变了两轮。 凭印象答一个「差不多 13% 吧」,轻则报价算错,重则退税申报的计税依据整批要更正。 本包做的事很明确:**把官方文库的在效快照搬进本地,按商品代码或名称查准税率**—— 不推算、不猜、不拿别的商品的值凑数。查不到就进异常表,告诉你为什么查不到。 ## 运行方式 <!-- WB-INVOKE-CONTRACT v1 --> **环境**:Python 3.8+,**仅标准库,无需安装任何依赖**。 **作用**:按商品代码 / 名称查询出口退税率,输出查询主表与需人工确认清单。 **命令**(在技能目录下执行): ```bash # 默认预览(不写盘) python scripts/export_rebate_rate.py <待查清单.csv> # 反向查询:列出出口退税率为 13% 的全部商品代码 python scripts/export_rebate_rate.py --rate 13 # 确认无误后正式执行 python scripts/export_rebate_rate.py <待查清单.csv> --execute ``` **参数**: | 参数 | 说明 | |---|---| | `<file>` | 待查清单(.xlsx / .csv),首行表头,含 查询项(商品代码或商品名称) | **选项**: | 选项 | 说明 | |---|---| | `--rate N` | 反向查询:列出出口退税率 == N% 的商品(无需输入文件) | | `--limit N` | 前缀匹配 / 反向查询的展示上限(默认 200) | | `--data PATH` | 自定义码表 CSV 路径(默认用包内 `data/cmcode.csv`) | | `--out-dir OUT_DIR` | 产物输出目录(默认 `<cwd>/_out`) | | `--operator OPERATOR` | 操作人(写入留痕) | | `--execute` | 真正写盘 | **退出码**:`0` 成功 / `2` 输入错误 / `3` 鉴权失败 / `4` 环境或依赖失败 / `8` 部分成功。 **输出**:四件套写入 `--out-dir`,源文件不改动;先跑预览确认,再加 `--execute` 落盘。 ## 何时不触发 以下情况**不要**启动本技能,并主动告诉用户该走哪条路: 1. 要**测算退税额**(免抵退 / 免退税怎么算、退多少) → 转 `caiyouyun-export-rebate-calc`。 2. 要**判断商品该归哪个 HS 编码**(归类) → 转 `caiyouyun-hs-code-guide`(归类是法律行为,本包不做)。 3. 要查的是**进口关税税率 / 最惠国税率 / 暂定税率** → 转 `caiyouyun-tariff-rate-lookup`。 4. 要查的是**国内税收分类编码 / 减免性质代码** → 转 `caiyouyun-tax-code-lookup` / `caiyouyun-tax-reduction-code`。 5. 要判断的是**能不能退税、适不适用免税**(政策适用性) → 转 `caiyouyun-tax-benefit-matcher`。 6. 用户要的是**实时最高版本 + 在线核验** → 说明本包是离线快照,实时数据请走国家税务总局「出口退税率查询」。 > 误触发一次的成本高于漏触发一次:给出一个错的退税率,用户可能直接拿去报关或算退税。 ## 工作流(编号阶段) | 阶段 | 做什么 | 产物 | 闸门 | |---|---|---|---| | 一 | 加载码表:读包内 `data/cmcode.csv`(在效快照) | 内存码表 | 码表缺失 → 拒绝(RC=4) | | 二 | 逐条匹配:代码精确 → 代码前缀 → 名称子串 | 命中结果 | 均未命中 → 异常表(中) | | 三 | 出表:税率结果 + 建议动作 | 查询主表 + 异常表 | 条目守恒校验 | > 按顺序推进;上一阶段闸门没过,不进入下一阶段。 ## 能力边界(先说清楚) | 本包**能**做 | 本包**不做** | |---|---| | 按 8/10 位商品代码查出口退税率、征税率 | 判断商品该归哪个代码(归类 = 法律行为) | | 按商品名称子串检索 | 测算退税额、免抵退/免退税计算 | | 按代码前缀列出下属全部商品 | 判断能否退税(政策适用性) | | 反向列出某税率的全部商品 | 保证「实时最新」(本包是季度快照) | > 边界是有意为之:**税率是官方定的,本包只搬不造**。 > 数据版本写在每次输出里,跨季使用时你会看到版本戳。 ## 数据说明 | 项 | 值 | |---|---| | 来源 | 国家税务总局《出口退税率文库》(CMCODE,各省税务局发布) | | 版本 | **CMCODE-2026B**(2026-06-04 编制) | | 内置范围 | 每商品代码取**最新一期**(在效快照),约 **32,099** 个代码 | | 字段 | 商品代码 / 商品名称 / 计量单位 / 征税率% / 出口退税率% / 生效起 / 生效止 | | 更新节奏 | **按季更新,每年 A/B/C 三版**(A≈3 月、B≈6 月、C≈10 月) | | 覆盖 | 有退税率(>0) 约 80.8%;退税率=0(不退税)约 19.2% | > 当前退税率分布(前几位):13% ≈ 11,690 个 · 0% ≈ 6,172 个 · 9% ≈ 3,945 个 · 16% ≈ 3,398 个 · 17% ≈ 2,386 个 · 5% ≈ 2,199 个。 ## 输入 / 输出 输入:1 张待查清单(`.xlsx` / `.csv`),首行表头。 | 列 | 必需 | 别名 | |---|---|---| | 查询项 | 必需 | 查询项 / 商品代码 / 商品编码 / 代码 / HS编码 / 商品名称 / 名称 / 查询内容 / 待查项 / 项目 | > 纯数字按**商品代码**处理(8/10 位精确,更短则按前缀);含文字按**商品名称**子串匹配。 输出(进 `--out-dir`,源文件一个字节都不动): | 文件 | 内容 | |---|---| | `出口退税率查询_主表.csv` | 逐条:查询项 / 匹配方式 / 商品代码 / 商品名称 / 计量单位 / 征税率% / 出口退税率% / 生效期 / 备注 | | `出口退税率查询_异常表.csv` | 需人工确认项(未命中 / 位数不符 / 查询项为空),带风险等级 | | `出口退税率查询_校验表.csv` | 能力边界 / 数据版本 / 数据规模 / **条目守恒校验** | | `fin-log.jsonl` | 处理日志(追加,含输入 sha256) | ## 真实输出 正常(4 行输入): ``` --- 出口退税率查询(共 3 条命中)--- 84713000 便携式自动数据处理设 退17.00% 按代码前缀命中 4 条;示例:... 85171100 无绳电话机 退13.00% 按代码前缀命中 154 条;示例:... 0101101010 改良种用濒危野马 退0.00% 按名称命中 11 条;示例:... --- 需人工确认(1 条)--- 99999999999999 商品代码位数不符(14 位);海关商品编码为 8 或 10 位(前缀查询可少于此) ``` 反向查询(`--rate 13`): ``` --- 反向查询:退税率 13.00% 共 11690 个商品代码,展示前 200 条 --- 0204430000 冻藏的其他去骨绵羊肉 退13.00% 0204500000 鲜或冷藏、冻藏的山羊 退13.00% ... ``` 校验表(条目守恒): ``` 条目守恒 | 输入 4 = 主表 3 + 异常 1 数据版本 | CMCODE-2026B / 2026B 版(2026-06-04 编制) ``` > 注意第 1 条:`847130` 是 6 位前缀,命中 4 条下属代码,主表给出首条 + 完整示例。 > 本包**不会**把 6 位前缀的下属代码收敛成一个「代表税率」——那样会掩盖差异。 ## 拒绝权(什么情况下不给判断) | 情况 | 处理 | |---|---| | 缺「查询项」列 | **拒绝(RC=2)**,列出可用别名 | | 查询项为空 | 该行进异常表(中) | | 商品代码位数不符(非 4–12 位) | 该行进异常表(中),说明应为 8/10 位 | | 码库中查无此代码 | 该行进异常表(中),提示改名称或核对位数 | | 名称未命中 | 该行进异常表(中),提示换更短关键词 | | 输入文件不存在 / 格式不支持 | **拒绝(RC=2)**,说明支持 .xlsx / .csv | | 包内码表缺失 | **拒绝(RC=4)**,说明需 `/data/cmcode.csv` 或 `--data` | ## 关键设计(容易踩的坑) 1. **税率是查出来的,不是算出来的**。本包不含任何税率规则,只做「代码 → 官方税率」的查表, 不做「这个商品大概几个点」的推断。 2. **前缀命中不收敛**。6 位前缀命中多个下属代码时,主表给出首条 + 示例清单, **不取平均值、不取众数**——不同子目税率可能不同,收敛会掩盖风险。 3. **退税率 0 是有效答案**。「不退税」和「查不到」是两回事:本包分开表达, 0% 进主表(是结论),查不到进异常表(是缺口)。 4. **版本戳必须带**。文库按季更新,跨季使用风险高;每次输出都打印数据版本,让使用者自己判断是否需重新取数。 5. **归类不做**。商品归哪个 HS 代码是法律行为(归类总规则),本包只查已归好的代码的税率。 6. **条目守恒**:输入条数 = 主表条数 + 异常表条数。对不上账,本包**拒绝输出**。 ## 人工复核(必读) - 本包输出的是**官方文库的税率快照**,是查询辅助,不是退税结论; - 退税还要看**政策适用性**(能不能退、免抵退还是免退税、有无征退税率差); - 文库按季更新,**跨季使用时请核对版本号**,重要申报前建议用官方在线查询复核一次; - 商品代码以海关 / 电子税务局现行有效版本为准; - 本包**不判断商品归类**,归类差异会导致查到的税率不适用。 ## 相邻路线转交 | 用户要做的事 | 转交给 | |---|---| | 测算出口退税额(免抵退 / 免退税) | `caiyouyun-export-rebate-calc` | | 判断商品归哪个 HS 编码 | `caiyouyun-hs-code-guide` | | 查进口关税 / 暂定 / 最惠国税率 | `caiyouyun-tariff-rate-lookup` | | 查国内税收分类编码 / 减免性质代码 | `caiyouyun-tax-code-lookup` / `caiyouyun-tax-reduction-code` | | 判断进项能不能抵扣(含征退税率差) | `caiyouyun-vat-input-deduction-check` | | 核验法规效力(某文件还有效吗) | `caiyouyun-policy-validity-check` | ## 可直接复制的说法 ```text 把这份商品清单的出口退税率过一遍。 按商品代码查,8 位或 10 位都行;只有名称的就按名称搜。 查不到的单独列出来,告诉我为什么查不到,别拿相近商品的值凑。 前缀能对上多条的时候不要合一个数,把明细列出来。 退税率 0 就是 0,不是查不到,这两种情况分开写。 先跑预览,我确认了再加 --execute。 ``` ## 做完怎么算完成 - [ ] 每条结果都带**商品代码 + 出口退税率**,不是只给一个数 - [ ] 未命中的项已单独列出并说明原因 - [ ] 前缀多命中项**没有**被收敛成一个代表值 - [ ] 输出里带了**数据版本戳**(CMCODE-2026B) - [ ] 已确认:税率是查询结果、不是退税结论,政策适用性另行判断 - [ ] 校验表「条目守恒」对得上 ## 参考资料(渐进式披露) | 文件 | 内容 | 何时读 | |---|---|---| | `references/01-legal-basis.md` | 依据(出口退税率文库机制 / 征退税率 / 官方入口)+ 数据来源 | 需要核对依据与来源时 | | `references/02-data-dict.md` | 码表字段字典 + 匹配规则 + 税率分布 | 理解字段含义、排查匹配问题时 | | `references/03-verification-checklist.md` | 前置信息清单 + 高风险情形 | 查询前齐备性检查、事后复核 | | `data/cmcode.csv` | 内置码表快照(32,099 条) | 脚本自动读取,勿手工改 | | `data/NOTICE.txt` | 数据来源与版权声明 | 引用数据时 | ## 输出规范 - **交付形态**:执行结果 + 变更清单,说清动了什么、没动什么。 - **必含字段**:执行前状态 / 执行动作 / 执行后状态 / 失败项与原因 / 回滚方式。 - **留痕**:产生副作用的执行必须写留痕文件(manifest / log),可回溯。 - **自检**:失败项未列原因,或无可回滚路径,视为未完成。 ## 免责声明 本技能输出的是**出口退税率查询结果**,不构成税务意见,也不是退税资格认定。 税率以国家税务总局《出口退税率文库》官方现行版本为准;政策适用性与退税测算须另行判断。 因使用本结果产生的后果,由使用者自行承担。 --- 版本:v0.1.0 · 出品:【财友云】 · 数据版本:CMCODE-2026B ## 反例对照(避开这些写法) | ❌ 反例 | ✅ 正例 | 判据 | |---|---|---| | 前缀命中多条时取一个代表税率 | 列出明细,标明命中条数 | 有没有替用户抹平差异 | | 查不到就按相近商品的税率给一个 | 进异常表,说明「码库中无此代码」 | 用户能不能看出这句没把握 | | 把退税率 0 写成「查不到」 | 0% 是主表结论,「查不到」是异常 | 有没有混淆结论与缺口 | | 输出不带数据版本 | 每次输出带 CMCODE-2026B 版本戳 | 跨季使用时会不会误用旧值 | | 顺手给出「退税额 = 出口额 × 退税率」 | 只给税率,测算转 export-rebate-calc | 有没有越界给结论 | <!-- WB-SELFCHECK v1 --> ## 交付前自检(必跑) 本包自带可执行自检脚本。**在交付 / 打包 / 发布之前,必须运行并通过**: ```bash python scripts/selfcheck.py ``` 退出码语义(与本节末尾「退出码(脚本契约)」一致): | 码 | 含义 | 你要做的事 | |---|---|---| | 0 | 全部通过 | 可以交付 | | 2 | 用法错误 | 检查运行路径,用包根目录下 `scripts/selfcheck.py` | | 3 | **门禁未通过** | 按 FAIL 项逐条修好再交付,**不要带病交付** | | 4 | 环境问题 | 检查 Python 版本(需 3.8+)与入口脚本是否可运行 | | 8 | 部分通过 | 无 FAIL,但有 WARN;建议先修警告项再交付 | 自检覆盖:SKILL.md 与 frontmatter(`name`·`description`)/ 合规声明(frontmatter `license` **或** `ATTRIBUTION.md`,二者其一即可)/ 必备章节 / 打包卫生(禁止 .pyc·__pycache__·.bak·.zip)/ 脚本可编译 / 入口脚本 `--help` 可运行。 <!-- /WB-SELFCHECK --> ## 退出码(脚本契约) | 码 | 含义 | 你要对用户说的话 | |---|---|---| | 0 | 成功 | 直接给结果,不解释过程 | | 2 | 输入错误(缺参数 / 格式不对 / 文件不存在) | 「你给的 <X> 不对,需要 <Y>」—— 说明正确格式,不要猜默认值硬跑 | | 3 | 鉴权/授权失败(密钥缺失、无权限) | 「需要你先提供 <凭据>」—— 说明去哪里拿,不要跳过鉴权 | | 4 | 服务/环境失败(网络不可用、依赖缺失) | 「这一步依赖 <X> 不可用」—— 给出替代路径或降级方案 | | 8 | 部分成功(有成功项也有失败项) | 「N 项成功、M 项失败」—— 逐条列出失败项与原因,不要只报总数 | 脚本退出非 0 时:**不要静默重试**。先把该码对应的话告诉用户,再决定是补齐输入重试、还是换路径。 ## 状态与断点 - 多阶段流程在执行目录写 `outputs/.state.json`,记录「当前阶段 + 已完成产物路径 + 时间」。 - **每个阶段结束后写一次**;中途中断后重启,先读该文件,从断点阶段继续,**不从头重跑**。 - 状态文件只记阶段与产物路径,不记对话内容、不记敏感数据。 - 发现状态文件与实际情况不符(产物已不存在)时,以实际产物为准并重置状态。
按真实会被问到的顺序排,每条答案都给得出可核对的依据,不含含糊其辞的部分。
【财友云】内置国家税务总局《出口退税率文库》在效快照(约 3.2 万个商品代码),按商品代码或商品名称查出口退税率、征税率、计量单位与生效期,并支持「退税率 13% 的商品有哪些」这类反向清单查询。适用于外贸企业报价前核税率、出口退税申报前核对商品退税率、财务复核退税额计算口径等场景。数据为离线快照、版本可查,运行时零联网。
常见的触发场景有:出口退税率是多少、这个商品退几个点、出口退税税率查询。
完整说明、版本记录和安装方式在 SkillHub 上的「出口退税率速查」页面 →。
输出会落在 _out/ 目录,主要包括:
出口退税率查询_主表.csv逐条:查询项 / 匹配方式 / 商品代码 / 商品名称 / 计量单位 / 征税率% 出口退税率查询_异常表.csv需人工确认项(未命中 / 位数不符 / 查询项为空),带风险等级出口退税率查询_校验表.csv能力边界 / 数据版本 / 数据规模 / 条目守恒校验有。下面几种情况它会明确拒绝,而不是硬给答案:
总之是算不出就说算不出,不会给你一个看着合理、实际没依据的数字。
这几条是设计时就写进去的口径,不知道会直接算错,不是「留意一下」那种套话:
不能直接拿去报。它给的是建议和依据,最终判断还是得你来做。下面这几条是它要求你逐条过的:
不会。运行时不发一个网络包。你自己就能验证,三条路任选:
把网断掉再跑一遍,功能照常——它本来就没打算联网。
打开包里的 SKILL.md,权限声明写的是 network: none,不声明就没有联网能力。
直接翻 scripts/ 下的源码,全站都是 Python 标准库写成,没有一行网络代码。
都不要。免费使用,不需要任何 API Key,不联网就不需要 Key,也不存在额度这回事。开源协议 BUSL-1.1,发布满 4 年后自动转为 Apache License 2.0。
安装后,在支持 SkillHub 的 AI 客户端(如 WorkBuddy)里直接使用即可。
触发方式:对话里提到「出口退税率是多少、这个商品退几个点、出口退税税率查询」等场景,或上传相关表格/凭证,它就会自动响应。
典型用法:把原始文件发给 AI,说『帮我跑 出口退税率速查』或『处理一下这个』,结果会输出到当前目录的 _out/出口退税率查询_主表.csv。
也可以从客户端的「已安装技能」列表里手动唤起。
Windows / macOS / Linux 都能跑,不需要 pip install 任何东西。
运行只依赖 Python 3 标准库:全站 345 个脚本的首行都是 #!/usr/bin/env python3,没有第三方依赖,也就没有环境冲突要调。
在 SkillHub 上一键安装即可,主流 AI 客户端都能装。运行是只读 + 输出到 _out/,你原来的账套和表格一个字节都不会被动。
【财友云】输入政策文件/文号清单,比对政策有效期与废止状态,输出「即将到期/已废止/仍有效」提醒与转交建议,严守"以主管机关口径为准"的边界。
【财友云】内置国家税务总局税收法规库的法规条目索引离线快照(约 5,473 条),按法规名称、关键词或税种检索,逐条给出时效性(全文有效/已修改/全文失效/全文废止/尚未生效)、效力等级(法律/行政法规/部门规章/规范性文件)、发布日期、修订沿革注释与官方原文链接,并支持按「有效」或「废止」等时效性、按效力等级筛选。适用于下结论前先确认依据文件还生不生效、某一税种有哪些现行文件、文号文件被谁替代等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置出口退税率文库商品码表快照(约 3.2 万个 8/10 位商品代码),把待查编码按 HS 规则拆成「章 / 品目 / 子目 / 本国子目」四层,做 8/10 位位数校验,并在码表里命中官方商品名称与计量单位,同时给出《进出口税则》归类总规则(GRI 1–6)的方法论提示。适用于外贸 / 财税人员核对编码层级写对没写对、按名称反查可能的编码、编码位数自检等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置国务院关税税则委员会《2026年关税调整方案》五张附表离线快照(进口商品暂定税率表 935 条、关税配额商品税目税率表 47 条、出口商品税率表 107 条,另有税目调整表与本国子目注释调整表),按税则号列或商品名称查进口最惠国税率、2026 年暂定税率、关税配额税率与出口税率,并提示该税则号列是否涉及税目调整 / 子目注释变化。适用于进出口报价前核税率、判断「出口要不要交关税」、核对进口暂定税率适用等场景。数据为离线快照、版本可查,运行时零联网。
【财友云】内置财政部关税司(国务院关税税则委员会办公室)政策发布公告索引离线快照(497 条,2008–2026 年),按关键词或年份检索关税税则委员会公告,输出标题、发布日期与原文链接,并按发布日期倒序。适用于追踪「美国 / 加征 / 零关税 / 暂定税率 / 税则」等主题的最新关税政策、核对某年度关税公告清单、定位政策原文链接等场景。数据为离线快照、版本可查,运行时零联网;本包只做公告索引检索与定位,不做政策解读。
【财友云】把一句财税问题检索到权威官方口径——在内置的国家税务总局「互动交流」官方问答语料(394 条,跨 2021–2026)上做本地 BM25 检索,返回命中的官方问答原文要点 + 依据文号 + 发布日期 + 原文链接。检索不到就说检索不到并给官方入口,绝不拿「看起来相关」的问答凑答案。
【财友云】内置两套官方数据:① 国家税务总局「税收条约」栏目索引快照(142 条,含条约/协定名称与原文链接);② 国务院关税税则委员会《2026 年关税调整方案》附 6「自贸协定和优惠贸易安排实施税率表」(8,931 个税则号列 × 32 个协定/优惠安排)。按协定或国家名定位条约原文,按税则号列摘录各协定优惠税率。适用于查某国/某协定有没有税收协定、条约原文在哪、某税则号列在东盟/RCEP/韩国等协定下适用什么优惠税率等场景。只做条款与税率的定位与摘录,不做原产地判定。数据为离线快照、版本可查,运行时零联网。
【财友云】逐条核验财税法规的效力状态——现行有效、尚未生效、已修改、条款废止、条款失效、部分废止、条款修订、全文失效、全文废止等,判定依据以**官方时效性字段**为第一级来源(内置国家税务总局法规库效力快照,去重后 5,386 条),每条结论标注来源与置信分级,官方库未标注或未收录的一律标「须回官方核验」不猜。适用于引法前的效力自查、政策清理、存量制度梳理等场景。
【财友云】逐行判断研发费用能不能加计、加计多少,含「其他相关费用」10%÷(1−10%) 交叉限额与负面清单筛查,每条结论带条文号。认不出的费用标「需人工核实」。适用于研发费用归集、加计扣除自查、辅助账核对等场景。