NF-e recebidas e manifestação

Para que serve

A aba NF-e de Notas recebidas mostra as NF-e (notas fiscais de mercadoria, modelo 55) que fornecedores emitiram contra o seu cliente, ou seja, as notas em que o cliente é o destinatário. Ninguém precisa digitar nada: com a busca ligada, o sistema consulta a SEFAZ sozinho, pela Distribuição DF-e do Ambiente Nacional, usando o certificado digital A1 do cliente.

Com as notas na tela você pode:

• conferir emitente, número, valor e situação (autorizada, cancelada ou denegada);
• abrir o XML (o resumo ou o XML completo);
• fazer a manifestação do destinatário: dizer à SEFAZ se o cliente reconhece a operação.

Esta aba trata das NF-e recebidas. Para emitir NF-e e NFC-e (recurso liberado conta a conta), veja Como começar a emitir NF-e e NFC-e.

Como ligar

Recurso liberado por conta

A NF-e recebidas é liberada conta a conta pela plataforma. Se a aba NF-e não aparece em Notas → Recebidas e o quadro NF-e recebidas não aparece no cliente, a sua conta ainda não tem o recurso: fale com o suporte para pedir a liberação. Enquanto ela não sai, a API também recusa as rotas de NF-e recebidas (nfe.nao_liberada). Se o recurso for retirado da conta, a busca de todos os clientes é desligada, mas as notas e as manifestações já recebidas ficam guardadas; quando ele volta, ligue a busca de novo em cada cliente.

Ligar a busca do cliente

Com a conta liberada, a busca vem desligada em todos os clientes.

1. Confira se o cliente tem um certificado A1 válido, do mesmo CNPJ dele. Sem certificado a busca não liga.
2. Abra o cliente em Clientes e vá ao quadro NF-e recebidas.
3. Ligue a chave Ligar busca de NF-e. A tela mostra "Busca ligada".
4. Se quiser, ligue também a Ciência automática (veja abaixo).
5. Abra Notas → Recebidas e clique na aba NF-e. Escolha o cliente no filtro do topo.

Quando as notas começam a aparecer

A SEFAZ só começa a guardar notas para um CNPJ a partir da primeira consulta feita com o certificado dele. Por isso a primeira busca costuma vir vazia. Daí em diante as notas novas aparecem sozinhas. Não há retroativo: notas com mais de 90 dias não chegam. E se o cliente ficar mais de 60 dias sem nenhuma consulta, a SEFAZ para de guardar e a contagem recomeça.

Cada documento recebido tem um número de ordem, o NSU. O sistema guarda o último NSU lido e continua de onde parou, então nenhuma nota é baixada duas vezes nem fica para trás.

Passo a passo

Ver as NF-e recebidas

1. No menu, abra Notas → Recebidas e depois clique na aba NF-e.
2. Escolha um cliente no filtro Cliente do topo (com Todos os clientes a aba pede para escolher um).
3. Use os filtros: Emissão de / até, CPF/CNPJ do emitente, Situação, Manifestação e Buscar (a chave de acesso completa, com 44 dígitos, ou parte do nome do emitente). Clique em Filtrar.
4. A lista mostra 50 notas por vez, das mais recentes para as mais antigas. Clique em Carregar mais para ver as seguintes.
5. Clique em Detalhes para ver a nota, os documentos e eventos recebidos da SEFAZ (por exemplo, cancelamento e carta de correção) e o histórico de manifestações.

Manifestar

1. Abra o Detalhe da nota.
2. Em Manifestar, clique no tipo desejado. Os botões fora do prazo ou que não valem para a nota ficam apagados, com o motivo logo abaixo.
3. Leia o efeito explicado na janela de confirmação. Em Operação não realizada, escreva a justificativa (de 15 a 255 caracteres; o contador mostra quantos você já usou).
4. Clique em Confirmar. O pedido vai para a SEFAZ em segundo plano e o resultado (Registrada ou Rejeitada, com o motivo) aparece no Histórico de manifestações.

A manifestação não pode ser desfeita. Confira a nota antes de confirmar.

Buscar agora

A busca já roda sozinha a cada 5 minutos. Buscar agora só antecipa quando a SEFAZ permite (veja a regra de 1 hora).

O que cada manifestação significa

A ciência da operação não é conclusiva: depois dela ainda é possível confirmar, desconhecer ou dizer que a operação não foi realizada. As outras três são conclusivas: depois de uma delas a ciência não é mais aceita, e cada tipo conclusivo pode ser enviado no máximo 2 vezes para a mesma nota.

Prazos

• Ciência: até 10 dias da autorização da nota.
• Manifestação conclusiva (confirmação, desconhecimento ou operação não realizada): até 90 dias da autorização. O prazo era de 180 dias e passou a 90 dias a partir de 01/06/2026.
• Fora do prazo a SEFAZ não aceita mais a manifestação. Nesse caso, trate a nota diretamente com o emitente.

