Este tutorial é para o estoquista, o comprador ou o responsável fiscal que precisa registrar a entrada de mercadorias no Gestor. Ele cobre as três formas de originar uma Compra: lançar os itens manualmente, importar o arquivo XML da NF-e enviada pelo fornecedor, ou buscar o documento direto na SEFAZ pela Manifestação DF-e — sem precisar do arquivo em mãos. Ao final, você saberá também vincular cada item do XML a um produto do seu cadastro (ou cadastrar um produto novo na hora), informar lote/grade quando o produto exigir, ajustar a precificação (simples ou composta) e Faturar a compra para movimentar o estoque.
Este tutorial está dividido em quatro partes que descrevem o lançamento manual, importação de um arquivo XML ou lançamento pela manifestação de nota fiscal. Escolha o método que melhor se adapta à sua necessidade, pois todos terão o mesmo resultado final, que é adicionar o estoque do produto no sistema.
Estoque → Compras abre a listagem de compras.

Ctrl+I) → lançamento manual (Parte 1).
Para gerar a compra sem precisar do arquivo, direto da SEFAZ: Fiscal → Manifestação DF-e (Parte 3).

⚠️ Não confunda com o menu Transporte → Manifesto Eletrônico (MDF-e) — é uma funcionalidade totalmente diferente (documento de transporte de carga que a própria empresa emite) e não gera Compra. O caminho certo para este tutorial é Fiscal → Manifestação DF-e.
Passo 1 — Abrir uma Compra nova
Em Estoque → Compras, clique em Incluir (Ctrl+I). A tela "Compras" abre em branco, com a etiqueta Situação marcando Aberto.

Passo 2 — Preencher o cabeçalho
Informe Empresa, Tipo de movimentação, Fornecedor, Data de entrada, Hora de entrada e Tipo do documento (Sem documento, NF-e ou NF Produtor).
Passo 3 — Inserir um produto
No grupo "Inserir produto", informe Produto, Unidade, Valor de compra, Desconto (R$) e Quantidade — o Valor total é calculado automaticamente. Se a unidade escolhida tiver conversão diferente da unidade base do produto, o campo "Fator" aparece rotulado "Fator (F2 - Dividir)" ou "Fator (F2 - Multiplicar)", conforme o sentido da conversão; pressione F2 dentro do campo para alternar entre dividir e multiplicar. Clique em Adicionar (ou Ctrl+Enter).

Sem produto, unidade, quantidade > 0 ou valor de compra > 0, o sistema recusa com mensagens específicas para cada campo faltante (ex.: "Selecione um produto.", "Quantidade deve ser maior que zero.").
Passo 4 — Informar Lote ou Grade, se o produto exigir
Se o produto for controlado por Lote ou por Grade (cor/tamanho), a janela correspondente abre automaticamente ao adicionar o item — ou você reabre depois com o botão "Lote / Grade..." (o texto do botão muda para "Lote..." ou "Grade..." conforme o produto).
Em ambas, confirme com F9 - Confirmar ou cancele com ESC - Cancelar.

Se você cancelar essa janela na hora de adicionar o item, o Gestor recusa a inclusão com "Produto controlado por LOTE requer informação de lote antes de adicionar." (ou o equivalente para grade).
Passo 5 — Ajustar a precificação do item
O grupo "Precificação" muda de acordo com a configuração da empresa:

F9 salva, Esc cancela.
Passo 6 — Consultar o histórico do produto (opcional)
Clique na lupa na coluna de ação do grid de itens para abrir o painel "Consulta do produto" ao lado da tela — ele é somente leitura: mostra comparativo Anterior × Atual de custo/margem/venda, lotes, grade, estoque por empresa e últimas compras do mesmo produto. Feche com Esc ou pelo X — isso fecha só o painel, não a compra.

Passo 7 — Repetir para os demais itens e preencher as demais abas
Repita os passos 3–6 para cada produto da nota. Nas abas seguintes:
Na inclusão manual, os campos de tributação por item (CFOP, CST, NCM, base de ICMS do item) ficam vazios — eles só chegam preenchidos pelo fluxo de Importação XML (Parte 2).
Passo 8 — Salvar
Clique em Salvar (Ctrl+S).

