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.
...
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
- DBAccess versão TOTVS DBACCESS - BUILD 20.1.1.2 (20200606) ou superior;
- APPSERVER_BUILD-19.3.1.7 ou superior;
- SMARTCLIENT_BUILD-19.3.1.4 ou superior;
- 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 - 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 |
|---|
| tabs | Configuração do Wizard,Agendamento da execução da rotina FWTECHFINJOB |
|---|
| ids | 1,2 |
|---|
|
| Totvs custom tabs box items |
|---|
| | É Para ativar o TOTVS Consignado em seu erp é necessário realizar a configuração do Wizard para conexão e exportação dos dados do ERP para a o ambiente em nuvem. Importante: https://endpoint-registry- 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=ambiente.totvs.app/api/v1/servicesOnde 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. info | 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”.  Figura 01 - Chamada do Wizard, no SmartClientFigura 01
| 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. 
Figura 02 - 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:  Figura 03 - Tela de “Boas vindas” do Wizard, com DBAccess incompatível
Figura 02
|
| 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. 
Figura 04 - Tela com os campos de usuário, senha e seleção de grupo de empresa, para autenticação do acesso
Figura 03
|
| 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. 
Figura 05 -Tela com os campos para inserção dos dados que possibilitam o acesso à plataforma
Figura 04
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. 
Figura 06 - Validação de campos vaziosFigura 05
Figura 07 - Campos preenchidos com informações inválidas Figura 06
|
| 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 Figura 07 08 Figura08 Figura09
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: 
Figura 10 - Exemplo de Schedule que deve ser configurado Figura 09
|
|
Obs. 1: Para mais informações de como configurar o schedule, verificar item 05. 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:
Image Added
Figura 11 - Acesso ao programa
Image Added
Figura 12 - Seleção da localização do parâmetro
Image Added
Figura 13 - Busca do parâmetro
Image Added
Figura 14 - Seleção do parâmetro
Image Added
Figura 15 - Validação da habilitação do parâmetro = .T.
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.
...
- 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;
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
- SR8 - Controle de Ausências
SRA - Funcionários- SRC - Movimento do Período
- 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
...
...