Manual de integração com a prefeitura

Download Manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio:
  • Síncrono.
• Consulta de NFSe.
• Consulta de NFSe Por Rps
• Cancelamento de NFSe.
• Substituição de NFSe.

Observações

• Não possui envio em lote;
• Não possui quebra de linha;
• É necessário entrar em contato com a prefeitura da cidade para liberação da utilização do webservice;
• É necessário informar o Token adquirido no portal da prefeitura;
• O Token será informado como parâmetro extra em "Senha" da seguinte forma:
  Senha=1234ABCdE567FG8hijkl90mno
• Para o ambiente de homologação deve ser informado o seguinte token e IM do Prestador:
  Senha=9f16d93554dc1d93656e23bd4fc9d4566a4d76848517634d7bcabd5731e4948f
  A Inscrição Municipal do prestador deverá ser 670 para o envio em homologação
• O retorno "ATENCAO AMBIENTE DE TESTE PARA VALIDACAO DE INTEGRACAO" indica que é necessário que o prestador entre em contato com a prefeitura para solicitar uma alteração cadastral da empresa em questão e "colocá-la em modo de produção" no cadastro.
• Para realizar a impressão de NFSe é necessário utilizar o xml de consulta e também o xml de envio.
• O padrão não aceita acentos e caracteres especiais dentro dos campos de Descrição.

Cancelamento de uma NFSe

• Para algumas cidades o cancelamento não está disponível, sendo necessário realizar uma substituição para cancelar.

Geração do XML - Campos Importantes

• Código CNAE segue a tabela nacional com 7 dígitos.
• O campo do XML "Codigo" será populado pelo campo de tx2 "CodigoItemListaServico". Para clientes PlugNotas campo "servico.codigo"

Erros comuns

• Access Violation at address 009053D
  Refere-se ao preenchimento incorreto do parâmetro Senha. Verifique se o token está sendo enviado corretamente.
  
• $CL' is not a valid integer value ()

        verifique se não foi informada a senha de acesso a portal da prefeitura do prestador ao invés do  token da API

• IB-E000 - Message content is not a valid JSON value, pode acontecer nas seguintes situações:
  • Os campos 'CodigoTributacaoMunicipio' e 'CodigoCnae' podem estar diferentes do cadastrado no portal da prefeitura. Exemplo: CodigoTributacaoMunicipio enviado: 0602, porém, no portal é 602, ou vice e versa.
  • O campo 'IM' relacionado ao prestador deve ser exatamente igual ao cadastrado no portal.
  • O campo 'NumeroRps' receber valor como '0002'. Deve-se passar números fixos. Exemplo '2'.
  • Campo CEP do tomador não informado.

Campos customizados para a impressão

Impressão do RPS

• CnpjPrestador=string[15]
• CpfPrestador=string[15]
• InscricaoEstadualPrestador=string[15]
• RazaoSocialPrestador=String[150]
• NomeFantasiaPrestador=String[60]
• EnderecoPrestador=String[125]
• NumeroPrestador=String[10]
• ComplementoPrestador=String[60]
• BairroPrestador=String[60]
• MunicipioPrestador=String[7]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• InscricaoMunicipalTomador=String[15]
• InscricaoEstadualTomador=String[15]
• ValorServicosItem=String[15]
• SimplesNacional=String[5]
• Recolhimento=String[80]

Impressão da NFSe

• InscricaoMunicipalTomador=String[15]
• InscricaoEstadualTomador=String[15]
• InscricaoEstadualPrestador=String[15]
• SimplesNacional=String[5]
• ValorServicosItem=String[15]
• NaturezaOperacao=String[50]
• Recolhimento=String[80]
• PercentualTributos=String[15]
• AssinaturaDigitalAntiga=String[50]