A compra permanece em Aberto até você clicar em Faturar (Parte 4).
Passo 9 — Escolher o arquivo
Em Estoque → Compras, clique em Importar XML. Selecione o arquivo .xml da NF-e no seletor de arquivos do Windows (filtro "Arquivo XML (*.xml)"). Não há arrastar-e-soltar nem download direto da SEFAZ por aqui — só seleção de arquivo local.

Passo 10 — Conferir o fornecedor e o tipo de cálculo
Abre a janela "Importação XML":

Passo 11 — Revisar o cabeçalho importado
Ao confirmar, abre a tela "Importação de arquivo fiscal", já processando o XML. Vêm preenchidos e bloqueados (o Gestor já leu do XML): Número, Série, Modelo, Fornecedor, Total da NF-e, Chave de acesso e Situação. Você ainda pode ajustar:

Passo 12 — Vincular os itens aos produtos do sistema
Veja o passo a passo completo na Parte 3 — Vínculo de produtos, a seguir. Você pode confirmar a importação com o restante desta Parte 2 só depois de resolver os vínculos pendentes.
Passo 13 — Conferir o item na aba "Detalhes do item"
Ao clicar numa linha da grade de itens, a aba "Detalhes do item", abaixo da grade, mostra tudo sobre aquele item, em quatro blocos:

Esse fator de conversão também pode ser alterado diretamente na listagem na coluna Fator.

O Gestor não aceita V. Custo menor que o V. Compra, nem V. Venda menor que o custo. Se isso acontecer, ele corrige o valor sozinho e avisa, por exemplo: "Valor de custo não pode ser menor que o valor de compra (R$ …). Ajustado."
Se a empresa usa precificação composta, aparece o aviso "Preço composto detectado, utilize a aba Precificação". Nesse caso, faça os ajustes de preço na aba Precificação (próximo passo).
Enquanto o item não tiver produto vinculado, os blocos de conversão e precificação ficam vazios ("—").
Passo 14 — Revisar a precificação composta (se a empresa usar esse modo)
Quando a configuração de precificação da empresa é Composta, aparece a aba "Precificação" com os grupos Custos de compra, Custos de venda e Totais e resultado. O IPI e o ICMS-ST do item vêm calculados a partir do próprio XML (rateados pela quantidade), mas Frete, Seguro e Outras despesas não vêm da nota — eles usam os valores já cadastrados no produto, que você pode ajustar aqui mesmo, item a item.

Passo 15 — Aba Faturas
A aba Faturas mostra as duplicatas extraídas do XML (Sequência/Vencimento/Valor), com o botão "Ratear pelo total da nota" para corrigir soma divergente — o título/observação de cada fatura só fica editável depois, já na compra gerada.

Passo 16 — Confirmar e gerar a compra
Clique em F9 - Confirmar e gerar compra. O Gestor confirma que você quer mesmo gerar a compra, salva o cabeçalho e cria a Compra. Se sobrar item Pendente de vínculo, ele lista todos e bloqueia: "Existem N item(ns) pendente(s) de associação. Vincule um produto ou marque como ignorado antes de gerar a Compra."

Ao concluir, o Gestor mostra "Compra gerada com sucesso." e abre direto a tela Compras, já com os itens — em Situação Aberto (a compra nunca nasce Confirmada, mesmo com todos os itens vinculados; você ainda precisa Faturar, ver Parte 4).
Se quiser parar no meio e voltar depois, clique em ESC - Continuar depois — o Gestor salva tudo silenciosamente e avisa "Importação salva. Você pode continuar depois.". Para retomar, use Estoque → Importações XML.

Esta é a etapa mais importante da importação: ligar cada item do XML do fornecedor a um produto do seu cadastro. Ela acontece direto na grade de itens da tela "Importação de arquivo fiscal" — não existe uma janela separada só para isso.
Como o Gestor tenta vincular automaticamente, na ordem (o primeiro critério que encontrar, vale):
Coluna "Vínculo" — cada item aparece com uma etiqueta e cor de fundo na linha:
| Etiqueta | Significado | Cor da linha |
|---|---|---|
| Pendente | Ainda sem produto vinculado — bloqueia a geração da compra | Amarelo claro |
| Automático | O Gestor achou e vinculou sozinho (por EAN, código do fornecedor ou descrição) | Verde claro |
| Manual | Você vinculou manualmente | Azul claro |
| Novo | Produto cadastrado agora, a partir deste item do XML | Ciano claro |
| Ignorado | Você marcou para não entrar na compra | Cinza, com texto riscado |

