Configurar impostos (TaxType e TaxRate)

O contable.io modela impostos com uma estrutura de dois níveis inspirada em SAP: a categoria (TaxType) e a tarifa específica (TaxRate). Isso permite agrupar tarifas relacionadas, herdar contas contábeis e modelar realidades complexas como IVA por origem, retenções por conceito ou ICA por município sem duplicar configuração.

Vem do modelo antigo? Antes havia um único registro “Tipo de imposto” que misturava categoria e tarifa. Agora cada categoria pode ter várias tarifas. As migrações automáticas converteram seus impostos existentes sem perda de dados.

O modelo em uma imagem

TaxType (categoria)              TaxRate (tarifa específica)
─────────────────                ───────────────────────────
IVA                              ├── 19% Geral
                                 ├── 5% Diferencial
                                 ├── 0% Isento
                                 └── Excluído

ReteFuente                       ├── Honorários 11%
                                 ├── Serviços 4%
                                 ├── Compras gerais 2,5%
                                 └── Autorretentor 0%

ReteICA Bogotá                   ├── Comerciais 11,04 ‰
                                 ├── Industriais 4,14 ‰
                                 └── Serviços 9,66 ‰

Cada TaxType define as contas contábeis padrão. Cada TaxRate herda essas contas mas pode sobrescrever qualquer uma se necessário.

TaxType: a categoria

Agrupa tarifas que compartilham natureza fiscal e, geralmente, contas contábeis. Campos: nome, código, tipo fiscal (IVA, RETENTION, OTHER), aplicação (vendas/compras), e contas contábeis para vendas, compras e devoluções.

TaxRate: a tarifa

É o que efetivamente se aplica a uma linha de fatura. Campos: TaxType pai, nome, porcentagem, vigência, e (opcional) override de contas.

Herança: se a TaxRate não especifica contas, usa as do TaxType. Isso evita duplicar configuração quando todas as tarifas compartilham contas (caso típico).

Quando você precisa de dois TaxTypes distintos

O sistema NÃO decide por lógica hardcoded qual conta usar. Se sua contabilidade precisa separar movimentos de imposto em contas distintas, crie dois TaxTypes, não duas TaxRates.

Necessidade	Solução
IVA nacional em 240801 vs IVA importações em 240803	Dois TaxTypes, cada um com sua conta.
ReteFuente honorários em 236505 vs compras em 236540	Dois TaxTypes (mais limpo).
ICA por cidade com contas distintas	Um TaxType “ICA” por cidade.

Quando bastam várias TaxRates

Se as tarifas compartilham contas e só muda a porcentagem, use um TaxType com várias TaxRates:

• IVA com tarifas 19%, 5%, 0% → um TaxType “IVA” com três TaxRates.
• ReteFuente por conceito tudo na mesma conta → um TaxType “ReteFuente” com tarifas por conceito.

Atribuição a produtos

Em Inventário → Produtos, cada produto tem dois campos opcionais: Tipo de imposto venda e Tipo de imposto compra. Ao agregar o produto a uma fatura, o sistema usa essas tarifas como sugestão e aplica as contas contábeis correspondentes.

Resolução de conta em uma linha de fatura

1. Produto tem tax_rate_id atribuída.
2. TaxRate tem seu override de conta ou herda do TaxType pai.
3. O auto-posting usa essa conta diretamente.
4. Se ambos vazios → fallback à lógica fiscal nativa da Colômbia.

Criar um TaxType

1. Vá em Configurações → Impostos → Tipos de imposto.
2. Toque em + Novo tipo.
3. Escolha tipo fiscal.
4. Atribua as contas contábeis.
5. Salve.

Criar uma TaxRate

1. Abra o TaxType pai.
2. Na aba Tarifas, toque em + Nova tarifa.
3. Defina nome, porcentagem e vigência.
4. Se precisar contas distintas, marque “Sobrescrever contas”.
5. Salve.

Erros comuns

• “O IVA está caindo numa conta errada”: revise a TaxRate do produto. A conta efetiva é TaxRate.account_override ?? TaxType.account.
• “Não posso eliminar um TaxType”: tem TaxRates ou produtos atribuídos. Primeiro migre.
• “Tarifas duplicadas após migração”: são a cabeçalho (TaxType) e a tarifa (TaxRate), não o mesmo registro.