Omie e Hult: como preparar a migração de cadastros sem levar duplicidades para o fechamento

Este é um guia prático, não o anúncio de uma funcionalidade nova. Migrar dados para um ERP parece uma tarefa de copiar e colar. Na prática, é uma mudança de base: nomes, documentos, categorias, contas correntes, produtos, contratos e títulos precisam obedecer às validações do sistema que vai recebê-los. Se a empresa leva cadastros duplicados ou incompletos para o Omie, o erro não fica restrito à planilha. Ele reaparece no faturamento, no financeiro, na conciliação e, depois, no fechamento contábil.

A própria Omie orienta revisar clientes e fornecedores antes da importação para identificar duplicidades. Também informa que contratos e contas a pagar ou a receber dependem de cadastros já existentes e de referências compatíveis, como categoria e conta corrente. O ponto central é simples: a migração deve começar pela qualidade dos dados, não pelo volume de linhas importadas.

O problema não é apenas “a planilha subir”

Uma importação concluída sem mensagem de erro não prova que a base ficou pronta para uso. Dois cadastros para o mesmo CNPJ podem dividir o histórico financeiro. Um título pode ficar associado ao fornecedor errado. Uma categoria criada apenas para acomodar a planilha pode não conversar com o plano contábil. Um produto sem revisão de NCM, unidade, origem ou tipo de item pode exigir correções justamente quando a empresa precisa faturar.

Para a contabilidade, a consequência aparece no fim do processo: mais exceções, mais perguntas ao cliente e menos confiança nos relatórios. A Hult pode trabalhar com o Omie como fonte organizada para o fechamento, mas isso depende de uma implantação em que os identificadores e as classificações sejam coerentes desde o início.

O que a documentação oficial da Omie exige na migração

No guia oficial de migração por planilha, publicado em 9 de outubro de 2024, a Omie informa que sistemas diferentes possuem validações próprias e que pode ser necessário ajustar os dados antes da transferência. Para clientes e fornecedores, a recomendação expressa é revisar a base e identificar possíveis duplicidades antes da importação.

Nos produtos, o guia aponta campos obrigatórios como código, NCM, unidade, local de estoque e tipo do produto para o Bloco K. Também recomenda inventário antes de importar o saldo de estoque. Nos contratos, o cliente precisa estar previamente cadastrado, enquanto categoria e conta corrente devem corresponder às informações existentes no Omie. Para contas a pagar e a receber, a lógica é semelhante: cliente ou fornecedor, categoria e conta corrente precisam estar preparados antes.

Há uma ordem técnica, portanto: primeiro os cadastros-base; depois as movimentações que dependem deles. Tentar inverter essa ordem costuma transformar a migração em uma sequência de correções manuais.

CNPJ e CPF ajudam a identificar, mas não corrigem uma base duplicada

A documentação do CRM Omie, publicada em 23 de outubro de 2025, traz um alerta importante. Quando existe mais de um cliente ou fornecedor com o mesmo CNPJ ou CPF, a conta do CRM é associada ao cadastro mais antigo. A Omie também informa que várias contas do CRM com o mesmo documento ficam vinculadas ao mesmo cadastro de cliente.

Outro cuidado: alterar o CNPJ ou CPF no cadastro do cliente não modifica automaticamente a conta correspondente no CRM e pode resultar na criação de um novo cliente. Excluir uma conta também não exclui o cliente, e o inverso igualmente não ocorre.

Isso não significa que o sistema esteja “errado”. Significa que a empresa precisa definir qual registro representa a contraparte válida e tratar exceções conscientemente. Desabilitar temporariamente a obrigatoriedade de CNPJ ou CPF pode ser um procedimento disponível para uma necessidade específica de importação, conforme o guia oficial, mas não deve virar uma estratégia para contornar a revisão de duplicidades.

Como preparar a base antes da importação

1. Defina o cadastro principal. Para cada CNPJ ou CPF, identifique qual registro será mantido e quais linhas são duplicadas, filiais, contatos ou situações realmente distintas.
2. Padronize os identificadores. Revise documentos, razão social, nome, e-mail e códigos internos. Evite criar variações apenas para fazer a planilha ser aceita.
3. Prepare as referências. Cadastre e valide categorias, contas correntes, departamentos, unidades e locais de estoque antes de importar movimentos que dependem deles.
4. Revise produtos com a contabilidade. NCM, origem da mercadoria, unidade e tipo do produto não são meros rótulos operacionais. A própria documentação da Omie recomenda validar com a contabilidade o tipo do produto usado no Bloco K.
5. Faça uma importação-piloto. Use uma amostra pequena, confira os vínculos e só depois avance para a base completa.
6. Concilie totais. Compare quantidades e saldos antes e depois: número de clientes ativos, fornecedores, produtos, títulos abertos, contratos e saldo de estoque.
7. Registre as exceções. Se um documento precisar permanecer duplicado, documente a razão, o responsável e o uso permitido.

