Manual de integração com o webservice

 

Download do manual

 

 

Portais Disponíveis 

 

• Produção 

 

Métodos Disponíveis

 

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

 

 

Observações

  Métodos Disponíveis

• Para realizar todas os métodos disponíveis pelo WebService, é necessário informar a Senha como parâmetro extra, levando em conta de que o padrão não utiliza certificado. Caso não possua as credenciais, basta acessar o portal da prefeitura, realizar o login, clicar no botão Editar no canto superior direito "Imagem de uma Chave Fixa" e pegar o Token.
  • O parâmetro extra será informados da seguinte forma: Senha=123senha
• No ambiente de HOMOLOGAÇÃO a consulta sempre retorna "Nota inexistente na base de dados". Por essa causa, não é possível realizar o resolve e a impressão da NFSe no Manager eDoc/SaaS.

   Envio de RPS

• Não é possível realizar o envio em Lote, sendo necessário enviar um RPS de cada vez;
• Múltiplos serviços:
  • o valor total do ISS deve ser informado no campo ValorTotalIss dentro do dataSet INCLUIR
  • O iss retido deverá ser informado conforme abaixo:
    • Primeiro Serviço: Se o campo IssRetido for igual a1, devemos informar a aliquota do iss retido no campo AliquotaISS e o valor retido no campo ValorIssRetido, que estão no DataSet INCLUIRRPS. Caso o campo IssRetido for igual a 2, os campos ficarão com 0.00.
    • Mais serviços: Se o campo IssRetidoServico for igual a 1, devemos informar a aliquota do iss retido no campo AliquotaIssRetidoServico e o valor retido no campo ValorIssRetido, que estão dentro no DataSet INCLUIRSERVICO. Caso o campo IssRetidoServico for igual a 2, os campos ficarão com 0.00.
  • os serviços devem ser informados da seguinte forma, pelo tx2 de padrão único TecnoNFSe:

INCLUIR
...
ValorTotalServicos=3.00
ValorTotalIss=0.40
ValorTotalDeducoes=0.03
...
SALVAR

INCLUIRRPS                                      
...
CodigoItemListaServico=10.02                    { Primeiro Serviço }
DiscriminacaoServico=Discriminacao Teste NFSe
BaseCalculo=1.00
AliquotaServico=2.00
ValorIss=0.10
IssRetido=1
AliquotaISS=2.00
ValorIssRetido=0.02
...
SALVARRPS

INCLUIRSERVICO
CodigoItemListaServico=10.02                     { SegundoServiço }
DiscriminacaoServico=Discriminacao Teste NFSe
BaseCalculo=1.00
AliquotaServico=2.00
ValorIss=0.20
IssRetidoServico=1
AliquotaIssRetidoServico=2.00
ValorIssRetido=0.01
SALVARSERVICO

INCLUIRSERVICO
CodigoItemListaServico=10.02                     { Terceiro Serviço }
DiscriminacaoServico=Discriminacao Teste NFSe
BaseCalculo=1.00
AliquotaServico=2.00
ValorIss=0.10
IssRetidoServico=2
AliquotaIssRetidoServico=0.00
ValorIssRetido=0.00
SALVARSERVICO

Obs: O primeiro serviço deve ser informado dentro do Dataset "INCLUIRRPS" e a partir do segundo serviço em diante (caso haja), devem ser informados em um Dataset "INCLUIRSERVICO".

 

 

Consultar NFSe por RPS

• Para realizar uma consulta de NFSe é necessário informar o Código de Verificação como o número da NFSe. Esse valor pode ser obtido na propriedade CodVerificacao da interface IspdRetConsultaNFSe. Também é necessário informar o parâmetro extra Senha.
  • Senha=123senha;

Resolve

• Caso ocorra divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Enviada), o procedimento a ser realizado é um resolve, informando o Número da Nota mais o Código de Verificação separados por underline. Essa informação deve ser passada no  parâmetro NumeroNFSE_CodigoVerificacao, conforme abaixo: Exemplo: NumeroNFSE_CodigoVerificacao=1234_12345678AB
  
  • Para encontrar a Código de Verificação da nota, é necessário fazer o download do XML no portal da prefeitura e visualizar o conteúdo da tag "<codigoVerificacao>" ;
  • Esse procedimento pode ser feito para as situações onde não temos o número da nota, nesse caso, devemos chamar o resolve e acrescentar 0 para o número da nota.

 