Quando a manifestação é obrigatória

Para a maioria das empresas a manifestação é opcional. Ela é obrigatória para quem recebe:

• combustíveis;
• bebidas ou cigarros, quando o destinatário é distribuidor ou atacadista.

Mesmo quando é opcional, a ciência é o caminho para ter o XML completo da nota.

Ciência automática

Ligada no quadro NF-e recebidas do cliente, a ciência automática registra sozinha a ciência da operação em cada nota nova que chega. Assim o XML completo é liberado sem ninguém precisar clicar, dentro do prazo de 10 dias.

Ela não confirma nem nega nada: as manifestações conclusivas continuam com você. No histórico da nota, os pedidos feitos assim aparecem como "ciência automática".

Por que o XML completo só aparece depois da ciência

A SEFAZ entrega primeiro só o resumo da nota (emitente, valor, data e chave). O XML da nota completo, com os produtos, só é liberado depois de uma ciência, confirmação ou operação não realizada. O desconhecimento não libera.

Depois da manifestação, o XML completo chega na próxima busca. Na lista, a coluna XML passa de Resumo para Completo.

Regra de 1 hora da SEFAZ

Quando a SEFAZ responde que não há notas novas, ela exige 1 hora de espera antes da próxima consulta daquele CNPJ. Consultar antes disso é tratado como consumo indevido e bloqueia o CNPJ por mais 1 hora.

Por isso:

• a faixa de situação mostra Próxima consulta permitida pela SEFAZ: às HH:MM;
• enquanto não chega a hora, o botão Buscar agora fica apagado com o horário liberado;
• se você clicar e a SEFAZ ainda não permitir, a tela avisa "A SEFAZ só permite uma nova consulta às HH:MM".

Não é preciso ficar clicando: a busca automática respeita a regra e consulta assim que é permitido.

Situação da busca

A faixa no topo da aba mostra:

Quem vê e quem faz

• Ver a lista, o detalhe e o XML: quem vê notas recebidas (Dono, Administrador, Operador fiscal, Integrador e Auditor).
• Manifestar, Buscar agora e ligar/desligar a busca e a ciência automática: Dono e Administrador.
• O contador vê a aba NF-e no portal dele, somente leitura: não manifesta nem busca.
• O cliente vê a aba NF-e no portal do cliente, também só leitura, e baixa o XML.

Para integrar com outro sistema, use os webhooks nfe.received, nfe.cancelled, nfe.manifestation.registered e nfe.manifestation.rejected.

Erros comuns e como resolver

• A aba NF-e não aparece, ou "Recurso não liberado para a conta". A NF-e recebidas ainda não foi liberada para a sua conta. Fale com o suporte. Veja nfe.nao_liberada.

• "Para ligar a busca de NF-e o cliente precisa de um certificado A1 vigente". Envie ou renove o certificado no quadro Certificados do cliente e ligue de novo. Veja nfe.sem_certificado.
• Erro de certificado de outro CNPJ na última busca. A SEFAZ identifica o cliente pela raiz do CNPJ (os 8 primeiros dígitos) do certificado. Um certificado de outra empresa, mesmo do mesmo grupo, é recusado. Envie o certificado do próprio cliente.
• "A SEFAZ não aceitaria esta manifestação: fora do prazo da SEFAZ". Passou o prazo (10 dias para a ciência, 90 dias para as conclusivas). Trate a nota com o emitente. Veja nfe.manifestacao_invalida.
• "A ciência não é aceita depois de uma manifestação conclusiva". A nota já foi confirmada, desconhecida ou marcada como não realizada. O XML completo já foi liberado (exceto no desconhecimento).
• "Já existe um pedido deste tipo para esta nota". O pedido anterior ainda está a caminho da SEFAZ. Acompanhe no histórico em vez de repetir. Veja nfe.manifestacao_duplicada.
• Manifestação "Rejeitada" no histórico. A SEFAZ recusou; o motivo aparece logo abaixo (por exemplo, nota cancelada pelo emitente). Uma manifestação rejeitada pode ser pedida de novo, se ainda estiver no prazo.
• "Buscar agora" apagado com horário. É a regra de 1 hora. Aguarde; a busca automática segue sozinha. Veja nfe.consulta_bloqueada.
• A aba está vazia. Se a busca está desligada, ligue-a no cliente. Se está ligada, lembre que a SEFAZ só manda notas a partir da primeira consulta, sem retroativo além de 90 dias.
• "Abrir XML completo" apagado. O XML completo ainda não foi liberado: faça a ciência e aguarde a próxima busca. Veja nfe.xml_indisponivel.

Veja também

• Notas recebidas
• Detalhe do cliente
• Certificado A1
• Notas recebidas no portal do contador
• Notas recebidas no portal do cliente
• Webhooks