📋 Manifesto de XML (Central de XML SEFAZ)

1. Disponibilidade e visão geral

Antes, o fluxo exigia ter o arquivo XML em mãos, abrir a Conciliação de XML, selecionar o arquivo e só então fazer a entrada. Agora a Central mostra todas as notas do CNPJ e o envio para a entrada é feito direto da lista.

2. Parâmetros

Todos os parâmetros são configurados no Parametreasy, grupo FISCAL, subgrupo MANIFESTO SEFAZ.

Parâmetros relacionados (já existentes, usados pelas telas de destino)

• PUXAR CONTAS A PAGAR DO XML NA CONCILIAÇÃO DE XML (grupo Produto)
• VALOR LIMITE DE DIVERGÊNCIA NA CONCILIAÇÃO DE XML (grupo Produto)
• SEMPRE COPIAR O EAN PARA O USE POR PADRÃO NA CONCILIAÇÃO DE XML (grupo Produto)
• COPIAR PREÇOS DO XML PARA O PEDIDO DE COMPRA (grupo Fiscal)
• GERAR NOTA FISCAL AUTOMÁTICA NA CONCILIAÇÃO DE PEDIDO DE COMPRA (grupo Suporte)

3. Permissões

Permissão padrão de todas as rotinas abaixo: Administrador e Diretor.

4. Como usar a Central

Caminho: Movimento > Movimento Fiscal > Central de XML SEFAZ

Videoaula: Central de XML SEFAZ – Manifesto de XML. Dentro do sistema, o botão de vídeo (ícone de câmera) fica na barra superior da tela, ao lado do cadeado e do botão Sair.

4.1 Visão geral da tela

A tela é dividida em quatro áreas: barra superior, faixa de consulta à SEFAZ, filtros e grade de notas. Acima da grade aparece a barra de ações quando há notas selecionadas.

4.2 Barra superior

• Loja: escolhe a loja de operação. A grade, a consulta à SEFAZ e os envios valem para a loja selecionada.
• Faixa azul "Operando como …": aparece quando a loja selecionada é diferente da loja logada, indicando loja e CNPJ em uso.
• Botão de vídeo: abre a videoaula da Central de XML.
• Cadeado: abre o controle de acesso (usuários) da tela.
• Sair: fecha a tela.

4.3 Consulta à SEFAZ

4.4 Filtros

• Emissão de / até: período de emissão da nota (por padrão, o último mês).
• Fornecedor: CNPJ ou razão social do emitente.
• Manifestação: Todas, Sem manifestação, Ciência, Confirmada, Desconhecida ou Não realizada.
• Processamento: Todos, Pendente, XML baixado, Enviado p/ Entrada, Enviado p/ Uso e Consumo, Enviado p/ Conciliação de Pedido ou Ignorado.
• XML: Todos, XML disponível ou XML pendente (a SEFAZ ainda não liberou o arquivo completo).
• Pesquisar aplica os filtros e Limpar volta ao padrão.

4.5 Grade de notas

Botão principal da linha (muda conforme o estado da nota):

• Dar ciência: nota ainda sem manifestação.
• Encaminhar ▾: ciência dada, XML baixado e nota autorizada. Abre as três opções de envio.
• Ver nota: nota já encaminhada, ignorada ou resolvida. Abre os detalhes.

O duplo clique na linha também abre os detalhes. O rodapé resume a lista (ex.: 35 notas • 34 pendentes de destino).

4.6 Ações em várias notas (barra de ações)

Marque as notas na caixa à esquerda da grade. A barra de ações aparece indicando quantas notas foram selecionadas.

• Dar ciência: registra a Ciência da Operação nas notas selecionadas.
• Confirmar operação: registra a Confirmação da Operação.
• Enviar para ▾: Entrada de Produtos, Uso e Consumo ou Conciliação de Pedido.
• Exportar: salva o XML das notas e dos eventos delas (cancelamento, carta de correção). Com uma nota, pergunta onde salvar; com várias, pergunta a pasta.
• Ignorar: marca como Ignorado (pede confirmação).
• limpar seleção: desmarca todas.

4.7 Menu ⋯ (todas as ações da nota)

Os eventos são enviados em lotes de até 20 notas. Ao final, o sistema informa quantas foram manifestadas, quantos XMLs foram baixados e, em caso de falha, a chave e o motivo devolvido pela SEFAZ.

Baixa da SEFAZ o arquivo inteiro da nota. Só age nas notas ainda sem XML. Se alguma estiver sem manifestação, pergunta antes: "N documento(s) ainda sem manifestação. Para baixar o XML será registrada a Ciência da Operação no SEFAZ. Deseja continuar?"

