Documentos Recebidos¶
Em uma frase. Consulta das NF-e e NFC-e emitidas por terceiros contra as empresas da conta — capturadas na SEFAZ ou importadas por arquivo —, com XML, DANFE e manifestação do destinatário.
Quem usa: analista fiscal, recebimento fiscal, contas a pagar · Frequência: diária · Pré-requisitos: empresa cadastrada no Hub; para a captura automática, empresa configurada em Configurações ▸ Recebimento com certificado digital ativo
Para que serve¶
Esta tela é a caixa de entrada fiscal da empresa: toda nota em que ela aparece como destinatária e que chegou ao sistema está aqui. Os documentos entram por três caminhos:
- Captura na SEFAZ — a distribuição de DF-e, configurada em Configurações ▸ Recebimento;
- Upload — XML autorizado (
procNFe) ou resumo (resNFe) enviado pela Gestão de Arquivos; - Integração — o mesmo upload, feito por outro sistema pela API.
A nota recebida nunca entra no fluxo de emissão: série, número e chave são os do fornecedor, e nada consome a numeração da empresa. O que se faz aqui é conferir o documento, baixar o XML e o DANFE e registrar a manifestação do destinatário (Confirmação, Ciência, Desconhecimento ou Operação não Realizada).
A tela responde a perguntas como "a nota do fornecedor já chegou?", "tenho o XML completo ou só o resumo?" e "já confirmei esta operação na SEFAZ?".
Como chegar¶
- No Hub, abra o app NF-e.
- No menu Documentos, selecione Recebidos.
Também se chega a uma nota recebida pela Gestão de Arquivos: o número de notas na linha do arquivo (ou Ver NF-e gerada) abre esta tela já filtrada — ou a nota — quando o arquivo gerou só documentos recebidos.
A tela de listagem¶
O título é Notas Fiscais Recebidas, e o subtítulo conta quantas notas o filtro trouxe ("N notas recebidas").
Atenção ao período. A lista abre com as notas emitidas hoje — o filtro de data é pela data de emissão do fornecedor, não pela data em que a nota chegou. Uma nota emitida na semana passada e capturada hoje não aparece na abertura: amplie Emissão de / Emissão até ou use o filtro Recebimento de / até em Mais filtros.
Cards de indicadores¶
| Card | O que conta | Ao clicar |
|---|---|---|
| Total | Todas as notas recebidas do período e das empresas escolhidas | Remove o filtro de situação |
| XML Completo | Notas com o XML autorizado completo | Filtra a situação "Autorizada (XML completo)" |
| Só Resumo | Notas que só têm o resumo da SEFAZ. O card só aparece quando há alguma | Filtra a situação "Resumo (aguardando XML)" |
| Valor Recebido | Soma do valor das notas completas e resumidas (canceladas e denegadas ficam fora) | — |
Os cards respeitam só a empresa e o período de emissão. Os demais filtros (situação, chave, fornecedor, valor…) mudam a lista, mas não os números dos cards.
O que a lista mostra¶
Use o ícone de engrenagem para ligar e desligar colunas — a escolha fica gravada no navegador e é separada da escolha feita em Emitidos.
| Coluna | Conteúdo | Visível por padrão | Ordenável |
|---|---|---|---|
| Modelo | NF-e ou NFC-e; selo H quando a nota é de homologação |
sim | não |
| Série | Três dígitos (001) |
sim | não |
| Número | Nove dígitos | sim | sim |
| Chave | Chave de acesso, com botão de copiar | sim | não |
| Emitente | Razão social e CNPJ do fornecedor | sim | não |
| Destinatário | A empresa da conta que recebeu a nota | sim | não |
| Status | Selo da situação (ver abaixo) | sim | sim |
| Data de Emissão | Emissão pelo fornecedor | sim | sim |
| Data de Autorização | Autorização na SEFAZ | não | não |
| Data de Recebimento | Quando a nota entrou no sistema | não | não |
| Total | Valor total da nota | sim | sim |
| Origem | SEFAZ (captura), UPLOAD (Gestão de Arquivos), Integração ou Manual |
sim | não |
| Escrita Fiscal | sim (com link para o documento na Escrituração Fiscal) ou não |
sim | não |
Ordenação inicial: emissão mais recente primeiro. Depois de ordenar por outra coluna, o botão Limpar ordenação volta ao padrão.
Situação da nota recebida¶
| Selo | Situação | O que significa |
|---|---|---|
| Autorizada | Recebida |
Documento autorizado com o XML completo gravado |
| Resumo | RecebidaResumo |
Só o resumo da SEFAZ (resNFe): sem itens, sem DANFE |
| Cancelada | Cancelada |
O fornecedor cancelou a nota (evento de cancelamento recebido) |
| Denegada | Denegada |
Uso denegado pela SEFAZ |
Filtros¶
Na barra da tela: abas Todos · NF-e · NFC-e, seleção de uma ou mais empresas e o período Emissão de / Emissão até. Atualizar aplica o que foi alterado.
Mais filtros abre o painel lateral:
| Grupo | Campos |
|---|---|
| Situação | Autorizada (XML completo) · Resumo (aguardando XML) · Cancelada · Denegada — mais de uma ao mesmo tempo |
| Operacional | Ambiente (Produção / Homologação) |
| Identificação | Chaves de acesso (cole várias, 44 dígitos cada; pontuação é ignorada) · Número de / até |
| Fornecedor e valores | CNPJ do fornecedor (emitente) · Valor mínimo / máximo |
| Origem e datas | Origem · Autorização de / até · Recebimento de / até |
Filtros ativos aparecem como etiquetas removíveis acima da grade.
Ações por linha¶
| Ícone | O que faz | Quando fica disponível |
|---|---|---|
| Olho | Abre a nota em tela cheia | Sempre |
| XML (menu) | XML Resumido, XML Autorizado ou XML de Cancelamento, com visualização e download | Resumido só em nota resumida; Autorizado só com XML completo; Cancelamento só em nota cancelada |
| Download | Baixa o XML gravado | Nota com XML (completo ou resumo) |
| Impressora | Visualiza o DANFE | Só com XML completo |
| Envelope | Envia por e-mail | Não se aplica a nota recebida autorizada |
| Evento (menu) | Manifestação do destinatário e eventos da Reforma Tributária do destinatário | Notas Autorizada e Resumo com chave de acesso |
Seleção e ações em massa¶
Marque as linhas pela caixa de seleção. Com a página inteira marcada, a tela oferece Selecionar todas as N do filtro. A faixa de seleção traz:
- Exportar selecionadas — pacote com XML autorizado, DANFE, XMLs e PDF de eventos e planilha resumo. Nota sem XML autorizado é ignorada e listada no relatório da exportação;
- Ações em massa ▸ Criar eventos — abre o assistente de eventos com as notas selecionadas.
O acompanhamento das exportações e operações em massa fica no Centro de Tarefas (ícone de lista ao lado da engrenagem).
A nota em tela cheia¶
O cabeçalho mostra série/número, selo de situação, modelo, ambiente e, quando houver, o selo de Escrita Fiscal. As ações do topo são:
- Consultar na SEFAZ — pergunta à SEFAZ o que existe hoje para a chave (ver abaixo);
- XML — mesmo menu da listagem;
- DANFE — desabilitado em nota resumida ("Resumo sem XML completo — DANFE indisponível").
Nota resumida mostra o aviso «Nota resumida — aguardando evento de Ciência da Operação para o XML completo.»
Abas¶
| Aba | Conteúdo |
|---|---|
| Cabeçalho | Identificação do documento, emitente, destinatário, autorização |
| Itens | Itens com os impostos de cada um, e a soma ao final |
| Totais | Totais da nota, inclusive IBS, CBS e IS da Reforma quando presentes |
| Transporte | Modalidade de frete, transportador, volumes |
| Pagamento | Formas de pagamento, cobrança e duplicatas |
| Adicionais | Informações complementares e ao fisco |
| Eventos | Eventos da nota (manifestações, cancelamento) e o botão Novo Evento |
| Histórico SEFAZ | Cada interação com a SEFAZ sobre esta nota, com os XMLs de envio e retorno |
Em nota resumida, só Eventos e Histórico SEFAZ têm conteúdo: as demais mostram «Indisponível sem o documento canônico.»
Consultar na SEFAZ¶
Consulta a chave na distribuição de DF-e, no ambiente da própria nota, e mostra o que voltou:
| Resultado | O que fazer |
|---|---|
| «XML autorizado encontrado na SEFAZ.» | Atualizar no sistema grava o XML na nota: itens, totais e protocolo passam a existir e o DANFE é liberado |
Só o resumo (resNFe) |
Registre a manifestação (Confirmação da Operação) na aba Eventos e consulte de novo |
| Nenhum documento | A SEFAZ não tem documento para a chave naquele ambiente |
O resultado também pode ser copiado ou baixado. A consulta não grava nada até o usuário clicar em Atualizar no sistema, e fica registrada no Histórico SEFAZ.
Manifestação do destinatário¶
No menu de eventos da linha, ou em Novo Evento na aba Eventos:
| Código | Evento | Natureza |
|---|---|---|
| 210200 | Confirmação da Operação | Conclusiva |
| 210210 | Ciência da Operação | Provisória |
| 210220 | Desconhecimento da Operação | Conclusiva |
| 210240 | Operação não Realizada | Conclusiva — exige justificativa |
A manifestação é enfileirada («Manifestação enfileirada — acompanhe o processamento na linha da nota.») e processada em segundo plano; o resultado aparece na aba Eventos.
Regras de negócio¶
- RN-REC-001 — Recebida é documento de terceiro. Só entra aqui a nota em que a empresa da conta
é a destinatária. Documento em que a empresa aparece apenas como autorizada a baixar o XML
(
autXML) não é capturado como recebido. - RN-REC-002 — Uma nota por chave. A nota recebida é única pela chave de acesso. Reenviar o mesmo documento não duplica; um resumo que depois chega completo é enriquecido na mesma linha, e passa de Resumo para Autorizada.
- RN-REC-003 — Emitida e recebida convivem. Quando o emitente também é empresa da conta (transferência entre filiais), o mesmo XML gera a nota em Emitidos e a nota aqui.
- RN-REC-004 — Nota recebida não é emitida nem reprocessada. As ações de emitir, reprocessar, inutilizar e cancelar não se aplicam: quem cancela é o fornecedor, e o cancelamento chega como evento e muda a situação para Cancelada.
- RN-REC-005 — Resumo não tem DANFE. Sem o XML completo não há itens, totais nem DANFE; o XML completo vem pela captura, pela consulta à SEFAZ ou por novo upload.
- RN-REC-006 — Ciência é automática na captura. Todo resumo capturado recebe a Ciência da Operação (210210) sem ação do usuário. Se a Ciência for recusada por prazo, o sistema registra a Confirmação da Operação (210200) — a menos que já exista manifestação conclusiva.
- RN-REC-007 — Prazos da manifestação. A Ciência vale até 10 dias da autorização; Confirmação, Desconhecimento e Operação não Realizada, até 90 dias [NT 2020.001 v1.60, item 4]. Cada manifestação conclusiva pode ser registrada no máximo duas vezes, valendo a última.
- RN-REC-008 — Operação não Realizada exige justificativa de 15 a 255 caracteres.
- RN-REC-009 — Consulta à SEFAZ tem intervalo mínimo. A mesma chave só pode ser consultada de novo depois de 5 minutos; consultar em excesso faz a SEFAZ bloquear a captura do CNPJ por uma hora (cStat 656).
- RN-REC-010 — A empresa do filtro é a destinatária. Aqui, filtrar por empresa traz as notas recebidas por ela; o fornecedor se filtra pelo CNPJ em Mais filtros.
O que esta tela não faz¶
- Não configura a captura. Ligar a distribuição de DF-e, escolher o ambiente e editar o NSU é em Configurações ▸ Recebimento.
- Não importa arquivo. O upload de XML ou
.zipé na Gestão de Arquivos. - Não escritura. A nota segue para a Escrituração Fiscal quando a empresa tem Usar Escrituração Fiscal ligado no Recebimento; a coluna Escrita Fiscal só mostra o resultado.
- Não cancela nem corrige a nota do fornecedor. Cancelamento e carta de correção são eventos do emitente.
- Não apaga nota recebida.
Erros e mensagens¶
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| «Nenhuma nota recebida encontrada» | Filtro sem resultado | Confira o período de emissão e as empresas |
| «A justificativa deve ter entre 15 e 255 caracteres.» | Operação não Realizada com texto curto | Complete a justificativa |
| «Configuração de emissão não encontrada.» | Manifestação de empresa sem configuração no app | Cadastre a empresa em Configurações ▸ Recebimento |
| «Nenhum certificado ativo para a empresa.» | Manifestação ou consulta sem certificado | Ative o certificado no cadastro da empresa no Hub |
| «Limite de sequência da manifestação atingido (máx. N).» | A manifestação já foi registrada o máximo de vezes | Nenhuma nova manifestação desse tipo é aceita |
| Consulta recusada por cooldown | A chave foi consultada há menos de 5 minutos | Aguarde e consulte de novo |
| Consulta recusada por bloqueio (cStat 656) | A SEFAZ bloqueou o CNPJ por consumo indevido | Aguarde a liberação automática (1 hora) |
| «Nota sem chave de acesso — nada a consultar.» | Nota sem chave | — |
Relação com a NF-e / SEFAZ / EFD¶
| Elemento | Relação |
|---|---|
| Distribuição de DF-e | A captura e a consulta por chave usam o serviço de distribuição do Ambiente Nacional; chegam o procNFe (completo), o resNFe (resumo) e os eventos da nota |
| Evento 110111 | Cancelamento feito pelo fornecedor: chega pela captura e muda a nota para Cancelada |
| Eventos 210200 / 210210 / 210220 / 210240 | Manifestação do destinatário, assinada com o certificado da empresa destinatária |
| EFD-ICMS/IPI — C100 | A nota recebida é escriturada como entrada (IND_OPER = 0) de emissão de terceiros (IND_EMIT = 1), com a chave em CHV_NFE e as datas em DT_DOC e DT_E_S [Guia Prático EFD-ICMS/IPI 3.2.3, p. 65]. A escrituração é feita pela Escrituração Fiscal, a partir do documento que este app envia |
Notas da EFD que dependem daqui. Em documento de entrada, imposto, base e alíquota só são informados quando há direito a crédito [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63]. NFC-e não deve ser escriturada nas entradas [Guia Prático EFD-ICMS/IPI 3.2.3, p. 64]. Documento denegado deixou de ser de informação obrigatória desde 01/12/2021 [Guia Prático EFD-ICMS/IPI 3.2.3, p. 63].
Perguntas frequentes¶
O fornecedor diz que emitiu, mas a nota não aparece. Primeiro amplie o período: a tela abre em "emitidas hoje". Se ainda não aparecer, confira em Configurações ▸ Recebimento se a captura da empresa está ativa, no ambiente certo e sem bloqueio.
A nota está como Resumo há dias. Como consigo o XML? Abra a nota e use Consultar na SEFAZ. Se voltar só o resumo, registre a Confirmação da Operação e consulte de novo; quando o XML vier, clique em Atualizar no sistema.
Importei o XML completo de uma nota que estava como Resumo. Ficou duplicada? Não. A nota é a mesma (mesma chave) e passa a Autorizada, com itens e DANFE.
Por que não consigo cancelar uma nota recebida? Porque o cancelamento é do emitente. Quando ele cancela, o evento chega pela captura e a situação muda sozinha.
Por que o card Só Resumo sumiu? Ele só aparece quando existe pelo menos uma nota resumida no período.