2069 Central Exportacao XML
A Central de Exportação de XML permite consultar documentos disponíveis para exportação e gerar seus arquivos XML em um arquivo compactado. O recurso foi criado para centralizar a geração de XMLs em uma única tela, facilitando a conferência, o armazenamento, o envio e o controle documental dos registros fiscais.
Atualmente, a central disponibiliza a exportação de XMLs de RPS. Porém, por se tratar de uma central de exportação, o recurso está preparado para receber futuramente outros tipos de documentos ou origens de exportação, conforme novas necessidades do processo.
Na tela, o usuário seleciona o Tipo Exportação, visualiza os registros disponíveis conforme o tipo escolhido e exporta os XMLs dos registros selecionados. Quando o tipo selecionado for RPS, o sistema apresenta os dados relacionados aos Recibos Provisórios de Serviço e permite gerar os XMLs correspondentes em lote.
O recurso contribui para o acompanhamento do processo porque organiza a exportação de XMLs em um fluxo padronizado, evita exportações sem seleção válida e permite que os arquivos sejam baixados de forma agrupada.
Objetivo
A tela tem como objetivo centralizar a exportação de XMLs do sistema, permitindo que usuários autorizados consultem registros disponíveis e gerem arquivos XML de forma simples, segura e padronizada.
Atualmente, o tipo de exportação disponível é RPS, mas a central foi estruturada para permitir que novos tipos de documentos sejam adicionados futuramente.
O recurso é utilizado por usuários operacionais, analistas fiscais, equipes administrativas e gestores que precisam obter XMLs para conferência, envio a clientes, auditorias, controles internos ou guarda documental.
A tela apoia a tomada de decisão ao apresentar informações importantes antes da exportação, como número do documento, número da nota, status, datas, tomador e valor líquido. Com isso, o usuário consegue validar quais registros serão exportados antes de gerar o arquivo.
A funcionalidade também reduz erros operacionais, pois impede a exportação quando o Tipo Exportação não foi selecionado ou quando não há registros selecionados para exportar.
Pré-requisitos
- O usuário deve possuir permissão para acessar o recurso 2069 — Central de Exportação de XML.
- O usuário deve estar autenticado no sistema.
- O usuário deve selecionar um Tipo Exportação para que a tabela de resultados seja exibida.
- Atualmente, o Tipo Exportação disponível é:
- 1 — RPS.
- Quando o Tipo Exportação for RPS, a pesquisa retorna apenas RPS vinculados à empresa do usuário logado.
- Devem existir registros disponíveis para o tipo de exportação selecionado.
- Para exportar XMLs, é necessário selecionar um ou mais registros na tabela.
- Todos os campos da tabela são apenas informativos e não podem ser editados.
- A exportação gera um arquivo compactado com os XMLs dos registros selecionados.
- O recurso pode receber registros carregados diretamente por meio do hot-link Exportar XML existente no recurso 657 — Recibo Provisório Serviço (RPS). Nesse caso, a Central de Exportação de XML é aberta já com o Tipo Exportação definido como RPS e com os registros selecionados carregados na tabela.
Fluxo Principal
Passo a passo para utilizar o recurso:
- Acesse o menu 2069 — Central de Exportação de XML.
- No campo Tipo Exportação, selecione a opção desejada.
- Atualmente, selecione RPS para consultar e exportar XMLs de Recibos Provisórios de Serviço.
- Após selecionar o tipo, a tabela de resultados será exibida.
- Execute a pesquisa para carregar os registros disponíveis conforme o Tipo Exportação selecionado.
- Confira os registros apresentados na tabela.
- Selecione um ou mais registros que deseja exportar.
- Clique no botão Exportar XML’s.
- O sistema irá gerar os XMLs dos registros selecionados.
- Ao final do processamento, será disponibilizado um arquivo .zip para download.
- Baixe o arquivo e utilize os XMLs conforme a necessidade operacional.
Funcionalidades
- Tipo Exportação: define qual conjunto de documentos será consultado e exportado. Atualmente, a opção disponível é RPS.
- Estrutura de central: o recurso foi criado para concentrar exportações de XML em um único local. Hoje atende RPS, mas pode receber novos tipos de exportação futuramente.
- Exibição da tabela somente após seleção do tipo: a tabela não é exibida enquanto o Tipo Exportação não for selecionado. Isso evita consultas sem contexto e orienta o usuário a iniciar o processo corretamente.
- Pesquisa conforme o Tipo Exportação: permite carregar os registros disponíveis conforme o tipo selecionado pelo usuário.
- Pesquisa de RPS: quando o Tipo Exportação for RPS, o sistema lista os RPS disponíveis para exportação.
- Filtro automático por empresa: para RPS, o sistema apresenta apenas registros da empresa vinculada ao usuário autenticado, evitando acesso a dados de outras empresas.
- Tabela de resultados: apresenta os dados principais dos registros encontrados, permitindo conferência antes da exportação.
- Campos não editáveis: todos os campos da tabela são somente leitura. A tela serve para consultar, selecionar e exportar, não para alterar dados.
- Seleção de registros: permite escolher um ou mais registros para exportação. Apenas os registros selecionados serão considerados na geração dos XMLs.
- Botão Exportar XML’s: gera os arquivos XML dos registros selecionados e disponibiliza o download em arquivo compactado.
- Arquivo .zip: agrupa os XMLs gerados em um único arquivo, facilitando o download, o armazenamento e o compartilhamento.
- Nome do arquivo compactado para RPS: quando a exportação for de RPS, o arquivo gerado segue o padrão exportacao-xml-rps-ddMMaaaa, onde ddMMaaaa representa o dia, mês e ano da geração.
- Nome dos XMLs individuais para RPS: cada XML é gerado com o nome baseado no número da NFS-e, no formato numeroNFse-nfse.xml.
- Mensagens de validação: o sistema orienta o usuário quando alguma condição obrigatória não foi atendida.
- Carregamento direto por hot-link: quando acionado pelo hot-link Exportar XML do recurso 657 — Recibo Provisório Serviço (RPS), o recurso 2069 pode ser aberto já com o Tipo Exportação definido como RPS e com os RPS selecionados carregados na tabela. Essa alternativa agiliza a exportação quando o usuário já possui registros previamente selecionados.
Problemas e Soluções
| Problema | Solução |
|---|---|
| A tabela de resultados não aparece. | Verifique se o campo Tipo Exportação foi preenchido. A tabela só é exibida depois que um tipo é selecionado. |
| O sistema exibiu a mensagem “Primeiro, selecione o Tipo de Exportação.” | Selecione o Tipo Exportação antes de clicar em Exportar XML’s. |
| O sistema exibiu a mensagem “Primeiro, selecione as Notas(s) a ser(em) exportadas.” | Selecione um ou mais registros na tabela antes de exportar. |
| Nenhum registro foi listado na pesquisa. | Verifique se existem registros disponíveis para o Tipo Exportação selecionado. No caso de RPS, a pesquisa retorna apenas registros vinculados à empresa do usuário logado. |
| Não consigo editar os dados da tabela. | Esse é o comportamento correto. A tabela é apenas para consulta, seleção e exportação dos registros. |
| O arquivo de exportação não foi baixado. | Tente executar a exportação novamente. Caso o problema continue, revise se os registros selecionados possuem dados válidos e acione o suporte responsável. |
| O arquivo .zip foi gerado, mas não encontrei o XML esperado. | Confira se o registro correto foi selecionado e valide o número da nota apresentado na tabela. |
| O recurso foi aberto pelo hot-link, mas os registros esperados não apareceram. | Verifique se os RPS foram selecionados antes do acionamento do hot-link no recurso de origem. |
Exemplos de Uso
- Exportação para conferência fiscal: uma analista fiscal precisa validar XMLs de documentos fiscais. Ela acessa o recurso 2069, seleciona o Tipo Exportação disponível, pesquisa os registros, confere as informações principais e exporta os XMLs.
- Exportação de XML de RPS: um operador seleciona o Tipo Exportação RPS, localiza os registros desejados, confere número da nota, tomador e valor líquido, seleciona os RPS corretos e gera o arquivo .zip.
- Envio de XML para cliente: um usuário precisa enviar o XML de uma NFS-e solicitada por um cliente. Ele localiza o registro na Central de Exportação, confere o tomador e o número da nota, seleciona o registro e baixa o arquivo.
- Auditoria documental: um gestor precisa reunir XMLs de vários registros para análise. Ele seleciona múltiplos itens e realiza uma única exportação em lote, reduzindo tempo e evitando downloads individuais.
- Carregamento direto por hot-link: quando os RPS já foram previamente selecionados em outro contexto, o hot-link Exportar XML pode abrir a Central de Exportação de XML já com os registros carregados. Isso agiliza o processo e evita nova seleção manual na tela 2069.
- Validação antes da exportação: antes de gerar o arquivo, o usuário confere status, número da nota, tomador e valor líquido para evitar exportar documentos incorretos.
Observações Gerais
- Sempre selecione o Tipo Exportação antes de tentar exportar.
- Atualmente, a exportação disponível é para RPS.
- A Central de Exportação de XML foi estruturada para permitir futuras expansões para outros tipos de documentos.
- Confira os registros selecionados antes de gerar o arquivo .zip.
- Use o número do documento, número da nota, tomador, status e valor líquido como principais pontos de conferência.
- A tabela não permite edição, pois o objetivo da tela é apenas consultar, selecionar e exportar.
- No caso de RPS, o sistema apresenta apenas registros da empresa do usuário logado.
- Ao exportar vários registros, todos os XMLs serão reunidos em um único arquivo compactado.
- O carregamento via hot-link deve ser usado apenas como facilitador para abrir o recurso 2069 com registros já selecionados.
- Guarde o arquivo .zip em local seguro, conforme as práticas internas da empresa.
- Caso ocorra erro durante a exportação, revise o Tipo Exportação, os registros selecionados e tente novamente.
- Para evitar envio incorreto de documentos, valide o tomador e o número da nota antes de compartilhar XMLs com terceiros.
Benefícios do Recurso
- Centraliza a exportação de XMLs em uma única tela.
- Prepara o sistema para futuras exportações de outros tipos de documentos.
- Reduz o tempo necessário para localizar e baixar XMLs.
- Permite exportar vários XMLs de uma só vez.
- Evita erros ao bloquear ações sem Tipo Exportação ou sem registros selecionados.
- Melhora a segurança ao respeitar as regras de acesso e empresa do usuário.
- Facilita conferências fiscais, administrativas e operacionais.
- Apoia auditorias e controles internos.
- Reduz retrabalho ao permitir conferência dos principais dados antes da exportação.
- Mantém os dados protegidos contra alterações indevidas, pois a tabela é somente leitura.
- Agiliza o processo quando os registros são carregados diretamente pelo hot-link relacionado.
Glossário de Termos
- XML — Arquivo em formato estruturado utilizado para armazenar e transmitir informações fiscais.
- RPS — Recibo Provisório de Serviço, documento relacionado ao processo de emissão de NFS-e.
- NFS-e — Nota Fiscal de Serviço Eletrônica.
- Tipo Exportação — Campo que define qual tipo de documento será consultado e exportado.
- Central de Exportação — Tela criada para concentrar em um único local a geração de XMLs de diferentes origens ou documentos.
- Tomador — Pessoa ou empresa que recebe o serviço.
- Valor Líquido — Valor final da nota após os cálculos aplicáveis.
- Status — Situação atual do registro, como normal ou cancelado.
- Hot-link — Atalho que permite abrir a Central de Exportação de XML com registros previamente selecionados.
- Modal — Janela aberta sobre a tela atual para executar uma ação sem sair totalmente do contexto anterior.
- Arquivo .zip — Arquivo compactado que reúne um ou mais arquivos em um único download.
- Identificador — Código interno usado pelo sistema para reconhecer um registro.
- Exportar XML — Ação que gera e disponibiliza os arquivos XML dos documentos selecionados.
Links Relacionados
- Central de Exportação de XML
- Consulta de RPS
- Gestão de NFS-e
- Exportação de XML