findscripter 何时使用
适用于面向某个国家/地区落地 Odoo 财税合规的场景：
- 为特定国家的公司初始化 Odoo 会计（墨西哥、意大利、西班牙、美国、巴西、德国等）。
- 配置国家强制的电子发票（向税务机关提交电子发票，如墨西哥 CFDI、意大利 FatturaPA、波兰 SAF-T、哥伦比亚 DIAN）。
- 设置 VAT/GST/IVA 税则并配置正确的财政税位（fiscal position）。
- 生成法定税务报表（VAT 申报、SAF-T、DIAN 报送等）。
不该用边界：与本地化/合规无关的常规记账、Odoo 模块二次开发与数据建模，以及在已有官方本地化模块时仍手工搭建科目表的情况——本技能不替代针对具体环境的验证、测试与专业（税务/审计）复核。若国家、Odoo 版本、税号、证书等关键输入缺失，应先停下来追问。
步骤
- 确认前置信息：国家、Odoo 版本、公司税号（如 RFC/VAT ID）、公司类型。
- 选型本地化模块：按国家选择对应
l10n_*模块（见下表），它会装好正确的科目表、税种与税务报表。 - 安装模块：在「应用(Apps)」中搜索国家名安装，或用 CLI 安装。
- 配置公司与证书：填写国家、税号、公司类型；电子发票场景上传税务机关签发的证书与私钥。
- 配置税码与财政税位：用 fiscal position 自动切换不同客户（B2B/B2C、境内/出口）的税率。
- 先测后上线：在税务机关测试环境验证电子发票，再切生产。
指令
国家本地化模块对照表：
| 国家 | 模块 | 关键能力 |
|---|---|---|
| 美国 | l10n_us |
GAAP 科目表、薪酬（ADP 桥接）、1099 报送 |
| 墨西哥 | l10n_mx_edi |
CFDI 4.0 电子发票、SAT 对接、IEPS 税 |
| 西班牙 | l10n_es |
SII 实时 VAT、Modelo 303/390、AEAT |
| 意大利 | l10n_it_edi |
FatturaPA XML、SDI 报送、反向征收 |
| 波兰 | l10n_pl |
SAF-T JPK_FA、VAT-7 申报 |
| 巴西 | l10n_br |
NF-e、NFS-e、SPED、ICMS/PIS/COFINS |
| 德国 | l10n_de |
SKR03/SKR04 科目表、DATEV 导出、UStVA |
| 哥伦比亚 | l10n_co_edi |
DIAN 电子发票、UBL 2.1 |
CLI 安装与校验：
# 当模块不在 Apps 中时，通过 CLI 安装
./odoo-bin -d mydb --stop-after-init -i l10n_mx_edi
# 在 Odoo 中校验：
# Apps → Installed → 搜索 "l10n_mx" → 应显示为 Installed
示例
示例 1：配置墨西哥 CFDI 4.0
步骤 1：安装模块
Apps → 搜索 "Mexico" → 安装 "Mexico - Accounting"
另装："Mexico - Electronic Invoicing" (l10n_mx_edi)
步骤 2：配置公司
Settings → Company → [你的公司]
Country: Mexico
RFC: 你的 RFC 税号
Company Type: Moral Person 或 Physical Person
步骤 3：上传 SAT 证书
Accounting → Configuration → Certificates → New
CSD 证书 (SAT 签发的 .cer 文件)
私钥 (.key 文件)
Password: 你的 FIEL 密码
步骤 4：开具 CFDI 发票
创建发票 → 确认 → 自动生成 CFDI XML
报送 SAT → 取得 UUID (folio fiscal)
PDF 含二维码 + UUID 供买方核验
示例 2：欧盟内部交易 VAT 配置（任意欧盟国家）
菜单：Accounting → Configuration → Taxes → New
Tax Name: EU Intra-Community Sales (0%)
Tax Type: Sales
Tax Scope: Services 或 Goods
Tax Computation: Fixed
Amount: 0%
Tax Group: Intra-Community
发票上标签："Intra-Community Supply - VAT Exempt per Art. 138 VAT Directive"
财政税位（单独创建）：
Name: EU B2B Intra-Community
自动识别：Country Group = Europe 且 VAT Required = YES
税映射：Standard VAT Rate → 0% Intra-Community
注意事项
- 先装本地化模块，再录任何会计分录——它负责建立正确的科目结构。
- 用**财政税位（fiscal position）**自动切换国际客户税率（B2B vs B2C、境内 vs 出口）。
- 电子发票务必先在税务机关测试环境验证再上线。
- 已有对应国家本地化模块时，不要手工创建科目表。
- 不要把本地化税务科目与自建科目混用——会破坏税务报表。
- 输出不能替代针对具体环境的验证、测试与专业复核；缺少关键输入（国家、版本、税号、证书、权限、成功标准）时先追问。
互见
（无可关联的现有技能。）
本条采编自 sickn33/antigravity-awesome-skills（MIT）。