用途
Odoo 本地化与合规(l10n)技能用于为特定国家的公司配置 Odoo 会计本地化。Odoo 提供 80 多个国家的本地化模块(l10n_*),可配置正确的会计科目表、税种和财政报告。该技能帮助安装和配置合适的本地化模块,设置国家特定的电子发票,并确保财政合规。
何时使用
- 为特定国家(墨西哥、意大利、西班牙、美国等)的公司设置 Odoo。
- 配置国家要求的电子发票(向税务机关提交电子发票)。
- 设置带正确财政位置的增值税/消费税/IVA 税规则。
- 生成所需的财政报告(增值税申报表、SAF-T、DIAN 报告)。
工作方式
- 激活:提及 @odoo-l10n-compliance 并指定你的国家和 Odoo 版本。
- 安装:获取确切的本地化模块和配置步骤。
- 配置:接收税码设置、财政位置规则和报告指导。
国家本地化模块
| 国家 | 模块 | 主要功能 |
|---|---|---|
| 美国 | 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 编号(税号)
- 公司类型:法人或自然人
步骤 3:上传 SAT 证书
- 会计 → 配置 → 证书 → 新建
- CSD 证书(来自 SAT 的 .cer 文件)
- 私钥(来自 SAT 的 .key 文件)
- 密码:你的 FIEL 密码
步骤 4:开具 CFDI 发票
- 创建发票 → 确认 → 自动生成 CFDI XML
- 发送至 SAT → 接收 UUID(财政 folio)
- PDF 包含二维码 + UUID 供买方验证
示例 2:欧盟内部增值税设置(任意欧盟国家)
菜单:会计 → 配置 → 税 → 新建
- 税名:EU Intra-Community Sales (0%)
- 税类型:销售
- 税范围:服务或商品
- 税计算:固定
- 金额:0%
- 税组:Intra-Community
- 发票标签:“Intra-Community Supply - VAT Exempt per Art. 138 VAT Directive”
财政位置(单独创建):
- 名称:EU B2B Intra-Community
- 自动检测:国家组 = 欧洲 + 需要增值税 = 是
- 税映射:标准增值税率 → 0% 欧盟内部
示例 3:安装并验证本地化
# 通过 CLI 安装(如果模块不在应用中)
./odoo-bin -d mydb --stop-after-init -i l10n_mx_edi
# 在 Odoo 中验证:
# 应用 → 已安装 → 搜索“l10n_mx” → 应显示为已安装
最佳实践
- 建议:在创建任何会计条目之前安装本地化模块——它会设置正确的科目。
- 建议:使用财政位置为国际客户自动切换税(B2B 与 B2C、国内与出口)。
- 建议:在正式上线前,在 SAT/税务机关测试环境中测试电子发票。
- 避免:如果存在适用于你国家的本地化模块,不要手动创建会计科目表。
- 避免:不要将本地化税科目与自定义科目混用——这会破坏财政报告。
限制
- 仅在任务明确匹配上述范围时使用此技能。
- 不要将输出视为环境特定验证、测试或专家审查的替代品。
- 如果缺少必需的输入、权限、安全边界或成功标准,请停止并请求澄清。