Tópicos desse artigo

• Manual do web service
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais
• Emissão pelo PlugNotas
• Emissão pelo ManagerEDoc/ManagerSaaS
• Emissão pelo componente NFSe
• Observações sobre a geração do XML
• Como obter os parâmetros de autenticação 
• Campos customizados para a impressão do RPS
• Campos customizados para a impressão da NFSe

 

 

---

Manual de integração com o webservice

• Download do Manual

 

 

Portais Disponíveis

• Produção

 

 

---

Métodos Disponíveis

• Envio.
  • Síncrono
  • Necessita envio sequencial¹
  • Não aceita envio de lote de RPS
• Consulta de NFSe por RPS
• Cancelamento de NFSe.

 

¹ Necessita que as notas sejam enviadas de forma sequencial

---

Tipo de impressão

• A impressão é feita via link da prefeitura¹

 

¹ Nossos produtos realizam o download do PDF da NFSe que foi gerado pela própria prefeitura.

Observações gerais

• Não possui Envio em Lote; 
• Não possui Múltiplos Serviços; 
• Para o padrão é necessário gerar uma chave de acesso no portal da prefeitura. Acesse o portal da prefeitura com os dados do prestador. Na tela que abre vá em Gerenciamento > Configurar Padrão. Em seguida, marcar a opção "Permitir Comunicação Web Service" como na imagem e copiar a chave que aparecer no campo abaixo. Por fim, clique em Gravar

 

 

Emissão pelo PlugNotas

• A chave de acesso deverá ser informada no parâmetro "Senha", nas configurações de autenticação com a prefeitura.

Exemplo de configuração da chave de acesso pela interface do PlugNotas

 Exemplo de configuração da chave de acesso pela API

 

 

Emissão pelo ManagerEdoc/ManagerSaaS

• ​A chave de acesso deve ser informado no campo Senha na aba Configurações > Autenticação da Prefeitura.

Exemplo de configuração da chave digital:

 

 

Emissão pelo Componente NFSe

• A chave digital deve ser informado no parâmetro extra "Senha". No EDoc/Saas, deixar o campo Login em branco e inserir a ChaveAcesso no campo da Senha. 
• A não utilização do parâmetro extra irá ocasionar a seguinte rejeição:
  Informações de acesso da inscrição não puderam ser confirmadas. ()

Exemplo de configuração da chave digital:

NFSe.ParametrosExtras = "Senha=999512b599abc9babc9a9bc99abc999c";

• Consulta de NFSe por RPS: No componente deve ser informado o número do RPS e o Código de Verificação no lugar do tipo RPS e a ChaveAcesso como  parâmetro extra.
• Para o cancelamento, é necessário o Número da nota e um parâmetro extra (referente a ChaveAcesso).

 

 

---

Observações sobre a geração do XML

• O código do serviço segue o que está descrito na LC-116.
• É necessário enviar no Tx2 o campo TipoRps preenchido com o código de verificação de cada RPS. Por exemplo: TipoRps=RTL0WEDDKS para o RPS nº 4 e assim por diante. Esse código é obtido no arquivo AIDF, ao lado da numeração de RPS:

       

 

 

Como obter os parâmetros de autenticação

• Como conseguir a chave de acesso no portal: Gerenciamento > Configurar Padrão > Gerar Chave de Acesso

• Deve-se gerar/baixar o Arquivo AIDF que contém o código de verificação de cada numeração de RPS liberada. Ele pode ser baixado no portal da prefeitura, no menu de RPS>Autorização de Impressão:

       

 

 

 

---

Campos customizados para a impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroPrestador=String[10]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• SubstitutoTributario=String[3]
• InscricaoMunicipalPrestador=String[20]
• CpfCnpjPrestador=String[20]
• InscricaoEstadualPrestador=String[20]
• CodigoCidadePrestador=String[40]
• OutrasRetencoes=String[10]
• ValorIssRetido=String[10]
• TotalRetencoes=String[10]
• ValorLiquido=String[10]
• BaseCalculo=String[10]
• ValorIss=String[10]
• DataCancelamento=String[30]
• NaturezaTributacao=String[30]
• TipoTributacao=String[30]

 

 

Campos Customizados para a impressão da NFSe

• InscricaoMunicipalPrestador=String[20]
• CpfCnpjPrestador=String[20]
• InscricaoEstadualPrestador=String[20]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[40]
• UfPrestador=String[2]
• NumeroPrestador=String[10]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• SubstitutoTributario=String[3]
• OutrasRetencoes=String[10]
• ValorIssRetido=String[10]
• TotalRetencoes=String[10]
• ValorLiquidoNfse=String[10]
• BaseCalculo=String[10]
• ValorIss=String[10]
• DataCancelamento=String[30]
• NaturezaTributacao=String[30]
• TipoTributacao=String[30]