CONTEÚDO
Índice |
---|
Para amadurecer o produto, antes de colocá-lo em grande escala é muito comum, no segmento de tecnologia da informação, as empresas realizarem testes pilotos prévios, de modo a garantir a adequação e robustez da solução. A fim de endereçar isso, são liberadas versões intermediárias do produto para testes em campo. A versão do produto tratada aqui, se enquadra nesse contexto e contamos com a sua empresa para nos ajudar nessa jornada.
A plataforma TOTVS Consignado tem como objetivo facilitar e automatizar os processos de contratação e cobrança de empréstimo consignado para empresas que tenham sua folha de pagamento controlada, via RM ou Protheus, módulos RH, criando uma nova experiência na contratação do crédito.
Com a plataforma, é possível tornar mais rápido esse contato da operadora de crédito com o colaborador, já que a mesma terá algumas informações à sua disposição.
Por ser uma plataforma na nuvem, o TOTVS Consignado precisa que os dados sejam extraídos dos ERP's, compartilhados e enviados para a plataforma. Já na nuvem, eles serão filtrados e tratados – sendo que esse tratamento pode ser feito de forma manual ou agendada – e, assim, serão disponibilizados para acesso e repasse à operadora de crédito, quando necessário. Para isso, é utilizada uma integração do ERP, que será o responsável por fazer o sincronismo de base de dados.
...
O processo de ativação é simples, porem, deve ser realizado com cautela para garantir a saúde do envio dos dados para nuvem.
Este processo é iniciado após provisionamento dos ambientes do cliente. Após o cliente receber as credenciais de acesso, através de email enviado ao final da preparação do ambiente SaaS, o responsável deverá seguir os passos abaixo para garantir o cumprimento dos requisitos bem como habilitar as credenciais no erp nos passos indicados abaixo.
Normalmente este procedimento é realizado por profissional da área de TI responsável.
Os seguintes requisitos são necessários para implantação do produto:
Ativação por RACID
Parâmetros necessários : clientid e clientsecret (credenciais enviadas por email)
Importante: Leia as seguintes instruções sobre a funcionalidade de subida de dados
Informações |
---|
Valores Os valores usados para o preenchimento dos campos são específicos para cada cliente e serão disponibilizados para que sejam realizadas as validações. Os dados usados na validação dos campos das imagens são apenas exemplos, para demonstração do funcionamento deste processo. |
Totvs custom tabs box | ||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||||
|
...
|
Atenção:
Totvs custom tabs box | |||||||
---|---|---|---|---|---|---|---|
| |||||||
|
O ERP terá seus dados transmitidos para a nuvem por meio de uma conexão estabelecida pela chamada de um assistente de ativação -
...
TOTVS App -, onde devem ser configurados os campos
...
correspondentes as
...
credenciais, responsáveis por essa conexão e parametrização do endpoint.
Os dados brutos são armazenados na nuvem, em tabelas mapeadas. Entretanto, é necessário que seja feito um tratamento e uma
...
normalização dos mesmos, antes da disponibilização para a
...
instituição de crédito parceira. O tratamento é feito por meio da execução de um job, dentro da Carol - plataforma de dados e inteligência artificial da TOTVS -, por uma execução agendada, mas que também pode ser feita de forma manual, conforme necessidade.
O TOTVS Consignado consome os dados, disponibilizados pela Carol, trata e
...
os envia para os parceiros, realizando a conciliação das parcelas que foram enviada para o ERP.
Esse assistente permitirá realizar a integração dos dados apurados no TOTVS Consignado com o ERP RM RH, através das considerações a seguir:
...
tabs | Processo de Integração, Logs de Exceção |
---|---|
ids | 4,5 |
No Totvs RM Folha de Pagamento, o acesso ao Wizard é feito pelo menu Folha Mensal, chamando o ícone "Integração TOTVS Consignado", conforme imagem abaixo.
Figura 7 - Tela de acesso ao Wizard.
...
default | yes |
---|---|
referencia | 4 |
O processo de integração dos dados do TOTVS Consignado com o ERP é simples e não precisa de interação do usuário além das configurações realizadas nas etapas anteriores citadas neste documento. Apenas é solicitado a confirmação de realização do processo por tabelas internas serão preenchidas neste momento, considerando os dados apurados no TOTVS Consignado para a competência em questão.
Figura 8 - Tela de confirmação do processo de integração.
Figura 9 - Tela de acompanhamento do Progresso de execução do processo.
Figura 10 - Tela esperada após conclusão do processo de integração.
IMPORTANTE: Caso não for concluído com sucesso a validação da integração, verifique a exceção apresentada conforme Log de Exceções apresentados neste documento.
...
default | no |
---|---|
referencia | 5 |
Após a finalização do processo de integração, você poderá acompanhar os movimentos que forma importados para a base do ERP (tabela PFMOVTEMP) , bem como possíveis causas de insucesso na conclusão do processo, conforme detalhamento a seguir:
- Na obtenção dos dados plataforma Consignado:
- Algum dos dados da integração com o TOTVS Consignado não está preenchido.
- Na obtenção de seções centralizadoras:
- Nenhuma seção centralizadora encontrada.
- Na obtenção do token do rac:
- O token de acesso não pode ser obtido.
- Código 404 (not found) na obtenção do token de acesso, possivelmente existe uma parametrização errada na sua URL da plataforma do RAC.
Atenção:
Existem dados do funcionário que são exigidos para consumo da instituição de crédito (necessários para análises de crédito e geração de objeto contratual) e devem estar na base de dados do ERP de forma integra para que sejam validados e não interfiram na consistência do processo de solicitação do empréstimo consignado.
Para tanto, faz-se necessária a realização de consistência destes dados onde é apresentada mensagem de validação no processo de simulação/solicitação; deve-se ter atenção para as regras de consistência dos dados, em especial aqueles que não são padronizados pelo erp, garantindo assim a subida destes dados para a base de dados do Consignado de forma integra no consumo das instituições parceiras.
Regras (campos obrigatórios informados no vínculo funcional do erp) :
- DDD e Telefone - pelo menos um telefone com DDD válido (numérico de 10 a 99)
- email (caso não exista um email funcional na tela de identificação no cadastro do funcionário. quando realizado o processo de solicitação você poderá informar um email pessoal durante este processo)
- Data de nascimento válida
- Nro de um documento oficial com Orgão emissor e Data de emissão válida (podendo ser RG e/ou CNH)
- Nome da mãe (mesmo que identificação de Mãe Desconhecida)
- Salário > 0
O procedimento para habilitar uma nova coligada no erp deve seguir as seguintes ações:
Atenção: As solicitações de habilitação de novas coligadas, ocorrem através da equipe Techfin que deve ser acionada pelo cliente;
- Código 400 (bad request) na obtenção do token de acesso, possivelmente existe uma parametrização errada nos dados de cliend_id e client_secret.
- Código 500 (internal server error) ocorreu um erro inesperado do lado do servidor do RAC.
- Na obtenção das parcelas do consignado:
- Nenhum evento de folha cadastrado.
- Nenhuma parcela a ser consumida do TOTVS Consignado na competência {0}/{1}.
- Integração TOTVS Consignado
- Foram encontradas {0} parcelas para serem importadas na competência {1}/{2}.
- Uma parcela de valor {0} na competência {1}/{2}, para a matrícula de funcionário {3}, não foi inserida.
Figura 12 - Exemplo da Tela de Logs
Figura 13 - Exemplo de Carga na Tabela PFMOVTEMP a ser consumida no Grupo de Eventos
Para que os dados vindos do parceiro de crédito através do processo de integração do TOTVS Consignado com o ERP sejam carregados no movimento da competência atual para desconto em Folha de Pagamento, é necessário a geração de movimento via Grupo de Eventos. Deverá ser marcado no Grupo de Eventos em questão, as flags indicadas a seguir:
...
tabs | Grupo de Eventos, Lançamento do Funcionário |
---|---|
ids | 6,7 |
...
default | yes |
---|---|
referencia | 6 |
Para a importação para a folha de pagamento, o grupo de eventos de lançamento de movimento deve ser marcado os campos em destaque abaixo para que a integração TOTVS Consignado (arquivo PFMOVTEMP) sejam carregados no movimento do Funcionário para a competência em questão.
Figura 14 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.
Figura 15 – Tela de Grupo de Eventos - TOTVS Consignado
...
default | no |
---|---|
referencia | 7 |
Para verificar o lançamento da verba de empréstimo na folha do funcionário, basta acessar o Envelope de Pagamento: Anexos > Movimento > Envelope de Pagamento.
Figura 16 – Verba de Empréstimo importada pela integração para a folha do funcionário.
...
As seguintes tabelas do RM são utilizadas nesse projeto:
...
...
HTML |
---|
<!-- esconder o menu --> <style> div.theme-default .ia-splitter #main { margin-left: 0px; } .ia-fixed-sidebar, .ia-splitter-left { display: none; } #main { padding-left: 10px; padding-right: 10px; overflow-x: hidden; } .aui-header-primary .aui-nav, .aui-page-panel { margin-left: 0px !important; } .aui-header-primary .aui-nav { margin-left: 0px !important; } </style> |
...