Assistente de Carga Inicial de Impostos
O Assistente de Carga Inicial de Impostos carrega todo o regramento fiscal de um país com um clique. Em vez de construir manualmente jurisdições, tipos de impostos, regras, contas contábeis e mapeamentos, você escolhe um país, revisa o pacote e o executa — e a base que você leu ao longo desta categoria aparece, pronta para uso.
Acesso necessário. Executar o assistente requer o conjunto de permissões Accounting Admin v2; o Accounting Controller v2 também consegue acessar o console. Os conjuntos Accounts Payable v2 e Accounts Receivable v2 não conseguem vê-lo — é uma função exclusiva de administrador.
O que uma execução cria
Um pacote de país constrói todo o regramento, na ordem correta de dependências, em uma única operação:
| Cria… | Para que… |
|---|---|
| Jurisdições (país + subnacional) | a geografia exista, o país antes dos níveis subordinados |
| Tipos de impostos e Perfis fiscais de terceiros/Perfis fiscais | o vocabulário fique definido |
| Operações fiscais (quando necessário) | a lógica de operações interestaduais/exportação funcione |
| Regras fiscais | as alíquotas corretas sejam aplicadas nas condições certas |
| Contas contábeis e Mapeamentos contábeis de impostos | o imposto tenha para onde ser contabilizado |
| Regras e alíquotas de retenção na fonte | a retenção (TDS, IRRF…) esteja pronta |
A execução é tudo ou nada: se algo falhar, toda a execução é revertida, então você nunca fica com um regramento fiscal pela metade.
Usando o assistente
O assistente é o componente Financial Setup Wizard — seu administrador o inclui em uma App Page uma única vez. A tela dele se chama CoA & Tax Seeding, com os países agrupados sob guias de continente (All · Americas · Europe · Asia-Pacific · Middle East & Africa) e um indicador de status em cada um: Seeded, Partial ou Not Seeded.
Modos de carga — seguros para reexecutar
Como todo registro carregado tem um código estável (um ID externo), o assistente pode ser executado repetidamente sem criar duplicidades. Três modos controlam o comportamento de uma reexecução:
| Modo (como o assistente descreve) | Use quando |
|---|---|
| Insert Only — “add new records, skip existing (safe, idempotent)” | Na primeira carga, ou para complementar um pacote sem tocar no que já está em vigor — a opção padrão e mais cautelosa |
| Upsert — “update existing records by Code if found, insert new” | Ao aplicar uma atualização de pacote: os registros correspondentes são atualizados com os valores do pacote, e o que você mesmo adicionou permanece intocado |
| Replace — “DELETE all existing country data, then re-seed (destructive)” | Apenas para uma reinicialização deliberada do regramento fiscal de um país — ele exclui primeiro os dados já carregados do país, incluindo registros que você editou |
Lidando com uma mudança de regime tributário
A legislação tributária muda — alíquotas se alteram, impostos são criados ou extintos, regimes inteiros são reformados (a transição do Brasil para CBS/IBS entre 2026 e 2033 é um exemplo em curso). A REDA trata isso com datas de vigência, e não excluindo dados:
- Uma regra que está sendo extinta recebe uma data de fim de vigência (por exemplo, PIS/COFINS até 31 de dezembro de 2026). O motor simplesmente para de aplicá-la após essa data.
- Uma regra nova recebe uma data de início de vigência (por exemplo, CBS a partir de 1 de janeiro de 2027). O motor começa a aplicá-la a partir dessa data.
As duas versões coexistem nos dados, e o motor escolhe a correta pela data do documento — assim, uma fatura de 2026 continua sendo calculada com as regras de 2026 e uma fatura de 2027 usa as regras de 2027. O histórico é preservado automaticamente, o que é importante para auditorias, retificações e notas de crédito referentes a faturas antigas. Quando a mudança entra em vigor, basta executar novamente o assistente no modo Upsert com o pacote atualizado.
O que está disponível — cobertura
| Região | Pacotes |
|---|---|
| Europa | 25 |
| Ásia-Pacífico | 17 |
| Oriente Médio e África | 17 |
| Américas | 11 |
| Global (plano de contas IFRS Core) | 1 |
A Referência de Países com Pacote de Impostos lista o conteúdo de cada pacote. Precisa de um país que ainda não está disponível? Você pode construir o regramento manualmente usando os objetos desta categoria — ou nos avise; novos pacotes são adicionados ao longo do tempo.
Depois da carga — quatro coisas a fazer
- Aponte os mapeamentos contábeis para o seu plano de contas. O pacote cria contas e mapeamentos de imposto padrão; redirecione-os para suas próprias contas (ou mantenha os carregados).
- Registre suas entidades. Adicione Registros fiscais de entidade para as jurisdições onde você cobra imposto — sem eles, nenhum imposto é cobrado.
- Classifique seus produtos e terceiros. Defina a Jurisdição fiscal e o Perfil fiscal do terceiro em suas entidades e contas, e classifique os produtos por meio dos perfis fiscais (ou do sinalizador Apply Default Tax).
- Em configurações multimoeda, verifique a moeda das regras de retenção. As regras de retenção carregadas assumem a moeda padrão da sua organização, e os limiares são comparados na moeda da regra — um limiar de ₹30.000 em uma regra denominada em dólares é um limiar de US$ 30.000. Corrija a moeda antes de confiar nas regras.
Os guias por país mostram isso do início ao fim.
O que vem a seguir
- Referência de Países com Pacote de Impostos — o catálogo completo de pacotes.
- Jurisdições fiscais — registros que o assistente cria.
- Regras fiscais — regras que o assistente carrega para você.
- IVA do Reino Unido — um país carregado na prática.
Perguntas frequentes
Sim. Os registros são identificados por seus códigos, então executar novamente (no modo Upsert) atualiza os registros existentes e adiciona os novos sem duplicar nada. É a forma prevista de aplicar atualizações de pacote.
No modo Upsert, somente os registros que correspondem a um código do pacote são alterados — suas próprias regras adicionadas, mapeamentos contábeis específicos de entidade e registros fiscais permanecem intactos. O modo Replace é diferente: ele exclui os dados carregados do país (incluindo suas edições nesses registros) antes de recarregar, então use-o apenas para uma reinicialização deliberada.
Ela não pode deixar um regramento fiscal parcialmente construído — a execução é tudo ou nada e reverte totalmente em caso de qualquer erro, informando o erro para que você possa corrigi-lo e executar novamente.
Não — carregue apenas os países em que você opera, um de cada vez. Você sempre pode adicionar outro depois; cada pacote é independente.
Isso foi útil?