Passo 17 — Vincular manualmente um item pendente
Na coluna "Produto (sistema)", use os botões do editor da célula:
O botão de rodapé "Desvincular do fornecedor" vai além: apaga de fato a memória de vínculo produto↔fornecedor (então da próxima vez o item volta a nascer Pendente), com aviso crítico de que a ação não pode ser desfeita pela tela. Só fica habilitado quando o item tem produto vinculado e não está ignorado.

Passo 18 — Cadastrar um produto novo a partir do item
Clique no botão ➕ da linha. O Gestor pergunta "Cadastrar novo produto?" e, se confirmado:
Ao salvar, o item passa para Novo e já fica vinculado.
Passo 19 — Usar as Sugestões (Top-N)
Clique em "Buscar sugestões (Top-N)" para o Gestor listar os produtos mais parecidos com a descrição do item do XML.

A busca irá mostrar Score, Critério (EAN, EAN (referência), Descrição exata ou Descrição similar), Descrição, EAN, Unidade, Valor de venda e se está Inativo. Duplo clique numa sugestão vincula ela ao cadastro de produto do sistema selecionado acima, e é exibido o toast "Produto vinculado ao item."

Passo 20 — Informar lote/grade, se algum item exigir
Selecione a linha do item e clique em "Lote / Grade...". As regras são as mesmas do lançamento manual (soma precisa fechar com a quantidade movimentada), mas aqui a janela é a versão da importação ("Lotes do item" / "Grade do item"), com um detalhe extra: ao digitar ou escolher um código de lote que já existe no sistema, os campos Validade e Localização são preenchidos automaticamente na hora — sem precisar sair da célula. Se você tentar abrir isso sem produto vinculado, o Gestor avisa "Vincule um produto antes de informar lote/grade."; e se o produto for do tipo Normal, avisa que ele "não exige lote nem grade".

Use este caminho quando o fornecedor já emitiu a NF-e contra o CNPJ da sua empresa e você quer buscar o documento direto na SEFAZ, sem receber/procurar o arquivo XML por fora.
Passo 21 — Buscar os documentos
Acesso o menu Fiscal → Manifestação DF-e.

Em seguida clique em "Buscar DF-es". O Gestor avisa que a consulta usa internet e pode demorar, e pede confirmação. Essa busca consulta o webservice de Distribuição DF-e da SEFAZ usando o certificado digital da empresa.

Existe um intervalo mínimo de 65 minutos entre buscas — dentro desse período, o rodapé mostra "Próxima consulta DFe:" com o tempo restante, e uma nova tentativa é recusada com "A última consulta de manifestação de documentos foi realizada recentemente...".
Após a consulta ser realizada com sucesso, é exibida a listagem com as NF-es emitidas contra seu CNPJ.

A grade mostra Razão social, CNPJ/CPF, Data emissão, Chave de acesso, Número, Situação, Valor DF-e, se o XML já está disponível e se a Compra já foi faturada para aquele documento.
Passo 22 — Manifestar a operação
Caso na coluna XML disponível estiver mostrando "NÃO", indica que o sistema ainda não teve acesso ao xml para ser possível lançar a compra, será preciso aplicar uma manifestação. Para isso, dê duplo clique no documento para abrir a janela de manifestação. No campo Operação, escolha uma das quatro opções:
| Opção | O que significa |
|---|---|
| CIÊNCIA DA OPERAÇÃO | Você tem conhecimento da nota, mas ainda não confirma se a operação de fato ocorreu — já libera o download do XML completo |
| CONFIRMAÇÃO DA OPERAÇÃO | Você confirma que a operação ocorreu conforme a nota — também libera o XML completo |
| DESCONHECIMENTO DA OPERAÇÃO | Você não reconhece essa nota como sua — a SEFAZ não libera o XML completo por esse caminho |
| OPERAÇÃO NÃO REALIZADA | A operação foi acordada, mas não se concretizou (devolução, sinistro etc.) — a SEFAZ também não libera o XML completo. Exige uma Justificativa com no mínimo 15 caracteres |
Clique em "Manifestar documento" e confirme. Só Ciência e Confirmação da Operação deixam o Gestor baixar depois o XML completo e gerar a compra.

