Gestão de Arquivos¶

Em uma frase. Porta de entrada e trilha de todo arquivo que chega ao app NF-e — upload na tela, integração por API, e-mail ou captura na SEFAZ —, com o resultado do processamento de cada um e as notas que ele gerou.

Quem usa: analista fiscal, implantação, suporte · Frequência: ao importar notas e ao investigar um arquivo que não virou nota · Pré-requisitos: empresas cadastradas no Hub; para emitir a partir de arquivo, empresa configurada em Configurações ▸ Emissão

Para que serve¶

Cada documento que o app recebe vira uma linha aqui, com protocolo interno (DOCFLOW-AAAA-XXXXXXXX), origem, situação e quantidade de notas geradas. Pela mesma tela se envia arquivo:

O que enviar	Para onde vai
JSON no formato de integração	Fluxo de emissão (pela empresa emitente do CNPJ no arquivo)
XML `enviNFe` / `NFe` (antes da autorização)	Fluxo de emissão, com série/numeração e ambiente da configuração
XML `procNFe` / `resNFe` (já autorizado ou resumo)	Nota recebida, quando o destinatário é empresa da conta; nota emitida, quando o emitente é empresa da conta; as duas, se ambos forem
XML de evento autorizado	Evento vinculado à nota da mesma chave
Pacote `.zip`	Descompactado em segundo plano; cada arquivo interno segue a regra acima

A tela responde a perguntas como "o arquivo do ERP chegou?", "por que esta nota não foi criada?" e "de qual arquivo saiu esta NF-e?".

Como chegar¶

No Hub, abra o app NF-e.
Selecione Gestão de Arquivos.

Envio de arquivo¶

A área de envio fica no topo: arraste o arquivo ou clique para escolher. Aceita .json, .xml e .zip.

Formato	Limite	Confirmação antes de enviar
`.json`	10 MB	Prévia com o número de NF-e detectadas, os emitentes encontrados ou «não cadastrado» (com atalho Cadastrar →) e o aviso «Este arquivo já foi importado anteriormente.» com o protocolo anterior
`.xml`	10 MB	Explica o destino conforme o conteúdo (emissão ou recebida)
`.zip`	512 MB	Explica a descompactação em segundo plano. Enviar pacote abre o acompanhamento em tempo real

O botão de envio diz Importar, Importar novamente (arquivo já importado) ou Enviar pacote. O resultado aparece numa notificação com a mensagem do processamento, cada nota gerada (com Ver NF-e →) e o atalho Ver detalhe do arquivo →.

A tela de listagem¶

Cards¶

Card	Situações contadas
Todos	Todas
Processados	Processado
Em andamento	Na fila, Processando
Com erro	Inválido, Erro
Ignorados	Ignorado

Clicar num card filtra a lista. Os cards respeitam empresa, período, chave, protocolo e origem.

Filtros¶

Na barra: seleção de uma ou mais empresas e o período De / Até — por data de recebimento, abrindo em hoje. Atualizar aplica.

A empresa filtra os arquivos cujas notas têm a empresa como emitente ou destinatária.

Mais filtros abre o painel lateral:

Campo	Regra
Chave de acesso	Cole uma ou mais chaves (44 dígitos cada); retorna o arquivo ou o pacote que contém o documento. Pontuação e espaços são ignorados
Protocolo	Busca parcial (`DOCFLOW-…`)
Origem	Todas · Upload · Integração · SEFAZ · E-mail

Colunas¶

Configuráveis pela engrenagem (escolha gravada no navegador).

Coluna	Conteúdo	Ordenável
Protocolo	Protocolo interno, com copiar	não
Arquivo	Nome do arquivo	sim
Notas	Quantidade de notas geradas — clicar abre a lista de notas filtrada pelo arquivo	sim
Origem	Upload · Integração · SEFAZ · E-mail (outra origem aparece com o valor recebido)	não
Status	Selo; no pacote, também `processados/total` e a fase; selo vermelho `N×` a partir de 3 tentativas em arquivo com erro	sim
Recebido em	Data e hora	sim
Ações	Ver · Baixar · Ver NF-e gerada · Reprocessar	—

Ordenação inicial: mais recentes primeiro. Enquanto houver arquivo em processamento, a tela se atualiza sozinha a cada 5 segundos («Atualizando automaticamente…»).

