---

Tópicos deste artigo

• Manual do webservice
• Portais disponíveis
• Métodos disponíveis
• Tipo de impressão
• Observações gerais
• Observações específicas 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

 

 

Métodos Disponíveis

• Envio 
  • Assíncrono.
  • Não necessita envio sequencial.¹
  • Aceita o envio de lote de RPS.
• Consulta Situação de lote.
• Consulta de lote.
• Consulta de NFSe por RPS.
• Consulta de NFSe.
• Consulta de Notas Tomadas.
• Cancelamento de NFSe.
• Consulta de RPS ao Descartar.

 

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

Tipo de impressão

• A impressão é feita via link da prefeitura.¹

 

¹ Nossos produtos realizam o download do PDF da NFSe que foi gerado pela própria prefeitura.

Observações gerais

• Padrão exige que o prestador solicite autorização para emitir via WebService. A Solicitação deve ser feita a prefeitura do prestador. 
• O cancelamento em algumas cidades do padrão GINFES deve ser feito junto à prefeitura por conta da indisponibilidade do serviço via webservice. 
• No cancelamento, pode-se informar o parâmetro Extra MotivoCancelamento para impressão.
• O fornecedor aconselha que consultas simultâneas não sejam feitas, visto que o Webservice pode bloquear temporariamente o CNPJ do prestador caso isso aconteça. Dessa forma, é fortemente recomendado que todas as notas sejam enviadas em um único lote.
• O Padrão GINFES não disponibiliza um serviço específico para Consulta de notas Tomadas. Como forma paliativa foi disponibilizada a Consulta de NFSe com a possibilidade de informar os dados do Tomador na Consulta, assim como o período da pesquisa.
• O padrão não aceita data de emissão futura, então deve ser enviado tanto a data de competência quando a data de emissão do RPS com a data atual ou inferior à data atual para cidades que aceitarem.
• No layout do padrão existe apenas o campo DataEmissao no XML, não havendo tag para DataCompetencia, caso seja enviado a competência do RPS no arquivo de integração, iremos usar esta data para preencher a tag DataEmissao no XML.
• O erro: 
  E78 - Número da NFS-e inexistente na base de dados para o prestador de serviço pesquisado.
  Pode ser retornado no cancelamento, caso a cidade tenha trocado o sistema para GissOnline, para resolver, é necessário adicionar a tag CancelamentoV3=1 no nfseLocais.ini. 

 

 

Observações especificas por cidade

Cidade	Observação
Fortaleza/CE	Para consultas de NFSe é obrigatório informar o certificado digital na requisição.
Piedade/SP	O CodigoTributacaoMunicipio é o CodigoItemListaServico com ponto. Por exemplo: 10.02
São Bernardo do Campo/SP	Para consultas de NFSe é obrigatório informar o certificado digital na requisição.

 

 

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

• 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. O Código CNAE segue a tabela nacional com 7 digítos.
• CodigoTributacaoMunicipio é o código da atividade listada no portal, podendo ser encontrada quando realizada a emissão manual "Código do Serviço/Atividade: Ex: 10.02/7490104", sendo assim, 7490104 seria o código de tributação do município.
• Quando utilizado padrão do município à alíquota deve ser dividido por 100.
• Ao enviar o caracter & no Xml de envio, apresentou erro de Falha de Schema junto ao Webservice do padrão. Portanto retiramos esse caracter ao realizar a geração do Xml para evitar esse problema.

 

 

Erros comuns

• Falha na comunicação com WebService-<faultstring>Fault occurred while processing.</faultstring>
    Pode ser indicativo de instabilidade no webservice. Tente reenviar a nota mais tarde.
• A1 - Alguns dos dados informados não constam do cadastro do contribuinte. (O tipo do serviço prestado não está registrado no cadastro do contribuinte. Procure a Prefeitura para registrar os códigos de tributação, códigos de serviço, códigos da subclasse CNAE ou o item da lista da Lei Complementar correspondentes aos serviços prestados pela empresa).
    Pode ocorrer quando não for informada a Inscrição municipal do tomador de Serviços quando ele for da mesma cidade do prestador. Veja como resolver. 

 

 

Campos customizados para a impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoCidadePrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• ComplementoEnderecoPrestador=String[20]
• BairroPrestador=String[40]
• CepPrestador=String[8]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• DeducoesIss=String[40]
• DescontoIncondIss=String[40]
• RetencoesFederais=String[40]

 

Campos customizados para a impressão da NFSe

• MotivoCancelamento=String[80]
• DeducoesIss=String[40]
• DescontoIncondIss=String[40]
• DescricaoLocalPrestacao=String[40]
• RetencoesFederais=String[40]

 

 

Soluções Tecnospeed

 

• Componente NFSe:     Release 7.7.43.X.
• Manager eDoc:     Release 2.0.77.X.