Odoo for Brazil: NF-e, Fiscal Localization & Tax Guide

Brazilian Tax Complexity

Brazil has one of the most complex tax systems in the world. Multiple overlapping taxes (ICMS, IPI, PIS, COFINS, ISS, IRPJ, CSLL), electronic fiscal documents (NF-e), and state-specific rules make Brazilian localization challenging for any ERP.

Odoo Brazilian Localization

The OCA (Odoo Community Association) maintains the Brazilian localization via the l10n-brazil project. It provides: Brazilian chart of accounts, tax computation for all major taxes, NF-e generation and transmission, fiscal document management, and CNPJ/CPF validation.

Key Components

Tax Structure

# Major Brazilian taxes:
# ICMS — State sales tax (varies 7-18% by state + interstate)
# IPI — Federal excise tax on manufactured goods (0-15%)
# PIS — Social contribution (0.65-1.65%)
# COFINS — Social security contribution (3-7.6%)
# ISS — Municipal service tax (2-5%)
# IRPJ — Corporate income tax
# CSLL — Social contribution on profit

# Tax regimes:
# Simples Nacional — Simplified for small businesses
# Lucro Presumido — Presumed profit
# Lucro Real — Actual profit (full tax computation)

NF-e (Nota Fiscal Eletrônica)

# NF-e is mandatory for all goods transactions:
# 1. Generate XML document with all fiscal data
# 2. Sign with digital certificate (e-CNPJ)
# 3. Transmit to SEFAZ (state tax authority)
# 4. Receive authorization (protocolo)
# 5. Print DANFE (simplified PDF for transport)
# 6. Store XML for 5 years

# OCA l10n-brazil modules handle:
# - XML generation in NF-e 4.0 schema
# - Digital signature with A1/A3 certificates
# - SEFAZ transmission and response handling
# - DANFE PDF generation
# - NF-e cancellation and correction

CNPJ/CPF

# Every Brazilian partner needs:
# CNPJ: 14-digit company registration (like EIN/TIN)
# CPF: 11-digit individual registration
# IE: State registration (Inscrição Estadual)
# IM: Municipal registration (Inscrição Municipal)

# Odoo l10n-brazil adds these fields to res.partner
# with validation (check digit verification)

Installation

# Clone OCA l10n-brazil:
git clone https://github.com/OCA/l10n-brazil.git --branch 19.0

# Key modules:
# l10n_br_base — Base (CNPJ, CPF, address)
# l10n_br_account — Accounting (chart of accounts, taxes)
# l10n_br_fiscal — Fiscal framework
# l10n_br_nfe — NF-e generation and transmission
# l10n_br_stock — Stock with fiscal documents

ICMS Interstate Rates

DeployMonkey for Brazil

Deploy Odoo for your Brazilian business on DeployMonkey. The AI agent helps install and configure the Brazilian localization — NF-e, tax setup, CNPJ validation, and fiscal documents.