Histórico da Página

CONTEÚDO

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;
• • • erp
      • Versão contemplada conforme Ciclo de Vida dos produtos TOTVS. 
      •  recomendado: Ultimo patch da versão principal instalado
    • Estar
Está
• • • aderente à portabilidade das versões do RM (verificar item
08
• • • 05. LINKS ÚTEIS,
 desse
• • •  desse documento);
    • Utilizar ambiente 3 camadas;
    • 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:

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
      

• Também são necessárias algumas configurações prévias:

Atenção: 

...

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.

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.

04. TELA DO TOTVS APP

O passo-a-passo para configuração do assistente de ativação Totvs App, pode ser visto a seguir.

...

...

Para acessar o Totvs App, é necessário fornecer permissão para o perfil do usuário. No RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Integração.

Image RemovedFigura 13 - Tela de permissão para acesso ao Totvs App.

...

Após a permissão fornecida, o acesso ao Totvs App é feito através do sistema Integração > Totvs App > Ativação Totvs App. O assistente de ativação possui apenas uma tela, onde deve ser informado os dados de conexão: URL da Carol, Id do Connector da Carol, Token da Carol e o checkbox "Consignado", que ativa o processo de integração.

Image RemovedFigura 14 - Tela do Processo de Ativação do Totvs App.

Caso algum campo não seja preenchido, o processo finalizará com falha, como mostra o exemplo a seguir:

Image RemovedFigura 15: Tela de configuração do Totvs App sem o campo Token Carol preenchido.

Image Removed
Figura 16 - Tela com log de erro.

Após a execução do processo de ativação, será criado um job, que executará em background, enviando os dados para a Carol.

05. 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:

...

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.

Image RemovedFigura 18 - Tela de acesso ao Wizard.

...

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.

Image Removed

Figura 19 - Tela de confirmação do processo de integração.

Image Removed

Figura 20 - Tela de acompanhamento do Progresso de execução do processo.

Image Removed

Figura 21 - 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.

...

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:

1. 1. Realizar a "Ativação do Convênio" conforme item 02deste documento
   2. Aguardar liberação da solicitação do time Techfin do b2b
   3. 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;

      
      

Após a finalização do processo de integração, você poderá acompanhar os movimentos que formam 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.

Image Removed

Figura 22 - Exemplo da Tela de Logs

...

Para acompanhar os movimentos integrados pela plataforma TOTVS Consignado (tabela PFMOVTEMP) , utilize a ferramenta abaixo que permitirá um acompanhamento do que irá ser gravado na tabela financeira dos funcionários para a competência em questão.

Image Removed    Figura 23 - Tela de acesso a consulta

• Para facilitar a busca, você poderá criar um filtro aplicando apenas a regra da Origem do Evento = TOTVS Consignado ou Tipo Lançamento = Parcela do empréstimo consignado conforme abaixo :

Image Removed             Figura 24 - Exemplo da Consulta de Movimento Integração (tabela PFMOVTEMP), carregada pela integração a ser consumida no Grupo de Eventos

06. 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: 

...

...

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.

Image Removed
Figura 25 – Tela de Grupo de Eventos - Lançar eventos de integração com outros aplicativos.

Image Removed
Figura 26 – Tela de Grupo de Eventos - TOTVS Consignado

...

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.

Image Removed

Figura 27 – Verba de Empréstimo importada pela integração para a folha do funcionário.

IMPORTANTE: Pode-se acompanhar o andamento das concessões através do  Portal - Empréstimos

...

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
• PTIPOLANCEVT

...

• • GPERFIL

06. LINKS ÚTEIS

• Integração TOTVS App
• Documento Portabilidade RM

Código de Cálculo 438

Código de Cálculo 439

• Portal - Empréstimos
• TOTVS Consignado
• 0 - FAQ - Perguntas e Respostas

...

<!-- 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>

...