Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta Situação de lote.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Consultar Notas Tomadas.
• Cancelamento de NFSe.

Observações

• ATENÇÃO: antes de realizar a emissão de notas, verifique o cadastro do contribuinte no Portal da Prefeitura. É importante que os dados do mesmo estejam preenchidos, principalmente a Inscrição Municipal. A falta desses campos causará problemas na execução dos métodos disponíveis.
  • Caso os campos não estejam preenchidos, entre em contato com a prefeitura para realizar a atualização dos dados.
• Em alguns municípios desse padrão, não está disponível o cancelamento de notas por webservice em ambiente de homologação (no XML de envio de cancelamento, o código IBGE vai ser "0"). Neste caso, abrir ticket para o desenvolvimento confirmar se é possível implementar o cancelamento.
• Os dados de faturas/parcelas devem ser informados no tx2 padrão único da seguinte forma:
  • Exemplo.

INCLUIRFORMAPAGAMENTO
QuantidadeParcelas=3
TipoPagamento=3
Parcela=1
DataVencimentoParcela=2020-01-30
ValorParcela=0.10
SALVARFORMAPAGAMENTO

• Os dados de faturas/parcelas devem ser informados no tx2 da cidade da seguinte forma:
  • Exemplo.

INCLUIRCONDICAOPAGAMENTO
QtdParcelas=3
TipoPagamento=3
Parcela=1
DataVencimentoParcela=2020-01-30
ValorParcela=0.10
INCLUIRCONDICAOPAGAMENTO

• É possível utilizar o DataSet de Serviço para informar mais de um serviço.  

INCLUIRSERVICO
DiscriminacaoServico=DISCRIMINACAO DO SERVICO 1
QuantidadeServicos=1
ValorUnitarioServico=0.10
AliquotaServico=2
CodigoItemListaServico=1005
ValorServicosItem=0.10
BaseCalculoServico=0.10
ValorDeducoesServico=0.00
DescontoCondicionadoServico=0.00
DescontoIncondicionadoServico=0.00
SALVARSERVICO

• Não é possível informar os seguintes caracteres no campo 'DiscriminacaoServico' do TX2: 
  • '[', ']', '{', '}', '<', '>'. Pois os mesmos quebram a identação do XML.
  • Os mesmos serão retirados, caso forem informados.
• Os campos ValorDeducoesServico, DescontoCondicionadoServico e DescontoIncondicionadoServico são utilizados apenas no envio, no momento o layout de impressão do padrão não os utiliza.

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
• Não é obrigatório informar o código CNAE, entretanto, caso informado será gerado no XML.
  • Código CNAE segue a tabela nacional com 7 digítos.
• Tanto a emissão através do portal ou via webservice, não utilizam o código de tributação do município, entretanto, caso informado será gerado no XML.
  • 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.
• Acentuação muitas vezes causa problema de rejeição no servidor. Devido a isso está sendo removido os acentos do RPS.

Campos customizados para a impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualPrestador=String[40]
• EnderecoPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[80]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• UfPrestador=String[2]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• CelularPrestador=String[20]
• NomeFantasiaTomador=String[80]
• InscricaoEstadualTomador=String[40]
• CelularTomador=String[20]
• SitePrestador=String[80]
• ValorTributoFederal=string[20]
• ValorTributoEstadual=string[20]
• ValorTributoMunicipal=string[20]
• PorcentagemTributoFederal=string[20]
• PorcentagemTributoEstadual=string[20]
• PorcentagemTributoMunicipal=string[20]
• Pagamento=string[80]
• ValorTTS=string[20]
• ValorTotal=string[20]  (Este campo aparecerá na impressão apenas se o ValorTTS também estiver preenchido)

Impressão da NFSe

• InscricaoEstadualPrestador=String[40]
• InscricaoEstadualTomador=String[40]
• CelularPrestador=String[20]
• SitePrestador=String[80]
• NomeFantasiaTomador=String[80]
• CelularTomador=String[20]
• ValorTributoFederal=string[20]
• ValorTributoEstadual=string[20]
• ValorTributoMunicipal=string[20]
• PorcentagemTributoFederal=string[20]
• PorcentagemTributoEstadual=string[20]
• PorcentagemTributoMunicipal=string[20]
• Pagamento=string[80]
• ValorTTS=string[20]
• ValorTotal=string[20]  (Este campo aparecerá na impressão apenas se o ValorTTS também estiver preenchido)

 Impressão da NFSe - DataSet Parcelas (verificar observação acima)

• Parcela=String[255]
• Vencimento=String[255]
• Valor=String[255]

Soluções Tecnospeed

• Componente NFSe:  Release 8.7.45.X.
• Manager eDoc:   Release 3.0.79.X