Configurações de Recebimento¶
Em uma frase. Liga, por empresa, a captura automática na SEFAZ das NF-e destinadas ao CNPJ (distribuição de DF-e), e mostra onde a captura parou, quando volta e por que falhou.
Quem usa: analista fiscal, implantação, suporte · Frequência: na implantação de cada empresa e ao investigar nota que não chegou · Pré-requisitos: empresa cadastrada no Hub com certificado digital A1 ativo
Para que serve¶
A SEFAZ guarda, para cada CNPJ, a fila de documentos em que ele é destinatário: notas, resumos e eventos (como o cancelamento feito pelo fornecedor). Cada item da fila tem um número sequencial, o NSU. Esta tela diz ao app de quais empresas buscar essa fila, em qual ambiente (Produção ou Homologação) e a partir de qual NSU.
Com a captura ativa, o app consulta a SEFAZ periodicamente, grava as notas em Documentos ▸ Recebidos, registra cada documento na Gestão de Arquivos com origem SEFAZ, dá a Ciência da Operação nos resumos e aplica os cancelamentos que chegarem.
A tela responde a perguntas como "a captura desta filial está rodando?", "por que a nota não chegou?" e "a SEFAZ bloqueou o CNPJ?".
Como chegar¶
- No Hub, abra o app NF-e.
- No menu Configurações, selecione Recebimento.
A tela de listagem¶
Título Configurações de Recebimento. Uma linha por empresa cadastrada nesta tela — a empresa configurada só para emissão não aparece aqui.
Cards¶
Todas · Ativas · Inativas · Bloqueadas · Com erro — clicar filtra a lista. Bloqueadas conta as empresas com bloqueio da SEFAZ em vigor agora.
Colunas¶
| Coluna | Conteúdo | Ordenável |
|---|---|---|
| Empresa | Razão social, CNPJ e UF | sim |
| Captura | Selos, nesta ordem: ativa/inativa · ambiente H/P (só com a captura ativa) · bloqueada · suspensa · com erro |
sim |
| Situação da empresa | regular ou sem certificado |
não |
| Último NSU | Posição do cursor | sim |
| Última consulta | Data e hora, com o cStat entre parênteses; o código e a descrição aparecem ao passar o mouse | não |
| Próxima | Quando a próxima consulta está agendada | sim |
| Ações | Configurar · Disparar agora · Remover da lista | — |
A busca procura em razão social, CNPJ e UF ao mesmo tempo. Limpar filtros zera busca e card; Atualizar recarrega. A paginação é de 20 linhas por padrão.
Ações da lista¶
| Ação | O que faz |
|---|---|
| Novo recebedor | Escolhe uma empresa do cadastro (que ainda não esteja na lista) e abre a configuração dela |
| Lápis | Abre a configuração da empresa |
| Play | Disparar agora, com o NSU do cursor pré-preenchido. Só com a captura ativa («Captura inativa — disparo indisponível») |
| Lixeira | Remover do recebimento, com confirmação |
Configuração da empresa¶
O cabeçalho mostra razão social, CNPJ, UF e regime (CRT). Nada é gravado até clicar em Salvar configurações — nem a troca de ambiente, nem a edição do NSU. Cancelar sai sem gravar.
Com bloqueio da SEFAZ em vigor, o topo da tela mostra: «Captura bloqueada pela SEFAZ (consumo indevido, cStat 656). Libera automaticamente em N min — nenhuma ação necessária.»
Chaves principais¶
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Captura automática ativa | não | Liga / desliga | Ligar exige certificado ativo. Desligar para a consulta periódica nos dois ambientes | — |
| Usar Escrituração Fiscal | não | Sim / Não | Desligado, os documentos recebidos por esta empresa não vão para a Escrituração Fiscal. Mensagens já enviadas não são afetadas. Pode ser alterado mesmo com a captura desligada | Alimenta o C100 de entrada na Escrituração Fiscal |
Bloco «Parâmetros de captura · NF-e (55)»¶
| Campo | Obrigatório | Formato / domínio | Regra | Registro / campo fiscal |
|---|---|---|---|---|
| Ambiente SEFAZ da captura | sim | Homologação · Produção | Independente do ambiente de emissão. Cada ambiente tem NSU e bloqueio próprios; trocar de ambiente não zera nem mistura o cursor do outro. Em Produção aparece o aviso «Atenção: consulta em Produção.» | tpAmb da consulta |
| Disparar agora | — | Botão | Pede o NSU de partida e enfileira uma consulta imediata no ambiente em uso | — |
O intervalo entre consultas não é editável: a leitura em vigor aparece em Status da captura ("a cada 60 min (1 hora)").
Bloco «Certificado de DF-e»¶
Somente leitura: nome, CNPJ, tipo, situação e validade do certificado ativo da empresa, definido no cadastro da empresa no Hub. Sem certificado: «Nenhum certificado ativo para esta empresa. A captura de DF-e exige um certificado ativo, definido no cadastro da empresa no Central Hub.»
Bloco «Status da captura»¶
Atualizado pelo botão Atualizar ("atualizado às HH:MM").
| Cartão | Conteúdo |
|---|---|
| Situação | ATIVO, INATIVO, SUSPENSO ou INEXISTENTE (a captura nunca rodou) |
| Último NSU · Homologação (Máx. N) | Cursor de homologação e o maior NSU que a SEFAZ informou. Lápis edita |
| Último NSU · Produção (Máx. N) | Idem, produção. Os dois cartões ficam sempre na mesma posição; só o do ambiente selecionado é editável |
| Documentos capturados | Total acumulado |
| Tentativas seguidas | Falhas consecutivas |
| Próxima captura | Contagem regressiva; "—" com a captura inativa |
A tabela abaixo traz CNPJ, Última consulta (com selo do ambiente em que rodou, cStat e os botões Ver envio / Ver retorno, que abrem o XML enviado e o recebido da SEFAZ), Próxima captura, Intervalo entre ciclos, Bloqueado até e Último erro.
Em homologação, «cStat 137 é o resultado normal — o ambiente de testes da SEFAZ raramente tem documentos destinados ao CNPJ. Não é erro.»
Editar o cursor NSU¶
O lápis do cartão do ambiente selecionado abre Editar cursor NSU. O campo aceita até 15
dígitos; vazio vira 0 e zeros à esquerda são removidos.
| Valor digitado | Aviso | Efeito |
|---|---|---|
Menor que o cursor (ou 0) |
«Retroagir o cursor reprocessa documentos já capturados a partir do NSU informado.» | Busca de novo; notas já gravadas não duplicam |
| Igual ao cursor ou cursor + 1 | — | Nenhum |
| Cursor + 2 ou mais | «Avançar o cursor descarta documentos ainda não capturados entre o cursor atual e o NSU informado.» | Os documentos pulados não voltam |
Salvar cursor só conclui a edição: o cartão passa a mostrar não salvo até Salvar
configurações. No Disparar agora, ao contrário, o NSU alterado é gravado na hora, porque a
consulta lê o cursor gravado.
Sub-telas¶
- Novo recebedor — lista das empresas do cadastro que ainda não estão no recebimento, com busca por razão social, CNPJ ou UF.
- Disparar captura — NSU de partida (pré-preenchido com o cursor) e o ambiente, somente leitura. Botão Disparar ou Retroagir e disparar.
- Remover do recebimento — confirma que a empresa sai da lista e a captura automática é desligada; a configuração de emissão da empresa não é afetada.
- XML de envio — distDFeInt / XML de retorno — retDistDFeInt — visualizador da última consulta, com download.
Regras de negócio¶
- RN-CAP-001 — Captura exige certificado ativo. Não se ativa a captura sem certificado A1 ativo na empresa. Certificado vencido durante a operação deixa a captura SUSPENSA; para voltar, renove o certificado e salve a configuração com a captura ativa.
- RN-CAP-002 — Um cursor por ambiente. Produção e homologação têm NSU, maior NSU, bloqueio e histórico próprios. Só um ambiente fica ativo por vez; o outro é desativado, nunca apagado.
- RN-CAP-003 — Frequência imposta pela SEFAZ. A consulta periódica roda a cada 60 minutos. Quando a SEFAZ responde que não há documento (cStat 137), a próxima consulta espera pelo menos 1 hora — consultar antes disso provoca bloqueio.
- RN-CAP-004 — Bloqueio por consumo indevido. Resposta cStat 656 bloqueia o CNPJ por 1 hora. O bloqueio se desfaz sozinho; o disparo manual é recusado enquanto durar.
- RN-CAP-005 — Disparo manual respeita a janela. O disparo é recusado com o CNPJ bloqueado ou quando a última resposta foi cStat 137 há menos de 1 hora, informando em quantos minutos libera.
- RN-CAP-006 — Lotes em sequência. Enquanto a SEFAZ indicar mais documentos (último NSU menor que o maior NSU), a captura continua imediatamente, sem esperar o próximo ciclo.
- RN-CAP-007 — Falhas com espera crescente. Erro de comunicação ou cStat inesperado reagenda a consulta em 1, 5, 15, 30 e 120 minutos, conforme as falhas seguidas.
- RN-CAP-008 — Só o que é destinado à empresa. Documento em que o CNPJ aparece apenas como autorizado a baixar o XML é ignorado.
- RN-CAP-009 — Ciência automática. Cada resumo capturado recebe a Ciência da Operação (210210). Fora do prazo da Ciência (cStat 596), o sistema registra a Confirmação da Operação (210200) e tenta baixar o XML liberado — exceto se já houver manifestação conclusiva.
- RN-CAP-010 — Cancelamento do fornecedor. Evento de cancelamento (110111) que chega na fila marca a nota recebida como Cancelada.
- RN-CAP-011 — Remoção protege o histórico. A empresa com notas recebidas não pode ser removida do recebimento — recadastrar recomeçaria do NSU 0 e a SEFAZ reentregaria todo o acervo. Sem notas, a remoção apaga os cursores dos dois ambientes.
- RN-CAP-012 — Recebimento e emissão são independentes. Cadastrar a empresa aqui não a coloca em Configurações ▸ Emissão, e removê-la daqui não mexe na emissão.
- RN-CAP-013 — Escrituração por fluxo. O interruptor desta tela vale só para documentos recebidos; o de emitidos fica em Configurações ▸ Emissão.
O que esta tela não faz¶
- Não cadastra nem troca o certificado. Isso é feito no cadastro da empresa no Hub.
- Não mostra as notas capturadas. Elas estão em Documentos ▸ Recebidos e na Gestão de Arquivos (origem SEFAZ).
- Não altera o intervalo da consulta periódica.
- Não captura CT-e, NFS-e nem outros documentos — só NF-e (modelo 55).
- Não desfaz o bloqueio da SEFAZ.
Erros e mensagens¶
| Mensagem | Quando aparece | O que fazer |
|---|---|---|
| «Nenhum certificado digital ativo para a empresa — não é possível ativar a captura.» | Salvou com a captura ativa sem certificado | Ative o certificado no cadastro da empresa no Hub |
| «Captura suspensa: nenhum certificado digital ativo para esta empresa…» | Certificado ausente ou vencido | Renove o certificado e salve de novo com a captura ativa |
| «CNPJ bloqueado pela SEFAZ por consumo indevido (cStat 656). O desbloqueio é automático em ~N min.» | Disparo manual durante o bloqueio | Aguarde |
| «A SEFAZ respondeu 'nenhum documento localizado' (cStat 137) há menos de 1 hora…» | Disparo manual cedo demais | Aguarde o tempo indicado |
| «Último ciclo falhou (N tentativas seguidas). Nova tentativa em N min.» | Falha de comunicação ou cStat inesperado | Veja Último erro; o sistema tenta de novo sozinho |
| «NSU inválido — informe até 15 dígitos numéricos.» | NSU fora do formato | Corrija o número |
| «A configuração não pode ser removida: existem N nota(s) recebidas(s) para a empresa …» | Remoção de empresa com notas recebidas | Desligue a captura em vez de remover |
| «XML não disponível para esta consulta.» | Ver envio/retorno sem consulta registrada | — |
Relação com a NF-e / SEFAZ / EFD¶
| Elemento | Relação |
|---|---|
Distribuição de DF-e (distDFeInt / retDistDFeInt) |
Consulta por NSU ao Ambiente Nacional; os XMLs da última tentativa ficam em Ver envio / Ver retorno |
| cStat 137 · 138 · 656 · 589 | Nenhum documento · documentos localizados · consumo indevido · NSU acima do maior NSU do Ambiente Nacional |
| Evento 210210 (Ciência) e 210200 (Confirmação) | Dados automaticamente nos resumos capturados |
| Evento 110111 (Cancelamento) | Aplicado à nota recebida quando chega na fila |
| EFD-ICMS/IPI — C100 | Com Usar Escrituração Fiscal ligado, cada nota recebida vai para a Escrituração Fiscal, que a escritura como entrada (IND_OPER = 0) de terceiros (IND_EMIT = 1) [Guia Prático EFD-ICMS/IPI 3.2.3, p. 65]. Desligado, a nota fica só neste app |
Perguntas frequentes¶
Ativei a captura e nada chegou. Veja Última consulta: cStat 137 significa que a SEFAZ não tem documento novo para o CNPJ naquele ambiente. Em homologação isso é o normal. Confira se o ambiente é Produção.
Quero buscar notas antigas que a SEFAZ ainda guarda.
Edite o cursor do ambiente para 0 (retroagir) e salve, ou use Disparar agora com NSU 0.
Notas já gravadas não duplicam.
A empresa aparece como bloqueada. Preciso fazer algo? Não. O bloqueio dura 1 hora e a captura volta sozinha; disparar de novo antes disso é recusado.
Troquei de Homologação para Produção. Perco o NSU de homologação? Não. Os dois cursores ficam guardados; ao voltar, a captura retoma de onde o ambiente parou.
Por que não consigo remover a empresa? Porque ela já tem notas recebidas. Desligue Captura automática ativa para parar a consulta.