O que é

No site da Natus, o Gestor XML é apresentado como a rotina que vincula e cadastra produtos, agiliza a entrada de mercadorias e dá controle com conferência e relatórios. Clientes citam a “entrada automatizada de mercadorias via gestor de XML” como diferencial no controle de compras.

Na prática, a tela /Suprimentos/GestorXml/Index é o painel dos documentos fiscais tomados (principalmente NF-e e CT-e) que chegaram para a empresa como destinatária: listar, manifestar, baixar XML, associar itens a produtos/pedidos e criar a NF-e de entrada no ERP.

Como a nota chega ao Gestor

Há três caminhos comuns:

  1. Distribuição SEFAZ (distNSU / DF-e) — job automático (Agendador + NFeDownloadDFeBusiness / DocumentosTomadosController) consulta a SEFAZ e grava os documentos em NFeManifestoDestinatario.
  2. Importar XML (ferramenta da tela) — upload manual do arquivo XML da NF-e (ConfigurarLerXMLNFe / LerXmlNFe).
  3. Consulta por chave — ConsultarManifestoSEFAZ busca/atualiza um documento específico na SEFAZ (quando a configuração da empresa permite).

Também existem fluxos de DI (declaração de importação) e suporte a CT-e / NFS-e em cenários específicos.

O que você faz nesta tela

Pesquisa (Index)

  • Lista documentos com filtros (emitente, chave, datas, situação de manifesto, se a NF já foi lançada, cancelados, etc.).
  • Colunas principais: tipo XML, número/série, situação do manifesto, natureza, emissão, valor, emitente, finalidade, classificação, relacionamento, chave, NSU, se já está lançada.

Ferramentas (menu da toolbar)

Ação Função
Importar XML Sobe o XML e cria/atualiza o registro no Gestor
Desassociar Remove vínculo de item com pedido/produto
Criar NFe Gera a NF-e de entrada a partir do(s) documento(s) selecionado(s) (ImportarNFe)
Cancelar Marca o registro como cancelado no Gestor
Manifestar Envia evento de manifesto do destinatário (ciência, confirmação, etc.)
Download XML Manifestado Baixa o XML já vinculado ao manifesto
Verificar NFe Atualiza status do documento na SEFAZ

Edição do documento

Ao abrir um XML você pode:

  • Ajustar finalidade, classificação e relacionamento comercial
  • Ver produtos do XML e associar a produto/SKU e a pedido de compra (wizard GestorXmlAssociar)
  • Tratar títulos / condição de pagamento
  • Usar split de linha de produto quando necessário
  • Conferir e então criar a NF-e de entrada no ERP

Fluxo típico de uso

  1. Aguarde a distribuição automática ou importe o XML / consulte pela chave.
  2. Localize o documento na pesquisa (atenção aos filtros padrão: “NF lançada = Não”, situação de manifesto aberta).
  3. Manifeste na SEFAZ quando a operação exigir (ciência / confirmação da operação).
  4. Abra o documento, associe cada item ao produto interno e, se houver, ao pedido de compra.
  5. Revise títulos e dados fiscais.
  6. Use Criar NFe para gerar a nota de entrada e seguir a conferência / estoque.

Por que a nota de compra não aparece?

Checklist na ordem:

  1. Filtros da pesquisa — o Index inicia com “NF lançada = Não” e filtro de situação de manifesto; limpe/ajuste se a nota já foi lançada ou está em outra situação.
  2. Job de distribuição — a SEFAZ só libera novos documentos via distNSU periodicamente. Se a fila veio vazia (cStat 137) ou houve consumo indevido (656), o sistema aplica intervalo de 65 minutos antes da próxima consulta em lote (GestorXmlDistDfeRateLimitHelper).
  3. Certificado / configuração fiscal — unidade e certificado precisam estar aptos à distribuição DF-e.
  4. CNPJ destinatário — a nota precisa ser para o CNPJ da empresa/unidade consultada.
  5. Importação manual — se o fornecedor enviou o XML por e-mail, use Importar XML em vez de esperar só o job.
  6. Manifesto / download — em alguns casos o resumo chega antes do XML completo; manifeste e use download/verificar NFe.

Observações técnicas

  • Entidade central: NFeManifestoDestinatario (e filhos produto/título).
  • Job: distribuição NFe/CTe no Agendador (usa DistribuicaoDistDfePermitidaParaJob + último NSU).
  • Rate limit SEFAZ (NT 2014.002 / 2015.002): após esgotar a fila ou consumo indevido, aguardar ~65 min (1h + margem) por empresa/CNPJ/tipo.
  • Configuração: EmpresaConfiguracaoSuprimentos.ConsultarManifestoSefaz influencia consulta por chave; bloqueio de última consulta também pode ficar em EmpresaConfiguracaoFiscal.
  • Permissão de menu: funcionalidade Gestor XML (Suprimentos).

Relação com o discurso do site

O material institucional destaca três resultados que esta tela entrega:

  • Vínculo e cadastro de produtos a partir do XML (associação produto/SKU/pedido)
  • Entrada de mercadorias mais rápida (do XML à NF-e de entrada)
  • Controle com conferência (situação, lançamento, cancelamento, verificação SEFAZ)