Documentação técnica - Padrão SigIssWeb

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.
   
• Campos que passarão a ser obrigatórios para cidades desse padrão:
  servico.codigoNbs
  cidadePrestacao.codigo

PlugNotas

[
 {
  "cidadePrestacao": {
   "codigo": "3549904"
 },
  "servico": [{
   "codigo": "14.02.01",
   "codigoNbs": "99871234"
  }]
 }
]

Componente/Manager SaaS

CodigoCidadePrestacao=3549904
CodigoNbs=99871234

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

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

Observação: Campos obrigatórios conforme o arquivo de esquema do Padrão estão destacados em negrito.

O ambiente de homologação do padrão ainda não retorna o XML de NFSe com os campos novos de IBS e CBS.

Ressaltamos que, para manter a funcionalidade em ambos os ambientes de emissão (produção e homologação), essas regras de validação ainda não foram aplicadas em nossas aplicações.

Para maiores informações sobre a forma de preenchimento destes campos novos, acesse nossa documentação do Padrão Unificado de TX2.

Exemplos de tx2 e XML:

• XML de Envio 
• XML de Retorno 
• TX2

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]

Exemplos de arquivos de integração