Com o objetivo de otimizar as ações do Módulo de Caixa, as novas rotinas utilizam a integração da MDI atual da Linha RM com telas em HTML, tudo isso de forma transparente ao usuário. 

Para utilizar esse novo recurso, é necessária a realização de algumas configurações que irão habilitar o uso das APIs que fazem a execução das ações e processos da nova interface. Nesse documento você encontrará orientações de como configurar o seu ambiente para começar a utilizar o Novo Módulo de Caixa.

Configurando as portas da API

O aplicativo RM.Host é responsável por hospedar e expor os serviços de APIs.

Veja mais sobre a configuração da porta webApi.

A tag ApiPort configurada nesta etapa será utilizada para acessar as APIs que fazem parte das rotinas do Novo Módulo de Caixa.

Para validar se as configurações de portas das APIs foram realizadas corretamente, acesse o browser e digite a URL  http://{IP ou domínio}:{porta}/api/swagger/. Exemplo: http://10.173.17.242:8051/api/swagger Importante na validação usar o IP, nome da máquina ou domínio. Verifique se a página abaixo foi carregada

Conectando com o banco de dados

Para que a API saiba em qual banco de dados conectar quando for acionada pelo Portal, devemos configurar a tag DefaulDB.

Veja mais em Configurando DefaultDB.

Para validar se a configuração da comunicação com o banco de dados das APIs foi realizada corretamente, acesse a API via browser. Exemplo: http://10.173.17.242:8051/api/financial/v1/paymenttypes/1 Neste exemplo estamos buscando do cadastro de Meios de Pagamento todos os que são pertencentes à coligada 1, ao acessar será solicitado um usuário do sistema que tenha acesso a este cadastro dentro do sistema. Você deverá ter um resultado semelhante a este, onde lista os registros do cadastro de meios de pagamento da coligada 1.

Após configurar a API é necessário ajustar o arquivo de configuração do Portal Financeiro.

Para isso, acesse o arquivo config.json que está disponível no diretório da instalação do RM em:  “...\RM.Net\wwwroot\PortalFinanceiro\config”.

No arquivo, alterar as informações a seguir:

• "apiServer": "http://INFORME_NOME_DA_MAQUINA_QUE_ESTA_EXECUTANDO_O_HOST:PORTA",
• "basePath": "/FrameHTML/Web/App/Fin/PortalFinanceiro",
• "defaultAlias": "infome_o_nome_do_Alias",
• "urlCorpore": "",
• "multitenant": "false" (Alterar para TRUE, se utilizar MultiTenancy)
• "subDomainMask": "[ALIAS].localhost", (se utilizar MultiTenancy deve alterar o localhost pelo nome da máquina que está executando o host)

Exemplo após a configuração

A validação de acesso continua considerando o usuário que está logado no TOTVS Gestão Financeira no momento da ativação da Sessão de Caixa.

O sistema permite que seja atribuído a cada operador um nível de acesso aos recursos através das definições do perfil. É possível criar um perfil para Supervisor, esse deve ser atribuído ao usuário que irá gerenciar as Sessões e um perfil para Operador, com acesso limitado às operações da Sessão do Caixa.
 
Para configurar o perfil acesse: Serviços Globais | Segurança | Perfis - Usuários.

Operador Supervisor

É necessário cadastrar um perfil que tenha acesso aos principais menus do Módulo de Caixa, cadastrar o usuário definindo que o mesmo será supervisor, indicar a coligada e associá-lo ao perfil criado.

Operador de Caixa

Será necessário cadastrar um perfil para o Operador, permitindo ou restringindo acesso aos principais menus do Caixa, cadastrar o usuário e associá-lo ao perfil criado.

Integração com outros Módulos

O sistema permite utilizar a tela de recebimento do Novo Módulo de Caixa por meio da visualização de lançamentos.

Para ter acesso ao Recebimento via Sessão de Caixa, é necessário que o usuário possua permissão em: Serviços Globais | Segurança | Perfis | Acesso a Menus | Gestão Financeira | Contas a Pagar/Receber | Operações Financeiras | Lançamentos | Recebimento via Sessão de Caixa.