TOTVS Consignado

Árvore de páginas

CONTEÚDO


01. VISÃO GERAL

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 erp
      • Estar aderente à portabilidade das versões do RM (verificar item 05. LINKS ÚTEIS, 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


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


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.

Para acessar o Totvs App, é necessário fornecer permissão para o perfil do usuário responsável pela ativação da integração.

Estando no erp RM, acesse a opção Serviços Globais > Segurança > Perfis > Sistema: Integração, edite o perfil desejado e na pasta "Acesso a Menus" habilite o acesso conforme imagem abaixo:


Figura 1 - Tela de permissão para acesso ao Totvs App.


Após a permissão fornecida,  através das opções de menu a esquerda, escolha o sistema Integração > Totvs App > Ativação Totvs App.

Será apresentada tela do wizard de ativação para que você preencha os campos chave, conforme credenciais enviadas no email de provisionamento do ambiente encaminhado ao destinatário administrador da plataforma.

Este processo deve ser executado apenas na empresa coligada principal.

    • Credenciais para ativação por RACID ( RAC Client Id e RAC Client Secret (credenciais recebidas por email) )
    • Marque o botão "Buscar Apps" . Ao clicar para Buscar Apps, serão retornados somente os Apps disponíveis em cada Client Id e Client Secret. 
      Ex.: Caso seja informado um Client Id e um Client Secret que possui somente o App "Consignado", só o mesmo será retornado na busca.
    • Após a leitura das credenciais do RAC será acionado processo de criação do serviço de execução continua, para o envio de dados; para isso, todos os arquivos atualizados com a versão disponibilizada na nuvem ( "totvsAppConfig","Conceitos") serão baixados para o servidor e inseridos na tabela GTOTVSAPP a configuração de execução do processo em questão e na tabela GTOTVSAPPCONCEITO, os "Conceitos" responsáveis pela subida de dados para o ambiente em nuvem Carol, podendo este processamento ser acompanhado através do recurso para Gerenciamento de Job (GTOTVSAPPCONCEITOHST) .

     Para maiores informações clique aqui!

    • Após visualizar a apresentação do App Consignado para ativação, clique em Avançar para concluir o processo de integração. 

Figura 2 - Tela para ativação das credenciais no TOTVS App.


Após a execução do processo de ativação, será criado um job, que executará em background que executará a cada 5 minutos os conceitos criados responsáveis pelo envio dos dados para integração com a plataforma Carol.


Para ativação do convênio da empresa erp com a instituição de crédito parceira, deverá ser aplicada a chave de ativação disponibilizada pela Techfin no menu Folha Mensal (opção deve estar liberada na segurança de menus dos perfis de acesso). Selecione o ícone "Ativação de Convênio TOTVS Consignado" conforme imagem a seguir e informe a senha de ativação do convênio.

Este processo deverá ser feito identificando quais empresas coligadas terão a integração com o TOTVS Consignado.


Figura 3 - Tela para ativação do convênio da empresa com a instituição de crédito parceira

Após ativado, através da opção de menu sistema Integração > Totvs App > Ativação Totvs App, será possível desativar a integração com o TOTVS Consignado caso desejado , conforme imagem a baixo:

Figura 4 - Tela para habilitar Ativação.

Observação:

Uma vez que a processo de desativar seja executado, todos os dados de configuração serão perdidos. Para reativá-lo, será necessário realizar o processo de configuração novamente, conforme mostrado anteriormente.



Atenção: 

Para que seja possível utilizar a integração do ERP com o TOTVS App  é importante ter atenção para a carga dos Conceitos que serão responsáveis pelo envio de dados para nuvem. Esses "Conceitos" serão processados via Jobserver conforme configurado em sua estrutura de criação e serão consumidos seguindo o processo de ativação da integração:


Importante

O serviço nunca deve ser interrompido sem a autorização da TOTVS pois este processo inviabiliza o correto uso dos dados pelo TOTVS Consignado


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.

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

- Nro de um documento oficial com Orgão emissor e Data de emissão (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. Realizar a "Ativação do Convênio" conforme item 02 deste 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;


05. TABELAS UTILIZADAS

As seguintes tabelas do RM são utilizadas nesse projeto:

    • GTOTVSAPP
    • GTOTVSAPPCONCEITO
    • GTOTVSAPPCONCEITOHST
    • GPERFIL


06. LINKS ÚTEIS