Atualização de Tabelas do Sistema¶

Utilitários > Atualização de Tabelas do Sistema

O que é¶

A Atualização de Tabelas do Sistema é o módulo responsável por manter as tabelas fiscais e legais do Master Key atualizadas. Essas tabelas são fornecidas pela equipe de suporte Office System e contêm dados que mudam por legislação federal, como alíquotas de tributos e classificações de produtos.

As tabelas gerenciadas por este módulo incluem:

NCM — Nomenclatura Comum do Mercosul (classificação fiscal de produtos)
IBPT — Alíquotas tributárias por NCM (federal, estadual, municipal) por UF
IBGE — Cidades — Tabela de municípios brasileiros
CEST — Código Especificador da Substituição Tributária
CST — ICMS — Situação Tributária do ICMS
CST — PIS/COFINS — Situação Tributária de PIS e COFINS
ECF — CNIEE — Tabela de equipamentos ECF homologados
ANP — Produtos combustíveis da Agência Nacional do Petróleo
SiTef Adquirentes / SiTef Bandeiras — Tabelas de meios de pagamento eletrônico (TEF)
Intermediadores — Marketplaces e intermediadores de pagamento para NF-e

Utilize este módulo sempre que a equipe de suporte informar que há atualizações disponíveis, ou quando o sistema emitir alertas sobre tabelas desatualizadas. Em geral, atualizar estas tabelas é necessário após mudanças de legislação (novas alíquotas IBPT, revisão da tabela NCM, novos municípios IBGE, etc.).

Como acessar¶

No menu principal, clique em Utilitários → Atualização de Tabelas do Sistema.

Como usar¶

Verificar quais tabelas precisam de atualização¶

Ao abrir o módulo, o sistema executa automaticamente a verificação de atualizações. O processo consulta o servidor da Office System via internet e compara as versões disponíveis com as versões instaladas no banco de dados.

A grade exibe as tabelas com as colunas:

Tabela — nome da tabela fiscal
Versão Atual — versão já instalada no banco
Versão Disponível — versão que pode ser baixada
Barra de progresso (coluna visual) — indica o status: Atualizado (verde), desatualizado (branco) ou não foi possível verificar (vermelho)

Por padrão, a tela exibe apenas as tabelas que precisam de atualização. Para ver todas, marque a opção Mostrar Todas as Atualizações.

Para atualizar a verificação manualmente, clique em Verificar Atualizações.

Selecionar e instalar atualizações¶

Na grade, marque o checkbox da primeira coluna nas tabelas que deseja atualizar. Tabelas já atualizadas não possuem checkbox disponível.
Clique em Atualizar Tabelas.
O sistema irá baixar os arquivos necessários do servidor da Office System (requer conexão com a internet). A barra de progresso de cada tabela vai se preenchendo conforme o download avança.
Após o download, o sistema importa os dados automaticamente para o banco Firebird.
Aguarde a conclusão do processo. Não feche a tela durante a importação.

Atenção: antes de executar atualizações de tabelas, recomenda-se fazer backup do banco de dados. Em caso de dúvida, acione o suporte técnico. Algumas tabelas (como IBPT e NCM) afetam diretamente a emissão de NF-e e o cálculo de tributos. Não utilize este módulo sem orientação do suporte caso o sistema esteja em produção e não haja certeza da necessidade de atualização.

Nota: a tabela de Troca NCM é atualizada automaticamente pelo sistema sem necessidade de aprovação manual e não aparece nesta tela.

Campos desta tela¶

Campo	O que é	Observações
Mostrar Todas as Atualizações	Exibe na grade todas as tabelas, inclusive as já atualizadas	Por padrão exibe apenas as desatualizadas
Checkbox (primeira coluna da grade)	Marca a tabela para ser atualizada	Disponível apenas para tabelas com atualização pendente
Tabela	Nome identificador da tabela fiscal	Ex: NCM, IBPT - SP, CEST
Versão Atual	Versão da tabela instalada no banco de dados local	Comparada com a versão do servidor
Versão Disponível	Versão mais recente disponível no servidor Office System	Vazia quando não foi possível verificar
Barra de progresso	Indica o percentual de download/importação ou o status (Atualizado / erro)	Visual: verde = atualizado, vermelho = não verificado
Verificar Atualizações	Botão que re-executa a consulta ao servidor e atualiza a lista	Útil quando não há internet no momento de abrir a tela
Atualizar Tabelas	Botão que inicia o download e importação das tabelas marcadas	-

Regras e comportamentos do sistema¶

A verificação de atualizações é feita automaticamente ao abrir a tela (evento FormShow).
Quando não há conexão com a internet, o sistema busca arquivos de atualização localmente na pasta tabelas dentro do diretório do executável. Os arquivos locais reconhecidos seguem o padrão de nomes: NCM_versao.csv, CSTICMS_versao.txt, CEST_versao.txt, CSTPISCOFINS_versao.zip, IBGECIDADES_versao.txt, ECFCNIEE_versao.txt, ANP_versao.txt, entre outros.
A integridade dos arquivos baixados é verificada por MD5. Se o arquivo baixado não corresponder ao hash esperado, ele é descartado automaticamente.
A atualização da tabela NCM força também a verificação das tabelas IBPT correspondentes, pois a atualização de NCM pode invalidar as alíquotas cadastradas.
A tabela IBPT é separada por UF (ex: IBPT - SP, IBPT - RJ). Apenas as UFs configuradas na filial são atualizadas.
A ordem de importação das tabelas segue prioridade: NCM primeiro, depois CEST, depois IBPT, depois as demais.
Após a importação de cada tabela, o arquivo local baixado é excluído da pasta tabelas.
Após a atualização da tabela IBPT, o parâmetro FONTE_TRIBUTOS da tabela PARAMESP é atualizado automaticamente para 'IBPT'.
Tabelas marcadas como "não importantes" (definição interna do sistema) não são selecionadas automaticamente para atualização e precisam ser marcadas manualmente pelo usuário.

Dúvidas frequentes¶

O sistema precisa de internet para atualizar as tabelas? Preferencialmente sim. O sistema consulta o servidor da Office System para verificar versões e baixar os arquivos. Se não houver internet, ele tenta encontrar os arquivos na pasta local tabelas. Neste caso, os arquivos devem ter sido disponibilizados pelo suporte técnico.

Com que frequência devo atualizar as tabelas? Sempre que o suporte técnico orientar ou quando houver mudanças de legislação (novas alíquotas IBPT divulgadas semestralmente, revisões de NCM, novos municípios IBGE). O próprio sistema indica quando há atualizações disponíveis ao abrir este módulo.

O que acontece se eu fechar a tela durante a importação? A importação pode ficar incompleta, deixando a tabela em estado inconsistente. Aguarde sempre a conclusão do processo antes de fechar a tela.

A atualização afeta todas as filiais? Sim. As tabelas fiscais são compartilhadas por todo o banco de dados e afetam todas as filiais.

A tabela de NCM precisa ser atualizada com frequência? A tabela NCM é revisada pelo governo periodicamente. A tabela IBPT (alíquotas) muda semestralmente (normalmente em julho e janeiro). O suporte técnico notifica quando há novas versões disponíveis.