Tópicos deste artigo

• Manual do web service
• Portais disponíveis 
• Métodos disponíveis 
• Tipo de impressão
• Observações gerais
• Observações específicas por cidade
• Emissão pelo PlugNotas
• Emissão pelo ManagerEDoc/Saas
• Emissão pelo componente
• 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
  
  

Métodos disponíveis

• Envio.
  • Síncrono
  • Assíncrono
  • Não necessita envio sequencial¹
  • Aceita envio de lote de RPS
• Consulta de lote
• Consulta de NFSe por RPS
• Consulta de NFSe
• Consultar Notas Tomadas
• Cancelamento de NFSe. (Para algumas cidades é feito por substituição)

 

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

Tipo de impressão

• A impressão é feita via layout próprio da Tecnospeed¹

¹Nossos produtos geram o PDF da NFSe, se aproximando o máximo possível do layout da prefeitura.

Observações gerais

• É obrigatório a informação de login e senha para todos os métodos de comunicação.
•  Recomenda-se a utilização do envio síncrono, pois as notas enviadas no envio assíncrono são processadas somente as 2h da manhã de cada dia.
• Para a emissão das notas no ambiente de homologação:
  • Enviar um email para pedro.fonseca@fiorilli.com.br ou fernando.vendite@fiorilli.com.br com os seguintes dados do prestador a ser liberado : Razão Social; CNPJ; Endereço completo e E-mail de contato.
  • Após receber a confirmação, na emissão utilize o certificado do prestador cadastrado e utilize os dados de um usuário de testes liberado pela prefeitura: CNPJ=01001001000113, IM:15000, Login=01001001000113, Senha=123456.
    
  • No cancelamento em Homologação, o parâmetro extra CodigoMunicipio a ser informado deverá ser 3504800, pois o servidor de Homologação é situado em Bálsamo - SP;
• Para algumas cidades desse padrão, o cancelamento deverá ser feito através do método de substituição, de uma nota já emitida.
• No cancelamento deverá ser informado o código de cancelamento e o código IBGE do munícipio. Se este não for informado, será assumido o valor do município que está configurado.
  
• Códigos de cancelamentos aceitos: 
  
  • 1- Erro na emissão
  • 2 – Serviço não prestado
  •  3 – Erro de assinatura
  • 4 – Duplicidade da nota
  • 5 – Erro de processamento
  • Os códigos 3  e 5 são de uso restrito da Administração Tributária Municipal.
• Através do site de NFSe disponibilizado pela prefeitura da cidade é possível emitir notas com mais de um item, porém pelo WebService não é possível de acordo com o schemas.xsd. Ao consultar notas emitidas com mais de um item é retornado apenas o último item da nota. Devido a isso não é possível emitir e imprimir notas com mais de um item.

 

 

Observações específicas por cidade

Cidade	Observação
Monte Alto/SP	Não precisa de assinatura e certificado digital.
Chapadão do Sul/MS	O cancelamento só poderá ser feito a partir do método de substituição de uma nota já emitida

 

 

Emissão pelo PlugNotas

• Requer configuração de login e senha: 
  
  Exemplo de configuração da senha  pela Interface do PlugNotas
  
  
  

 

Exemplo de configuração de login e senha através da API

 

 

Emissão pelo ManagerEdoc/ManagerSaaS

• Como o cancelamento para algumas cidades desse padrão, só poderá ser feito a partir do método de substituição de uma nota já emitida. Para realizar esse procedimento no EDoc/SaaS, será necessário informar no TX2 de envio apenas o campo NumeroNfseSubstituida. Exemplo:  
  • Para cancelar a nota de número 100 e substitui-la por um novo RPS, deverá ser informado o seu número no campo "NumeroNfseSubstituida=100" . 
  • Para sincronizar a nota que foi cancelada, basta usar a rota RESOLVE.
    
    
• Requer configuração de login e senha: 

Exemplo de configuração da senha  pela Interface do Edoc/Saas:

 

 

Emissão pelo componente

