Tópicos deste artigo

• Manual do webservice
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais
• Observações especificas por cidade
• Observações sobre a geração do XML
• Erros comuns
• Campos customizados para a impressão do RPS
• Campos customizados para a impressão da NFSe

Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção 
• Homologação (Para alguns municípios)

Métodos Disponíveis

• Envio
  • Não necessita envio sequencial¹ 
  • Síncrono
  • Assíncrono
  • Aceita envio de lote de RPS
• Consulta de NFSe por RPS
• Consulta de lote
• Consulta de NFSe
• Cancelamento de NFSe

¹ Não necessita que as notas sejam enviadas de forma sequencial.

Tipo de impressão

• A impressão pode ser feita via link da prefeitura.¹
• A impressão pode ser feita via layout próprio da Tecnospeed.²

¹Nossos produtos realizam o download do PDF da NFSe que foi gerado pela própria prefeitura.
² Nossos produtos geram o PDF da NFSe, se aproximando o máximo possível do layout da prefeitura.

Observações gerais

• O padrão faz uso de certificado digital;
• Possui quebra de linha;
• Para dúvidas diretamente com o sistema: suporte@notacontrol.com.br
• Cada município geralmente possuí uma série especifica;
• Aceita nota sem informação de tomador. Caso você seja cliente Plugnotas, não precisa mandar o nó "tomador". Para demais produtos, basta mandar os campos de tomador vazios no tx2;
• Atualmente o padrão conta com impressão via link e também RTM. No caso da impressão via link, é necessário ter o certificado do prestador configurado.

Observações especificas por cidade

Observações sobre a geração do XML

• O código do serviço segue o que está descrito na LC-116 sem ponto.

Erros comuns

• E029-O código de serviço prestado não permite retenção de ISSQN.  
  Preencha o ISSRetido como 0.
• E035-Código de tributação inexistente.
  Preencha o CodigoTributacaoMunicipio de acordo com a tabela.
  
• E043-Inscrição Municipal do prestador do serviço não encontrada na base de dados do município.
  Verifique no cadastro do emitente se a Inscrição Municipal está registrada corretamente e se o restante das informações de Tributação como Exigibilidade estão conforme a Ficha Cadastral do Prestador junto a Prefeitura.
• E090-Número do RPS inválido.
  Verifique se há numerações de RPS disponíveis no portal da prefeitura.
• E138-Usuário não autorizado a realizar o serviço.
  Esta rejeição poderá ocorrer devido ao certificado digital estar diferente do emitente. Ou, o prestador não ter permissão para consumir o WebService. Para habilitar o consumo do WebService, deve ser solicitado a liberação pelo contato suporte@notacontrol.com.br.
• E178-Lote aguardando processamento. 
  Webservice se encontra instável dado ao excesso de solicitações. Aguarde para resolver e verificar o retorno da nota.
• Unable to translate bytes [A0] at index 0 from specified code page to Unicode.
  Verificar se há caracteres em codificações distintas no arquivo de integração. Pode ser visto utilizando notepad++.
• E232 - Ocorreu um erro no processamento do arquivo. (Tente novamente mais tarde. Caso o problema persista, entre em contato com nosso suporte.) geralmente indica uma instabilidade no WebService da cidade. Nesse caso, é recomendado primeiro verificar no Portal se o registro realmente não foi autorizado. Nas situações de instabilidade, a única solução eficaz é continuar tentando a reemissão até que a nota seja aprovada.

Campos customizados para a impressão do RPS

• RazaoSocialPrestador=String[200]
• NomeFantasiaPrestador=String[200]
• EnderecoPrestador=String[200]
• NumeroEnderecoPrestador=String[200]
• ComplementoEnderecoPrestador=String[200]
• BairroPrestador=String[200]
• CepPrestador=String[50]
• TelefonePrestador=String[50]
• CodigoMunicipioPrestador=String[50]
• UfPrestador=String[10]
• FaxCelular=String[30]
• EmailPrestador=String[200]
• CnpjCpfIntermediario=String[50]
• InscricaoMunicipalIntermediario=String[50]
• RazaoSocialIntermediario=String[100]
• DescricaoCodigoTributacaoMunicipio=String[250]
• Aliquota=String[10]
• BaseCalculo=String[10]
• ValorIss=String[10]
• CodObra=String[50]
• Art=String[50]
• DescricaoCodigoTributacaoMunicípio=String[250]

Campos customizados para a impressão da NFSe

• FaxCelular=String[30]
• ResponsavelRetencao=String[100]
• CnpjCpfIntermediario=String[50]
• InscricaoMunicipalIntermediario=String[50]
• RazaoSocialIntermediario=String[100]
• CodObra=String[50]
• Art=String[50]