Situações do arquivo¶

Selo	Significado
Na fila	Recebido, aguardando processamento
Processando	Em validação ou em processamento
Processado	Processado com sucesso
`ProcessadoComPendencias`	Pacote que importou parte dos arquivos e deixou outros com erro, inválidos ou desconhecidos
Inválido	Conteúdo não interpretável ou recusado pelas regras
Erro	Falha durante o processamento
Ignorado	Não processado (ex.: item de pacote cancelado)
Desconhecido	Item de pacote com extensão não reconhecida

Ações¶

Ação	O que faz	Quando
Olho / clique na linha	Detalhe do arquivo; em pacote, o acompanhamento do processamento	Sempre
Download	Baixar arquivo original — os mesmos bytes que chegaram	Sempre
Link	Ver NF-e gerada — abre a nota em Emitidos ou em Recebidos, conforme o papel	Arquivo que gerou nota
Reprocessar arquivo	Processa de novo o conteúdo guardado	Arquivo (não pacote) Inválido ou com Erro
Reprocessar lote	Reenfileira os itens com erro e os não processados	Pacote concluído, com erro ou cancelado, com itens a reprocessar

Detalhe do arquivo¶

Cabeçalho com protocolo, nome, origem, data, quantidade de notas e situação. Mensagem de erro, quando houver.

Notas no arquivo (arquivo JSON) — uma linha por nota com o CNPJ e a razão social do emitente, e o atalho Emitente → para a configuração de emissão. «Os status individuais de cada nota estão na listagem de NF-e, filtradas pelo protocolo.»
Dados técnicos — Hash (SHA-256), Início e Fim do processamento, Tentativas, Armazenamento e, quando o arquivo veio do buscador de e-mail, Registro na outbox.
Visualizar conteúdo — abre o conteúdo como texto, com os mesmos bytes do download.

Acompanhamento do pacote `.zip`¶

Janela Processamento do pacote, atualizada a cada 2 segundos:

Etapas: Recebido → Extraindo → Processando → Concluído, com "N de M arquivos";
Cards Total, Válidos, Na fila, Inválidos, Desconhecidos e Erros — clicar filtra os itens;
Itens: arquivo, tipo, tamanho, situação e ações (reprocessar item, ver motivo do erro, visualizar, baixar, ver NF-e gerada). Item com erro ou inválido pode ser selecionado para Reprocessar selecionados;
Cancelar processamento, enquanto o pacote está em andamento: os itens ainda não processados ficam como ignorados;
Avisos: falha de comunicação (a tela passa a tentar a cada 10 s) e processamento que parece parado (contadores sem mudança por alguns minutos).

Regras de negócio¶

RN-ARQ-001 — Todo arquivo tem protocolo. O protocolo interno identifica o arquivo para o usuário e para quem integra; a busca por protocolo aceita trecho.
RN-ARQ-002 — O mesmo arquivo não é processado duas vezes. Conteúdo idêntico (mesmo hash) já registrado devolve «Arquivo já processado anteriormente (idempotência).» — exceto itens de pacotes diferentes, que são arquivos distintos.
RN-ARQ-003 — O papel da nota vem do XML. Destinatário da conta → nota recebida; emitente da conta → nota emitida; os dois → as duas; nenhum → o arquivo é recusado.
RN-ARQ-004 — Resumo precisa de empresa. O resNFe não informa o destinatário: em conta com mais de uma empresa, o resumo enviado pela tela é recusado.
RN-ARQ-005 — Nota recebida não duplica. Um XML completo enviado para uma nota que estava só em resumo completa a mesma nota.
RN-ARQ-006 — O conteúdo original é preservado. Download e visualização entregam os bytes recebidos, inclusive de arquivo inválido.
RN-ARQ-007 — Situação final do pacote. Todos os itens válidos → Processado; parte válida e parte com problema → ProcessadoComPendencias; nenhum válido e algum erro → Erro; nenhum válido e só inválidos ou desconhecidos → Inválido.
RN-ARQ-008 — Limites do pacote. Até 50.000 arquivos, 4.096 MB descompactados no total, 50 MB por arquivo interno e razão de compressão de até 200 por item.
RN-ARQ-009 — Captura da SEFAZ também aparece aqui. Cada documento capturado gera um arquivo com origem SEFAZ, sem duplicar em nova captura.
RN-ARQ-010 — Reprocessar só o que falhou. Arquivo só é reprocessado com situação Inválido ou Erro; pacote só depois de concluído, com erro ou cancelado.

