B4 Guia

Passo 4 · Entrada pelo XML da nota

Importar o XML da NF-e do fornecedor para preencher fornecedor, nota, chave, prazos e itens, cadastrando as mercadorias que ainda não existem.

Sistema: SoftWay Comercial (Retaguarda) · Atualizado em 21/11/2026

Conteúdo criado com apoio de inteligência artificial · em revisão pela equipe da B4 System

Em vez de digitar a nota item a item, você pode importar o XML da NF-e que o fornecedor enviou. O sistema preenche o fornecedor, o número da nota, a emissão, a chave da NF-e, os prazos de pagamento e os itens, e cadastra as mercadorias que ainda não existem. Veja antes o tipo de controle de estoque: a importação de XML só funciona no tipo 1 - Mercadoria (estoque).

Linha da tela de entrada com a chave da NF-e, o botão de localizar XML, a nota, a emissão e os prazos

#O que fazer na tela

  1. Chave NFe: depois da importação, mostra a chave da nota. Se você já tiver a chave nesse campo, ela é levada para a janela de busca do XML.
  2. Botão “...”: abre a janela “Localizar arquivo XML”. É por aqui que a importação começa.
  3. Nota Fiscal: recebe o número da nota do XML.
  4. Emissão Nota: recebe a data de emissão do XML.
  5. Quantidade de parcelas (o campo logo antes dos prazos): recebe o número de duplicatas do XML.
  6. Prazos Pgtos: recebem os prazos, em dias, contados a partir da emissão.

#Importar o XML, passo a passo

  1. Abra uma entrada nova (ou clique em Alterar numa entrada Em Aberto) no tipo 1 - Mercadoria (estoque) e clique em “...”.
  2. Se a entrada já tiver itens, o sistema pergunta: “Este documento possui outros registros lançados anteriormente. Deseja continuar o processo de importação de documento eletrônico ? Obs.: Esta operação irá excluir os itens lançados anteriormente.” Responda Sim para substituir. Os itens antigos só são apagados quando a importação gravar os novos; se você cancelar no meio, eles ficam como estavam.
  3. Na janela Localizar arquivo XML, escolha o arquivo. Ela mostra os XMLs da pasta padrão configurada no sistema. Use Busca Emitente e Filtra para achar a nota e marque Somente XML NÃO importado sistema para esconder os que já foram usados. Se o XML não estiver na lista, use Inclui XML Manualmente. Selecione a nota e clique em Ok (Sair cancela).
  4. Se o XML for de outro CNPJ, o sistema avisa e deixa você decidir (veja as mensagens abaixo).
  5. O sistema procura o fornecedor pelo CNPJ do emitente. Se não encontrar, ajuda a relacionar ou cadastrar (veja a seção seguinte).
  6. Os prazos são preenchidos com as duplicatas do XML (veja abaixo).
  7. Abre a janela Importar Mercadorias XML com formação de preços, com os itens da nota. Confira, ajuste e clique em Importa Itens para cadastro mercadorias e compras.
  8. O sistema pergunta: “Esta rotina irá cadastrar automaticamente a lista de mercadorias que ainda não estão cadastradas desta relação. Deseja prossegui com o processo ?” Responda Sim.
  9. Os itens entram na compra, os totais são calculados e a entrada passa a ter a origem “XML fiscal”, gravada ao salvar. Confira os itens e siga para confirmar a entrada.
O estoque não muda na importação

Importar o XML cadastra as mercadorias que faltam e grava os itens na compra Em Aberto. O estoque só muda quando você confirma a entrada.

#A janela “Importar Mercadorias XML com formação de preços”

Ela traz a lista de itens da nota (quadro Dados coletados XML) e a Área de edição e ajuste com seu cadastro, onde você completa o que falta: grupo, marca, preços de venda, markups, CFOP e CSOSN, unidade de venda, referência, tamanho e cor.

  • Linhas em vermelho: itens com pendência (grupo, marca, venda, CST ou CFOP). O botão Avaliar item lista os campos do item selecionado que estão em desacordo.
  • Não importar item: marca o item selecionado para não entrar na importação (ele fica riscado na lista). Clique de novo para voltar a importar.
  • Dados fixos e Limpa Fixos: valores que você repete em vários itens (grupo, marca, CFOP, CSOSN, unidade de venda, markups). Usar cProd como Referência usa o código do produto da nota como referência.
  • Itens que já têm um produto relacionado no seu cadastro usam esse produto; os demais são cadastrados como mercadoria nova, com código gerado pelo sistema.

#Fornecedor do XML

O sistema compara o CNPJ do emitente com o dos seus fornecedores, ignorando pontos, traços e barras. Se não achar, trata do fornecedor antes de continuar:

Situação O que o sistema faz
Fornecedor com o mesmo CNPJ Usa esse fornecedor e preenche nota, emissão e chave.
Fornecedor SEM CNPJ parecido com o do XML Mostra até 5 candidatos, um por vez: “Foi encontrado um cadastro de fornecedor SEM CNPJ que pode ser o mesmo do XML: … Usar este cadastro e completar os dados com o XML ? (Sim = usa e atualiza | Não = ver o próximo | Cancelar = não usar nenhum)”. Com Sim, grava o CNPJ e completa só os campos vazios do cadastro.
Nenhum cadastro serve “Fornecedor não cadastrado com este CNPJ !” com três saídas. Sim = cadastrar como novo fornecedor; Não = relacionar a um fornecedor já cadastrado (incompleto); Cancelar = sair sem importar.