Passo 23 — Gerar a compra
Selecione o documento (já manifestado com Ciência ou Confirmação) e clique em "Gerar compra". Por trás da cena, o Gestor baixa o XML da SEFAZ e abre exatamente as mesmas telas da Parte 2 (seleção/confirmação de fornecedor e a tela de importação com o vínculo de produtos) — a partir daqui, siga os Passos 10 a 20 normalmente.

Se a situação do documento for Desconhecimento ou Operação não Realizada, o Gestor bloqueia: "O XML completo não é disponibilizado pela SEFAZ para esse tipo de manifestação, portanto não é possível gerar a compra por aqui." Se o documento ainda não tiver manifestação nenhuma (Sem Informação), o Gestor pergunta se pode manifestar Ciência da Operação automaticamente antes de seguir.
Passo 24 — Recuperar uma nota que não apareceu na busca (variação)
Se uma nota já foi manifestada em outro sistema (por isso nunca apareceu na varredura automática do Gestor), use o botão "Recuperar por chave". Cole a Chave de acesso (44 dígitos), marque "Recuperar e manifestar" se também quiser enviar a manifestação dali mesmo, e clique em "Recuperar nota". A nota recuperada cai na grade principal — depois é só usar "Gerar compra" normalmente (Passo 21).

Vale para qualquer compra, seja lançada manualmente, importada de XML ou gerada pela Manifestação DF-e — todas nascem em Aberto e passam por aqui.
Antes de faturar é possível corrigir ou alterar os dados de algumas colunas diretamente na tela da compra, bastando clicar no campo. Quando utilizado o tipo de preço simples é possível editar os dados das colunas: Qtde Nota, Tipo de conversão, Fator, Vlr Compra, Desconto, Custo(%), Custo(R$), Margem Lucro, Tipo mov. item e Atualizar preço.

Quando utilizar o preço composto é possível editar diretamente nos item os dados das colunas: Qtde Nota, Tipo de conversão e Fator.

Os valores, podem ser alterados dando dois cliques em cima do nome do produto na listagem, que irá abrir uma nova janela para com os campos de valores(compra, custo, venda, etc) para que possam ser alterados.

Passo 25 — Faturar a compra
Com a compra em Aberto, clique em Faturar. O Gestor mostra um resumo (total, quantidade de itens) avisando que o estoque dos produtos será movimentado e que a situação passará para Confirmado e não poderá mais ser editada. Confirme para concluir — toast "Compra confirmada com sucesso.".

O Gestor não deixa faturar se houver item com lote/grade pendente (soma diferente da quantidade movimentada) ou se a chave de acesso informada já pertencer a outra compra confirmada.
Passo 26 — Estornar a compra (se precisar corrigir algo)
Com a compra Confirmado, clique em Estornar. O aviso é direto: "ATENÇÃO: deseja reabrir a compra #N?", informando que a movimentação de estoque será estornada, que contas a pagar em aberto vinculadas serão excluídas, e que "Esta ação não pode ser desfeita.". Não é possível estornar se já existir NF-e de entrada gerada para a compra, se houver uma Transferência de Estoque já confirmada vinculada, ou se alguma conta a pagar gerada já tiver sido baixada.