O que esta tela não faz¶

Não edita o conteúdo do arquivo. Para corrigir, envie o arquivo corrigido.
Não apaga um arquivo individual.
Não mostra o status de cada nota. O status individual está em Documentos ▸ Emitidos e Recebidos.
Não configura a captura na SEFAZ — isso é Configurações ▸ Recebimento.

Limpar dados de teste. O botão vermelho do cabeçalho apaga todas as notas (emitidas, recebidas e capturadas), arquivos, eventos, e-mails, entregas de webhook, inutilizações e lotes da conta. Só as configurações — emissão, séries, alíquotas, eventos, webhooks e cursor de captura — são preservadas. A ação é irreversível e pede que se digite EXCLUIR. Use apenas em ambiente de testes.

Erros e mensagens¶

Mensagem	Quando aparece	O que fazer
«Apenas arquivos .json ou .xml são aceitos.»	Extensão diferente em envio avulso	Envie `.json`, `.xml` ou `.zip`
«Arquivo excede o limite de 10 MB.»	JSON ou XML acima de 10 MB	Divida o conteúdo ou compacte em `.zip`
«Pacote excede o limite de 512 MB.»	`.zip` acima do limite	Divida o pacote
«XML não pôde ser interpretado: …»	XML malformado	Confira o arquivo na origem
«Nem o emitente (CNPJ …) nem o destinatário (CNPJ …) correspondem a uma empresa do tenant — nenhuma nota foi registrada.»	Documento de outra empresa	Cadastre a empresa no Hub ou descarte o arquivo
«O resumo de NF-e (resNFe) não informa o destinatário — informe a empresa destinatária…»	`resNFe` em conta com várias empresas	Envie o XML completo ou use a captura
«XML autorizado sem destinatário.»	NF-e modelo 55 sem destinatário	Confira o documento
«Arquivo com status '…' não pode ser reprocessado.»	Reprocessar arquivo que não está Inválido nem com Erro	—
«Arquivo sem conteúdo original para reprocessar.»	Registro sem conteúdo guardado	Envie o arquivo de novo
«Pacote em processamento — aguarde concluir para reprocessar.»	Reprocessar lote em andamento	Aguarde ou cancele o processamento
«Motivo não registrado para este item…»	Item com erro anterior ao registro do motivo	Reprocesse o item

Relação com a NF-e / SEFAZ / EFD¶

Elemento	Relação
`enviNFe` / `NFe`	Arquivo que gera NF-e a emitir, pelo fluxo normal de autorização
`procNFe` / `resNFe`	Documento já autorizado (ou resumo da distribuição DF-e) registrado como nota
XML de evento autorizado	Evento aplicado à nota da mesma chave
Distribuição de DF-e	Documentos capturados aparecem com origem SEFAZ
EFD-ICMS/IPI	Este app não gera a EFD. As notas criadas a partir dos arquivos seguem para a Escrituração Fiscal quando a empresa usa escrituração; nota de terceiro é escriturada como entrada (`IND_OPER` = 0, `IND_EMIT` = 1) [Guia Prático EFD-ICMS/IPI 3.2.3, p. 65]

Perguntas frequentes¶

Enviei o arquivo e não vejo a linha. A lista abre em "recebidos hoje". Confira o período e os filtros; o protocolo que a notificação mostrou pode ser buscado em Mais filtros ▸ Protocolo.

O arquivo foi processado, mas não achei a nota em Emitidos. Se o documento era de terceiro, a nota está em Documentos ▸ Recebidos. O número na coluna Notas abre a lista certa, já filtrada pelo arquivo.

Posso reenviar o mesmo arquivo? Pode, mas o conteúdo idêntico não é processado de novo. Para processar outra vez um arquivo com erro, use Reprocessar.

Um item do pacote ficou "Desconhecido". A extensão dele não é reconhecida. PDF, TXT e semelhantes ficam como inválidos; nenhum dos dois vira nota.

Limpei os dados de teste e a captura não trouxe as notas de volta. O cursor de captura é preservado na limpeza: a SEFAZ não reentrega o que já foi entregue. Para buscar de novo, retroaja o NSU em Configurações ▸ Recebimento.