Histórico da Página
CONTEÚDO
| Índice |
|---|
01. VISÃO GERAL
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.
02. PRÉ-CONDIÇÕES PARA CONEXÃO
Os seguintes requisitos são necessários para implantação do produto:
- RM
- versão
12.1.28 ou superior;- RM
- erp
- Versão contemplada conforme Ciclo de Vida dos produtos TOTVS.
- recomendado: Ultimo patch da versão principal instalado
- Estar
- erp
Está - aderente à portabilidade das versões do RM (verificar item
08- 05. LINKS ÚTEIS,
desse - desse documento);
- Utilizar ambiente 3 camadas;
Protheus- versão 12.1.25 ou superior;
- DBAccess versão BUILD-20191119 ou superior;
- APPSERVER_BUILD-17.3.1.18 ou APPSERVER_BUILD-19.3.0.4 ou superior; SMARTCLIENT_BUILD-17.3.0.16 ou SMARTCLIENT_BUILD-19.3.0.5 ou superior;
- Caso não tenha acessado o parametrizador dos Serviços Globais após a atualização do ambiente, é necessário executá-lo até o final, ainda que não faça nenhuma alteração. Isso é necessário para criação de parâmetros internos.
- Totvs App (Ativação):
- Para banco de dados Oracle a versão do banco tem que ser 12.2C ou superior
- Para que seja possível utilizar o TOTVS Consignado é importante estar de posse das credenciais enviadas por email pela TOTVS, para integração entre as plataformas. A ativação ocorrerá por:
- Totvs App (Ativação):
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
- Integração TOTVS App: https://tdn.totvs.com/pages/viewpage.action?pageId=561643159
- Integração TOTVS App: https://tdn.totvs.com/pages/viewpage.action?pageId=561643159
- Também são necessárias algumas configurações prévias:
| 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 | ||||||||
|---|---|---|---|---|---|---|---|---|
| ||||||||
|
...
|
03. FUNCIONAMENTO DA CARGA DE DADOS
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.
Com a execução desse job, os dados ficam disponíveis para que o parceiro possa acessá-lo por uma API e possa usar esses dados para as ofertas e negociações referentes ao empréstimo consignado.
Assim como o middleware possibilita que esses dados sejam disponibilizados ao parceiro, ele permite que seja feito o caminho reverso e que os dados do parceiro, referentes à contração de empréstimo consignado por funcionários do cliente, sejam disponibilizados na nuvem.
Do mesmo modo que os dados são disponibilizados do ERP para o parceiro, os dados disponibilizados pelo parceiro precisam ser tratados dentro da Carol, para que sejam organizados em um arquivo no formato .txt, para upload dentro do ERP. No caso do RM, no menu Folha Mensal, em Importação > Importação do Movimento.
04. TELA DO WIZARD - TOTVS CONSIGNADO
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.
Figura 11 - Tela de falha na processo de integração. Verifique os logs de Exceção
...
| 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:
- Exceções consideradas e tratadas com as seguintes mensagens:
- 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.
- 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}.
- Eventos descritos no Log resultante do processo de integração:
- 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
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.
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
04. ATIVAÇÃO DE NOVA COLIGADA
O procedimento para habilitar uma nova coligada no erp deve seguir as seguintes ações:
- Realizar a "Ativação do Convênio" conforme item 02deste documento
- Aguardar liberação da solicitação do time Techfin do b2b
- Aguardar liberação da solicitação do time Techfin realizada ao parceiro para habilitação dos novos CNPJ's
Atenção: As solicitações de habilitação de novas coligadas, ocorrem através da equipe Techfin que deve ser acionada pelo cliente;
05. TELA DE IMPORTAÇÃO DO MOVIMENTO INTEGRADO
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 | 7 |
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 | 9 |
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 para a folha do funcionário.
Atenção: No arquivo de importação existirá apenas o evento de base de cálculo com o valor original da parcela enviada pelo Parceiro. No evento de código de cálculo 438 deverá ser incluído uma fórmula de cálculo para receber o valor do evento de base de cálculo e verificar se é possível realizar o desconto, pois existe o limite de 30% da folha do funcionário.
Exemplo de fórmula:
Se C('XXXX') > 0
entao
Se C('XXXX')>= (L*0.3)
entao L*0.3
Senao C('XXXX')
FimSe;
* Onde 'XXXX' deve ser o código do evento de base de cálculo com código de cálculo 439 - BASE DE CÁLCULO EMPRÉSTIMO CONSIGNADO PLATAF.TOTVS
...
05.
TABELAS UTILIZADAS
As seguintes tabelas do RM são utilizadas nesse projeto:
- PPESSOA
- GTOTVSAPP
PFUNC - GTOTVSAPPCONCEITO
PFPERFF - GTOTVSAPPCONCEITOHST
- PFFINANC
- PSECAO
- PFEMPRT
- PFHSTAFT
- PPARAM
- PPARAMADICIONAIS
- PFCONSIGNADODISTMARGEM
- PCONSOPERADORAS
- PFMOVTEMP
- PGRPLANC
...
- GPERFIL
06. LINKS ÚTEIS
...
...
| 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>
|
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas