Manual de integração com o webservice
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 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
Comentários
0 comentário
Por favor, entre para comentar.