Tipos de impressão de NFS-e no PlugNotas

As formas de geração são:

• Impressão via link da prefeitura
• Impressão gerada pelo PlugNotas (RTM)

Impressão via Link da Prefeitura

Nesta modalidade, o PlugNotas realiza o download automático do PDF da nota diretamente do portal da prefeitura. O link para o arquivo geralmente está presente no XML da nota ou é construído a partir das informações disponibilizadas pela própria prefeitura.

Essa impressão utiliza exatamente o mesmo layout visual que seria acessado no portal da prefeitura, mantendo identidade visual e dados complementares exibidos por lá.

Em alguns casos, o link pode não funcionar devido a falhas temporárias ou instabilidade no sistema da prefeitura. Nesses casos, o PlugNotas assume a geração do PDF, utilizando o gerador de relatórios próprio, garantindo que o documento continue acessível.

Como saber se a cidade possui suporte à impressão via link?

A forma mais prática de verificar se uma cidade disponibiliza o PDF oficial por link é utilizando a rota de consulta de cidades da nossa API.

Apesar de ainda não estar documentado oficialmente, a resposta da API já traz o campo impressaoLink.

Exemplo de resposta:

{
  "id": 4201406,
  "nome": "Araranguá",
  "uf": "SC",
  ...
  "impressaoLink": true,
  ...
}

Interpretação:

• "impressaoLink": true → A cidade disponibiliza o PDF oficial via link da prefeitura.

• "impressaoLink": false → A cidade não fornece o PDF oficial, assim a impressão será feita com base em um modelo interno do PlugNotas.

   

Impressão Gerada pelo PlugNotas (RTM)

Quando a prefeitura não fornece um link para o PDF oficial ou este encontra-se indisponível, o PlugNotas gera um PDF próprio, utilizando um modelo interno baseado nas informações presentes no XML da nota.

Esse modelo:

• Contém todos os dados fiscais essenciais para validade e conferência da nota;
• Pode apresentar diferenças visuais em relação ao layout original da prefeitura;
• Não exibe informações que não constam no XML, como QR Codes não dedutíveis ou avisos customizados por cidade.