Manual de integração com o webservice

Download do manual

Portais Disponíveis 

• Produção
• Homologação

Métodos Disponíveis

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

Observações

• Não possui envio em lote.
• Não possui Múltiplos Serviços.
• Para realizar todas os métodos disponíveis pelo WebService, é necessário informar Login e Senha como parâmetro extra. A senha do webservice pode ser obtida no portal da prefeitura no menu Gerenciamento > Usuários > Pesquisar > Clicar no cadeado > Abrirá a página de criação da senha do webservice.

Métodos Disponíveis

Envio de RPS

• Não é possível realizar o envio em Lote, sendo necessário enviar um RPS de cada vez; 

Consultar NFSe por RPS

• Para realizar uma consulta de NFSe por RPS é necessário informar o Login e Senha mencionado acima como parâmetro extra. 

Cancelamento NFSe

• Para realizar o cancelamento é necessário informar a chave de cancelamento obtida na consulta de NFSe por RPS e também informar o Login e Senha mencionado acima como parâmetro extra.

Impressão

• Para realizar a impressão da NFSe pelo componente, deverá ser informado o Consulta de NFSe por RPS.
• A impressão de NFSe do portal pode ser obtida por um link através do comando auxiliar ObterLinkImpressaoNFSe, Exemplo:
  • Realizar um POST na rota https://wsvalinhos.sigissweb.com/rest/login informando o login e senha utilizados anteriormente como parâmetro extra, no Body e no Headers informar Content-Type com a value application/json.
  • Realizar um GET com o link obtido pelo comando auxiliar ObterLinkImpressaoNFSe, no parâmetro Headers informar a Key como Content-Type com a value application/pdf e informar outra Key como AUTHORIZATION com a value obtida no POST anteriormente.

Geração do XML - Campos Importantes

• O padrão não faz uso do Tipo RPS.
• O Padrão não utiliza os campos NaturezaOperacao, CodigoTributacaoMunicipio e CodigoCnae.
• O código do serviço segue o que está descrito na LC-116 com ponto.
• Não utilizar acentos e caracteres especiais no envio pois o WebService não suporta tal.
• DataVencimento = Preenche campo Forma de Pagamento da impressão.
• Se o campo IssRetido estiver vazio, ele irá considerar o que está no campo tipotributacao, logo:
  iss_retido=F 
  

  IssRetido=
  TipoTributacao=7

  iss_retido=D
  

  IssRetido=
  TipoTributacao=3

  iss_retido=I
  

  IssRetido=
  TipoTributacao=1 ou 4

  Se o campo IssRetido estiver preenchido, ele irá considerar apenas este campo, logo:
  iss_retido=S
  

  IssRetido=1 ou sim ou true

  iss_retido=N
  

  IssRetido=2 ou não ou false

Campos customizados para a impressão

Impressão do RPS

• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroPrestador=String[10]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• ValorExtenso=String[255]
• InscricaoMunicipalPrestador=String[15]
• InscricaoEstadualPrestador=String[15]
• RegimeApuracao=String[50]
• OutrasInformacoes=String[200]
• OptanteSimplesNacional=String[5]

Impressão da NFSe

• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroPrestador=String[10]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• EmailPrestador=String[80]
• TelefonePrestador=String[20]
• ValorExtenso=String[255]
• ValorTributos=String[15]
• RegimeApuracao=String[50]
• OutrasInformacoes=String[200]
• ValorLiquidoNfse=String[15]
• ValorTotalImpostosFederais=String[15]