Pular para conteúdo
ComprasAvançado

Importação avançada de NF-e: SEFAZ, matching manual e vínculo com OS

Cenários avançados da importação de compras — buscar XML direto da SEFAZ, fazer matching manual de produtos, escolher política de custo, gerar conta a pagar e vincular a Ordem de Serviço.

6 min de leituraAtualizado em

Importação avançada de NF-e

Para que serve

Este tutorial cobre os cenários que fogem do caminho rápido:

  • Você não tem o XML, só a chave de acesso → busca SEFAZ
  • O fornecedor é novo e você quer cadastrar agora
  • Alguns itens têm matching incerto (70–89%) e exigem revisão
  • Você quer controlar a política de custo dos produtos
  • A NF-e é de uma compra para atender uma Ordem de Serviço específica

Se for sua primeira vez importando uma NF-e, leia antes o caminho rápido — este tutorial assume que você já conhece o wizard.

Pré-requisitos

  • Tutorial Importar NF-e em 4 cliques lido
  • Permissão de perfil Compras (purchase.post)
  • Para busca SEFAZ: certificado digital A1 válido cadastrado em Configurações > Fiscal > Certificado
  • Para vínculo com OS: ao menos uma Ordem de Serviço em status Orçamento, Aprovada, Agendada ou Executada

Busque a NF-e direto da SEFAZ

Em vez de pedir o XML ao fornecedor, você pode baixar direto da Receita usando a chave de acesso de 44 dígitos (vem no e-mail do fornecedor, no DANFE em PDF ou no WhatsApp).

Na tela de upload, clique na aba Buscar pela chave (SEFAZ). Cole a chave e clique em Baixar da SEFAZ.

Aba 'Buscar pela chave (SEFAZ)' com textarea preenchida com chave de 44 dígitos e botão 'Baixar da SEFAZ'
Busca SEFAZ — alternativa quando você só tem a chave de acesso.

Cenários possíveis durante a busca:

  • Sucesso — o XML é baixado, parseado e você cai no passo de fornecedor
  • Certificado expirado — cadastre um novo A1 e tente novamente
  • SEFAZ indisponível — aguarde 1–2 minutos ou faça upload manual
  • Chave não encontrada — confirme a chave (44 dígitos exatos, sem espaços)

Crie o fornecedor durante a importação

Quando o emitente não está cadastrado, o card aparece com badge azul Novo e três opções:

  • Vincular ao fornecedor existente — só aparece quando o sistema encontrou alguém parecido pelo CNPJ
  • Criar um novo cadastro — registra o fornecedor com razão social, CNPJ, IE e endereço extraídos do XML
  • Não vincular agora — a nota fica sem fornecedor (você pode vincular depois no detalhe)

Para uma compra recorrente, escolha Criar um novo cadastro — o fornecedor fica disponível em Compras > Fornecedores para todas as próximas notas.

Card de fornecedor com badge azul 'Novo', dados extraídos do XML e radio 'Criar um novo cadastro' selecionado
Fornecedor novo — criar o cadastro durante a importação evita digitação manual depois.

Faça matching manual de produtos

Os itens são separados em três faixas de confiança:

FaixaCorComportamento padrão
≥ 90%VerdeMatch sugerido — basta aceitar
70–89%LaranjaRequer revisão — sistema não atualiza preço sem sua confirmação
< 70%AzulSem candidato — criar como novo ou buscar manualmente

Para itens em laranja, clique em Trocar produto para abrir o editor expandido. Você verá:

  • Lista de candidatos do seu catálogo ordenada por % de confiança
  • Ação por item:
    • Atualizar produto existente — credita estoque e ajusta preço pela política escolhida
    • Vincular sem atualizar — credita estoque, mantém preço atual do produto
    • Cadastrar como novo — cria produto novo (não usa o catálogo)
    • Ignorar item — não credita estoque (útil para frete, descontos, brindes)
Editor expandido de um item com dropdown 'Atualizar produto existente' e lista de candidatos com % de confiança
Matching manual — escolha entre atualizar, vincular sem atualizar, criar novo ou ignorar.

Cadastre produtos novos com inline edit

Para itens da aba azul (Produtos novos), o card permite editar antes de confirmar:

  • SKU (cProd do XML como sugestão)
  • Nome do produto (xProd do XML como sugestão)
  • Preço de custo unitário (vUnCom do XML como sugestão)

Ajuste se necessário — por exemplo, padronize o SKU para o formato do seu catálogo. Em massa, o botão Criar todos os novos confirma todos com os valores sugeridos.

