Documentação Técnica - Padrão ISSNETONLINE30

Tópicos deste artigo (Sumário)

• Manual do web service
• Portais disponíveis
• Métodos disponíveis
• Observações Gerais - Homologação
• Solicitação de acesso ao ambiente de Homologação - Passo a Passo
• Tipo de impressão
• Observações gerais do padrão
• Observações sobre a geração do XML / TX2 / JSON
• Novos campos disponibilizados para adequação da Reforma Tributária
• Campos customizados para impressão do RPS
• Compatibilidade / versões mínimas

Manual de integração com o web service

• Download do manual - Manual de Integração

Métodos disponíveis

Envio

• Envio sequencial: ( ) Necessita envio sequencial / (X) Não necessita envio sequencial
  • Nota: “envio sequencial” = numeração do RPS precisa estar na sequência esperada.
• Modo: (X) Síncrono / ( ) Assíncrono / ( ) Ambos
• Lote de RPS: (X) Aceita lote / ( ) Não aceita lote

Consulta

• (X) Consulta de lote
• (X) Consulta por RPS
• (X) Consulta por NFS-e
• ( ) Consulta por protocolo

Cancelamento

• ( ) Cancelamento de NFS-e via web service¹
• ( ) Cancelamento apenas administrativo (fora do WebService)

¹Cancelamento via WebService ainda não disponível nesta versão. Informação confirmada junto à equipe responsável pelo padrão em 11/09/2026.

Tipo de impressão

• ( ) Impressão via link da prefeitura¹
  • Nossos produtos fazem download do PDF gerado pela prefeitura.
• (X) Impressão via layout Tecnospeed
  • Nossos produtos geram o PDF, aproximando ao máximo o layout nacional.

Observações gerais do padrão

• Tomador: (X) Aceita emissão sem identificação do tomador / ( ) Não aceita 

Autenticação

O padrão ISSNETONLINE30 utiliza comunicação pela Internet com SSL e autenticação com certificado digital. São aceitos certificados emitidos por autoridade certificadora credenciada pela ICP-Brasil, de pessoa física ou jurídica, dos tipos A1, A3 ou certificado de servidor (híbrido). O certificado é exigido tanto para a assinatura das mensagens quanto para a transmissão entre o sistema do contribuinte e o web service. 

Componente NFS-e : Configurando a Autenticação pelo Certificado Digital

PlugNotas: Cadastrando Certificados via API e Cadastrando Certificado pela interface

Manager Saas: Como cadastrar, consultar e deletar certificados digitais

• Liberação de Acesso ao ambiente de Homologação: Antes de iniciar, o prestador deve solicitar a liberação do ambiente seguindo o guia: Solicitação de acesso ao ambiente de Homologação - Passo a Passo
• Cidade Base (Campo Grande/MS): O webservice de homologação utiliza o município de Campo Grande como base universal de testes. Portanto, os campos de código IBGE serão processados com o código desta cidade, refletindo inclusive na impressão do cabeçalho e local de emissão do documento, independentemente do município real do emissor.

• Série do Documento: É obrigatório o uso exclusivo da Série 8 para todas as emissões de teste.

Observações sobre a geração do XML / TX2 / JSON

Códigos aceitos para CodigoTributacaoMunicipio:

• 001 - Alíquota de 2%

• 004 - Alíquota de 2,5%

• 006 - Alíquota de 5%

• 007 - Alíquota de 3%

Municípios com tabela de tributação própria:

Alguns municípios utilizam uma tabela de CodigoTributacaoMunicipio própria, divergente dos códigos aceitos listados acima. Nesse caso, é necessário validar o código vigente diretamente no portal ISSNETonline de sua cidade antes da emissão, evitando rejeições ou aplicação de alíquota incorreta.

Como consultar a tabela do município:

Acesse o portal ISSNETonline da cidade desejada — exemplo (Goiânia/GO). No menu superior direito, clique em Downloads.


 
Localize e faça o download do arquivo "Correlação Tributação Municipal X Tributação Nacional" (disponibilizado e atualizado periodicamente pela prefeitura).

Utilize a tabela obtida para consultar e preencher corretamente o campo CodigoTributacaoMunicipio conforme a atividade/alíquota do serviço prestado.

Exemplos de TX2, JSON e XML:

• TX2
• JSON
• XML 

Novos campos disponibilizados para adequação da Reforma Tributária

Observações:

• Campos obrigatórios conforme o arquivo de esquema do Padrão estão destacados em negrito.
• Os campos obrigatórios possuem validação de preenchimento na geração do XML.
• Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.

Para empresas optantes do Simples Nacional, o preenchimento do campo RegimeApuracaoTributaria (regApTribSN) é obrigatório:

Exemplos de TX2, JSON e XML:

• TX2
• JSON
• XML 

Versão de layout 1.00 para optantes do Simples Nacional sem IBS/CBS

Emissores optantes do Simples Nacional podem emitir sem as informações de IBS/CBS até que o envio se torne obrigatório, previsto para 2027. Para isso, é preciso informar a versão de layout 1.00 no envio da nota.

Se a versão não for informada, ou for informado um valor diferente de 1.00, a nota é emitida na versão 1.01, que exige as informações de IBS/CBS.

PlugNotas (API/JSON)

Informe a versão no campo versao do JSON de envio:

Exemplo: 

Componente (TX2)

Informe a versão na propriedade Versao do TX2:

Versao=1.00

Campos customizados para impressão do RPS

• NomeFantasiaPrestadorCustom=String[80]
• RazaoSocialPrestadorCustom=String[80]
• EnderecoPrestadorCustom=String[80]
• CodigoMunicipioPrestador=String[10]
• NumeroPrestadorCustom=String[7]
• ComplementoPrestadorCustom=String[20]
• BairroPrestadorCustom=String[40]
• CepPrestadorCustom=String[8]
• TelefonePrestadorCustom=String[20]
• EmailPrestadorCustom=String[80]
• InscricaoMunicipalPrestadorCustom=String[20]
• CodigoCidadeIncidencia=String[7]
• ValorBaseCalculo=String[15]
• ValorTotalRetencoes=String[15]
• ValorIss=String[15]
• AliquotaIss=String[15]

Compatibilidade / versões mínimas

• Componente NFSe: Release 2.1.84.7797
• Manager eDoc: Release 6.2.1.14144