Manual de integração com o webservice

Download do manual

Portais Disponíveis

• Produção
• Homologação

Métodos Disponíveis

• Envio.
  • Assíncrono.
• Consulta de lote.
• Consulta de NFSe.
• Cancelamento de NFSe.

Observações

• Os campos xServ e infAdic são limitados pelo schema do padrão com 256 caracteres.
• A cidade de Carlos Barbosa, São Borja e Canoas utiliza série RPS. 
• Na página 13 do manual você pode observar a formação do campo ChaveAcesso , porém no Manager Edoc a formação dessa chave é feita automaticamente.
• O campo CodigoItemListaServico do TecnoNFSe é referente ao campo cLCServ do XML da prefeitura.
• O campo CodigoCnae /CodigoTributacaoMunicipio do TecnoNFSe é referente ao campo cServ do XML da prefeitura.
• Observação:
  • NumEmissorRps: Conforme a documentação do padrão, os 9 últimos dígitos da tag refNF deve ser aleatório. Esse número é informado na tag cNFS-e e atualmente nosso produto informa o mesmo número do rps. Ocorre que, alguém pode deduzir a chave e visualizar notas de outros prestadores de serviço.
    Para corrigir esse problema, foi criado o campo customizado NumEmissorRps, onde o cliente poderá informar um número aleatório de 9 dífigitos para compor essa chave.
    Caso o campo NumEmissorRps esteja vazio, o produto seguira com seu padrão, ou seja, informar o número do RPS.
  • A cidade utiliza o número do RPS para definir o número da NFS-e, logo, eles são os mesmos. No RetornoWS, retornamos a chave de acesso da NFS-e no objeto NumeroNFSe para facilitar o processo de consultas, por exemplo. 
    Caso necessário ler somente o número da NFS-e, basta pegar o conteúdo do objeto NumeroRPS, visto que são os mesmos. 

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 existam divergências entre a situação da nota na prefeitura (Autorizada) e em nosso produto (Enviada) e a mensagem do retorno tenha sido:
  • "Nota fiscal já foi emitida"
• 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, informe o código de verificação da NFSe através do parâmetro "CodVerificacao", e também informe 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 a 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 difiram 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.

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  

Campos customizados para a impressão

Impressão do RPS

• ISSQN=String[100]
• Deducoes=String[100]
• RetIss=string[10]

Impressão da NFSe

• ISSQN=String[100]
• Deducoes=String[100]
• RetIss=string[10]

Soluções Tecnospeed

• Componente NFSe:   Release 8.7.52.X.
• Manager eDoc: Release 3.0.85.X.