• No cancelamento, pode-se informar o parâmetro Extra CodigoMunicipio, referente ao código IBGE do município. Se este não for informado, o componente assumirá este valor do município que está configurado. Ex: _XML := ProxyNFSe.CancelarNota('123', 'CodigoMunicipio=3504800');
• Os dados de login e senha deve ser informado no parâmetro extra

Exemplo: 

NFSe.ParametrosExtras = "Login=33333333333;Senha=123abc";

 

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

• O código do serviço segue o que está descrito na LC-116.
• O padrão em questão possui uma formatação diferente para o código de tributação do município. O formato é o código da atividade (000010) + código atividade desdobro (0000005). Essa informação pode ser encontrada no portal da cidade, na opção "Consultar alíquotas".
• O código CNAE não tem nenhuma informação específica, mas também não é obrigatório. 

 

 

Erros comuns

• Erro L78 - "Não existe setor cadastrado para encaminhar o protocolo de recebimento de lote. Configure um setor correspondente para encaminhamento de tramites na prefeitura"
   Nesse caso, o erro está na integração da prefeitura com o sistema da FIORILLI, é necessário entrar em contato com o responsável da prefeitura para a normalização do sistema.

• ERRO L4 - "Estrutura do xml recebido incorreta. javax.xml.bind.MarshalException - with linked exception:[org.xml.sax.SAXParseException lineNumber: 0 columnNumber: 0 cvc-complex-type.2.4.d: Invalid content was found starting with element 'ns2:Signature'. No child element is expected at this point.]. (Valide as tags do xml antes de enviar.)."
  Quando acontecer esse erro é porque a cidade não aceita assinatura, nesse caso deve ser incluído o campo AssinaturaDesabilitada=1 no nfseLocais.ini.
  
  
• Erro na assinatura
   Esse padrão possui cidades que aceitam uma, mais de uma ou nenhuma assinatura, ou seja, caso ocorra problema de assinatura na emissão, aconselhamos emitir com assinatura diferente do que está atualmente. A FIORILLI possui um validador de XML em seu portal disponível em todas as cidades.
  
  

Campos customizados para a impressão do RPS

• NomeFantasiaPrestador=String[80]
• RazaoSocialPrestador=String[80]
• EnderecoPrestador=String[80]
• CodigoMunicipioPrestador=String[10]
• UfPrestador=String[2]
• NumeroEnderecoPrestador=String[7]
• BairroPrestador=String[40]
• ComplementoEnderecoPrestador=String[20]
• CepPrestador=String[10]
• TelefonePrestador=String[20]
• EmailPrestador=String[80]
• TipoISS=String[50]
• NomeFantasiaTomador=String[50]
• RgPrestador=String[20]
• InscricaoEstadualPrestador=String[20]
• RgTomador=String[20]
• InscricaoEstadualTomador=String[20]
• RgIntermediario=String[20]
• InscricaoEstadualIntermediario=String[20]
• NomeFantasiaIntemediario=String[50]
• Quantidade=String[10]
• UnidadeDeMedida=String[20]
• ValorUnitario=String[20]
• Total=String[20]
• NumeroNfse=String[20]
• ValorLiquidoRps=String[20]
• InformacoesComplementares=String[200]

 

 

Campos customizados para a impressão da NFSe

• TipoISS=String[50]
• CodigoCadastro[50]
• NomeFantasiaTomador=String[50]
• RgPrestador=String[20]
• InscricaoEstadualPrestador=String[20]
• RgTomador=String[20]
• InscricaoEstadualTomador=String[20]
• RgIntermediario=String[20]
• InscricaoEstadualIntermediario=String[20]
• NomeFantasiaIntemediario=String[50]
• Quantidade=String[10]
• UnidadeDeMedida=String[20]
• ValorUnitario=String[20]
• Total=String[20]
• InformacoesComplementares=String[200]

 

 

Soluções Tecnospeed

 

• Componente NFSe:  Release 8.7.45.X.
• Manager eDoc:   Release 3.0.79.X