Odoo Localization & Compliance (l10n)
Overview
Odoo provides localization modules (l10n_*) for 80+ countries that configure the correct chart of accounts, tax types, and fiscal reporting. This skill helps you install and configure the right localization, set up country-specific e-invoicing (Mexico CFDI, Italy FatturaPA, Poland SAF-T), and ensure fiscal compliance.
When to Use This Skill
- Setting up Odoo for a company in a specific country (Mexico, Italy, Spain, US, etc.).
- Configuring country-required e-invoicing (electronic invoice submission to tax authorities).
- Setting up VAT/GST/IVA tax rules with correct fiscal positions.
- Generating required fiscal reports (VAT return, SAF-T, DIAN report).
How It Works
- Activate: Mention
@odoo-l10n-compliance and specify your country and Odoo version.
- Install: Get the exact localization module and configuration steps.
- Configure: Receive tax code setup, fiscal position rules, and reporting guidance.
Country Localization Modules
| Country |
Module |
Key Features |
| 🇺🇸 USA |
l10n_us |
GAAP CoA, Payroll (ADP bridge), 1099 reporting |
| 🇲🇽 Mexico |
l10n_mx_edi |
CFDI 4.0 e-invoicing, SAT integration, IEPS tax |
| 🇪🇸 Spain |
l10n_es |
SII real-time VAT, Modelo 303/390, AEAT |
| 🇮🇹 Italy |
l10n_it_edi |
FatturaPA XML, SDI submission, reverse charge |
| 🇵🇱 Poland |
l10n_pl |
SAF-T JPK_FA, VAT-7 return |
| 🇧🇷 Brazil |
l10n_br |
NF-e, NFS-e, SPED, ICMS/PIS/COFINS |
| 🇩🇪 Germany |
l10n_de |
SKR03/SKR04 CoA, DATEV export, UStVA |
| 🇨🇴 Colombia |
l10n_co_edi |
DIAN e-invoicing, UBL 2.1 |
Examples
Example 1: Configure Mexico CFDI 4.0
Step 1: Install module
Apps → Search "Mexico" → Install "Mexico - Accounting"
Also install: "Mexico - Electronic Invoicing" (l10n_mx_edi)
Step 2: Configure Company
Settings → Company → [Your Company]
Country: Mexico
RFC: Your RFC number (tax ID)
Company Type: Moral Person or Physical Person
Step 3: Upload SAT Certificates
Accounting → Configuration → Certificates → New
CSD Certificate (.cer file from SAT)
Private Key (.key file from SAT)
Password: Your FIEL password
Step 4: Issue a CFDI Invoice
Create invoice → Confirm → CFDI XML generated automatically
Sent to SAT → Receive UUID (folio fiscal)
PDF includes QR code + UUID for buyer verification
Example 2: EU Intra-Community VAT Setup (Any EU Country)
Menu: Accounting → Configuration → Taxes → New
Tax Name: EU Intra-Community Sales (0%)
Tax Type: Sales
Tax Scope: Services or Goods
Tax Computation: Fixed
Amount: 0%
Tax Group: Intra-Community
Label on Invoice: "Intra-Community Supply - VAT Exempt per Art. 138 VAT Directive"
Fiscal Position (created separately):
Name: EU B2B Intra-Community
Auto-detect: Country Group = Europe + VAT Required = YES
Tax Mapping: Standard VAT Rate → 0% Intra-Community
Example 3: Install and Validate a Localization
# Install via CLI (if module not in Apps)
./odoo-bin -d mydb --stop-after-init -i l10n_mx_edi
# Verify in Odoo:
# Apps → Installed → Search "l10n_mx" → Should show as Installed
Best Practices
- ✅ Do: Install the localization module before creating any accounting entries — it sets up the correct accounts.
- ✅ Do: Use Fiscal Positions to automate tax switching for international customers (B2B vs B2C, domestic vs export).
- ✅ Do: Test e-invoicing in the SAT/tax authority test environment before going live.
- ❌ Don't: Manually create a chart of accounts if a localization module exists for your country.
- ❌ Don't: Mix localization tax accounts with custom accounts — it breaks fiscal reports.
Limitations
- Use this skill only when the task clearly matches the scope described above.
- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.
- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.
Source: sickn33/agentic-awesome-skills → skills/odoo-l10n-compliance/SKILL.md
Also appears in: sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills/skills/odoo-l10n-compliance/SKILL.md, sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills-claude/skills/odoo-l10n-compliance/SKILL.md
1---2name: odoo-l10n-compliance3description: Country-specific Odoo localization: tax configuration, e-invoicing (CFDI, FatturaPA, SAF-T), fiscal reporting, and country chart of accounts setup.4---567# Odoo Localization & Compliance (l10n)89## Overview1011Odoo provides localization modules (`l10n_*`) for 80+ countries that configure the correct chart of accounts, tax types, and fiscal reporting. This skill helps you install and configure the right localization, set up country-specific e-invoicing (Mexico CFDI, Italy FatturaPA, Poland SAF-T), and ensure fiscal compliance.1213## When to Use This Skill1415- Setting up Odoo for a company in a specific country (Mexico, Italy, Spain, US, etc.).16- Configuring country-required e-invoicing (electronic invoice submission to tax authorities).17- Setting up VAT/GST/IVA tax rules with correct fiscal positions.18- Generating required fiscal reports (VAT return, SAF-T, DIAN report).1920## How It Works21221. **Activate**: Mention `@odoo-l10n-compliance` and specify your country and Odoo version.232. **Install**: Get the exact localization module and configuration steps.243. **Configure**: Receive tax code setup, fiscal position rules, and reporting guidance.2526## Country Localization Modules2728| Country | Module | Key Features |29|---|---|---|30| 🇺🇸 USA | `l10n_us` | GAAP CoA, Payroll (ADP bridge), 1099 reporting |31| 🇲🇽 Mexico | `l10n_mx_edi` | CFDI 4.0 e-invoicing, SAT integration, IEPS tax |32| 🇪🇸 Spain | `l10n_es` | SII real-time VAT, Modelo 303/390, AEAT |33| 🇮🇹 Italy | `l10n_it_edi` | FatturaPA XML, SDI submission, reverse charge |34| 🇵🇱 Poland | `l10n_pl` | SAF-T JPK_FA, VAT-7 return |35| 🇧🇷 Brazil | `l10n_br` | NF-e, NFS-e, SPED, ICMS/PIS/COFINS |36| 🇩🇪 Germany | `l10n_de` | SKR03/SKR04 CoA, DATEV export, UStVA |37| 🇨🇴 Colombia | `l10n_co_edi` | DIAN e-invoicing, UBL 2.1 |3839## Examples4041### Example 1: Configure Mexico CFDI 4.04243```44Step 1: Install module45 Apps → Search "Mexico" → Install "Mexico - Accounting"46 Also install: "Mexico - Electronic Invoicing" (l10n_mx_edi)4748Step 2: Configure Company49 Settings → Company → [Your Company]50 Country: Mexico51 RFC: Your RFC number (tax ID)52 Company Type: Moral Person or Physical Person5354Step 3: Upload SAT Certificates55 Accounting → Configuration → Certificates → New56 CSD Certificate (.cer file from SAT)57 Private Key (.key file from SAT)58 Password: Your FIEL password5960Step 4: Issue a CFDI Invoice61 Create invoice → Confirm → CFDI XML generated automatically62 Sent to SAT → Receive UUID (folio fiscal)63 PDF includes QR code + UUID for buyer verification64```6566### Example 2: EU Intra-Community VAT Setup (Any EU Country)6768```69Menu: Accounting → Configuration → Taxes → New7071Tax Name: EU Intra-Community Sales (0%)72Tax Type: Sales73Tax Scope: Services or Goods74Tax Computation: Fixed75Amount: 0%76Tax Group: Intra-Community7778Label on Invoice: "Intra-Community Supply - VAT Exempt per Art. 138 VAT Directive"7980Fiscal Position (created separately):81 Name: EU B2B Intra-Community82 Auto-detect: Country Group = Europe + VAT Required = YES83 Tax Mapping: Standard VAT Rate → 0% Intra-Community84```8586### Example 3: Install and Validate a Localization8788```bash89# Install via CLI (if module not in Apps)90./odoo-bin -d mydb --stop-after-init -i l10n_mx_edi9192# Verify in Odoo:93# Apps → Installed → Search "l10n_mx" → Should show as Installed94```9596## Best Practices9798- ✅ **Do:** Install the localization module **before** creating any accounting entries — it sets up the correct accounts.99- ✅ **Do:** Use **Fiscal Positions** to automate tax switching for international customers (B2B vs B2C, domestic vs export).100- ✅ **Do:** Test e-invoicing in the **SAT/tax authority test environment** before going live.101- ❌ **Don't:** Manually create a chart of accounts if a localization module exists for your country.102- ❌ **Don't:** Mix localization tax accounts with custom accounts — it breaks fiscal reports.103104## Limitations105- Use this skill only when the task clearly matches the scope described above.106- Do not treat the output as a substitute for environment-specific validation, testing, or expert review.107- Stop and ask for clarification if required inputs, permissions, safety boundaries, or success criteria are missing.108109---110111**Source:** [`sickn33/agentic-awesome-skills`](https://github.com/sickn33/agentic-awesome-skills) → `skills/odoo-l10n-compliance/SKILL.md`112113**Also appears in:** `sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills/skills/odoo-l10n-compliance/SKILL.md`, `sickn33/agentic-awesome-skills/plugins/agentic-awesome-skills-claude/skills/odoo-l10n-compliance/SKILL.md`