Como Dar Entrada de XML de Compra no Olist ERP: Vínculo de Produtos, Estoque e Custo Médio (Com Telas)

A rotina de compras e abastecimento de mercadorias é a espinha dorsal de qualquer operação de varejo, distribuição ou e-commerce de alta performance. Quando uma empresa recebe produtos do fornecedor, a simples chegada física das caixas na doca de descarga é apenas a primeira metade do processo. O verdadeiro desafio operacional, fiscal e financeiro reside em saber como dar entrada de XML de compra no Olist ERP de forma automatizada, garantindo que o catálogo de produtos seja vinculado com precisão cirúrgica, os saldos de estoque físico sejam atualizados em tempo real, as duplicatas caiam com exatidão no Contas a Pagar e o Custo Médio Ponderado de cada SKU seja recalculado para blindar a sua margem de lucro.

Se você comete falhas no momento de importar o XML da nota do fornecedor ou realiza lançamentos de estoque manuais sem nota fiscal, os impactos em cascata são devastadores: surgem produtos duplicados com códigos diferentes no catálogo, quebras inexplicáveis de estoque físico (furo de estoque), vendas de itens indisponíveis em marketplaces gerando cancelamentos traumáticos e, pior de tudo, relatórios financeiros e DRE com margens distorcidas porque o custo de frete, IPI ou ICMS-ST da compra não foram computados no preço de custo unitário.

1. Métodos de Entrada de Mercadorias no Olist ERP: Do Arquivo XML ao Buscador MD-e da SEFAZ

No Olist ERP (antigo Tiny ERP), a entrada de mercadorias foi arquitetada para atender desde o microempreendedor que compra de poucos fornecedores locais até grandes operações que recebem dezenas de carretas de produtos por semana. O sistema disponibiliza duas formas principais e inteligentes para alimentar seu catálogo e estoque com base em Notas Fiscais Eletrônicas (NF-e Modelo 55):

Método A: Importação Direta do Arquivo XML (.xml)

Este é o método clássico e universal. Assim que o fornecedor emite a nota de compra e envia o arquivo XML por e-mail ou disponibiliza em seu portal B2B, você realiza o download do arquivo .xml para o seu computador. Em seguida, dentro do Olist ERP, basta acessar o caminho oficial:

Menu Superior > Suprimentos > Notas de Entrada > Mais Ações (…) > Importar XML.

Ao arrastar ou selecionar o arquivo XML da NF-e, o parser inteligente do Olist ERP decodifica instantaneamente a estrutura completa da nota fiscal: dados cadastrais do emitente (CNPJ, Razão Social, Inscrição Estadual e endereço do fornecedor), data de emissão, número da NF-e, série, chave de acesso de 44 dígitos, itens da nota (código do produto no fornecedor, descrição, NCM, CST/CSOSN, CFOP, unidade de medida, quantidade, valor unitário, IPI, frete, seguro e substituição tributária) e os dados de cobrança com datas de vencimento das faturas.

Método B: Busca Automática via Chave de Acesso e Buscador de Notas (MD-e da SEFAZ)

Para quem busca velocidade e automação em escala, o Olist ERP conta com a extensão nativa Buscador de Notas (Manifesto do Destinatário Eletrônico – MD-e). Com esse recurso habilitado e seu Certificado Digital A1 configurado, o Olist ERP conecta-se periodicamente aos servidores da Receita Federal e da SEFAZ do seu estado e consulta todas as notas fiscais emitidas contra o CNPJ da sua empresa em todo o território nacional.

Esse fluxo elimina completamente a necessidade de solicitar ou caçar arquivos XML enviados por e-mail. No módulo do Buscador de Notas, você visualiza em tempo real as notas recém-faturadas pelos seus fornecedores antes mesmo da mercadoria sair da fábrica. O lojista pode realizar a manifestação fiscal com um clique:

• Ciência da Emissão: Declara à SEFAZ que tem conhecimento da nota emitida, liberando o download completo do XML com todos os itens discriminados;
• Confirmação da Operação: Confirma que a mercadoria física foi devidamente conferida e entregue no seu estabelecimento comercial, garantindo segurança jurídica contra fraudes e notas frias emitidas indevidamente contra o seu CNPJ;
• Importação Direta: Com o XML sincronizado via MD-e, você clica em “Dar Entrada” e o sistema abre o assistente de conciliação de produtos de forma 100% automatizada.

