Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção

Métodos Disponíveis

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

Observações

• 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 e é necessário entrar em contato com o técnico responsável da prefeitura para a normalização do sistema.
• Erro na assinatura: Esse padrão possui cidades que aceitam 1, mais de 1 ou nenhuma assinatura, ou seja, caso ocorra problema de assinatura na emissão, aconselho emitir com assinatura diferente do que está atualmente. A Fiorilli possui um validador de xml em seu portal disponível em todas as cidades;
• 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.
•  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;
•  
• É obrigatório a informação de login e senha para todos os métodos de comunicação. Ex: _XML := ProxyNFSe.EnviarSincrono(mmXML.Text, 'Login=XXXXXXXXX;Senha=XXXXXX');
• Para a emissão das notas no ambiente de homologação:
  • Enviar um email para pedro.fonseca@fiorilli.com.br com os seguintes dados do prestador a ser liberado : Razão Social, CNPJ, Endereço completo e Email 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;
• Para gerar um XML compatível com o envio síncrono via Tx2, é necessário informar o parâmetro extra EnvioSincrono=True. Ex: _XML := spdNFSeConverterX.ConverterEnvioNFSe(OpnDlgTx2.FileName, 'EnvioSincrono=True');
• Para gerar um XML compatível com o envio síncrono via Dataset, é necessário setar a propriedade MappingFileName com o valor 'MappingEnvioSincrono.txt'.
• No cancelamento, pode-se informar o parâmetro Extra CodigoCancelamento. Se este não for informado, o componente assumirá este valor como 2 (Serviço não prestado). Ex: _XML := ProxyNFSe.CancelarNota('123', 'CodigoCancelamento=0'); Códigos Disponíveis na Pagina 26 do manual
• 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');
• 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;
• 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.

Cancelamento por Substituição

Para algumas cidades do padrão Fiorilli (Ex: Chapadão do Sul - MS) o cancelamento 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. (Obs: Não informar os campos de RpsSubstituido). 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.

Geração do XML - Campos Importantes

• 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). Ess 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. 

Campos customizados para a impressão

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]

Impressão da NFSe

• 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]
• InformacoesComplementares=String[200]

Soluções Tecnospeed

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