Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Assíncrono.
  • Síncrono.
• Consulta Situação de lote.
• Consulta de lote.
• Consulta de NFSe por RPS - Somente para notas enviadas em modo assíncrono.
• Consulta de NFSe.
• Cancelamento de NFSe.

• Apesar de passar pelo método assinar, o XML não possui as tags de assinatura.
• É obrigatório informar Login e Senha para todos os métodos: EnvioDeLote Síncrono e Assíncrono, Consultas e Cancelamento. Exemplo:
• Login deve ser informado sem mascaras. 
  • Exemplo Componente:
    • _Extras := 'Login=01234567890123;Senha=0123';
    • _XML := ProxyNFSe.EnviarSincrono(mmXML.Text, _Extras);
  • Exemplo Manager Edoc/SaaS: Para informar o Login e a senha do emitente, basta logar na interface web / Selecionar o documento NFSe / Aba - Autenticação da Prefeitura.
• Para gerar XML para o Envio Síncrono é necessário informar o parâmetro extra EnvioSincrono=true;
  • Componente:
    • Exemplo: _XML := spdNFSeConverterX.ConverterEnvioNFSe(OpnDlgTx2.FileName, 'EnvioSincrono=true');
  • Manager Edoc/SaaS: Para utilizar o envio síncrono, basta logar na interface web / Selecionar o documento NFSe / Configurações / Geral - marcar o checkbox "Utiliza envio síncrono". Ou utilizar a rota modo informando EnvioSincrono=1;
• É possível incluir mais de um serviço na nota, separando por quantidade, valor e discriminação, porém apenas um CodigoItemListaServico é aceito na nota, portanto o CodigoItemListaServico só deve ser informado dentro do INCLUIRRPS e fora do INCLUIRSERVICO e SALVARSERVICO, basta informar os novos itens, com os seguintes campos (Para maiores esclarecimentos, ver arquivo anexo Mult_Serv_Piracicaba.tx2):                                                                               

  INCLUIRSERVICO
  ValorUnitarioServico=1.00
  QuantidadeServicos=1
  ValorServicos=1.00
  DiscriminacaoServico=Teste Serv 2
  SALVARSERVICO
  
  INCLUIRSERVICO
  ValorUnitarioServico=2.00
  QuantidadeServicos=1
  ValorServicos=2.00
  DiscriminacaoServico=Teste Serv 2

  Exemplo de impressão de múltiplos serviços emitido pelo componente:                                             

• No momento do primeiro envio via webservice, poderá ocorrer as seguintes rejeições: 
  • E138-CNPJ não autorizado a realizar o serviço. (Informe o CNPJ autorizado a executar o serviço.):
  • E157-Usuário não está autorizado a utilizar esse serviço para esse contribuinte. (Solicite ao contribuinte autorização para utilizar o serviço em seu nome.)
  • Para ambos os casos, será necessário que o contribuinte ou algum responsável por ele que possua acessos e permissões, providencie a liberação para utilização de RPS via webservice no portal SIMPLISS (no menu chat online) ou entrando em contato com o departamento fiscal da prefeitura.
• O erro "<faultstring xml:lang="pt-BR">The server was unable to process the request due to an internal error" Pode ser causado devido a caracteres especiais ou acentuação em qualquer campo do XML/TX2, isso é válido para traços no CEP, por exemplo. 

 if (ProxyNFSe.ComponenteNFSe.ConfiguracoesImpressao.ModoImpressao = printNFSe) and (ProxyNFSe.ComponenteNFSe.ColecaoAtiva.Name = 'Simpliss') then
 begin
   with ProxyNFSe.ComponenteNFSe.Impressao.Parte('Servicos') do
   begin
     First;
     while not Eof do
     begin
       Editar;
         Campo('TotalItem').AsString := '500.00';
       Salvar;
       Next;
     end;
   end;
 end; 

DadosImpressao=Editar=Servicos|TotalItem=10.20|Salvar=Servicos|Proximo=Servicos|Editar=Servicos|TotalItem=20.20|Salvar=Servicos

ATENÇÃO: no Manager eDoc/SaaS serão barrados os fluxos de DESCARTE e RESOLVE para notas que tenham sido enviadas em modo síncrono e estejam em situações intermediárias. Isso acontecerá devido ao fato de que o envio Síncrono não valida os identificadores do RPS informados no XML. Com isso evitaremos duplicar notas que já tenham sido emitidas.

Caso a nota esteja AUTORIZADA na prefeitura, mas não no Manager eDoc/SaaS: será possível realizar uma tentativa de sincronização dessa nota utilizando a rota RESOLVE. Deverá ser informado o parâmetro NumNFSeConsulta, preenchido com o número da nota já autorizada. Com isso será realizado uma comparação entre os dados da nota consultada(NumNFSeConsulta) e os dados da nota enviada(eDoc/SaaS). A mesma só ficará com a situação AUTORIZADA/CANCELADA se os dados forem os mesmos. 

Exemplo dos parâmetros:

Ou seja, será realizado uma tentativa de sincronizar a nota referente ao Handle=1, com os dados da nota NumNFSeConsulta=2 (Número da NFSe).

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.

Campos customizados para a impressão

Impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• InscricaoEstadualPrestador=String[15]
• EnderecoPrestador=String[80]
• NumeroEnderecoPrestador=String[10]
• BairroPrestador=String[80]
• ComplementoEnderecoPrestador=String[20]
• CodigoMunicipioPrestador=String[7]
• UfPrestador=String[2]
• CepPrestador=String[8]
• EmailPrestador=String[80]
• TelefonePrestador=String[20]
• OutrasInformacoes=String[2000]
• InscricaoEstadualTomador=String[15]
• TotalItem=String[15]
• ValorImposto=String[20]
• PorcentagemImposto=String[20]
• AliquotaPis=String[5]
• AliquotaCofins=String[5]
• AliquotaInss=String[5]
• AliquotaIr=String[5]
• AliquotaCsll=String[5]
• ValorTributavel=String[20]
• ValorNaoTributavel=String[20]
• ValorImpostoFederal=String[20]
• ValorImpostoEstadual=String[20]
• ValorImpostoMunicipal=String[20]

Impressão da NFSe

• InscricaoEstadualPrestador=String[15]
• MotivoCancelamento=String[100]
• ValorImposto=String[20]
• PorcentagemImposto=String[20]
• AliquotaPis=String[5]
• AliquotaCofins=String[5]
• AliquotaInss=String[5]
• AliquotaIr=String[5]
• AliquotaCsll=String[5]
• ValorTributavel=String[20]
• ValorNaoTributavel=String[20]
• ValorImpostoFederal=String[20]
• ValorImpostoEstadual=String[20]
• ValorImpostoMunicipal=String[20]

Soluções Tecnospeed

• Componente NFSe:   Release 7.7.36.X.
• Manager eDoc:  Release 2.0.70.X