Abre a tela de importação de XML da Entrada de Produtos já com o XML da nota.

• Aceita uma nota por vez.
• A nota passa para Enviado p/ Entrada quando a entrada é gravada. Se o usuário abrir e cancelar, o status não muda.

Registra o XML no fluxo de Uso e Consumo. Com uma nota, abre direto a conciliação (conciliar com um pedido em aberto do fornecedor ou criar o pedido a partir do XML). A nota passa para Enviado p/ Uso e Consumo.

Registra o XML na Conciliação de Pedido de Compra. Com uma nota, abre direto a escolha/conciliação com o pedido. A nota passa para Enviado p/ Conciliação de Pedido.

Abre a janela Detalhes do Documento, com cabeçalho (emissão, Nº NF, valor total, NSU, tipo e chave de acesso), itens da nota (código, descrição, NCM, CFOP, unidade, quantidade, valores), parcelas/duplicatas com vencimento e valor, e o histórico de eventos da nota (NSU, tipo, data de recebimento, manifestação e processamento). Se o XML completo ainda não foi baixado, mostra apenas o resumo e orienta a dar Ciência ou usar Baixar XML.

Salva o XML da nota e dos eventos dela (cancelamento e carta de correção, exigíveis em fiscalização).

Marca a nota como Ignorado para sair das pendências. A nota continua na Central e pode ser filtrada em Processamento > Ignorado. Só vale para notas ainda não encaminhadas.

5. Passo a passo: da nota ao estoque

Caminho: Movimento > Movimento Fiscal > Central de XML SEFAZ

6. Quando a consulta acontece

Não existe serviço rodando em segundo plano. A consulta à SEFAZ é disparada ao abrir qualquer uma destas telas:

• Central de XML SEFAZ – é possível acompanhar e forçar pelo botão Buscar agora.
• Entrada de Produtos – consulta silenciosa (sem botão nem aviso).
• Conciliação de XML – consulta silenciosa.
• Uso e Consumo – consulta silenciosa.

Com a ciência automática ativa, as notas novas encontradas nessa consulta já recebem a Ciência e têm o XML baixado.

7. Regras de negócio

• A consulta é por NSU (número sequencial da SEFAZ), sempre incremental: não existe consulta por período de datas.
• O intervalo entre consultas respeita o parâmetro (mínimo 60 minutos). Consultar antes disso faz a SEFAZ bloquear por 1 hora (rejeição 656 – Consumo Indevido).
• A SEFAZ mantém os documentos disponíveis para consulta por até 90 dias após o recebimento pelo Ambiente Nacional (Nota Técnica 2014.002). O prazo para manifestar uma NF-e é de 180 dias da autorização.
• A ciência automática processa no máximo 100 notas por execução; o excedente fica para a próxima consulta.
• A Ciência da Operação libera o XML completo, mas não confirma a compra. Confirmação, Desconhecimento e Operação não Realizada são sempre manuais.
• Eventos de manifestação são fiscais e não podem ser revertidos pelo sistema. O fornecedor é notificado.
• Notas canceladas ou denegadas não podem ser encaminhadas.
• O envio para Entrada de Produtos aceita uma nota por vez.
• Ignorar não vale para nota já encaminhada, para não apagar o histórico do envio.
• O XML completo é guardado no banco de dados do USE (não depende de arquivo no terminal).
• O certificado digital é lido do terminal (loja + nome da máquina) cadastrado no USE, não do usuário logado.
• Se outro sistema (ex.: SIEG) consultar a Distribuição DF-e do mesmo CNPJ com o mesmo certificado, os dois podem bloquear um ao outro por excesso de consultas.
• Fornecedor sem cadastro não impede o fluxo de Uso e Consumo: o caminho "criar do XML" cadastra o fornecedor.

8. Erros mais comuns e como resolver

8.1 Certificado não configurado

Causa mais comum: o certificado A1 é lido do cadastro do terminal (loja + nome da máquina), não do usuário logado.

O que verificar:

• Se a máquina tem terminal cadastrado para a loja.
• Se o caminho do arquivo .pfx existe e está acessível.
• Se o certificado é do CNPJ da loja selecionada.

8.2 Sincronização em andamento (em vermelho)

Causa mais comum: outra sincronização está segurando a trava dessa loja/CNPJ (outro terminal ou uma consulta que ficou pendurada). A trava órfã é liberada sozinha após 30 minutos.

O que verificar (se persistir por mais de 30 minutos):