Como isso facilita a integração com a Hult

Quando a base está organizada, a Hult recebe dados que podem ser relacionados com menos ambiguidade. O benefício não está apenas em importar um arquivo. Está em reduzir o tempo gasto para descobrir se “Fornecedor A”, “Fornecedor A Ltda.” e um terceiro cadastro com o mesmo CNPJ representam a mesma empresa.

Um fluxo proposto pode funcionar assim:

1. Cliente: extrai a base antiga, identifica responsáveis internos, esclarece duplicidades e confirma saldos e cadastros em uso.
2. Hult: orienta os campos que afetam classificação fiscal e contábil, revisa categorias e pontos sensíveis de produtos, contratos e títulos.
3. Cliente e implantador: ajustam as planilhas ao padrão documentado pelo Omie e realizam a importação-piloto.
4. Hult: confere uma amostra dos vínculos e compara totais relevantes antes da virada.
5. Cliente: passa a manter o cadastro principal atualizado e evita criar novos registros sem pesquisar CNPJ, CPF ou código já existente.
6. Hult: monitora exceções no fechamento e devolve os problemas de origem para correção no ERP, em vez de reconstruir a informação fora dele.

Esse fluxo é uma proposta de implantação. Ele não significa que exista transmissão automática ativa entre o Omie do cliente e o sistema contábil da Hult. O modo de troca — arquivo, API ou outro processo — precisa ser definido e validado em cada projeto.

Planilha, API e automação não são a mesma coisa

Importação por planilha é uma carga de dados preparada em arquivo. Ela depende do preenchimento correto das colunas e das referências previamente cadastradas. É útil para uma migração inicial, mas não cria, por si só, um fluxo contínuo entre sistemas.

Integração por API utiliza interfaces documentadas para consultar, criar ou alterar registros. O Portal do Desenvolvedor Omie informa que clientes e fornecedores são cadastros compartilhados entre módulos e disponibiliza serviços para criar, editar e consultar esses registros. O portal também lista interfaces para categorias, contas correntes, títulos e outros dados.

Automação efetiva exige mais do que a existência da API. É preciso definir credenciais, regras, frequência, tratamento de erros, prevenção de duplicidades, registros de execução e responsabilidade pela conferência. Sem isso, chamar uma API apenas muda o meio pelo qual um erro entra no sistema.

Exemplo hipotético

Uma empresa possui 4.000 linhas de clientes na base antiga. Após revisar documentos e cadastros inativos, percebe que 350 linhas são duplicadas e 80 não têm CNPJ ou CPF. Se importar tudo e tentar corrigir depois, pedidos, contas a receber e vínculos de CRM podem se espalhar por registros diferentes.

Em um processo controlado, a empresa define o cadastro principal, trata as exceções e importa uma amostra. A Hult valida as categorias e confere se os primeiros títulos estão associados às contrapartes corretas. Só então a carga completa é executada. O possível ganho vem da prevenção: menos cadastros paralelos, menos reclassificações e menos perguntas no fechamento. Os números deste exemplo são hipotéticos e não representam resultado medido pela Hult.

O que o cliente precisa manter correto

• Um cadastro principal por contraparte, salvo exceção documentada.
• CNPJ, CPF, razão social e contatos revisados.
• Categorias e contas correntes usadas de forma consistente.
• Produtos com campos obrigatórios e classificações revisadas.
• Títulos vinculados ao cliente ou fornecedor correto.
• Controle sobre quem pode criar e alterar cadastros.

O que a Hult precisa configurar, validar e conferir

• A relação entre categorias gerenciais e tratamento contábil.
• Os campos fiscais e contábeis que exigem orientação técnica.
• A coerência de saldos, amostras e totais após a importação.
• As exceções que podem afetar conciliação e fechamento.
• O desenho do fluxo de arquivos ou API, quando contratado e tecnicamente implantado.
• O retorno dos erros à origem para que o ERP continue sendo a base operacional correta.

Migrar bem é decidir antes de importar

A pergunta mais importante não é “quantas linhas o sistema aceita?”. É “quais dados a empresa quer levar adiante e como eles serão usados depois?”. O Omie documenta os campos, vínculos e serviços disponíveis. Cabe à empresa e à contabilidade transformar essa estrutura em um processo confiável.

Quando cliente, Omie e Hult trabalham sobre cadastros consistentes, o fechamento tende a exigir menos reconstrução manual. Mas esse benefício é condicionado à implantação: a ferramenta ajuda, enquanto a qualidade dos dados e a conferência continuam sendo responsabilidades humanas.

Fontes oficiais

• Omie — Dicas para a Migração de Dados via Planilha no Omie, publicada em 9 de outubro de 2024.
• Omie — Cadastrando um Cliente/Fornecedor a partir de uma Conta do CRM, publicada em 23 de outubro de 2025.
• Omie — Portal do Desenvolvedor: lista de APIs, consultada em 17 de setembro de 2026.