RH - Linha Protheus - GPE - eConsignado - Principais dúvidas/erros na importação de empréstimos via API

Tempo aproximado para leitura: 00:05:00 min

Dúvida
Quais são as principais dúvidas/erros na importação de eConsignado via API?

Ambiente
TOTVS RH - TOTVS RH (Linha Protheus) - Gestão de Pessoal - A partir da versão 12.1.2510

Solução
As principais dúvidas e erros na importação do eConsignado via API são:

1. Na rotina de importação (GPEM815A), só aparece uma Filial, mas meu funcionário é de outra filial.
-> A rotina de importação mostra apenas a Filial definida como Matriz no TAF (tabela C1E), em razão do eSocial trabalhar diretamente com o conceito de raiz de CNPJ para identificar e unificar a empresa matriz e suas filiais.



2. Quando tento realizar a importação, é gerada a mensagem 'Nenhum empréstimo retornado para o empregador XXXXXX'.
-> Esta mensagem pode ser gerada quando alguma atualização de fonte (acumulado RH, TAF ou TSS) ou de URL do TSS está pendente. Sugerimos que a documentação com os pré requisitos da integração seja consultada.



Para a conferência dos fontes do Protheus e TSS, recomendamos que seja utilizada a ferramenta VSCode, pois através dela, é possível conectar em cada um dos RPOs para validação de forma mais exata.
É importante ressaltar que os produtos Protheus e TSS tem RPOs diferentes, portanto, no RPO do Protheus devem ser aplicadas apenas as atualizações de RH e TAF, e no RPO do TSS apenas a atualização do TSS.

Para conferência, basta se conectar em um ambiente, clicar com o botão direito do mouse sobre ele e selecionar a opção Inspetor de Objetos:


Após isso, basta digitar o nome do fonte que precisa ser validado:




Após a atualização das URLs do TSS, é possível fazer a query abaixo no banco de dados:
SELECT * FROM SPED158 WHERE MODELO = 'ECONSIG'

O resultado da query deve retornar quatro registros conforme exemplo abaixo:



3. Quando tento realizar a importação, é gerada a mensagem 'Bad Request - erro 400'.
-> Este erro pode acontecer quando:
• a chave TSSSECURITY=1 é utilizada no appserver.ini do TSS (para maior entendimento desta chave, o time de suporte do TSS deve ser consultado)
• o serviço do TSS não está no ar ou configurado corretamente (neste caso, deve ser contatado o time de suporte do TSS)
• pendência de atualização de fontes (acumulado RH, TAF ou TSS).


Em casos de dúvida sobre o erro ser falha de autenticação, é possível avaliar o arquivo consolelog do Protheus, onde será mostrada uma mensagem informando que a conexão foi recusada:



4. É possível fazer a importação quando o empregador utiliza CPF?
-> Conforme o manual da DataPrev, página 7, a importação de dados via API só é válida para empregadores do tipo 1 (CNPJ).




5. Quais tipos de Certificado Digital são aceitos?
-> São aceitos certificados do tipo A1 e A3. Para certificados por Procuração/Outorga, deve ser consultada a documentação específica. 



6. Pode acontecer erro por bloqueio de Firewall?
->Por se tratar de uma integração via API, é necessário que os acessos externos do REST/WS sejam validados pelo seu time de TI/Infraestrutura.


7. Pode ocorrer falha na busca dos empréstimo se existir mais de um parâmetro MV_TAFSURL?
-> Recomendamos manter apenas um parâmetro com campo de filial em branco no dicionário. Para fazer esta validação, sugerimos que o parâmetro seja avaliado diretamente pelo dicionário SX6, e caso necessário, seja feito o ajuste:



Saiba Mais:
RH - Linha Protheus - GPE - eConsignado - Configuração para integração de dados via API DataPrev e Protheus