URL da NFS-e: entendendo como o link de impressão é gerado e como ele influencia no DANFSe

[Diego.Foliene]

Um elemento que faz parte do contexto da NFS-e é o link de impressão. Esse link é uma URL que, ao ser acessada, exibe o DANFSe correspondente à nota fiscal eletrônica autorizada, permitindo que o documento seja salvo ou impresso.

Além disso, esse link também é utilizado pelas soluções ACBr para gerar o QR Code no DANFSe.

Existem três maneiras de esse link ser gerado;

Devolvida no XML da NFS-e

A forma mais comum é quando o próprio web service do provedor gera o link e o devolve como parte do XML, seja em uma tag específica para essa finalidade — como, por exemplo, LinkNFSe, LINK, linkPdf, LinkImpressao ou Url —, seja dentro da tag OutrasInformacoes.

Se o arquivo XML da sua NFS-e não possuir essa informação, isso quer dizer que ela não é gerada e devolvida a você pelo provedor e o link precisará ser gerado de outra maneira.

URL base no arquivo ACBrNFSeXServicos.ini

Alguns provedores disponibilizam uma URL base com query params que podem ser utilizados para gerar a URL correspondente à respectiva nota.

Essas URLs ficam armazenadas nas chaves HomLinkURL, para o ambiente de homologação, e ProLinkURL, para o ambiente de produção.

Por meio do método ACBrNFSeX.LinkNFSe, passando os parâmetros necessários, a solução ACBr constrói a URL completa.

Alguns exemplos de HomLinkURL/ProLinkURL no arquivo ACBrNFSeXServicos.ini:

[3550308]
Nome=Sao Paulo
UF=SP
Provedor=ISSSaoPaulo
ProLinkURL=https://nfe.prefeitura.sp.gov.br/nfe.aspx?ccm=%InscMunic%&nf=%NumeroNFSe%&cod=%CodVerif%
HomLinkURL=https://nfe.prefeitura.sp.gov.br/nfe.aspx?ccm=%InscMunic%&nf=%NumeroNFSe%&cod=%CodVerif%

[3552205]
Nome=Sorocaba
UF=SP
Provedor=DSF
Versao=2.03
ProLinkURL=https://notafiscal.sorocaba.sp.gov.br/notafiscal-ws/servico/notafiscal/autenticacao/cpfCnpj/%Cnpj%/inscricaoMunicipal/%InscMunic%/numeroNota/%NumeroNFSe%/codigoVerificacao/%CodVerif%
HomLinkURL=https://homolsod.dsfweb.com.br/notafiscal-ws/servico/notafiscal/autenticacao/cpfCnpj/%Cnpj%/inscricaoMunicipal/%InscMunic%/numeroNota/%NumeroNFSe%/codigoVerificacao/%CodVerif%

Se, ao consultar a cidade no arquivo ACBrNFSeXServicos.ini, ela não tiver nenhuma dessas chaves, então essa URL não é fornecida pelo provedor e o link precisará ser gerado de outra maneira.

Utilizando o método de consulta

A forma menos comum é quando o provedor disponibiliza em seu web service um endpoint de consulta que devolve o link diretamente.

Nesse caso, utilize o método ACBrNFSeX.ConsultarLinkNFSe, passando os parâmetros necessários. A solução se comunicará com o web service do provedor e retornará a URL.

Para verificar se o provedor permite esse tipo de consulta, consulte os métodos disponíveis para o provedor (veja como fazer isso neste tópico).

Exemplo de caso em que o provedor permite a consulta de link:

Citar

Serviços Disponibilizados

 Permite o envio de Lote em Modo Assíncrono
 Permite o envio de Lote em Modo Síncrono
 Permite o envio Unitário em Modo Síncrono
 Não permite Consultar a Situação do Lote
 Permite Consultar o Lote
 Permite Consultar o Rps
 Não permite Consultar a NFS-e
 Permite Consultar uma Faixa de NFS-e
 Permite Consultar Serviço Prestado
 Permite Consultar Serviço Tomado
 Permite Cancelar NFS-e
 Permite Substituir NFS-e
 Não permite Gerar Token
 Não permite Enviar Evento
 Não permite Consultar Evento
 Não permite Consultar DF-e
 Não permite Consultar Parâmetros
 Não permite Consultar Sequencia de Rps
 Permite Consultar Link da NFS-e
 Não permite Consultar NFS-e por Chave

Importante

Como já mencionado, o QR Code impresso no DANFSe é gerado a partir dessa URL. Portanto, se nenhuma das alternativas for possível para o provedor utilizado, o link de impressão não poderá ser gerado e o QR Code não será exibido no DANFSe.