RNF042 — Exportação de Arquivos XML (enriquecimento)
Menu: Faturamento > Relatórios > Notas Fiscais > Exportação de Arquivos XML
Objetivo
A tela RNF042 gera um arquivo .zip com os XMLs de notas fiscais (NF-e, CT-e, NFC-e, SAT) de uma empresa em um período — autorizados, cancelados e inutilizados — junto com um relatório PDF de conferência (notas, inutilizações e lacunas de numeração). Também identifica, em uma aba separada, notas válidas que ainda não foram transmitidas (pendentes), impedindo que entrem no arquivo até serem regularizadas.
Fluxo principal
- Abrir a tela pelo menu Faturamento > Relatórios > Notas Fiscais > Exportação de Arquivos XML; um novo filtro é criado automaticamente com valores padrão. (Arquivos para Exportação) —
source/RNF042/URNF042.pas:119-164 (iniciar) - Confirmar/informar a Empresa (obrigatória). (Arquivos para Exportação) —
source/RNF042/UdmRNF042.pas:119-142 (TdmRNF042.tabFILTROCD_EMPRESAValidate) - Informar o período (Data e Até), respeitando o limite de 31 dias. (Arquivos para Exportação) —
source/RNF042/URNF042.pas:283-303 (TfrmRNF042.btnSalvarClick) - Selecionar Tipo Movimento (Entrada/Saída/Todos) e Tipo Nota XML (CTe/NFCe/NFe/SAT/Todos). (Arquivos para Exportação) —
source/RNF042/URNF042.dfm:409-441 - Opcionalmente filtrar por Pessoa, Nº Ordem Carregamento, Série e Nº Nota Inicial/Final. (Arquivos para Exportação) —
source/RNF042/URNF042.pas:366-418 (TfrmRNF042.btnSalvarClick) - Conferir ou escolher o Local de Destino do arquivo .zip. (Arquivos para Exportação) —
source/RNF042/URNF042.pas:1179-1201 (TfrmRNF042.btnDestinoClick) - Clicar em Gerar Arquivo (toolbar Salvar ou botão da aba / F6). (Arquivos para Exportação) —
source/RNF042/URNF042.pas:1203-1206 (TfrmRNF042.btnGerarArquivoClick) - Se houver pendências, consultar a lista na aba Notas Pendentes e usar Consultar Nota para abrir a nota na tela CNF001. (Notas Pendentes) —
source/RNF042/URNF042.pas:1301-1325 (TfrmRNF042.btnOKClick)
Campos obrigatórios
| Campo | Condição | Mensagem | Fonte |
|---|---|---|---|
| CD_EMPRESA (Empresa) | Sempre obrigatório para clicar em Gerar Arquivo; se vazio, foco vai para o campo e a aba Arquivos para Exportação é ativada. | É Obrigatório informar a Empresa para Gerar os Arquivos. Verifique! | source/RNF042/URNF042.pas:295-300 (TfrmRNF042.btnSalvarClick) |
| DT_INICIAL / DT_FINAL | Data Final não pode ser anterior à Data Inicial. | A Data Final não pode ser Inferior à Data Inicial. Verifique! | source/RNF042/URNF042.pas:302-303 (TfrmRNF042.btnSalvarClick) |
| DT_INICIAL / DT_FINAL | Intervalo entre as datas não pode ultrapassar 31 dias. | Não é Possivel Realizar a Emissão do Arquivo de um Periodo Maior que 31 Dias. Verifique! | source/RNF042/URNF042.pas:283-284 (TfrmRNF042.btnSalvarClick) |
| NR_NOTAINI / NR_NOTAFIM | Nº da nota final não pode ser inferior ao nº da nota inicial (quando ambos preenchidos). | O Nº Nota Fiscal Final não pode ser Inferior ao Nº Nota Fiscal Inicial. Verifique! | source/RNF042/URNF042.pas:305-306 (TfrmRNF042.btnSalvarClick) |
Mensagens: causa e ação
A Data Final não pode ser Inferior à Data Inicial. Verifique!
Causa: O usuário informou uma Data Final anterior à Data Inicial do filtro.
Ação: Corrigir os campos Data e Até para que a Data Final seja igual ou posterior à Data Inicial.
Fonte: source/RNF042/URNF042.pas:302-303 (TfrmRNF042.btnSalvarClick)
Arquivo salvo com sucesso! Local: "%s"
Causa: O zip com os XMLs e o relatório PDF foi gerado e salvo com sucesso no local de destino informado.
Ação: Nenhuma ação necessária; acessar o caminho informado para localizar o arquivo.
Fonte: source/RNF042/URNF042.pas:1083-1083 (TfrmRNF042.btnSalvarClick)
Empresa não Cadastrada!
Causa: O código de empresa digitado não existe na tabela EMPRESA.
Ação: Informar um código de empresa válido, usando F9 para buscar.
Fonte: source/RNF042/UdmRNF042.pas:119-142 (TdmRNF042.tabFILTROCD_EMPRESAValidate)
Foram identificadas NF-e Pendentes para Envio no Período! Verifique.
Causa: Existem notas válidas no período filtrado sem protocolo de autorização nem de cancelamento (status 'V').
Ação: Consultar a aba Notas Pendentes, usar Consultar Nota para abrir cada nota no CNF001 e regularizar a transmissão antes de gerar o arquivo novamente.
Fonte: source/RNF042/URNF042.pas:736-786 (TfrmRNF042.btnSalvarClick)
Não foi encontrado nenhum arquivo XML na pasta do Sistema! Verifique.
Causa: Nenhuma nota do filtro tinha XML autorizado, cancelado ou inutilizado disponível para incluir no zip.
Ação: Revisar os filtros (empresa, período, tipo de nota/XML, série) ou confirmar se as notas foram transmitidas para a SEFAZ.
Fonte: source/RNF042/URNF042.pas:787-791 (TfrmRNF042.btnSalvarClick)
Não foi possivel salvar o XML da Nota Fiscal no banco de Dados!%sMotivo: %s
Causa: Falha ao regravar no banco (campo BI_ARQUIVOXML de NFE/CTRC) o conteúdo de um XML encontrado em disco mas ausente no banco.
Ação: Verificar o motivo técnico exibido na mensagem (ex.: permissão, conexão) e tentar gerar o arquivo novamente.
Fonte: source/RNF042/URNF042.pas:1276-1281 (ExecSQL)
Não é Possivel Realizar a Emissão do Arquivo de um Periodo Maior que 31 Dias. Verifique!
Causa: O intervalo entre a Data Inicial e a Data Final do filtro é superior a 31 dias.
Ação: Reduzir o período filtrado para no máximo 31 dias.
Fonte: source/RNF042/URNF042.pas:283-284 (TfrmRNF042.btnSalvarClick)
O Nº Nota Fiscal Final não pode ser Inferior ao Nº Nota Fiscal Inicial. Verifique!
Causa: O número informado no campo Nota Fiscal Final é menor que o informado em Nota Fiscal Inicial.
Ação: Corrigir os campos Nº Nota Fiscal Inicial/Final para que o final seja maior ou igual ao inicial.
Fonte: source/RNF042/URNF042.pas:305-306 (TfrmRNF042.btnSalvarClick)
O Usuário não Possui Acesso a Consulta de Notas!
Causa: O usuário clicou em Consultar Nota (aba Notas Pendentes) sem ter o programa CNF001 liberado no menu.
Ação: Solicitar ao administrador do sistema a liberação de acesso ao programa CNF001 (Consulta de Notas).
Fonte: source/RNF042/URNF042.pas:1309-1312 (TfrmRNF042.btnOKClick)
Os XMLs foram gerados e salvos no arquivo, porém não foi possível gerar o Relatório PDF (XML_Relat.pdf). Verifique o Visualizador/Layout da RNF042 e gere novamente caso necessite do PDF. Local: "%s"
Causa: O zip com os XMLs foi criado normalmente, mas o Visualizador não concluiu a geração do relatório PDF dentro do tempo de espera do sistema.
Ação: Verificar o Visualizador/Layout cadastrado para a RNF042 e, se o PDF for necessário, gerar o arquivo novamente.
Fonte: source/RNF042/URNF042.pas:1086-1088 (TfrmRNF042.btnSalvarClick)
É Obrigatório informar a Empresa para Gerar os Arquivos. Verifique!
Causa: O campo Empresa está vazio ao clicar em Gerar Arquivo.
Ação: Preencher o código da empresa na aba Arquivos para Exportação antes de gerar o arquivo.
Fonte: source/RNF042/URNF042.pas:295-300 (TfrmRNF042.btnSalvarClick)
Regras de negócio
RNF042.R001(verregras/RNF042/RNF042.R001.md)RNF042.R002(verregras/RNF042/RNF042.R002.md)RNF042.R003(verregras/RNF042/RNF042.R003.md)RNF042.R004(verregras/RNF042/RNF042.R004.md)RNF042.R005(verregras/RNF042/RNF042.R005.md)RNF042.R006(verregras/RNF042/RNF042.R006.md)RNF042.R007(verregras/RNF042/RNF042.R007.md)RNF042.R008(verregras/RNF042/RNF042.R008.md)RNF042.R009(verregras/RNF042/RNF042.R009.md)RNF042.R010(verregras/RNF042/RNF042.R010.md)RNF042.R011(verregras/RNF042/RNF042.R011.md)RNF042.R012(verregras/RNF042/RNF042.R012.md)RNF042.R013(verregras/RNF042/RNF042.R013.md)RNF042.R014(verregras/RNF042/RNF042.R014.md)RNF042.R015(verregras/RNF042/RNF042.R015.md)RNF042.R016(verregras/RNF042/RNF042.R016.md)RNF042.R017(verregras/RNF042/RNF042.R017.md)RNF042.R018(verregras/RNF042/RNF042.R018.md)RNF042.R019(verregras/RNF042/RNF042.R019.md)
Perguntas frequentes
P: Por que aparece a mensagem 'É Obrigatório informar a Empresa para Gerar os Arquivos'?
R: O campo Empresa está vazio na aba Arquivos para Exportação. Preencha o código da empresa (ou use F9 para buscar) antes de clicar em Gerar Arquivo.
Fonte: source/RNF042/URNF042.pas:295-300 (TfrmRNF042.btnSalvarClick)
P: Por que não consigo gerar o arquivo com um período maior que um mês?
R: O sistema limita a geração a no máximo 31 dias entre a Data Inicial e a Data Final; reduza o período filtrado.
Fonte: source/RNF042/URNF042.pas:283-284 (TfrmRNF042.btnSalvarClick)
P: Deu a mensagem 'Foram identificadas NF-e Pendentes para Envio no Período'. O que fazer?
R: Há notas válidas no período sem protocolo de autorização nem de cancelamento; consulte a aba Notas Pendentes e use o botão Consultar Nota para regularizar a transmissão antes de gerar o arquivo novamente.
Fonte: source/RNF042/URNF042.pas:736-786 (TfrmRNF042.btnSalvarClick)
P: O arquivo zip foi gerado mas não encontro no local informado; recebi 'Não foi encontrado nenhum arquivo XML na pasta do Sistema'.
R: Nenhuma nota do filtro tinha XML autorizado, cancelado ou inutilizado disponível; o zip é apagado do disco nesse caso. Revise os filtros (empresa, período, tipo de nota/XML) ou confirme se as notas foram transmitidas.
Fonte: source/RNF042/URNF042.pas:787-791 (TfrmRNF042.btnSalvarClick), source/RNF042/URNF042.pas:1095-1101 (TfrmRNF042.btnSalvarClick)
P: O zip foi salvo mas o relatório PDF não veio junto. Por quê?
R: O sistema aguarda a geração do relatório XML_Relat.pdf pelo Visualizador por até cerca de 1000 segundos; se não conseguir a tempo, avisa que os XMLs foram salvos mas o PDF não foi anexado. Verifique o Visualizador/Layout da RNF042 e gere novamente se precisar do PDF.
Fonte: source/RNF042/URNF042.pas:1042-1088 (TfrmRNF042.btnSalvarClick)
P: Cliquei em Consultar Nota na aba de pendentes e recebi 'O Usuário não Possui Acesso a Consulta de Notas'.
R: O usuário não tem o programa CNF001 (Consulta de Notas) liberado no menu; solicite ao administrador a liberação de acesso.
Fonte: source/RNF042/URNF042.pas:1301-1325 (TfrmRNF042.btnOKClick)
P: Por que os botões Salvar/Excluir não aparecem para mim?
R: O usuário tem acesso do tipo Consulta (tpAcesso = 2) ao programa; nesse modo os botões de gerar/excluir arquivo ficam ocultos.
Fonte: source/RNF042/URNF042.pas:136-141 (iniciar)
P: Recebi 'Empresa não Cadastrada!' ao digitar o código da empresa.
R: O código informado não existe na tabela EMPRESA; confira o código ou use F9 para buscar uma empresa válida.
Fonte: source/RNF042/UdmRNF042.pas:119-142 (TdmRNF042.tabFILTROCD_EMPRESAValidate)
P: A tela não abre e mostra uma mensagem sobre parâmetros de faturamento [MFA001].
R: A empresa não tem os Parâmetros de Faturamento cadastrados (tela MFA001); é preciso cadastrá-los antes de usar a Exportação de XMLs.
Fonte: source/RNF042/UdmRNF042.pas:90-107 (Busca_Parametros), source/RNF042/URNF042.pas:145-154 (iniciar)
P: Notas SAT (CF-e) não aparecem corretas no zip; por que o comportamento é diferente das NF-e/CT-e?
R: Para CD_ESPECIE = 'SAT' o sistema usa uma estrutura de pastas própria (SAT_CFe) e procura nos XMLs locais a chave de cancelamento correspondente antes de montar o caminho do arquivo; isso é tratamento específico já existente no código.
Fonte: source/RNF042/URNF042.pas:559-580 (TfrmRNF042.btnSalvarClick)
Dúvidas em aberto (o código não responde)
- O botão Imprimir (btnImprimirClick) tem toda a lógica comentada — é uma funcionalidade desativada de propósito ou pendência de reativação? — source/RNF042/URNF042.pas:1379-1649 — o corpo do procedimento está inteiramente dentro de um bloco de comentário (* ... *), então clicar no botão Imprimir não executa nenhuma ação hoje.
- A função DiretorioXML aceita um parâmetro NrNota para filtrar a inutilização por número de nota, mas o chamador do laço principal nunca passa esse valor (fica 0/NULL) — isso é intencional? — source/RNF042/URNF042.pas:98-99 (assinatura), 540-545 (chamada sem NrNota), 1327-1356 (uso do parâmetro na consulta SQL).
- Por que o diálogo de destino oferece a extensão .rar se o arquivo gerado é sempre um .zip (via TZipFile)? — source/RNF042/URNF042.pas:1191-1201 valida extensão .rar ou .zip, mas a geração em 526-527 sempre abre um TZipFile.