Download do XML da NF-e emitida contra o CNPJ

Última atualização em: 31 de março, 2016

Olá! Neste artigo descrevemos como é realizada a solicitação de download dos documentos XML das NF-e emitidas contra o CNPJ da empresa através do InvoiCy.

Após realizar a ciência da operação ou a manifestação também é possível baixar o arquivo XML completo, onde o cliente poderá solicitar o download de até dez documentos por vez. Cabe destacar que a SEFAZ poderá bloquear essa funcionalidade de download do arquivo XML completo quando ultrapassar 50% de documentos emitidos contra o CNPJ da empresa no período de 30 dias.

1. Gere a estrutura do arquivo XML de solicitação de download

Através dessa funcionalidade, é possível solicitar o download de até dez documentos em apenas uma requisição.

Clique aqui para visualizar um exemplo de XML com a estrutura para solicitação de download dos documentos.

Disponibilizamos também um documento que especifica o layout do XML que deve ser gerado, clique para fazer o download.

2. Consuma o Web Service de envio de documentos do InvoiCy

Após a geração do XML de solicitação de download o próximo passo é realizar o consumo do Web Service de recepção do InvoiCy.

O XML de solicitação de download deve estar na tag “Documento”, convertido para texto, como mostra a imagem abaixo:

Clique aqui para fazer download do XML exibido na imagem.

Para a geração do código hash informado no campo “EmpCK” deve-se utilizar todo o conteúdo da tag “Documento”. O procedimento para a geração do hash você encontra no artigo Gerando o hash MD5.

3. Obtenha retorno da solicitação de download

Os dados do retorno da solicitação de download serão a chave de acesso do documento que foi solicitado download e o arquivo XML em base 64 (para mais informações sobre base64 acesse o artigo). Será retornado também o código e descrição da situação do download, para conhecimento do usuário.

Disponibilizamos um exemplo de XML de retorno, clique aqui para fazer o download.

Download do XML da NFS-e – Antigo

Última atualização em: 31 de março, 2016

 

Há duas formas de como fazer o download do XML da NFS-e, a primeira é via Sistema web e a segunda é via Web Service.

Download via Sistema web

Acessar o Sistema web e na listagem de notas da tela inicial clicar sobre o ícone download_xml (download XML) correspondente da nota. Após irá aparecer uma tela com várias opções de download, conforme imagem abaixo selecione a opção “NFS-e”.

download_xml
Nota: Por questões de segurança dos navegadores, os downloads só estão habilitados para conexão HTTPS.

Download via Web Service

A partir de agora, assumimos que você já leu o artigo Integrar com o InvoiCy NFS-e. Caso ainda não tenha lido o artigo, recomendamos que realize a leitura do mesmo, para facilitar o entendimento desta etapa.
Para realizar o download via Web Service, primeiro é necessário realizar a integração, conforme os passos a seguir:

     1. Consumindo o Web Service
Primeiramente, você deve realizar o consumo do seguinte Web Service https://gnfse.gnfe.com.br/apnuc209.aspx?wsdl

     2. Gerar o XML de envio
Nessa etapa é gerado um XML contendo os parâmetros da solicitação, dados de identificação da empresa e segurança no cabeçalho e uma lista de RPS que se deseja fazer o download do XML. Os detalhes de como criar o XML e transmitir estão detalhados abaixo. Para obter os layouts de envio e retorno do XML de Download XML, faça o download do arquivo DownloadXML.zip. Nele você encontrará também o arquivo XSD e XML de exemplo. O XML a ser enviado pode ser divido em duas partes: Cabeçalho (comum a todos os serviços – exceto no cadastro de prestador) e os parâmetros para a consulta (Tag <FaixaConsulta>). Para saber como gerar os dados do cabeçalho, consulte o artigo Gerar um XML de Envio passo-a-passo. O documento XML deve ser convertido para texto, e inserido entre as TAGS <nfse:Entradaxml> </nfse:Entradaxml> do SOAP de envio. Veja abaixo um exemplo:

Nos casos em que for usada uma ferramenta RAD para consumo do Web Service através de componente nativo, por exemplo Visual Studio utilizando Web Reference, a conversão do XML para texto irá ocorrer de forma automática. Para os casos em que o desenvolvedor preferir codificar toda a comunicação sem utilizar componentes, além de ser necessário escrever todo o XML do SOAP, também deverá ser feita a conversão do XML do documento para texto, substituindo os caracteres “<”, “>” e “ “ ” (aspas) por “&lt;”, “&gt;” e “&quot;” respectivamente, de acordo com a tabela da W3C: http://www.w3schools.com/html/html_entities.asp.

Para facilitar a geração do XML de integração, disponibilizamos o XML de envio, bem como um arquivo de esquema XSD que poderá servir como base. É recomendável que após a geração do arquivo XML e antes do consumo do Web Service, o mesmo seja validado contra o arquivo de esquema. Maiores detalhes no artigo Validação de arquivos XML.

     3. Realizar a leitura do retorno
Após o envio do XML, precisamos realizar a leitura do retorno do processamento. O retorno recebido segue a seguinte estrutura SOAP:

A estrutura SOAP acima demonstra o retorno do serviço de Download XML de apenas um RPS requisitado.
O seu sistema deve ler o retorno, validando as informações conforme o layout de retorno. O retorno criará um grupo para cada RPS solicitado, contendo a série, o número e o XML da NFS-e em base64. Retornará também mensagens de erro caso ocorra. Para informações de como decodificar o conteúdo da tag <NfseXml> em arquivo XML ver o artigo Exemplo de decodificação de base64 para arquivo.

Seu próximo passo é: Gerar o Espelho do RPS e NFS-e.

Artigos Relacionados:

Download do XML da NFS-e

Última atualização em: 09 de agosto, 2016

Há duas formas de como fazer o download do XML da NFS-e, a primeira é clicando no ícone no lado direito onde é listado o RPS ou através do menu “Exportar documentos”.

Download na Tela Inicial

Acessar o Invoicy na listagem de notas da tela inicial clicar sobre o ícone download_xml (download XML) correspondente da nota. Após o download do documento deve ser feito, já sendo possível sua visualização, conforme imagem abaixo.

Realizar Download via Menu “Exportar Documentos”

No menu é permitido aplicar filtros realizando a exportação de um ou mais documentos dependendo da sua preferência.