• Procedimentos: 
  • Para comunicações via API:
    • terá que ser adicionado um novo parâmetro na Key, onde o mesmo é ParametroExtra, com seu valor no body que será NumeroNFSE_CodigoVerificacao=1234_12345678AB por exemplo.
  • Para comunicações via integração por pasta:
    • o parâmetro NumeroNFSE_CodigoVerificacao=... deverá ser adicionado no TX2;
  • Para realizar via Interface Web:
    • Selecione a nota desejada(apenas uma por vez), e clique no botão RESOLVE. Abrirá uma caixa de texto aonde deve ser informado a NumeroNFSE_CodigoVerificacao daquela nota separados por "_" conforme o exemplo.
      
      • Obs: O procedimento funcionará apenas quando:
        
        • A nota estiver com a situação ENVIADA;
        • Possuir um motivo de duplicidade;
        • E para apenas uma nota for selecionada.

• ATENÇÃO: a sincronização será realizada independente de que as informações contidas na nota emitida sejam diferentes da NFSe do portal da prefeitura. Portanto é necessário se certificar que o Código de Verificação e Número da NFSe sejam exatamente os correspondentes à nota resolvida.

Impressão

• Para realizar a impressão da NFSe pelo componente, deverá ser informado o XML de envio do RPS e o de Consulta de NFSe pois algumas informações são obtidas do XML de envio e que não estão no XML de consulta.
• Além do XML de envio do RPS, deverá ser informado os campos Customizados informados na seção "Campos customizados para a impressão". 
  • ATENÇÃO ao informar o XML do RPS referente a NFSe autorizada, para que não haja diferenças.
• O Padrão disponibiliza impressão via Link para os Municípios de Pedregulho-SP e São José do Rio Pardo-SP;

 

Geração do XML - Campos Importantes

 

• O padrão utiliza número de RPS sequencial e não faz uso da série do RPS e do Tipo RPS.
• Padrão não utiliza o campo CodigoTributacaoMunicipio e CodigoCnae.
• O campo DescricaoRPS será referente a tag OBSERVACAO do XML.
• Padrão não possui quebra de Linha.
• Caracteres especiais como: !@#$%*()'"-=+/.,:?][{}\/;.|:& < > " ' não devem ser informados pois o padrão EddyData não consegue ler esses valores que ocasiona em erros internos do WebService.
• Para múltiplos serviços, utilizar o campo ValorTotalIss para informar o valor total do mesmo.

 

Campos customizados para a impressão

 

Impressão do RPS

• InscricaoEstadualPrestador=String[20]
• InscricaoEstadualTomador=String[20]
• NumeroLicencaPrestador=String[20]
• NumeroLicencaTomador=String[20]
• TelefonePrestador=String[15]
• TelefoneTomador=String[15]
• ValorTotalServicos=String[15]
• IdentificacaoTomadorEstrangeiro=String[20]
• ValorLiquido=String[20]

 

Impressão da NFSe

• InscricaoEstadualPrestador=String[20]
• InscricaoEstadualTomador=String[20]
• NumeroLicencaPrestador=String[20]
• NumeroLicencaTomador=String[20]
• TelefonePrestador=String[15]
• TelefoneTomador=String[15]
• ValorTributosFederais=String[20]
• ValorTributosEstaduais=String[20]
• ValorTributosMunicipais=String[20]
• PorcentagemTributosFederais=String[20]
• PorcentagemTributosEstaduais=String[20]
• PorcentagemTributosMunicipais=String[20]
• IssDevido=String[20]
• IdentificacaoTomadorEstrangeiro=String[20]
• Competencia=String[10]
• NomeFantasiaPrestador=String[100]
• UfPrestador=String[2]
• CodigoServico=String[10]

 

 

Soluções Tecnospeed

 

• Componente NFSe:    Release 9.1.63.X.