---

name: odoo-l10n-compliance description: "国家特定的 Odoo 本地化：税务配置、电子发票（CFDI、FatturaPA、SAF-T）、财务报告和国家会计科目表设置。" risk: unknown source: community

Odoo 本地化与合规（l10n）

概述

Odoo 为 80 多个国家提供本地化模块（l10n_*），配置正确的会计科目表、税种和财务报告。此技能帮助你安装和配置正确的本地化、设置国家特定的电子发票（墨西哥 CFDI、意大利 FatturaPA、波兰 SAF-T），并确保财务合规。

何时使用此技能

• 为特定国家（墨西哥、意大利、西班牙、美国等）的公司设置 Odoo。
• 配置国家要求的电子发票（向税务机关提交电子发票）。
• 设置包含正确财务状况的增值税/GST/IVA 税务规则。
• 生成所需的财务报告（增值税申报、SAF-T、DIAN 报告）。

工作原理

1. 激活：提及 @odoo-l10n-compliance 并指定你的国家和 Odoo 版本。
2. 安装：获取确切的本地化模块和配置步骤。
3. 配置：接收税码设置、财务状况规则和报告指导。

国家本地化模块

| 国家 | 模块 | 主要功能 | |---|---|---| | 🇺🇸 美国 | l10n_us | GAAP 科目表、薪资（ADP 桥接）、1099 报告 | | 🇲🇽 墨西哥 | l10n_mx_edi | CFDI 4.0 电子发票、SAT 集成、IEPS 税 | | 🇪🇸 西班牙 | l10n_es | SII 实时增值税、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 |

示例

示例 1：配置墨西哥 CFDI 4.0

步骤 1：安装模块
  应用 → 搜索 "Mexico" → 安装 "Mexico - Accounting"
  同时安装："Mexico - Electronic Invoicing" (l10n_mx_edi)

步骤 2：配置公司
  设置 → 公司 → [你的公司]
  国家：墨西哥
  RFC：你的 RFC 号码（税务 ID）
  公司类型：法人或自然人

步骤 3：上传 SAT 证书
  会计 → 配置 → 证书 → 新建
  CSD 证书（来自 SAT 的 .cer 文件）
  私钥（来自 SAT 的 .key 文件）
  密码：你的 FIEL 密码

步骤 4：开具 CFDI 发票
  创建发票 → 确认 → 自动生成 CFDI XML
  发送至 SAT → 接收 UUID（财务凭证号）
  PDF 包含二维码 + UUID 供买方验证

示例 2：欧盟共同体内增值税设置（任何欧盟国家）

菜单：会计 → 配置 → 税务 → 新建

税务名称：欧盟共同体内销售（0%）
税务类型：销售
税务范围：服务或商品
税务计算：固定
金额：0%
税务组：共同体内

发票标签："共同体内供应 - 根据增值税指令第 138 条免税"

财务状况（单独创建）：
  名称：欧盟 B2B 共同体内
  自动检测：国家组 = 欧洲 + 需要增值税 = 是
  税务映射：标准增值税率 → 0% 共同体内

示例 3：安装和验证本地化

# 通过 CLI 安装（如果模块不在应用中）
./odoo-bin -d mydb --stop-after-init -i l10n_mx_edi

# 在 Odoo 中验证：
# 应用 → 已安装 → 搜索 "l10n_mx" → 应显示为已安装

最佳实践

• ✅ 应该： 在创建任何会计分录之前安装本地化模块——它会设置正确的科目。
• ✅ 应该： 使用财务状况为国际客户自动切换税务（B2B 与 B2C、国内与出口）。
• ✅ 应该： 在上线前在SAT/税务机关测试环境中测试电子发票。
• ❌ 不应该： 如果你的国家存在本地化模块，不要手动创建会计科目表。
• ❌ 不应该： 将本地化税务科目与自定义科目混合——这会破坏财务报告。

限制

• 仅在任务明确匹配上述范围时使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少所需的输入、权限、安全边界或成功标准，请停下来寻求澄清。