Card de produto novo com campos editáveis SKU, Nome e Custo R$ pré-preenchidos do XML
Inline edit — ajuste SKU/nome/custo antes de criar o produto.

Escolha a política de custo e gere a conta a pagar

Na tela de Confirmação, duas decisões importantes:

Política de custo

Controla como o preço de custo dos produtos é atualizado ao creditar a NF-e:

PolíticaComportamentoQuando usar
Média ponderada (padrão)Combina custo atual + novo conforme proporção de quantidadesRecomendado por norma contábil (CFC 1.170/09) — adequado para estoque com giro
Último custoSobrescreve com o preço da NF-eQuando o mercado tem variação alta e você quer sempre o preço mais recente
Manter atualIgnora o preço da nota, mantém o cadastradoCompras pontuais ou promocionais que não devem afetar o custo médio

Conta a pagar automática

Switch Gerar conta a pagar automaticamente — quando ativo:

  • Cria uma fatura em Financeiro vinculada à NF-e
  • Vencimento = data de emissão + 30 dias (ou prazo padrão do fornecedor, se configurado)
  • Pode ser editada/parcelada depois em Financeiro > Contas a pagar
Tela de confirmação com seção 'Política de custo' (radio com 3 opções) e seção 'Conta a pagar' (switch ativado)
Política de custo + AP automática — duas decisões que afetam Estoque e Financeiro.

Vincule a NF-e a uma Ordem de Serviço

Após confirmar e lançar, a tela final mostra um bloco "Vincular a uma OS (opcional)".

Isso é útil quando a compra foi feita especificamente para atender uma OS — por exemplo, você comprou um kit de embreagem para o serviço do cliente João.

  1. Digite código da OS ou nome do cliente no seletor — ele busca OS em status Orçamento, Aprovada, Agendada ou Executada
  2. (Opcional) Ative Copiar itens da NF-e para a OS — adiciona os produtos à OS com prefixo [NF-e XXX] no nome
  3. Clique em Vincular OS
Bloco 'Vincular a uma OS' com seletor de OS preenchido, switch 'Copiar itens' ativo e botão 'Vincular OS' destacado
Vínculo opcional com OS — rastreia de qual NF-e vieram as peças usadas no serviço.

Para fechar o ciclo, clique em Concluir OC — a NF-e fica em status terminal Concluída. Pular essa etapa também é válido: a nota fica em Aberta e você pode concluir depois pelo detalhe.


Solução de problemas

Solução de problemas

  • Mensagem 'Certificado digital A1 expirado'

    Solução

    Acesse Configurações > Fiscal > Certificado e suba um novo certificado A1 válido. Sem certificado ativo a busca SEFAZ não funciona — o upload manual continua disponível.

  • Mensagem 'SEFAZ temporariamente indisponível'

    Solução

    É instabilidade temporária do serviço da Receita. Aguarde 1–2 minutos e clique novamente em Baixar da SEFAZ. Como alternativa imediata, peça o XML ao fornecedor e use upload manual.

  • Item com candidato de match em laranja, mas o produto sugerido está errado

    Solução

    Clique em 'Trocar produto' para abrir o editor expandido. No dropdown, escolha 'Atualizar produto existente' (ou 'Vincular sem atualizar') e selecione o produto correto na lista de candidatos. Em último caso, escolha 'Cadastrar como novo'.

  • Conta a pagar foi gerada com vencimento errado

    Solução

    O vencimento padrão é 30 dias após a emissão. Se o fornecedor tem prazo diferente, configure em Compras > Fornecedores > [Fornecedor] > Prazo padrão de pagamento. Para essa nota específica, edite a parcela em Financeiro > Contas a pagar.

  • OSPicker não encontra a OS que estou procurando

    Solução

    O seletor só lista OS em status Orçamento, Aprovada, Agendada ou Executada. Se a OS já está Faturada/Concluída/Cancelada, não aparece. Verifique o status em Ordens de Serviço.

  • 'Copiar itens para a OS' está desabilitado

    Solução

    Esse switch só fica ativo quando há pelo menos um item da NF-e com ProductId resolvido (criado ou vinculado). Se todos os itens foram marcados como Ignorar, não há o que copiar.


Perguntas frequentes

Perguntas frequentes


Artigos relacionados

Este artigo ajudou você?

Seu feedback nos ajuda a melhorar a documentação.

Precisa de mais ajuda?

Fale diretamente com nossa equipe de suporte pelo WhatsApp e receba ajuda personalizada em poucos minutos.

Falar com suporte