...
- Protheus versão 12.1.25 ou superior;
- 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;
- Configuração dos Parâmetros (SIGACFG > Ambiente > Cadastros > Parâmetros):
- MV_CONSIG - Preencher com .T. para a ativação da importação de parcelas do TOTVS Consignado, em sua base;
- MV_URLRAC e MV_URLPLAT - Com a configuração do wizard, explicada abaixo, estes parâmetros são automaticamente preenchidos Preenchidos automaticamente com as URLs de produção. Caso o ambiente utilizado seja algum outro, como o de homologação, os conteúdos destes parâmetros devem ser alterados, via configurador, conforme 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, deve incluir uma URL na seção referente ao ambiente, no appserver.ini. A URL em questão é a:
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.
- 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).
| Informações |
|---|
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:
- , após configuração do Wizard. Para mais informações, verificar o item de "Configuração do Wizard", deste documento.
- 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).
| Informações |
|---|
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:
| 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, os conteúdos destes parâmetros devem ser alterados, via configurador, conforme 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, deve incluir uma URL na seção referente ao ambiente, no appserver.ini. A URL em questão é a:
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 |
|
| 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. 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”.  Chamada 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 de para inserção dos dados para 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 |
|
...