2. Tabela Comparativa: Métodos de Entrada de Estoque no Olist ERP

Muitos empreendedores iniciantes cometem o erro gravíssimo de lançar entradas de mercadorias ajustando o saldo de estoque manualmente ou digitando produtos um a um. Veja no comparativo técnico abaixo por que a importação via XML ou MD-e é o único caminho aceitável para empresas estruturadas:

A conclusão prática da tabela é evidente: lançar mercadoria no estoque de forma manual sem nota é uma prática amadora que destrói a integridade dos seus dados e coloca sua empresa em risco fiscal permanente perante o SPED e a Receita Federal. O uso do XML é o padrão ouro de qualquer operação profissional.

3. A Ordem Oficial de Prioridade no Vínculo Automático de Produtos ao Estoque

O maior temor de um lojista ao dar entrada em uma nota fiscal é a duplicidade de catálogo. Imagine que você vende uma garrafa térmica preta cadastrada internamente no seu ERP com o código SKU-TERM-001. O seu fornecedor distribuidor emite a nota de venda faturando esse mesmo item com o código dele: FORN-9988-B. Se o sistema não for inteligente, ele criará um novo produto com o código do fornecedor, gerando dois produtos idênticos no seu estoque e provocando furos catastróficos nas vendas.

Para solucionar esse problema com máxima confiabilidade, o Olist ERP executa um algoritmo estrito de verificação hierárquica em 6 níveis de prioridade para relacionar automaticamente os itens da nota fiscal aos produtos já cadastrados no seu depósito:

1. 1ª Prioridade — Código GTIN / EAN-13: A primeira tentativa e a mais segura de todas é realizada pelo código de barras internacional (GTIN/EAN). Se o código EAN destacado no XML da nota fiscal for idêntico ao código EAN cadastrado em apenas um produto do seu ERP, o Olist realiza o match automático imediato. Dica de ouro: se mais de um produto tiver o mesmo EAN (por erro de cadastro duplicado prévio), o sistema não vincula automaticamente para evitar associação incorreta e solicita confirmação visual;
2. 2ª Prioridade — Fornecedor + Código do Fabricante + Descrição Exata: Se o produto da nota não tiver GTIN/EAN informado (ou se você já comprou desse fornecedor anteriormente), o Olist ERP busca uma correspondência exata combinando o CNPJ do fornecedor, o código que o fabricante usa no produto e o texto da descrição cadastrada no ERP;
3. 3ª Prioridade — Fornecedor + Código do Fabricante: Caso a descrição seja ligeiramente diferente (por exemplo, na nota está “GARRAFA INOX TERM 500ML” e no seu ERP está “Garrafa Térmica Aço Inox 500ml”), o sistema verifica o fornecedor e o código do item no fabricante. Se o fornecedor coincidir com o histórico prévio, o vínculo é concluído com sucesso;
4. 4ª Prioridade — Código do Fabricante + Descrição: Se o fornecedor for novo (você nunca comprou dele antes), o Olist ERP tenta buscar se existe algum produto no seu estoque cujo código de fabricante e descrição sejam idênticos;
5. 5ª Prioridade — Apenas Descrição do Produto (Regra Opcional): Nas configurações de notas de entrada do ERP, existe a opção: “Se não encontrar pelas regras acima, relacionar apenas pela descrição”. Se marcada, o sistema tentará casar a string de texto. Atenção de Elite Developer: recomendamos manter essa opção desmarcada caso você trabalhe com produtos que tenham nomes parecidos mas voltagens, cores ou tamanhos diferentes (como “Camiseta Básica Preta M” e “Camiseta Básica Preta G”), evitando que tamanhos diferentes sejam somados no mesmo SKU;
6. 6ª Prioridade — Cadastrar Automaticamente como Novo Item: Se nenhuma das regras de correspondência acima for atendida, o Olist ERP identifica que trata-se de uma mercadoria inédita na sua empresa e prepara o produto para ser cadastrado como um novo item no seu estoque, importando todos os dados fiscais da nota.

4. Como Cadastrar Novos Produtos Diretamente a Partir da Nota Fiscal do Fornecedor

Quando a nota de compra traz mercadorias que você nunca vendeu antes, o Olist ERP poupa horas de cadastro braçal ao importar automaticamente os metadados fiscais mais complexos exigidos pela legislação tributária brasileira diretamente do arquivo XML:

