Essa documentação se aplica somente ao Módulo de Caixa 2.0.

Conteúdo totalmente técnico, direcione para o time de TI da empresa.

As evoluções da Linha RM, utilizam a integração da MDI atual 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.


Configurando as portas 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 Módulo de Caixa 2.0.


A execução do Host precisa ser como administrador:

  • Caso o Host seja iniciado como aplicativo (RM.Host.exe), certifique-se que ao executá-lo, tenha selecionado a opção "Executar como Administrador".
  • Caso o Host tenha sido instalado como serviço, o usuário vinculado ao serviço deve ser um administrador do sistema.

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 Módulo de Caixa, 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 Módulo de Caixa 2.0.

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.

Em breve, mais detalhes sobre as permissões do Novo Módulo de Caixa serão descritas aqui e o texto definido abaixo será revisado contemplando o novo cenário.


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.


 Voltar para o Menu Principal