• Tabela NFEDISTRIBUICAOCONTROLE da loja (campos SINCRONIZANDO e DATAINICIOSINCRONIZACAO).
• Se o terminal consegue acessar a SEFAZ (rede, firewall, proxy).

8.3 Bloqueio da SEFAZ (656 – Consumo Indevido)

Causa mais comum: a SEFAZ recusou por excesso de consultas. O bloqueio dura 1 hora e libera sozinho.

O que verificar (se voltar a acontecer):

• Se há mais de uma loja com o mesmo CNPJ.
• Se outro sistema (ex.: SIEG) está consultando com o mesmo certificado.

8.4 "Aguarde X min"

8.5 Nenhum documento encontrado

O que verificar:

• Ajustar o período e os filtros.
• Lembrar que a SEFAZ só disponibiliza documentos dos últimos 90 dias.

8.6 Tempo limite ao manifestar

Causa mais comum: falha de comunicação durante a manifestação. Por limitação conhecida (Issue 92359), o erro exibido pode ser o da gravação do log e não o erro original da SEFAZ.

O que verificar:

• Conexão do terminal com a internet/SEFAZ.
• Repetir a manifestação.

9. Perguntas frequentes

A Ciência da Operação confirma a compra?

Não. A Ciência apenas declara que a loja tem conhecimento da NF-e e libera o download do XML completo. A confirmação é um evento separado e manual.

Dá para consultar notas de um período específico na SEFAZ?

Não. A consulta é sempre incremental por NSU. O filtro de período da tela atua apenas sobre as notas já trazidas para o USE, e a SEFAZ guarda os documentos por até 90 dias.

Por que o cliente não vê a Central de XML SEFAZ no menu?

Verifique se o parâmetro UTILIZA MANIFESTO SEFAZ (DISTRIBUICAO DFE) está ativo e se o usuário tem a rotina 1400 (padrão: Administrador e Diretor).

Posso desfazer uma manifestação enviada por engano?

Não pela tela. Os eventos de manifestação são fiscais, não podem ser revertidos pelo sistema e o fornecedor é notificado.

Abri a Entrada de Produtos pela Central e cancelei. A nota some das pendências?

Não. O status só muda para Enviado p/ Entrada quando a entrada é gravada.

Dá para enviar várias notas de uma vez para a Entrada de Produtos?

Não. A Entrada de Produtos aceita uma nota por vez.

Posso ignorar uma nota que já foi encaminhada?

Não. Ignorar só vale para notas ainda não encaminhadas, para preservar o histórico do envio.

O cliente usa o SIEG e as consultas ficam bloqueando. Por quê?

Se outro sistema consulta a Distribuição DF-e do mesmo CNPJ com o mesmo certificado, os dois podem bloquear um ao outro por excesso de consultas (rejeição 656).

10. Informações técnicas (apoio N2 / desenvolvimento)

• Feature 87609: Manifesto SEFAZ – Importação automática de XMLs (Distribuição DF-e)
• User Story 87610: MVP: Central de XMLs + download automático + encaminhamentos
• User Story 88383: Criar Pedido de Compra a partir do XML (na Central)
• User Story 88384: Padronizar navegação Tab/Enter/Ctrl+V na Conciliação de XML
• User Story 88765: Permissão por ação (Enviar p/ Entrada, Uso e Consumo, Conciliação de Pedido) com liberação por senha
• User Story 91452: Acesso nativo ao parâmetro "Utiliza Manifesto SEFAZ" para Administrador e Diretor
• User Story 91453: Mover parâmetros do grupo Loja para o grupo Fiscal
• User Story 91454: Remover parâmetro "Utiliza modo demonstração Manifesto SEFAZ"
• User Story 91455: Mover "Intervalo mínimo entre consultas" para Fiscal e impedir valor abaixo de 60 minutos
• User Story 90044: Conciliação de XML – Copiar preço de venda na entrada (via parâmetro)
• User Story 90085: Conciliação de XML – Alertar impressão de etiquetas ao gravar a entrada (via parâmetro)
• User Story 92708: Disponibilizar a videoaula da Central de XML SEFAZ na versão Master
• Issue 89914: Status incorreto ao cancelar Uso e Consumo
• Issue 92359: Falha ao gravar log mascara a exceção real da manifestação
• Issue 93049: Não oferecer "Enviar para" quando há mais de uma nota selecionada
• Bug 88211: Follow-up: camada Business + StatusCode nos endpoints
• Bug 88212: Follow-up: pesquisa de XML Uso e Consumo sem escopo de loja nem permissão