• Nomenclatura Comum do Mercosul (NCM): O código de 8 dígitos que define a tributação de IPI, PIS, COFINS e ICMS é copiado diretamente para a ficha do produto;
• Código Especificador da Substituição Tributária (CEST): Vital para mercadorias sujeitas ao regime de Substituição Tributária (ST), evitando bloqueios e rejeições de emissão de NF-e na SEFAZ;
• Unidade de Medida Comercial: Importa a sigla de medição (UN, PC, KG, PAR, MT);
• Origem da Mercadoria: Define se o item é nacional (Origem 0), importado direto (Origem 1) ou adquirido no mercado interno (Origem 2);
• Preço de Custo e Fornecedor Padrão: Registra o valor unitário pago e grava o CNPJ do fornecedor na aba de fornecedores do cadastro do produto para alimentar o histórico de compras.

Assim que os produtos são criados pela nota de compra, você pode utilizar a Inteligência Artificial LIS do Olist ERP (liberada gratuitamente através do Cupom GEFF) para transformar as descrições técnicas e resumidas da nota de compra em títulos de alta conversão para o Mercado Livre, Shopee, Amazon e loja virtual, gerando descrições com bullet points persuasivos e otimizadas para as buscas orgânicas dos marketplaces.

5. Conversão de Unidades de Medida e Fator Multiplicador (Compra em Caixa/Fardo vs Venda em Unidade)

Um dos cenários operacionais mais recorrentes no comércio atacadista e varejista é a divergência na unidade de medida de compra versus unidade de medida de venda. Observe os casos reais do dia a dia:

• A fábrica ou distribuidor vende para você em Caixa (CX) com 12 unidades pelo valor total de R$ 120,00;
• A sua loja virtual ou anúncio no marketplace vende o produto de forma fracionada em Unidade (UN);
• Se você der entrada direta no XML sem conversão, o sistema lançará apenas 1 unidade no seu estoque custando R$ 120,00 cada. O resultado? Seu estoque físico ficará furado em 11 peças e seu preço de custo ficará 12 vezes mais caro do que o real!

Como Operar a Conversão no Olist ERP

Para resolver essa questão com precisão matemática, o Olist ERP disponibiliza no momento da conciliação do item da nota a funcionalidade de Fator de Conversão de Unidade. O fluxo funciona da seguinte forma:

1. No item da nota fiscal que foi faturado em Caixa (CX), Pacote (PCT), Fardo (FD) ou Dúzia (DZ), clique no ícone de edição do item;
2. Selecione a unidade de saída que você utiliza no cadastro do produto (ex: UN);
3. No campo Fator Multiplicador, informe a quantidade de unidades que vêm dentro de cada embalagem (no nosso exemplo, digite 12);
4. O Olist ERP calcula instantaneamente a multiplicação na quantidade física: se a nota faturou 10 Caixas, o sistema dará entrada de 120 Unidades no depósito;
5. Simultaneamente, o sistema divide o valor da caixa pelo fator multiplicador: se a caixa custou R$ 120,00, o ERP recalcula o custo unitário de compra para R$ 10,00 por unidade;
6. O sistema memoriza essa regra para esse fornecedor específico: nas próximas notas fiscais de compra desse mesmo item vindas desse mesmo CNPJ, o ERP já sugerirá a conversão por 12 automaticamente.

6. Integração Financeira: Lançamento Automático no Contas a Pagar e Gestão de Parcelas

Dar entrada de notas fiscais no Olist ERP não alimenta apenas o galpão de estoque físico; trata-se da rotina que blinda a gestão do fluxo de caixa da sua empresa. Todo arquivo XML de NF-e contém o grupo de tags <cobr> e <dup>, onde o emissor discrimina o número das faturas, as datas de vencimento e o valor de cada parcela combinada na negociação comercial.

Ao concluir o processo de entrada da nota no Olist ERP, na aba “Contas a Pagar”, o sistema faz o seguinte:

• Geração Automática de Contas a Pagar: Se a compra foi realizada faturada em 30, 60 e 90 dias, o Olist ERP gera automaticamente os três lançamentos financeiros com suas respectivas datas de vencimento no módulo de Finanças;
• Associação com Centro de Custos e Categoria Financeira: Você pode parametrizar para que todos os lançamentos de entrada sejam debitados na categoria de “Custos das Mercadorias Vendidas (CMV) / Fornecedores de Estoque”, permitindo apuração exata do demonstrativo DRE no final do mês;
• Forma de Pagamento: Registra se o compromisso será quitado via Boleto Bancário, TED, PIX ou Transferência em Conta Corrente;
• Vinculação com o CNPJ do Credor: Evita pagamentos duplicados e permite emitir relatórios de saldo devedor consolidado por fornecedor.

