Histórico da Página
CONTEÚDO
Índice style none
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.
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 Protheus ou via RM, módulo 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 dos ERPs sejam extraídos, compartilhados e enviados do ERP à plataforma. Já na nuvem, eles serão filtrados e tratados. 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:
- Protheus
versão 12- Versão contemplada conforme Ciclo de Vida dos produtos TOTVS.
- recomendado: Ultimo patch da versão principal instalado
- DBAccess versão TOTVS DBACCESS - BUILD 20.1.1.
25 - 2 (20200606) ou superior;
- DBAccess versão BUILD-20191119 ou superior;
- APPSERVER_BUILD-
17- 19.3.1.
18 ou - 7 ou superior;
- SMARTCLIENT
APPSERVER- _BUILD-19.3.
0- 1.4
ou - ou superior;
- SMARTCLIENT_BUILD-17.3.0.16 ou SMARTCLIENT_BUILD-19.3.0.5 ou superior; Configuração dos Parâmetros (SIGACFG >
- Pacote de atualização da LIB >= TECHFIN-2.0.0;
- Ativação da chave do TOTVS Consignado, através da configuração do Parâmetro no configurador (SIGACFG > Ambiente > Cadastros > Parâmetros):
- MV_CONSIG -
Preencher com .T. para a ativação do TOTVS Consignado, em sua base;MV_CSAUTID e MV_CSAUTSE - Preencher com os dados de autenticação de cada cliente, para integração da base do Protheus à plataforma do TOTVS Consignado- Chave do TOTVS Consignado, deve ser criado manualmente (preenchido com o valor .T.);
- Caso o dicionário de dados seja no banco, o parâmetro será criado automaticamente durante a execução do Wizard de Configuração do Conector entre Protheus/Carol.
- Configuração da tabela S137, na rotina de Manutenção de Tabelas;
- Atualização do menu do SIGAGPE, para disponibilização do menu de Importação de Parcelas (solicitar o arquivo ao time de suporte).
ATENÇÃO: Para ter essas novas funcionalidades na base do Protheus, é importante realizar a atualização do dicionário de dados, via UPDDISTR, e estar com o pacote de expedição contínua aplicado na base, conforme última versão disponibilizada na Central de Downloads.
- Também são necessárias algumas configurações prévias:
| Informações |
|---|
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 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
Obs. 1: Para mais informações de como configurar o schedule, verificar item 0805. LINKS ÚTEIS, desse documento;
Obs. 2: O schedule deve ser configurado após a configuração do Wizard.
IMPORTANTE: Após finalizar o Wizard realize a conferência da habilitação da chave de ativação do TOTVS Consignado conforme abaixo:
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 (wizard) - TOTVS App -, onde devem ser configurados os campos com as
...
URL's correspondentes, 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 especial para as regras de consistência dos dados em especial os que não são padronizados pelo erp para que os mesmos sejam carregados para a base de dados do Consignado de forma integra no consumo das instituições parceiras.
Regras (campos obrigatórios informados no vinculo funcional do erp) :
- DDD e Telefone - pelo menos um telefone com DDD válido (numérico de 10 a 99)
- email funcional
- Data de nascimento
- Nro RG, Orgão emissor e Data de emissão
- Nome da mãe (mesmo que identificação de Mãe Desconhecida)
- Salário > 0
04. ATIVAÇÃO DE NOVO GRUPO DE EMPRESAS
O procedimento para habilitar um novo grupo de empresa no erp deve seguir as seguintes ações:
- Realizar novamente a configuração do wizard e apontar o novo grupo de empresa conforme item 02 deste documento. Este procedimento deve ser realizado com o job em modo exclusivo e depois retornar para normal.
- 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;
...
Em relação às parcelas, estas são enviadas pelas parceiras de crédito, via API, para o TOTVS Consignado que as disponibiliza, também via API para importação dentro do Protheus, por meio da rotina Import. Parcelas. Para fazer essa importação, o analista deve acessar a rotina na filial onde se deseja realizar a importação e informar o período de consulta. A API retornará as parcelas abertas disponíveis para importação no período em questão. As parcelas selecionadas e importadas ficam gravadas na rotina Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário) - RGB, com o código da verba configurada na tabela S137 - Verbas - Empréstimo Consignado (Manutenção de Tabelas (SIGAGPE > Atualizações > Definições Cálculos > Manutenção tabelas)).
Essa parcela importada precisa ser retornada ao parceiro de crédito, para que o mesmo saiba o valor que foi ou não averbado na folha do funcionário. Para isso, com a(s) parcela(s) importada(s) na RGB, basta que o analista siga com o fluxo já conhecido de integração, cálculo e fechamento da folha. Com o Job FWTECHFINJOB e o wizard configurados corretamente, o valor averbado será enviado para a Carol, na tabela SRD, permitindo que o mesmo seja consumido e tratado no TOTVS Consignado, para realização da conciliação do empréstimo e disponibilização de dados atualizados da parcela à operadora de crédito.
04. IMPORTAÇÃO DE PARCELAS
Para que os dados vindos do parceiro de crédito sejam utilizados no ERP, é necessário realizar a importação das parcelas. Como explicado anteriormente, neste documento (02. PRÉ-CONDIÇÕES PARA CONEXÃO), é preciso estar com os parâmetros e a S137 configurados. Segue abaixo exemplo de preenchimento da S137, utilizada para realização da importação.
Figura 17 - Tabela S137, configurada para a D MG 01.
Ao acessar a rotina pelo menu de Import. Parcelas (SIGAGPE > Miscelanea > Import. Parcelas), o sistema exibirá ao usuário a tela com a parametrização para consulta à API. Será necessário informar apenas o período no qual se deseja realizar a importação (no formato AAAAMM), pois será considerada a filial que o usuário está logado para disponibilização das parcelas que serão importadas.
Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D MG 01 e o período para importação de 202007. Com esses dados e com os parâmetros configurados, o usuário pode clicar no Ok e verificar a disponibilidade de parcelas para importação e posterior desconto na folha do funcionário.
Figura 18 - Rotina de Import. Parcelas com o período 202007 parametrizado.
No caso deste exemplo, são retornadas 3 parcelas disponíveis para importação no período de 202007:
Figura 19 - Rotina de Import. Parcelas com as parcelas disponíveis para 202007.
É possível selecionar todas as parcelas ou apenas uma ou mais, conforme necessidade do analista. Existem diferentes tratamentos para diferentes situações que podem ocorrer durante a utilização dessa rotina:
...
| tabs | Parcelas indisponíveis, Nenhuma parcela selecionada, Seleção de uma parcela, Seleção de mais de uma parcela, Seleção todas as parcela, Lançamentos por funcionário e cálculo da folha,Fechamento do período |
|---|---|
| ids | 8,9,10,11,12,13,14 |
| Totvs custom tabs box items | ||||
|---|---|---|---|---|
| ||||
No caso de não haver nenhuma parcela disponível para o período selecionado, é exibido o log a seguir:
Figura 20 - Rotina de Import. Parcelas com o período 202007 parametrizado e nenhuma parcela disponível para importação no período selecionado. |
| Totvs custom tabs box items | ||||
|---|---|---|---|---|
| ||||
Após a chamada da API, nenhuma parcela é selecionada e a importação é confirmada:
Figura 21 - Log de confirmação de importação sem nenhuma seleção de parcela. |
...
| default | no |
|---|---|
| referencia | 10 |
Após a chamada da API, uma das três parcelas é selecionada e a importação é confirmada:
Figura 22 - Rotina de Import. Parcelas com a parcela selecionada.
Figura 23 - Log de confirmação de importação da parcela.
Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Figura 24 - Lançamentos por funcionário com a parcela importada - Mat.: 091250.
...
| default | no |
|---|---|
| referencia | 11 |
Após a chamada da API, duas das três parcelas são selecionadas e a importação é confirmada:
Figura 25 - Rotina de Import. Parcelas com as parcelas selecionadas.
Figura 26 - Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Figura 27 - Lançamentos por funcionário com a parcela importada - Mat.: 091250.
Figura 28 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.
...
| default | no |
|---|---|
| referencia | 12 |
Após a chamada da API, três parcelas são selecionadas e a importação é confirmada:
Figura 29 - Rotina de Import. Parcelas com as parcelas selecionadas.
Figura 30 - Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:
Figura 31 - Lançamentos por funcionário com a parcela importada - Mat.: 091310.
Figura 32 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.
Figura 32 - Lançamentos por funcionário com a parcela importada - Mat.: 091250.
...
| default | no |
|---|---|
| referencia | 13 |
Para exemplificar o cálculo da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091341:
Figura 34 - Lançamentos por funcionário com a parcela importada - Mat.: 091341.
Após o cálculo da folha, a parcela importada na RGB é levada para a SRC, conforme rotina Consulta de Cálculo por Funcionário:
Figura 35 - Consulta de cálculo por funcionário com a parcela importada - Mat.: 091341.
...
| default | no |
|---|---|
| referencia | 14 |
Para exemplificar o Fechamento do Período da folha de um funcionário que teve a importação da parcela do consignado, será utilizada a matrícula 091341:
Figura 36 - Log de fechamento do período.
Após o fechamento, o recibo de pagamento do funcionário pode ser consultado:
Figura 36 - Recibo de Pagamento - Mat.: 091341.
Após o processo de importação da parcela, cálculo e fechamento da folha, os dados referentes ao pagamento da parcela são enviados à Carol, na tabela SRD, para consumo e tratamento no TOTVS Consignado, para disponibilização de dados atualizados da parcela conciliada à operadora de crédito.
| Card documentos | ||||
|---|---|---|---|---|
|
...
05.
TABELAS UTILIZADAS
As seguintes tabelas do Protheus são utilizadas nesse projeto:
- CONFIGCONSIGNADO
- FWTECHFINJOB
- RCB - Configuração de Parâmetros
- RCC - Parâmetros RGB - Incidências
- SX6 - Parâmetros do Sistema
- SX6 - Parâmetros do Sistema
- SR8 - Controle de Ausências
- SRA - Funcionários
- SRD - Históricos de Movimentos
- SRG - Rescisões
- SRK - Movimento de Valores futuros
- SRR - Itens de Férias e Rescisões
- SRV - Verbas
...
05. 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