Manual de integração com o webservice

Manual é disponibilizado de acordo com cada prefeitura.

Portais Disponíveis

• Produção

Métodos Disponíveis

• Envio.
  • Assíncrono.
  • Síncrono.
• Consulta de Lote.
• Consulta de NFSe.
• Consulta de NFSe por RPS

Observações

• O Xml de retorno do Envio Síncrono não é valido para a impressão, sendo assim, deve ser utilizado os métodos de consulta de NFSe ou Consulta de NFSe por RPS.
• Envio em lote permitido apenas para o método Assincrono.
• É necessário solicitar liberação na prefeitura para emitir pelo WebService
• O campo Login deve ser configurado sem máscara.
• No caso em que um prestador possuir matriz e filiais, é possível emitir notas pelo CNPJ da filial utilizando o certificado da matriz. Para isso, deve ser inserido o CNPJ da matriz nos parâmetros extras de todos os métodos do componente. Exemplo: "CnpjMatriz=11111111111111"
• No SaaS, na Autenticação da prefeitura, o campo Login deve ser preenchido com a informação de CNPJ da Matriz, Exemplo: login=11111111111111, caso o prestador possua filiais e deseja utilizar o certificado da matriz.
• Em casos do erro: 1 - Lote nao encontrado com o numero 1. É necessário solicitar o credenciamento do contribuinte junto a prefeitura para emissão em lote. 
• Em casos do erro: 1497-Verificar se nao houve informacao de retencao indevida no RPS para empresa fora de Campinas. É necessário que a inscrição municipal do tomador esteja preenchida.
• Em casos do erro: 1465-Tomador e um Substituto Tributario no Cadastro do Municipio. Por este motivo, o prestador nao podera emitir RPS como A recolher. Favor cancelar e emitir um novo RPS com imposto Retido na Fonte. É necessário preencher o campo TipoTributacao com o valor 5
• Em casos do erro: 1433 - Contribuinte nao credenciado para o metodo de integracao com a NFSe utilizado. Contribuinte credenciado para emitir NFS-e pelo site, para possibilitar a entrega em Lote deve ser solicitado junto a prefeitura a alteração no credenciamento para habilitar entrega em lote. É necessário solicitar o credenciamento do contribuinte junto a prefeitura para emissão via WebService (algumas prefeituras solicitam, também, o envio de um PDF com protocolo de RPS).
• Caso o tomador for um consumidor não identificado informar no campo CPFCNPJTomador o valor ‘77777777777’, no campo RazaoSocialTomador informar ‘Consumidor’
  e nos campos TipoLogradouroTomador, LogradouroTomador, TipoBairroTomador, BairroTomador
• EmailTomador informar o valor ‘-’ quando não possuir essa informação. No campo NumeroEnderecoTomador informar valor zero e no campo CEPTomador informar
  ‘00000000’.
• Caso o tomador for estrangeiro informar no campo CidadeTomador o valor ‘9999’ e no
  campo CidadeTomadorDescricao informar o nome do país, no campo CepTomador informar ‘00000000’.
• Caso o município de prestação for no exterior informar no campo MunicipioPrestacao o
  valor ‘9999’ e no campo MunicipioPrestacaoDescricao informar o nome do país.
  Quando a situação do RPS for cancelada, deve se informar o motivo do cancelamento
  no campo MotCancelamento.

Geração do XML - Campos Importantes

• O código do serviço segue o que está descrito na LC-116.
• Para algumas cidades do padrão, ao enviar um Item do SubItens 7.02, 7.04 e 7.05, a prefeitura exige a Inscrição Municipal da Obra, para isso, basta passar a inscrição no campo CodigoObra.
• Para cidade de Sorocaba é obrigatório o envio do CNAE, sendo este um código proprietário do município que contém 9 dígitos e pode ser encontrado no portal da prefeitura na aba "Configuração Empresa".

Campos customizados para a impressão

Impressão do RPS

• CPFCNPJPrestador=String[14]
• EnderecoPrestador=String[80]
• CidadePrestador=String[8]
• CidadePrestadorDescricao=String[30]
• UFPrestador=String[2]
• UFTomador=String[2]
• ValorISS=String[10]
• ItemListaServico=String[256]
• NomeBairroTomador=String[50]
• ValorCredito=String[10]
• ValorLiquido=String[20]
• ValorTotalComposicao=[8]

Impressão da NFSe

• CPFCNPJPrestador=String[14]
• EnderecoPrestador=String[80]
• CidadePrestador=String[8]
• CidadePrestadorDescricao=String[30]
• UFPrestador=String[2]
• UFTomador=String[2]
• ValorISS=String[10]
• ItemListaServico=String[256]
• DataCancelamento=String[15]
• NomeBairroTomador=String[50]
• DataVencimentoISSQN=String[20]
• OptanteSimplesNacional=String[2]
• ValorTotal=String[10]
• ValorLiquido=String[20]
• HoraEmissao=String[8]
• DescricaoNBS=String[256]
• ValorTotalComposicao=[8]

Soluções Tecnospeed

• Componente NFSe:     Release 8.7.53.X.
• Manager eDoc:  Release 3.0.87.X