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 de NFSe.

Observações

• Formato de Autenticação: "Login=99999999999999;senha=123"
• Para a consulta de NFSe, deve ser informado o código verificador de autencidade
• Para o Cancelamento é necessário utilizar a chave numeroNFSE|chaveCancelamento___
• No cancelamento, também é possível informar o parâmetro extra MotivoCancelamento. Ex: Login=00000000000000;Senha=123;MotivoCancelamento=Teste
  • Por ser um valor obrigatório no XML, caso não seja informado nada no MotivoCancelamento o componente preenche com a seguinte mensagem: NFSe cancelada à pedido do prestador.
  • Em alguns casos, ao informar algum valor no MotivoCancelamento, recebemos a seguinte mensagem no XML de retorno do cancelamento: "Erro na estrutura do arquivo XML enviado. Verifique a estrutura da tag NFSE". Passar o MotivoCancelamento em branco poderá resolver.
• Impressão de RPS pelo componente disponível.
• Caso o tomador seja órgão público informar o campo no campo DescricaoDocumentoTomador o valor "OP".

• A partir do dia 01/06/2020 o padrão IPM possuirá a inclusão de múltiplas parcelas. O preenchimento no arquivo TX2 de integração fica conforme exemplo abaixo: 

  INCLUIRFORMAPAGAMENTO
  
  TipoPagamento=1 -> Tipo da forma de Pagamento, verificar possíveis valores abaixo.
  
  Parcela=1 -> Número da parcela
  
  DataVencimentoParcela=2020-05-27 -> Data do vencimento da parcela, deve estar no formato yyyy-mm-dd
  
  ValorParcela=2.00 -> Valor da parcela.
  
  SALVARFORMAPAGAMENTO
  
   
  
  Valores referentes ao tipo da forma de pagamento:
  
  1 - À vista
  2 - À prazo
  3 - Na Apresentação
  4 - Cartão de Débito
  5 - Cartão de Crédito 

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
  • Caso não esteja utilizando o TecnoNFSe, o código deve ser informado sem pontuação.
• O campo CodigoCNAE não é utilizado no esquema. E o campo CodigoTributacaoMunicipio é facultativo.
• Caso não esteja utilizando o padrão único, a alíquota deve ser informada com o valor inteiro, utilizando ',' para separador decimal. Ex: Aliquota=5,00.

Campos customizados para a impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[10]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[20]
• CepPrestador=String[20]
• TelefonePrestador=String[40]
• EmailPrestador=String[40]
• InscricaoEstadualPrestador=String[15]

Impressão da NFSe

A impressão de NFSe pode ser feita por um link retornado no envio e na consulta. Para obter esse link, basta utilizar o comando auxiliar ObterLinkImpressaoNFSe ou pode ser feita através do comando ObterPDF onde o PDF da nota é baixado, conforme exemplo abaixo:

Parâmetros:

• Xml de uma NFSe Autorizada.
• Caminho completo e o nome do PDF.

Exemplo de implementação:

 Resposta:

'Impressão realizada na pasta: H:\ImpressaoIPM.pdf'

Soluções Tecnospeed

• Componente NFSe:  Release 8.7.50.X.
• Manager eDoc:   Release 3.0.84.X.