...
| Totvs custom tabs box |
|---|
| tabs | Configuração do Wizard,Agendamento da execução da rotina FWTECHFINJOB |
|---|
| ids | 1,2 |
|---|
|
| Totvs custom tabs box items |
|---|
| É necessário realizar a configuração do Wizard para conexão e exportação dos dados do ERP para a nuvem. Importante: - O wizard deve ser aberto de forma exclusiva, sem que nenhuma outra instância do SmartClient esteja aberta e sem que outros jobs estejam rodando.
- MV_URLRAC e MV_URLPLAT - Com a configuração do wizard, explicada abaixo, estes parâmetros são automaticamente preenchidos com as URLs de produção. Caso o ambiente utilizado seja algum outro, como o de homologação (staging), os conteúdos destes parâmetros devem ser alterados, via configurador, informando o que for recebido no e-mail de provisionamento, contendo as informações para conexão.
- Caso o cliente deseje fazer essa alteração de ambiente de produção para homologação, por exemplo, devem ser incluídos um parâmetro e uma URL na seção referente ao ambiente, no appserver.ini. O parâmetro e a URL em questão são:
fw-tf-registry-endpoint=https://endpoint-registry.ambiente.totvs.app/api/v1/services Onde ambiente deve ser substituído por staging ou dev, conforme necessidade do cliente. Para ambiente de produção, não há a necessidade dessa URL e nada precisa ser feito. - Com a atual configuração do Wizard, os dados de conexão do RAC - Client Id e Client Secret, não são mais gravados nos parâmetros MV_CSAUTID e MV_CSAUTSE, respectivamente.
O passo a passo para configuração do Wizard, que pode ter seu processo cancelado em qualquer etapa da execução, pode ser visto a seguir, assim como alguns exemplos de preenchimento incorreto.
| Informações |
|---|
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 do Wizard. |
O acesso ao Wizard é feito pelo SmartClient, chamando o programa CONFIGCONSIGNADO, pelo campo de “Programa inicial”.  Image Removed Image AddedChamada do Wizard, no SmartClient
| Totvs custom tabs box |
|---|
| tabs | Boas Vindas,Autenticação,Dados de Integração,Ativando a Integração |
|---|
| ids | 4,5,6,7 |
|---|
| | Totvs custom tabs box items |
|---|
| Com o Wizard aberto, a tela de boas vindas é exibida. Neste ponto, o usuário pode ou cancelar a ação ou avançar para a tela de autenticação. 
Tela de “Boas vindas” do Wizard
Também é nessa tela que ocorrem as validações da versão da Techfin e dos artefatos. Como exemplo, é possível ver na figura abaixo que o DBAccess utilizado não estava compatível:  Tela de “Boas vindas” do Wizard, com DBAccess incompatível
|
| Totvs custom tabs box items |
|---|
| Na tela de autenticação, devem ser inseridos o usuário e senha do sistema. Apenas é possível avançar para a próxima tela se os dados de ambos os campos forem inseridos corretamente. Caso contrário, o sistema exibe alertas para que os dados sejam informados, caso tenham ficado em branco, ou para que sejam corrigidos o(s) campo(s) com preenchimento incorreto. Preenchendo os campos com os dados corretos e com a seleção do grupo de empresas realizada, o usuário pode seguir para a próxima tela, para preenchimento dos dados da plataforma. 
Tela com os campos de usuário, senha e seleção de grupo de empresa, para autenticação do acesso |
| Totvs custom tabs box items |
|---|
| A tela para preenchimento com os dados de integração contém dois campos, onde devem ser informados os dados da plataforma, que são: Client ID e Client Secret. 
Tela com os campos para inserção dos dados que possibilitam o acesso à plataforma
Nesse ponto, ocorrem algumas validações, por exemplo, se algum dos campos não tiver sido preenchido ou se o campo teve o seu preenchimento feito com dados incorretos. 
Validação de campos vazios 
Campos preenchidos com informações inválidas |
| Totvs custom tabs box items |
|---|
| Com os dados preenchidos corretamente, é possível avançar e verificar o status da ativação da integração, na última tela do Wizard.  
Telas com o status da ativação da integração do ERP com a plataforma
Após a ativação da integração do ERP com a plataforma, ative o job FWTECHFINJOB para que os dados sejam enviados para a Carol. |
|
|
| Totvs custom tabs box items |
|---|
| No configurador do Protheus (SIGACFG > Ambiente > Schedule > Schedule), realizar o Agendamento da execução da rotina FWTECHFINJOB, com Padrão de recorrência “Sempre Ativo”, conforme exemplo abaixo: 
Exemplo de Schedule que deve ser configurado |
|
...
| Totvs custom tabs box |
|---|
| tabs | Instituições financeiras,Filial não especificada,Filial especificada |
|---|
| ids | 16,17,18 |
|---|
|
| Totvs custom tabs box items |
|---|
| 
Tabela S137 - Retorno da consulta às instituições de crédito |
| Totvs custom tabs box items |
|---|
|
Tabela S137 - Com filial não especificada |
| Totvs custom tabs box items |
|---|
| Os registros podem ser criados sem especificar ou especificando a filial relacionada. Para a seleção da filial a ser especificada, é importante levar em consideração o compartilhamento das tabelas RCB e RCC, sendo que as duas devem ter o mesmo tipo de compartilhamento configurado.
Tabela S137 - Com filial específica
|
|
...
- Que a instituição de crédito parceira tenha enviado as parcelas para a plataforma do TOTVS Consignado, para que elas possam ser disponibilizadas ao cliente, via API;
- Que o período de cálculo selecionado para importação esteja aberto e ativo;
- Que a configuração da tabela S137, na Manutenção de Tabelas, esteja correta. Ou seja, é necessário que haja a configuração das verbas e da instituição de crédito, que deve ser a mesma do contrato da parcela. Para maiores informações, consultar o documento TOTVS Consignado - Manutenção de tabelas - Verbas do Consignado;
- Que a verba cadastrada na S137 esteja cadastrada na filial onde se realizará a importação das parcelas;
- Que a verba cadastrada na S137 esteja com o campo Qtde.Lancto (RV_QTDLANC) com o preenchimento respeitando a quantidade de lançamentos que serão feitos por funcionário. Recomenda-se que o campo Qtde.Lancto (RV_QTDLANC) esteja com o preenchimento igual à nove (RV_QTDLANC=9);
- Que a verba cadastrada na S137 esteja com o campo Lcto Diario (RV_LCTODIA) esteja com o preenchimento igual à "N - Nao".
Segue exemplo de preenchimento da S137, utilizada para realização da importação.
Tabela S137, configurada para a D MG 01.
...
Para exemplificar o uso da rotina de Import. Parcelas, será usada a filial D PR 01, o período para importação de 202201 e todas as situações da folha selecionadas, que são os parâmetros para consulta das parcelas em aberto disponíveis na API, aptas para importação na RGB (Lançamentos por funcionário ((SIGAGPE > Atualizações > Lançamentos > Por Funcionário). 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.
Parâmetros:
Rotina de Import. Parcelas com o período 202201 parametrizado.
No caso deste exemplo, são retornadas 13 parcelas disponíveis (ordenados por contrato) para importação no período de 202201:
Rotina de Import. Parcelas com as parcelas disponíveis para 202201.
...
| Totvs custom tabs box |
|---|
| tabs | Validações, Importação de 1 parcela, Importação de 2 parcelas, Importação de todas as parcelas, Importação com filtro, Lançamento e Cálculo da Folha, Fechamento da Folha |
|---|
| 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: Rotina de Import. Parcelas com o período 202202 parametrizado e nenhuma parcela disponível para importação no período selecionado.
Após a chamada da API, nenhuma parcela é selecionada e a importação é confirmada: 
Log de confirmação de importação sem nenhuma seleção de parcela.
No caso de não existir verba associada a uma Instituição de Crédito, é exibido o log a seguir: 
Log mostrando que não foi encontrado vínculo de verba com Instituição de Crédito.
No caso de não encontrar um roteiro FOL para o período atual, é exibido o log a seguir: 
Log mostrando que não foi encontrado roteiro FOL para o período atual.
No caso de não encontrar um período ativo/aberto com o valor informado no filtro, é exibido o log a seguir: 
Log mostrando que não foi possível encontrar um período ativo/aberto.
No caso de não encontrar um Centro de Custo associado ao funcionário que estiver recebendo lançamentos de uma parcela, é exibido o log a seguir: 
Log mostrando que não foi possível encontrar um Centro de Custo associado ao funcionário que estiver recebendo lançamentos de uma parcela. |
| Totvs custom tabs box items |
|---|
| Após a chamada da API, apenas 1 das parcelas é selecionada e a importação é confirmada:  Rotina de Import. Parcelas com a parcela selecionada. 
Log de confirmação de importação da parcela.
Lançamento importado na RGB do funcionário, conforme rotina Lançamentos por funcionário: 
Lançamentos por funcionário com a parcela importada - Mat.: 000014. |
| Totvs custom tabs box items |
|---|
| Após a chamada da API, 2 parcelas são selecionadas e a importação é confirmada:  Rotina de Import. Parcelas com as parcelas selecionadas.
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário:  Image Modified Lançamentos por funcionário com a parcela importada - Mat.: 000014.  Image Modified Lançamentos por funcionário com a parcela importada - Mat.: 00039. |
| Totvs custom tabs box items |
|---|
| Após a chamada da API, todas as parcelas são selecionadas e a importação é confirmada:  Rotina de Import. Parcelas com as parcelas selecionadas. 
Log de confirmação de importação das parcelas.
Lançamentos importados na RGB do funcionário, conforme rotina Lançamentos por funcionário: 
Lançamentos por funcionário com a parcela importada - Funcionário afastado - Mat.: 000014.
Lançamentos por funcionário com a parcela importada - Funcionário em situação normal - Mat.: 00039.
Lançamentos por funcionário com a parcela importada - Funcionário demitido - Mat.: 091500.
Lançamentos por funcionário com a parcela importada - Funcionário transferido - Mat.: 091591. 
Lançamentos por funcionário com a parcela importada - Funcionário em férias - Mat.: 091592. |
| Totvs custom tabs box items |
|---|
| Com o parâmetro "Situações" é possível escolher qual será a situação na folha importada, podendo-se selecionar uma opção ou todas as opções disponíveis.
No exemplo abaixo, será selecionada apenas a opção "Situação Normal":  Parametrização de importação de parcelas considerando o período 202008 e situação normal.
Ao confirmar os parâmetros, é exibida apenas uma parcela disponível para importação com as características solicitadas: 
Parcela disponível para importação, considerando o período 202008 e situação normal.
|
| Totvs custom tabs box items |
|---|
| 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 091230:  Lançamentos por funcionário com a parcela importada - Mat.: 091230.
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: 
Consulta de cálculo por funcionário com a parcela importada - Mat.: 091230. |
| Totvs custom tabs box items |
|---|
| 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:  Log de fechamento do período.
Após o fechamento, o recibo de pagamento do funcionário pode ser consultado:  Recibo de Pagamento - Mat.: 091341.
|
|
...