Diferença no link_url da NFS-e (Nuvem Fiscal vs ACBr API) – link da prefeitura (DF/GO)

[TiagoLC]

Olá

Estou realizando a migração da API da NFS-e da Nuvem Fiscal para a ACBr API e me deparei com uma diferença no retorno do campo link_url.

Na Nuvem Fiscal, o link_url retornado apontava diretamente para o link de impressão da nota na prefeitura, por exemplo:

https://iss.fazenda.df.gov.br/online/NotaDigital/Nota_Digital_204.aspx?EF+4E+50+D1...

Já na ACBr API, o retorno está vindo no padrão nacional:

https://www.nfse.gov.br/ConsultaPublica/?tpc=1&chave=...

Porém, esse link não leva diretamente para a impressão da nota na prefeitura (no caso, DF e GO), o que impacta meu fluxo atual.

Existe alguma configuração na ACBr API para retornar o link direto da prefeitura (como ocorria na Nuvem Fiscal)?

Desde já agradeço

[daniel.oliveira.mm]

Por favor, anexe o payload dos dois para análise ...

[TiagoLC]

Segue payload dos dois casos:

Payload ACBR:
{"infDPS": {"serv": {"cServ": {"CNAE": "xxxxx", "cNBS": "xxxxx", "cTribMun": "xxxx", "cTribNac": "xxxx", "xDescServ": "Teste envio 1}}, "toma": {"xNome": "Tomadorxxyy"}, "dhEmi": "2026-04-23T16:56:24Z", "prest": {"CNPJ": "000000000000000"}, "tpAmb": 1, "dCompet": "2026-04-23", "valores": {"trib": {"totTrib": {"pTotTrib": {"pTotTribEst": 0, "pTotTribFed": 0, "pTotTribMun": 0}, "vTotTrib": {"vTotTribEst": 0, "vTotTribFed": 0, "vTotTribMun": 0}, "indTotTrib": 0, "pTotTribSN": 0}, "tribMun": {"vBC": 9.67, "vLiq": 0.48, "cLocIncid": "5300108", "tribISSQN": 1, "tpRetISSQN": 1}}, "vDedRed": {"vDR": 0.48}, "vServPrest": {"vServ": 10.15, "vReceb": 0}, "vDescCondIncond": {"vDescCond": 0, "vDescIncond": 0}}, "verAplic": "1.0"}, "ambiente": "producao", "provedor": "padrao", "referencia": "aaaxxbb"}

Payload Nuvem:

{"infDPS": {"serv": {"cServ": {"CNAE": "xxxxxx", "cNBS": "xxxxx", "cTribMun": "xxxx", "cTribNac": "xxxx", "xDescServ": "Teste envio 1"}}, "toma": {"CPF": "Tomadorxxyy", "dhEmi": "2026-04-23T17:29:58Z", "prest": {"CNPJ": "000000000000000000"}, "tpAmb": 1, "dCompet": "2026-04-23", "valores": {"trib": {"totTrib": {"pTotTrib": {"pTotTribEst": 0, "pTotTribFed": 0, "pTotTribMun": 0}, "vTotTrib": {"vTotTribEst": 0, "vTotTribFed": 0, "vTotTribMun": 0}, "indTotTrib": 0, "pTotTribSN": 0}, "tribMun": {"vBC": 547.92, "vLiq": 27.4, "cLocIncid": "5300108", "tribISSQN": 1, "tpRetISSQN": 1}}, "vDedRed": {"vDR": 127.4}, "vServPrest": {"vServ": 2675.32, "vReceb": 0}, "vDescCondIncond": {"vDescCond": 0, "vDescIncond": 0}}, "verAplic": "1.0"}, "ambiente": "producao", "provedor": "padrao", "referencia": "xxxyy"}
 

17 horas atrás, danieloliveira-mm disse:

Por favor, anexe o payload dos dois para análise ...

Segue payload dos dois casos:

Payload ACBR:
{"infDPS": {"serv": {"cServ": {"CNAE": "xxxxx", "cNBS": "xxxxx", "cTribMun": "xxxx", "cTribNac": "xxxx", "xDescServ": "Teste envio 1}}, "toma": {"xNome": "Tomadorxxyy"}, "dhEmi": "2026-04-23T16:56:24Z", "prest": {"CNPJ": "000000000000000"}, "tpAmb": 1, "dCompet": "2026-04-23", "valores": {"trib": {"totTrib": {"pTotTrib": {"pTotTribEst": 0, "pTotTribFed": 0, "pTotTribMun": 0}, "vTotTrib": {"vTotTribEst": 0, "vTotTribFed": 0, "vTotTribMun": 0}, "indTotTrib": 0, "pTotTribSN": 0}, "tribMun": {"vBC": 9.67, "vLiq": 0.48, "cLocIncid": "5300108", "tribISSQN": 1, "tpRetISSQN": 1}}, "vDedRed": {"vDR": 0.48}, "vServPrest": {"vServ": 10.15, "vReceb": 0}, "vDescCondIncond": {"vDescCond": 0, "vDescIncond": 0}}, "verAplic": "1.0"}, "ambiente": "producao", "provedor": "padrao", "referencia": "aaaxxbb"}

Payload Nuvem:

{"infDPS": {"serv": {"cServ": {"CNAE": "xxxxxx", "cNBS": "xxxxx", "cTribMun": "xxxx", "cTribNac": "xxxx", "xDescServ": "Teste envio 1"}}, "toma": {"CPF": "Tomadorxxyy", "dhEmi": "2026-04-23T17:29:58Z", "prest": {"CNPJ": "000000000000000000"}, "tpAmb": 1, "dCompet": "2026-04-23", "valores": {"trib": {"totTrib": {"pTotTrib": {"pTotTribEst": 0, "pTotTribFed": 0, "pTotTribMun": 0}, "vTotTrib": {"vTotTribEst": 0, "vTotTribFed": 0, "vTotTribMun": 0}, "indTotTrib": 0, "pTotTribSN": 0}, "tribMun": {"vBC": 547.92, "vLiq": 27.4, "cLocIncid": "5300108", "tribISSQN": 1, "tpRetISSQN": 1}}, "vDedRed": {"vDR": 127.4}, "vServPrest": {"vServ": 2675.32, "vReceb": 0}, "vDescCondIncond": {"vDescCond": 0, "vDescIncond": 0}}, "verAplic": "1.0"}, "ambiente": "producao", "provedor": "padrao", "referencia": "xxxyy"}

[Michel Araruna]

Ola meu amigo estamos verificando essa situação e logo retornaremos com uma solução ok 

 

Obrigado 

[daniel.oliveira.mm]

Boa tarde, precisamos dos dados da debug dessa requisição para entender como resolver esse problema

https://dev.acbr.api.br/docs/api/#tag/Debug/operation/DebugHttpResponseContent

[TiagoLC]

Olá,

Realizei novos testes para obtenção do debug das requisições.

nfs_3a20e276dbad4d5da01dea60b68b1214

nfs_3a20e2f7efde445b84dff59f6002363d

Todas as notas foram enviadas com sucesso, processadas corretamente e autorizadas com XML disponível para download
Ou seja, a integração está funcionando normalmente.

Ao realizar o debug, o sistema está retornando HTTP 403 mesmo com permissão "debug" ativa na credencial.

[diego.foliene]

Bom dia!

2 horas atrás, TiagoLC disse:

Ao realizar o debug, o sistema está retornando HTTP 403 mesmo com permissão "debug" ativa na credencial.

Por favor, caso já não o esteja fazendo, tente realizar um teste enviando no parâmetro scope da requisição de autenticação, o scope debug

[TiagoLC]

Em 27/04/2026 at 09:58, Diego Foliene disse:

Bom dia!

Por favor, caso já não o esteja fazendo, tente realizar um teste enviando no parâmetro scope da requisição de autenticação, o scope debug

Boa tarde!

Enviei com debug no scope, mesmo assim retorna erro.

ultima nota processada: nfs_3a20ec284bd8456d9f43bac5cc169a1c

Editado 28 Abril por TiagoLC

[diego.foliene]

19 horas atrás, TiagoLC disse:

Boa tarde!

Enviei com debug no scope, mesmo assim retorna erro.

ultima nota processada: nfs_3a20ec284bd8456d9f43bac5cc169a1c

Bom dia!

Questionando sobre o problema junto ao time da ACBr API, eles informaram que:

Citar

tem que ter o scope na credencials e quando gera o token tem que passar o debug

Por favor, pode confirmar se está fazendo esse processo corretamente?

Apenas para trazer mais contexto, o pedido do conteúdo de end-point de debug é para nós conferirmos como a informação está sendo devolvida para a API na íntegra e verificar se essa URL está sendo devolvida pelo web service, pois a princípio, não encontramos nada que implique nela sendo montada pelo componente ACbrNFSeX(que é utilizado pela ACBr API para esse caso).

Se os problemas com o end-point de debug persistirem, por favor, tente recuperar o XML da NFS-e da Nuvem e o XML da NFS-e da ACBr API usando o end-point BaixarXmlNFSe.

A resposta do debug é mais completa, mas acredito que o XML da NFS-e também possa ter a resposta.

[TiagoLC]

3 horas atrás, Diego Foliene disse:

Bom dia!

Questionando sobre o problema junto ao time da ACBr API, eles informaram que:

Por favor, pode confirmar se está fazendo esse processo corretamente?

Apenas para trazer mais contexto, o pedido do conteúdo de end-point de debug é para nós conferirmos como a informação está sendo devolvida para a API na íntegra e verificar se essa URL está sendo devolvida pelo web service, pois a princípio, não encontramos nada que implique nela sendo montada pelo componente ACbrNFSeX(que é utilizado pela ACBr API para esse caso).

Se os problemas com o end-point de debug persistirem, por favor, tente recuperar o XML da NFS-e da Nuvem e o XML da NFS-e da ACBr API usando o end-point BaixarXmlNFSe.

A resposta do debug é mais completa, mas acredito que o XML da NFS-e também possa ter a resposta.

Boa tarde,

O ponto em análise é apenas a diferença no retorno do campo link_url.

Pela ACBr API, a NFS-e é autorizada corretamente, os dados da nota estão corretos e o XML é baixado com sucesso. Porém, o link_url retornado vem no padrão nacional:

https://www.nfse.gov.br/ConsultaPublica/?tpc=1&chave=...

Na Nuvem Fiscal, o link_url retornava o link direto de impressão da prefeitura/DF:

https://iss.fazenda.df.gov.br/online/NotaDigital/Nota_Digital_204.aspx?...

Tentei obter o debug conforme orientação. Após incluir o scope debug, o retorno deixou de ser 403 e passou a ser 404, indicando que a permissão foi aplicada, mas o conteúdo de debug não foi encontrado/gerado para as requisições testadas.

Pelo comparativo, os XMLs possuem estrutura muito semelhante, com dados de autorização, RPS, serviço, prestador, tomador, valores, município e assinatura todos corretos.

A principal diferença prática observada no fluxo não está no XML em si, mas no retorno da API:

Nuvem Fiscal retornava link_url apontando diretamente para o portal municipal/prefeitura;

ACBr API retorna link_url apontando para a consulta nacional da NFS-e.

Existe algum campo alternativo no retorno, XML ou configuração da ACBr API que permita obter o link direto municipal/prefeitura quando disponível?

Obrigado.

[Daniel InfoCotidiano]

Bom dia @TiagoLC
Vou ver com o time sobre isso. mas lembre-se que são 2 produtos distintos;
Nós atuamos com o ACBr API;
Assim que tiver uma resposta relato aqui.