Ao relacionar com Não, você escolhe o fornecedor na busca. O sistema só aceita cadastro sem CNPJ (ou com o mesmo CNPJ): nunca troca o CNPJ de outro fornecedor. Ele pergunta “Relacionar o XML ao fornecedor Cód. … ?” e avisa que “O CNPJ será gravado e os campos vazios do cadastro serão completados com o XML.”.

#Prazos de pagamento vindos do XML

O sistema lê as duplicatas do XML e converte cada vencimento em dias a partir da emissão. Preenche a quantidade de parcelas e os prazos e mostra na barra de status, por exemplo, “Prazos preenchidos pelo XML (2 parcela(s)): 30/60 dias”.

  • XML sem duplicatas (compra à vista): o sistema não altera os prazos que já estavam na tela.
  • XML com mais de 10 parcelas: o sistema aceita até 10, não preenche e avisa. Informe os prazos à mão.

#Proteções contra importar duas vezes

Cada XML só pode ser importado em uma entrada. Se a chave já está em outra entrada, a importação é bloqueada. O sistema também guarda uma cópia do XML na pasta Dados\XMLs Recebidos, com o nome da chave seguido de “-ent-nfe.xml”.

#Se você sair sem concluir

Se você fechar a importação sem clicar em Importa Itens para cadastro mercadorias e compras, o sistema desfaz tudo o que puxou do XML: chave, nota, emissão, fornecedor e prazos voltam ao que eram, a cópia do XML que ele criou é apagada e nada fica gravado na compra.

#Mensagens deste passo

O que aparece O que significa O que fazer
“A importação de XML cadastra mercadorias e só se aplica a entradas do tipo Mercadoria (estoque).” A entrada não está no tipo 1. Trocar o tipo antes de lançar itens (passo 3).
“Importação bloqueada: Este XML já está relacionado à entrada …. Não é permitido importar o mesmo XML duas vezes.” O XML já foi usado em outra entrada. Abrir essa entrada em vez de importar de novo.
“Importação bloqueada: Este XML já foi importado na entrada …. Não é permitido importar o mesmo XML duas vezes.” A chave da nota já existe em outra entrada. Idem.
“O sistema identificou que este XML pertence a outro CNPJ. CNPJ Destino : … Destinatário : … Deseja importar assim mesmo ?” A nota foi emitida para outro CNPJ, não o da sua empresa. Não, a menos que você tenha certeza.
“O XML seleciona está fora dos padrões para esta operação !” O arquivo não é um XML de NF-e válido para a importação. Escolher o XML correto.
“Fornecedor cadastrado com sucesso.” O fornecedor novo foi criado a partir do XML. Nada a fazer.
“Cadastro do fornecedor … atualizado com o CNPJ e os dados do XML.” Um cadastro existente foi completado. Nada a fazer.
“O fornecedor escolhido (…) já tem outro CNPJ (…) e não será alterado. Escolha um cadastro sem CNPJ ou cadastre o fornecedor como novo.” O fornecedor escolhido tem CNPJ diferente. Escolher outro, ou cadastrar como novo.
“Não foi possível cadastrar o fornecedor do XML (…). Nada foi gravado. Cadastre o fornecedor manualmente e tente novamente.” O cadastro do fornecedor falhou. Cadastrar o fornecedor à mão e importar de novo.
“O XML tem … parcelas e o sistema aceita ate 10. Prazos nao preenchidos: informe manualmente.” A nota tem mais de 10 duplicatas. Preencher os prazos à mão.
“Confira o cadastro do produto no item … para continuar.” e uma observação O item tem pendência (grupo, marca, venda, CST ou CFOP). Completar o item e importar de novo.
“Todos os itens estão marcados como 'Não importar'. Desmarque ao menos um para continuar.” Nenhum item entraria. Desmarcar ao menos um item.
“Importação não concluída: A importação foi encerrada sem gravar os itens (botão 'Importa Itens para cadastro mercadorias e compras'). A chave da NF-e e os dados puxados do XML foram desfeitos e nada foi gravado na compra.” Você saiu sem concluir. Importar de novo e clicar no botão final.
“Importação não concluída: Não foi possível gravar os itens na compra. Nada foi alterado: os itens anteriores da compra foram mantidos. Erro …” A gravação dos itens falhou e foi desfeita. Anotar o erro e avisar a B4 System se repetir.
“Regime tributário não identificado” O campo Regime Tributário do cadastro do contador está vazio ou inválido. Ajustar o cadastro do contador. Enquanto isso o sistema assume o Simples Nacional na validação do CST/CSOSN.
© 2026 B4 System · B4 Guia, manual de treinamento. Material criado com apoio de inteligência artificial e em revisão pela equipe da B4 System; pode conter imprecisões. Os exemplos usam dados fictícios e as telas são ilustrações geradas a partir do sistema.