Guia CoA & Tax Seeding
Um sistema contábil vazio é uma folha em branco que ninguém quer preencher: centenas de contas contábeis a definir, regras de impostos por país, regimes de retenção na fonte… A guia CoA & Tax Seeding substitui semanas disso por alguns cliques — seu banner é o próprio manual de instruções: "Faça a carga inicial do seu Plano de Contas, dos dados de referência fiscal e das regras de retenção na fonte. Comece pelo pacote Global de CoA e depois faça a carga inicial de cada país de operação."
Acesso necessário. A carga inicial exige 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 área exclusiva para administradores.
Lendo um cartão de pacote
A guia é uma biblioteca de pacotes, filtrada por região — All, Americas, Europe, Asia-Pacific, Middle East & Africa — com um cartão por pacote. Todo cartão traz as mesmas cinco informações:
| Elemento do cartão | O que informa / faz |
|---|---|
| Nome e descrição | O que o pacote é e o que ele carrega — por exemplo, "Global — IFRS Core CoA: plano de contas global alinhado ao IFRS… Execute-o primeiro, antes de qualquer pacote de país." A descrição é o próprio manual de instruções do pacote. |
| Linha de conteúdo | Uma contagem do que está incluído — o cartão Global traz "72 GL Accounts · Reporting Framework + Groups + Defaults" — para você conhecer o tamanho da mudança antes de tocar em qualquer coisa. |
| Selo SEEDED | Um selo verde indicando que esta organização já executou o pacote. Sem selo: ainda não foi carregado aqui. |
| Preview | Lista exatamente o que uma execução criaria — leia antes de toda primeira carga inicial. |
| Seed Data | Confirma o pacote. Seguro para executar novamente: atualiza os próprios registros em vez de duplicá-los. |
O que uma execução de carga inicial realmente cria
| Criado por | Categoria | O que fornece |
|---|---|---|
| Pacote Global | Contas contábeis | A base alinhada ao IFRS: caixa, contas de controle de AR/AP, despesas antecipadas, contas de impostos, patrimônio líquido, receita, CPV, custos operacionais e financeiros. |
| Estrutura de relatórios e grupos | A árvore de classificação sobre a qual suas demonstrações financeiras são construídas. | |
| Padrões contábeis globais | O registro de padrões válido para toda a organização na Guia de Configuração Financeira, já conectado às contas carregadas. | |
| Pacotes de país | Jurisdições fiscais | O país, chegando aos estados quando relevante. |
| Tipos e regras de imposto | Regimes de VAT, GST ou imposto sobre vendas, com suas alíquotas e regras. | |
| Classificações fiscais | Classificações de terceiros e produtos que o motor de impostos usa para fazer a correspondência. | |
| Retenção e contas locais | Regimes de retenção na fonte e quaisquer contas contábeis específicas do país. |
Passo 1 — O pacote Global, sempre primeiro
O pacote Global — IFRS Core estabelece a base que toda entidade compartilha: um plano de contas alinhado ao IFRS (caixa, contas de controle de AR/AP, despesas antecipadas, contas de impostos, patrimônio líquido, receita, CPV, custos operacionais e financeiros), a estrutura de relatórios com seus grupos de contas, e os Padrões contábeis globais já conectados a essas contas. Um clique, e uma organização vazia já pode contabilizar sua primeira fatura corretamente.
Passo 2 — Cada país de operação
Os pacotes de país (navegue por região) sobrepõem a realidade local: as jurisdições fiscais do país, chegando aos estados quando relevante, os tipos e regras de imposto (VAT, GST, impostos sobre vendas), as classificações fiscais de terceiros e produtos, os regimes de retenção na fonte e as contas específicas do país. Faça a carga inicial dos países onde suas entidades estão registradas — a organização da Meridian executa Global + EUA, e adicionará Reino Unido, Índia e Brasil conforme essas entidades entrarem em operação.
Mecânica da carga inicial que vale a pena conhecer
- Preview antes de confirmar — o Preview de cada cartão lista exatamente o que seria criado.
- Seguro para executar novamente — a carga inicial reconhece o que criou antes (o selo SEEDED); executar de novo atualiza em vez de duplicar. É assim também que as atualizações de alíquotas de imposto chegam: refaça a carga inicial do país, o histórico é preservado, as novas alíquotas ficam com data de vigência.
- Aditiva, não destrutiva — suas próprias contas e regras, ao lado das carregadas, permanecem intocadas.
- Carregado ≠ bloqueado — tudo o que um pacote cria é dado normal, que você pode estender (a Meridian adicionou suas contas de receita de aluguel ao lado do plano carregado; veja Criando e gerenciando contas contábeis).
Modo de semeadura — e o único ajuste que pode apagar
Quando você clica em Seed This Country, a caixa de confirmação oferece uma escolha de Modo de semeadura. Ela já vem na opção segura, e a maioria dos administradores nunca a altera:
| Modo | O que faz | Use quando |
|---|---|---|
| Apenas inserir (padrão) | Adiciona registros novos e ignora os que já existem — seguro e idempotente. | Sempre, a menos que você tenha um motivo específico para não usar. É o que torna inofensivo executar de novo. |
| Upsert | Atualiza os registros existentes correspondentes por Código e insere os demais. | Você quer que um pacote atualizado sobrescreva os valores semeados que você editou desde então. |
| Substituir | Exclui todos os dados existentes daquele país e semeia novamente do zero. A caixa de diálogo o rotula como destrutivo, e é literal. | Apenas para desfazer uma carga malfeita em uma sandbox ou em uma organização antes do go-live — nunca sobre livros que já carregam documentos contabilizados. |
O que impede uma carga antes de começar
- A moeda não está habilitada. Carregar os dados fiscais de um país exige que a moeda dele esteja ativa na organização: “Não é possível carregar os dados fiscais de [país]: a moeda [ISO] não está habilitada nesta organização. Adicione [ISO] em Gerenciar moedas na Configuração e execute a carga novamente.” Habilite a moeda primeiro e execute de novo.
Um exemplo prático — a sessão de carga inicial da Meridian
A administradora da Meridian Properties Group faz a carga inicial de uma organização nova em uma única sessão:
Fazer o preview do pacote Global
Ela clica em Preview no cartão Global — IFRS Core CoA e lê a lista: as contas fundamentais, a estrutura de relatórios com seus grupos e os padrões. A linha de conteúdo já prometia o formato — 72 GL Accounts · Reporting Framework + Groups + Defaults.
Fazer a carga inicial do Global
Seed Data é executado, e o cartão ganha seu selo verde SEEDED. A organização já pode contabilizar corretamente — e o registro de Padrões contábeis globais existe, já conectado.
Fazer a carga inicial do primeiro país de operação
Ela filtra por Americas, faz o preview e a carga inicial do pacote dos Estados Unidos — jurisdições, regras de imposto sobre vendas, classificações. A entidade dos EUA da Meridian será criada em seguida, copiando sua conexão do que já existe.
Voltar conforme o negócio cresce
Os pacotes do Reino Unido, Índia e Brasil esperam na biblioteca. Cada um recebe a carga inicial pouco antes de sua entidade entrar em operação — mesma rotina: filtrar por região, Preview, Seed Data, selo fica verde.
Erros comuns a evitar
| Erro | Por que prejudica | Faça isto em vez disso |
|---|---|---|
| Criar entidades antes da carga inicial | A criação de entidade copia as contas padrão da configuração carregada — uma entidade criada antes começa com uma conexão vazia que você teria de preencher manualmente | Faça a carga inicial do Global (e do país da entidade) primeiro, depois crie a entidade |
| Fazer a carga inicial de um pacote de país antes do pacote Global | A camada local não tem base à qual se conectar | Global primeiro — o próprio cartão informa isso |
| Pular o Preview na primeira carga inicial | Você confirma centenas de registros sem saber o que está por vir | O Preview custa um clique e lista todos os registros que uma execução criaria |
| Reconstruir o plano de contas manualmente em vez de estender o carregado | Semanas de trabalho, e a estrutura de relatórios deixa de corresponder às contas | Estenda: adicione suas próprias contas ao lado do plano carregado — tudo o que um pacote cria é dado normal e editável |
| Evitar refazer a carga inicial por medo de duplicatas | Sua organização perde as atualizações de alíquotas de imposto lançadas | Refaça a carga inicial com confiança — ela reconhece seus próprios registros e atualiza em vez de duplicar, com as novas alíquotas com data de vigência |
O que vem a seguir
- Assistente de carga inicial de impostos — o mergulho profundo no lado fiscal.
- Referência de Países com Pacote de Impostos — o que cada pacote contém.
- Práticas recomendadas de configuração do plano de contas — estendendo bem o plano carregado.
Perguntas frequentes
Faça a carga inicial do Global e depois monte manualmente a configuração fiscal daquele país — o motor de impostos é totalmente orientado por configuração, então nenhum pacote é obrigatório, apenas conveniente. E avise à REDA: os pacotes crescem por demanda.
Não — refazer a carga inicial atualiza os registros que ela criou (identificados por suas próprias chaves) e não toca em mais nada. Contas personalizadas, regras personalizadas, renomeações dos seus próprios registros: seguros.
Carga inicial primeiro — a criação de entidade copia suas contas padrão da configuração carregada. Uma entidade criada antes da carga inicial começa com uma conexão vazia que você teria de preencher manualmente.
Observe o cartão: um selo verde SEEDED significa que sim. Sem selo, ainda não. O selo é por organização, então uma sandbox e a produção mantêm cada uma sua própria verdade.
Sim — é exatamente para isso que serve o Preview: ele lista o que uma execução criaria, antes de qualquer coisa ser confirmada. A Referência de Países com Pacote de Impostos também documenta o conteúdo de cada pacote.
Não — faça a carga inicial apenas dos países onde suas entidades estão registradas. Pacotes extras adicionam configuração fiscal que ninguém usa. Os pacotes sempre podem receber a carga inicial mais tarde, no dia em que uma nova entidade de país entrar em operação.
Isso foi útil?