Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção

Métodos Disponíveis

• Envio.
  
  • Síncrono.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Cancelamento de NFSe.

Observações

• Para integração com o Web Service, é necessário preencher o campo Senha no cadastro do Prestador. A senha é gerada diretamente no portal da prefeitura nos passos a seguir:
  Faça Login no portal > Clique na opção do menu Informações (Símbolo "i") > Informações da Empresa > Clique no ícone de "Gerar Senha WS" (Símbolo de cadeado).A senha será gerada e enviada para o email cadastrado em "Contatos do Contribuinte" nessa mesma tela.
• Na mesma tela, também é necessário liberar a emissão de lote em produção:
• Uma das causas do erro à seguir: "<faultstring xml:lang="en">Validation error<" é a ausência de liberação do CNPJ do prestador para emissão de RPS no Web service do município em questão.
• Para envio e consulta, deve ser informado o parâmetro extra Senha=XXXXXXX;
• O Erro S13 - O valor do desconto incondicionado não confere com a soma dos descontos lançados nos itens ocorre por conta do campo DescontoIncondicionadoServico Não ter sido preenchido no Tx2 de envio da nota com o valor total dos descontos
• Para cancelamento de notas no componente NFSe v2, atualmente, é necessário executar uma consulta de NFSe ou NFSe por Rps para que seja gerado a chave correta de cancelamento. 
  
  • A chave de cancelamento é uma concatenação do campo 'ChaveAcesso' + numero da NFSe + Identificação do Rps.
  • O campo 'ChaveAcesso' é um campo que consta apenas no XML da NFSe. O mesmo tem o intuito de ser um código para autenticação da nota na prefeitura.

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
• É obrigatório informar o código CNAE.
  • Código CNAE segue a tabela nacional com 7 digítos.
• O "Código de Tributação do Município" é um código proprietário de cada município, ou seja, cada município tem o seu, não existe um padrão, sendo assim é necessário contatar o município para identificar qual a codificação utilizada. Algumas prefeituras adotam o codificação da lista de serviço da Lei Complementar 116/03 ampliada, outras adotam o código CNAE.
• O município faz uso dos seguintes campos do Padrão Único:
  • NomeFantasiaPrestador
  • RazaoSocialPrestador
  • EnderecoPrestador
  • NumeroPrestador
  • BairroPrestador
  • CodigoMunicipioPrestador
  • DescontoIncondicionadoServico

Campos customizados para a impressão

Impressão do RPS

• InscricaoEstadualPrestador=string[15]
• RazaoSocialPrestador=string[150]
• NomeFantasiaPrestador=string[60]
• EnderecoPrestador=string[125]
• NumeroEnderecoPrestador=string[10]
• ComplementoEnderecoPrestador=string[60]
• BairroPrestador=string[60]
• CodigoMunicipioPrestador=string[7]
• CidadeNomePrestador=string[125]
• UfPrestador=string[2]
• CodigoPaisPrestador=string[15]
• CepPrestador=string[8]
• TelefonePrestador=string[20]
• EmailPrestador=string[80]
• RegimeFiscal=String[15]
• AliquotaPIS=String[50]
• AliquotaCOFINS=String[50]
• AliquotaINSS=String[50]
• AliquotaIR=String[50]
• AliquotaCSLL=String[50]
• AliquotaCPP=String[50]
• AliquotaImpostoFederal=String[50]

Impressão da NFSe

• InscricaoEstadualPrestador=string[20]
• RazaoSocialPrestador=string[150]
• NomeFantasiaPrestador=string[60]
• EnderecoPrestador=string[125]
• NumeroEnderecoPrestador=string[10]
• ComplementoEnderecoPrestador=string[60]
• BairroPrestador=string[60]
• CodigoMunicipioPrestador=string[7]
• CidadeNomePrestador=string[125]
• UfPrestador=string[2]
• CodigoPaisPrestador=string[15]
• CepPrestador=string[8]
• TelefonePrestador=string[20]
• EmailPrestador=string[80]
• RegimeFiscal=String[50]
• AliquotaPIS=String[50]
• AliquotaCOFINS=String[50]
• AliquotaINSS=String[50]
• AliquotaIR=String[50]
• AliquotaCSLL=String[50]
• AliquotaCPP=String[50]
• AliquotaImpostoFederal=String[50]
• InscricaoEstadualTomador=[50]
• DescricaoCidadePrestacao=String[120]

Soluções Tecnospeed

• Componente NFSe:      Release 7.7.32.X.
• Manager eDoc:      Release 2.0.66.X.