Devolução, Transferência de estoque e Gerar NF-e de entrada só aparecem depois que a compra está Confirmada, e cada um tem seu próprio fluxo (fora do escopo deste tutorial).
A configuração global de precificação da empresa decide se os campos de custo/venda aparecem no modo simples (4 campos) ou composto (rateio detalhado de frete/IPI/ICMS-ST/seguro/outras despesas). Isso vale igualmente para o lançamento manual (Parte 1) e para a importação de XML (Parte 2) — só muda a origem dos valores de IPI/ICMS-ST (vêm do XML na importação; são digitados manualmente no lançamento manual).
Se você importar de novo um XML com a mesma chave de acesso de uma importação ainda Aberta, o Gestor simplesmente reabre a importação existente (não duplica). Se a chave já pertencer a uma importação em outra situação (por exemplo, já Confirmada), o Gestor recusa: "Já existe uma importação para a NF-e com chave '{chave}' ... Não é possível importar a mesma NF-e novamente."
Se a soma das duplicatas do XML não bater com o total da nota, ao confirmar a importação o Gestor oferece três opções: "Ratear pelo total da nota", "Continuar mesmo assim" ou "Cancelar".
Em monitores de resolução menor, a tela de Importação XML reorganiza os mesmos campos em blocos mais compactos (inclusive renomeando "Precificação anterior" para "Preços anteriores"). É só uma reorganização visual — nenhum campo ou regra muda.
"Selecione um produto." / "Selecione a unidade." / "Quantidade deve ser maior que zero." / "Valor de compra deve ser maior que zero."
Faltou preencher um dos campos obrigatórios do grupo "Inserir produto" antes de clicar em Adicionar.
"Produto controlado por LOTE requer informação de lote antes de adicionar." / "...GRADE requer distribuição (cor/tamanho)..."
Você cancelou a janela de Lote/Grade na hora de incluir o item. Adicione o item de novo e confirme a distribuição.
"Soma das quantidades dos lotes (X) deve ser igual à quantidade movimentada (Y)." (ou o equivalente de grade)
A soma das linhas do editor de Lote/Grade não fecha com a quantidade do item. Ajuste as quantidades até a diferença chegar a zero.
"Fornecedor não cadastrado. Use o botão 'Cadastrar fornecedor' antes de continuar."
O CNPJ do emitente do XML não bateu com nenhum fornecedor cadastrado. Use o botão indicado para cadastrar sem saltar de tela.
"Existem N item(ns) pendente(s) de associação. Vincule um produto ou marque como ignorado antes de gerar a Compra."
Ainda há item na cor amarela (Pendente) na grade de importação. Volte à Parte 3 e vincule ou ignore cada um.
"Já existe uma compra confirmada com a chave de acesso informada."
A chave de acesso já foi usada em outra compra confirmada — confira se você não está lançando a mesma nota duas vezes.
"O XML completo não é disponibilizado pela SEFAZ para esse tipo de manifestação, portanto não é possível gerar a compra por aqui."
O documento foi manifestado como Desconhecimento ou Operação não Realizada — esses dois tipos nunca liberam o XML completo.
"A última consulta de manifestação de documentos foi realizada recentemente. Por favor, aguarde mais {tempo}."
Você tentou buscar DF-es antes de completar o intervalo mínimo de 65 minutos entre consultas.
"Não é possível reabrir uma compra que já possui NF-e gerada. Cancele a NF-e antes de reabrir a compra."
Você tentou Estornar uma compra que já tem NF-e de entrada emitida. Cancele a NF-e primeiro.
"Não é possível reabrir compra. Existem contas à pagar baixadas."
Algum título financeiro gerado por essa compra já foi baixado (pago). Não é possível estornar enquanto isso não for revertido no financeiro.
Ctrl+I - Tela Compras, abre uma compra nova (Incluir)
Ctrl+M - Tela Compras, entra em modo de edição (Editar)
Ctrl+Del - Tela Compras, exclui a compra atual
Ctrl+S - Tela Compras, salva a compra
Esc - Tela Compras, cancela a edição / fecha a tela
Ctrl+P - Tela Compras, imprime
Ctrl+W - Tela Compras, fecha a janela
F4 - Tela Compras — campo Produto, abre a busca de produto
Ctrl+Enter - Tela Compras — grupo Inserir produto, equivale a clicar em Adicionar
F2 - Tela Compras — campo Fator, alterna o fator entre Dividir e Multiplicar
Ctrl+L - Tela Compras — grid de itens, abre o editor de Lotes do item selecionado
Ctrl+G - Tela Compras — grid de itens, abre o editor de Grade do item selecionado
Delete - Tela Compras — grid de itens ou de faturas, remove a linha selecionada (com confirmação)
F9 - Editores de Lote — Grade e Precificação Composta (manual e importação), confirma e salva a janela
Esc - Editores de Lote, Grade e Precificação Composta (manual e importação), cancela e fecha a janela
Esc - Painel de consulta do produto, fecha só o painel, sem afetar a compra
F9 - Janela "Importação XML" (escolha do arquivo), confirma e avança para a tela de importação
Esc - Janela "Importação XML" (escolha do arquivo), cancela a importação
F9 - Tela "Importação de arquivo fiscal", confirma e gera a compra
Esc - Tela "Importação de arquivo fiscal", salva e permite continuar depois ("Continuar depois")
Enter - Tela de importação — campo Fator, aplica o fator de conversão digitado
Enter - Tela de importação — busca de produto (popup), foca a primeira linha do resultado da busca
Esc - Janelas de manifestação (Manifestar / Recuperar por chave), cancela e fecha a janela