Manual de integração com o webservice
Portais Disponíveis
- Produção
- Homologação
Métodos Disponíveis
- Envio.
- Assíncrono.
- Consulta situação de lote.
- Consulta de lote.
- Consulta de NFSe por RPS.
- Consulta de NFSe.
- Cancelamento de NFSe.
Observações
- Para liberação de emissões para prefeituras no padrão Equiplano inicialmente é necessário fazer solicitação de acesso e testes no ambiente de homologação diretamente no portal de testes. Após os testes com sucesso, é necessário pedir liberação de RPS no portal e também na prefeitura para emissões em produção.
- Mesmo enviando o valor do ISS vlIssServico o webservice faz o cálculo com base na alíquota.
- Para impressão da NFSe são utilizados os campos enviados no RPS.
- WebService instável, pode ocorrer erro de assinatura mesmo estando tudo correto.
- 1053-Rejeição: Certificado Assinatura - Erro Cadeia de Certificação.
- É permitido o envio de lote para o município.
- Obs: Webservice com processamento lento, não aconselhamos utilizar envio em lote.
- O retorno do web service apresenta falha ao enviar notas com acentuação, é recomendado que envie notas sem acentuação.
- Padrão possuí múltiplos serviços para cada RPS. Utilize o tx2 em anexo "TecnoNFSe_MultiplosServicos.tx2".
- A tag <idEntidade> é formada pelo campo CodigoCidadeRemetente=X, onde "X" é um código próprio definido pela Equiplano para cada prestador. Esse código pode ser visualizado ao acessar o portal da prefeitura, ficando no canto superior da tela, ao lado do nome e da logo do município.
- Os erros "O RPS ainda não foi convertido em NFS-e" e "O RPS informado já foi convertido em NFS." podem indicar falta de liberação de RPS no portal da prefeitura, verifique dentro do portal em -> RPS -> Último RPS utilizado
- O campo "CodigoSubItemListaServico" é obrigatório e deve ser obtido na prefeitura.
- Esse padrão não possui campo de desconto em seu layout, então caso seja preenchido DescontoCondicionado ou DescontoIncondicionado os mesmos serão ignorados. Uma alternativa é usar o campo ValorDeducoes, nesse caso precisará preencher também o campo JustificativaDeducao.
Notas Rejeitadas por Duplicidade (Edoc/SaaS)
- Para evitar duplicações e o descarte de notas que já foram AUTORIZADAS será possível sincronizar as notas que retornarem o erro de duplicidade no fluxo de ENVIO. As notas ficarão com a situação ENVIADA, necessitando de um tratamento especial para chegarem a situação final (AUTORIZADA, REJEITADA OU CANCELADA).
- Caso exista divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Enviada) e a mensagem do retorno tenha sido: "RPS já convertido em NFS", ou retorne as seguintes mensagens ao tentar resolver ou descartar uma nota:
- "EXCEPTION,EspdManNFSeCheckParamsException,Por questão de segurança, o RPS informado já foi convertido em NFSe, caso os dados da nota sejam os mesmos e deseje sincronizar, passe o parâmetro "forcar=true.""
- "EXCEPTION,EspdManNFSeResolveException,Por questão de segurança a nota não será descartada pois o RPS informado já foi convertido em uma NFSe, caso os dados da nota não sejam os mesmos e deseje descartar, passe o parâmetro "forcar=true""
- Siga algum dos passos à seguir:
- Dados Iguais: Se os dados da nota enviada forem os mesmos da nota que está AUTORIZADA no portal da prefeitura, e deseje sincroniza-la, deve ser utilizado o parâmetro "forcar=true" na rota de RESOLVE, como no exemplo abaixo:
ATENÇÃO: a sincronização será realizada independente de que as informações contidas na nota emitida sejam diferentes da NFSe do portal da prefeitura. Portanto é necessário se certificar que as notas sejam exatamente as mesmas.
- Dados Diferentes: caso os dados da nota enviada e da AUTORIZADA no portal da prefeitura sejam divergentes e deseje descartar essa nota, deverá utilizar o parâmetro "forcar=true" na rota de DESCARTA, conforme o exemplo abaixo:
ATENÇÃO: Isso fará com que a nota seja descartada.
- Dados Iguais: Se os dados da nota enviada forem os mesmos da nota que está AUTORIZADA no portal da prefeitura, e deseje sincroniza-la, deve ser utilizado o parâmetro "forcar=true" na rota de RESOLVE, como no exemplo abaixo:
Os demais parâmetros do método RESOLVE, continuam sendo os mesmos já aceitos (handle; numNFSe; e numRPS, serieRPS e tipoRPS ), conforme a documentação
Geração do XML - Campos Importantes
- O código do serviço segue o que está descrito na LC-116.
- Código CNAE não utilizado.
- Código Tributação não utilizado.
Campos customizados para a impressão
Impressão do RPS
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[7]
- ComplementoEnderecoPrestador=String[20]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- Serie=String[20]
- DiscriminacaoImpostos=String[255]
- TipoLogradouroPrestador=String[20]
- TipoLogradouroTomador=String[20]
- DataCancelamento=String[20]
- OutrasInformacoes=String[255]
- NfseSubstituidora=String[40]
- NfseSubstituida=String[40]
- vlAliquotaIss=String[20]
- NumeroNFSe=String[40]
- DataHoraNFSe=String[40]
- SitePrestador=String[60]
Impressão da NFSe
- NomeFantasiaPrestador=String[80]
- RazaoSocialPrestador=String[80]
- EnderecoPrestador=String[80]
- UfPrestador=String[2]
- NumeroEnderecoPrestador=String[7]
- ComplementoEnderecoPrestador=String[20]
- BairroPrestador=String[40]
- CepPrestador=String[8]
- SitePrestador=String[20]
- InscricaoEstadualPrestador=String[8]
- InscricaoMunicipalTomador=String[8]
- TelefonePrestador=String[20]
- EmailPrestador=String[80]
- TotalISS=String[20]
- OperadorEmissor=String[80]
- CodigoMunicipioPrestador=String[20]
- TipoLogradouroPrestador=String[20]
- TipoLogradouroTomador=String[20]
- Serie=String[20]
- OutrasInformacoes=String[255]
- NfseSubstituidora=String[40]
- NfseSubstituida=String[40]
- DataHoraNFSeSubstituida=String[40]
- vlAliquotaIss=String[20]
- DiscriminacaoImpostos=String[255]
- DadosProcon=String[80]
Soluções Tecnospeed
- Componente NFSe: Release 5.7.24.X.
- Manager eDoc: Release 2.0.54.X.
Comentários
0 comentário
Por favor, entre para comentar.