7. Recálculo do Custo Médio Ponderado e Preço de Custo para Precificação Certa

Um dos erros mais graves cometidos por gestores de e-commerce é utilizar o valor do produto estampado na última nota fiscal como se fosse o custo real de venda. O custo real de uma mercadoria não é apenas o valor de tabela do item: ele engloba o frete de compra rateado (FOB), o seguro de transporte, outras despesas acessórias e os impostos não recuperáveis, como o IPI e o temido ICMS por Substituição Tributária (ICMS-ST).

Como o Olist ERP Calcula o Custo Médio Ponderado

O Olist ERP utiliza o método contábil padrão e mais recomendado pelos órgãos fiscais e contábeis: o Custo Médio Móvel Ponderado. A fórmula matemática aplicada pelo sistema é:

Vamos a uma simulação real de negócio:

1. Você possui 10 unidades no estoque com Custo Médio de R$ 50,00 cada (Valor total em estoque = R$ 500,00);
2. Você compra mais 20 unidades do fornecedor. Devido à inflação ou frete maior, cada nova unidade chegou custando R$ 65,00 (Valor total da nova compra = R$ 1.300,00);
3. Ao dar entrada no XML no Olist ERP, o sistema soma: R$ 500,00 + R$ 1.300,00 = R$ 1.800,00 de patrimônio em estoque;
4. Em seguida, divide pela nova quantidade física total: 10 + 20 = 30 unidades;
5. O novo Custo Médio unitário é recalculado automaticamente para: R$ 1.800,00 ÷ 30 = R$ 60,00.

Ao atualizar o Custo Médio e o Preço de Custo na ficha do produto, o Olist ERP garante que a sua regra de markup e precificação de marketplaces calcule a margem de contribuição correta. Você nunca mais venderá um produto achando que está lucrando 30% quando, na verdade, o aumento de custo do fornecedor comeu toda a sua margem de lucro!

8. Sincronização Automática com os Canais de Venda (Mercado Livre, Shopee, Amazon e Lojas Virtuais)

A etapa final e mais gratificante da entrada de mercadorias no Olist ERP é o reflexo instantâneo nas suas frentes de venda. No momento em que você clica em “Lançar Estoque” na nota fiscal de entrada, a engrenagem do ecossistema Olist é disparada:

1. O Saldo Físico do depósito selecionado é incrementado com as quantidades conferidas;
2. O Olist ERP subtrai as reservas ativas de pedidos pendentes para apurar o Saldo Disponível Real;
3. Aplica as regras de Estoque de Segurança (por exemplo: manter sempre 2 unidades de margem de proteção contra furos);
4. O módulo de integrações dispara requisições via API de alta velocidade para todos os canais conectados simultaneamente: Mercado Livre, Shopee, Amazon, Magalu, TikTok Shop, Shein, Nuvemshop, WooCommerce e Shopify;
5. Anúncios que estavam pausados por falta de estoque são reativados automaticamente nos marketplaces sem que você precise abrir painel por painel!

FAQ — Perguntas Frequentes sobre Entrada de XML e Estoque no Olist ERP

Conclusão e Boas Práticas Operacionais

Dominar o fluxo de entrada de XML de compras no Olist ERP é a linha divisória entre uma operação de e-commerce amadora — que vive apagando incêndios de estoque furado e margens no vermelho — e uma empresa madura, escalável e lucrativa. Ao parametrizar as 6 regras de vínculo hierárquico, configurar o fator multiplicador para unidades fracionadas e permitir que o ERP recalcule o Custo Médio Ponderado e alimente o Contas a Pagar automaticamente, você economiza dezenas de horas de trabalho administrativo por semana e blinda sua conformidade fiscal perante a SEFAZ.

Se você ainda não implantou o Olist ERP ou deseja profissionalizar a gestão da sua loja virtual e canais de marketplace com suporte de alto nível, aproveite a nossa parceria oficial com o Cupom GEFF. Garanta 30 dias totalmente gratuitos + 3 meses com 50% de desconto na mensalidade e IA LIS liberada através do link info.olist.com/lp-geff, e alranque seu poder de compra com o Flip Crédito usando o cupom GEFFALENCAR em olist.com/credito!