Localização e Conformidade do Odoo (l10n)

Visão Geral

O Odoo oferece módulos de localização (l10n_*) para mais de 80 países que configuram o plano de contas correto, tipos de impostos e relatórios fiscais. Esta habilidade ajuda você a instalar e configurar a localização correta, configurar a emissão de notas fiscais eletrônicas específicas do país (México CFDI, Itália FatturaPA, Polônia SAF-T) e garantir a conformidade fiscal.

Quando Usar Esta Habilidade

• Configurar o Odoo para uma empresa em um país específico (México, Itália, Espanha, EUA, etc.).
• Configurar a emissão de notas fiscais eletrônicas exigida pelo país (envio de faturas eletrônicas para as autoridades fiscais).
• Configurar regras de impostos sobre Valor Agregado (VAT/GST/IVA) com posições fiscais corretas.
• Gerar relatórios fiscais necessários (declaração de IVA, SAF-T, relatório DIAN).

Como Funciona

1. Ativar: Mencione @odoo-l10n-compliance e especifique seu país e versão do Odoo.
2. Instalar: Obtenha o módulo de localização exato e as etapas de configuração.
3. Configurar: Receba configuração de códigos de impostos, regras de posições fiscais e orientação de relatórios.

Módulos de Localização por País

Exemplos

Exemplo 1: Configurar México 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

Exemplo 2: Configuração de IVA Intra-Comunitário da UE (Qualquer País da UE)

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

Exemplo 3: Instalar e Validar uma Localização

# 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

Melhores Práticas

• ✅ Fazer: Instale o módulo de localização antes de criar quaisquer lançamentos contábeis — ele configura as contas corretas.
• ✅ Fazer: Use Posições Fiscais para automatizar a troca de impostos para clientes internacionais (B2B vs B2C, doméstico vs exportação).
• ✅ Fazer: Teste a emissão de notas fiscais eletrônicas no ambiente de teste SAT/autoridade fiscal antes de entrar em produção.
• ❌ Não fazer: Crie manualmente um plano de contas se um módulo de localização existir para o seu país.
• ❌ Não fazer: Misture contas de impostos de localização com contas personalizadas — isso quebra os relatórios fiscais.

Limitações

• Use esta habilidade apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate a saída como substituta para validação específica do ambiente, testes ou revisão especializada.
• Pare e peça esclarecimentos se os inputs necessários, permissões, limites de segurança ou critérios de sucesso estiverem ausentes.