GF - Como Fazer - Portal Financeiro

De CIGAM WIKI
Revisão de 11h57min de 4 de novembro de 2024 por Tais.felles (discussão | contribs) (→‎Requisitos do usuário)


Instalação do Portal Financeiro

Aplicações necessárias para o Portal Financeiro:

  • API
  • Broker
  • CDN
  • Pesquisa Dinâmica
  • BI
  • Portal Financeiro

Para a instalação do Portal Financeiro pela ferramenta CGImplanta, leia o manual GE - Como Fazer - Ferramenta de implantação de sites e aplicações web. Após a instalação, revise se o arquivo config.json esta configurado corretamente e apontando para os servidores de instalação. Exemplo: 

{ 
  "API_URL": "http://cigam-web8:13520/api", 
  "CDN_URL": "http://cigam-web8:13520/cdn/files.ashx/", 
  "CDN_KEY": "1", 
  "APM_MONITOR_URL": "http://cigam-web8:13520/apm", 
  "PORTAL_SERVICOS_URL": "http://cigam-web8:13520/portalservicos", 
  "PD_URL": "http://cigam-web8:13520/pesquisadinamica", 
  "BI_URL": "http://cigam-web8:13520/BI", 
  "DEFAULT_THEME": "CIGAM", 
  "ACTIVE_PORTALS": ["portalfinanceiro"], 
  "DEFAULT_LOGIN": "cigam", 
  "THEMES": null 
}

Verifique se os seguintes parâmetros estão configurados para o Portal Financeiro: 

  "ACTIVE_PORTALS": ["portalfinanceiro"], 
  "DEFAULT_LOGIN": "cigam",

Para os painéis BI, o parâmetro “BI_URL” deve ser informado com o servidor onde o BI foi instalado.

Para o uso da Pesquisa Dinâmica de lançamentos, o parâmetro “PD_URL” deve ser informado com o servidor onde o recurso de pesquisa dinâmica está instalada.

Histórico do Portal Financeiro

Para habilitar o ícone do “Portal Financeiro” no Portal CIGAM é necessário ter o direito "MNGFRELOPE - MENU GF REL OPERACIONAIS" cadastrado.

Até a versão RC 231002, o ícone do “Portal Financeiro” dentro do mosaico de Portais do Portal CIGAM irá direcioná-lo para o Painel Financeiro Padrão CIGAM da aplicação BI, maiores informações sobre este painel podem ser encontrados no manual Painel Financeiro. Lembrando que para este acesso estar disponível, é preciso que se tenha uma instalação CIGAM BI e um painel financeiro BI previamente configurado.

A partir da Versão RC 240506 o acesso pelo botão “Portal Financeiro” do Portal CIGAM irá direcioná-lo para o novo Portal Financeiro CIGAM, contendo todas as funcionalidades apresentadas a seguir nesta WIKI. Além disso, o painel financeiro de BI passa a estar incorporado ao novo portal financeiro e a também ser uma de suas funcionalidades. Para garantir que o portal financeiro esteja acessível através do menu mosaico do portal ERP Cigam, edite o arquivo Web.config do portal Cigam e adicione na chave <add key="MENU_PORTAL_FINANCEIRO" value=" "/> o endereço do site e porta onde a aplicação do portal financeiro foi instalada. Veja abaixo a seção das URL's dos portais contendo um exemplo fictício da chave mencionada: 

    <!--urls portais-->
    <add key="HOST" value="http://cigam-web8:13520"/>
    <add key="MENU_PORTAL_CIGAM" value="portalcigam"/>
    <add key="MENU_PORTAL_ERP" value="portalerp"/>
    <add key="MENU_PORTAL_CRM" value="portalcrm"/>
    <add key="MENU_PORTAL_APROVACOES" value="portalaprovacoes"/>
    <add key="MENU_PORTAL_CLIENTE" value="portalcliente"/>
    <add key="MENU_PORTAL_SERVICOS" value="portalservicos"/>
    <add key="MENU_PORTAL_REPRESENTANTE" value="portalrepresentante"/>
    <add key="MENU_PORTAL_VAREJO" value="portalvarejo"/>
    <add key="MENU_PORTAL_FORNECEDOR" value="portalfornecedor"/>
    <add key="MENU_PORTAL_FINANCEIRO" value="http://cigam-web8:23520"/>
    <add key="MENU_PORTAL_INDUSTRIA" value="portalindustria"/>


Login

Para acessar o portal, primeiro será necessário que o usuário a ser utilizado possua o direito GFLANCTO_P e o Tipo de Acesso igual a Ambos.

Portal Financeiro 00010.png

Após a parametrização informe seu usuário e senha na tela de login do Portal Financeiro.

Portal Financeiro 00008.png

Visão Geral

[Versão 240506 1]Após o login no portal nos é apresentado os principais índices de movimentação:

Portal Financeiro 00001 redimen 2.png

Para a correta visualização dos indicadores, será necessária a parametrização dos seguintes direitos para o usuário:

INDICADORES DIREITOS E/OU MENUS DESCRIÇÃO
Saldo Atual de Portadores Pelo menos um menu e um Direito:

- Menus: “CG02076,CG02105”

- Direitos: “MNGFCON,MNFACON,MNCECON,MNGECON”

- CG02076 = Parâmetros

- CG02105 = Pesquisas

- MNGFCON = MENU GF CONFIGURACOES

- MNFACON = MENU FA CONFIGURACOES

- MNCECON = MENU CE CONFIGURACOES

- MNGECON = MENU GENERICO PARAMETROS

Receber, Pagar, Recebimentos em atraso, Pagamentos em atraso e Variação de entradas e saídas. Pelo menos um menu e o direito:

Menus: CG00003,CG00026,CG00027,CG00031

Direito: "GFLANCTO_P"

- CG00003 = Movimentos

- CG00026 = Pesquisas

- CG00027 = Pesquisas

- CG00031 = Pesquisas

- GFLANCTO_P = GF LANCAMENTO PESQUISAR

Receber

Lista o total e a quantidade de todos lançamentos com tipo Receber que possuam a data de vencimento para o dia atual e utilizem portador com o campo "Tipo Controle" do cadastro de portadores como "Carteira".

Portal Financeiro 00002.png

Pagar

Lista o total e a quantidade de todos lançamentos com tipo Pagar que possuam a data de vencimento para o dia atual e utilizem portador com o campo "Tipo Controle" do cadastro de portadores como "Carteira".

Portal Financeiro 00003.png

Recebimentos em Atraso

Lista todos os lançamentos a receber em atraso e que utilizem portador com o campo "Tipo Controle" do cadastro de portadores como "Carteira".

Portal Financeiro 00004.png

Pagamentos em Atraso

Lista todos os lançamentos a pagar em atraso e que utilizem portador com o campo "Tipo Controle" do cadastro de portadores como "Carteira".

Portal Financeiro 00005.png

Saldo de Portadores

O saldo de portadores exibirá o saldo atual de todos portadores da base que controlarem saldo:

  • Possuírem "Saldo Inicial", esse dado estará presente na guia Saldo do cadastro de portadores;
  • Checkbox "Listar no relatório de saldos" marcado, esse checkbox faz parte da guia Configurações do cadastro de portadores.

Portal Financeiro 00006.png

Variação de entradas e saídas

Neste gráfico podemos visualizar a movimentação entre a data atual e os próximos 30 dias de lançamentos em aberto que utilizem portador com Tipo Controle igual a "Carteira".

Portal Financeiro 00007.png


Portal Financeiro 00009.png

Pesquisa Dinâmica de Lançamentos

A pesquisa dinâmica é o principal local de acesso as funções do portal financeiro em relação a criação e visualização de lançamentos, sendo elas: 

Observação: O menu "Pesquisar Lançamentos" somente será habilitado para usuários que possuírem o direito "GFLANCTO_P (GF LANCAMENTO PESQUISAR)".

Visualização Rápida:

Aqui conseguimos visualizar e localizar os últimos lançamentos criados na base de dados com suas principais informações. Para facilitar a busca de um determinado lançamento utilize o campo "Pesquisar".

Portal Financeiro 00048.png

Se necessário maiores detalhes sobre o lançamento, é disponibilizado o botão para maximizar ou minimizar o lançamento através da visualização rápida:

Portal Financeiro 00049.png


Filtros:

Além do campo "Pesquisar", temos a função de filtragem afim de possibilitar buscas mais aprofundadas com filtros mais abrangentes.

Portal Financeiro 00050.png


Exportação:

O portal também disponibiliza a exportação dos lançamentos, para isso selecione Exportar e defina o formato desejado do arquivo:

Portal Financeiro 00051.png


Visualização do lançamento:

O botão "Visualizar" tem a função de abrir o lançamento em tela e proporcionar uma visualização mais abrangente dos dados do lançamento, trazendo suas informações das guias Geral, Correlatos e Complemento. Selecione o lançamento desejado e clique em "Visualizar" para abrir o lançamento.

Portal Financeiro 00052.png
Capa do lançamento
Portal Financeiro 00053.png

Para o correto funcionamento e exibição de todos os dados na visualização do lançamento será necessária a seguinte parametrização de direitos para o usuário:

FUNCIONALIDADE DIREITOS E/OU MENUS DESCRIÇÃO
Listar Lançamento Pelo menos um Menu e o direito:

- Menus: CG00003,CG00026,CG00027,CG00031

- Direito: "GFLANCTO_P"

- CG00003 = Movimentos

- CG00026 = Pesquisas

- CG00027 = Pesquisas

- CG00031 = Pesquisas

- GFLANCTO_P = GF LANCAMENTO PESQUISAR

Busca Liquidações Pelo menos um Menu e o direito:

- Menus: CG00003,CG00026,CG00027,CG00031

- Direito: "GFLANCTO_P"

- CG00003 = Movimentos

- CG00026 = Pesquisas

- CG00027 = Pesquisas

- CG00031 = Pesquisas

- GFLANCTO_P = GF LANCAMENTO PESQUISAR



No botão "Contábil" teremos os valores referentes ao rateio contábil/gerencial do lançamento.

Rateio Contábil
Portal Financeiro 00054.png
Rateio Gerencial
Portal Financeiro 00055.png

Para o correto funcionamento dos botões “Contábil” e “Gerencial”, serão necessários os direitos abaixo:

FUNCIONALIDADE DIREITOS E/OU MENUS DESCRIÇÃO
Debitar Creditar Pelo menos um Menu e o direito:

- Menus: CG00003,CG00026,CG00027,CG00031

- Direito: "GFLANCTO_P"

- CG00003 = Movimentos

- CG00026 = Pesquisas

- CG00027 = Pesquisas

- CG00031 = Pesquisas

- GFLANCTO_P = GF LANCAMENTO PESQUISAR

Buscar Rateio Pelo menos um Menu e o direito:

- Menus: CG00003,CG00026,CG00027,CG00031 - Direito: "GFLANCTO_P"

- CG00003 = Movimentos

- CG00026 = Pesquisas

- CG00027 = Pesquisas

- CG00031 = Pesquisas

- GFLANCTO_P = GF LANCAMENTO PESQUISAR

Cria Conforme Modelo

[Versão 240506 2]O objetivo dessa funcionalidade é permitir a geração de lançamentos financeiros pelo portal financeiro através de modelos de lançamento previamente cadastrados, sejam eles um “Contas a Pagar” (Pagar ou Saída) ou um “Contas a Receber” (Receber ou Entrada).

Requisitos do usuário

Para a criação de lançamentos conforme modelo no portal financeiro, o usuário deve ter os seguintes direitos:

Botão “+ CRIAR”

Para que o botão "+ CRIAR" seja habilitado, será necessário o direito:

FUNCIONALIDADE DIREITOS E/OU MENUS DESCRIÇÃO
Criar Lançamento Conforme Modelo Deve possuir o Direito: "GFLANCTO_P" GFLANCTO_P = GF LANCAMENTO PESQUISAR

Criar lançamento Conforme Modelo

Para o funcionamento total para “Criar lançamentos conforme modelo”, são necessários todos os direitos e menus, conforme mapeados abaixo:

FUNCIONALIDADE DIREITOS E/OU MENUS DESCRIÇÃO
Exemplo Exemplo Exemplo
Exemplo Exemplo Exemplo
Exemplo Exemplo Exemplo



Também vale lembrar que o usuário deve estar dentro dos limites permitidos do módulo "FINANCEIRO".

Cadastro do modelo

Antes de partir para a criação de lançamentos pelo portal financeiro, precisamos dos modelos de lançamento previamente cadastrados através do Cigam desktop. O que definirá um modelo apto a ser utilizado na web é o checkbox 'Disponibilizar na Web' marcado, ele será responsável por definir os modelos que serão apresentados no portal e validar os campos necessários para que um modelo de lançamento possa ser apresentado na web, ou seja, somente poderá ter esta opção marcada um modelo de lançamento que suprir as regras definidas nas informações adicionais sobre o uso na web:

Portal Financeiro 00026.png


Portal Financeiro 00027.png

Após o cadastro, inclua os novos modelos na faixa de exibição de modelos de lançamento nas configurações GF - GE - 1483 - Faixa inicial dos "Modelos de Lançamento" e GF - GE - 1484 - Faixa final dos "Modelos de Lançamento".

Criação do lançamento

No Portal financeiro, vá para a pesquisa dinâmica e clique em "Criar".

Portal Financeiro 00024.png

Nesta tela serão apresentados todos modelos cadastrados que estiverem com o checkbox "Disponibilizar na Web" marcado e dentro da faixa das configurações GF - GE - 1483 - Faixa inicial dos "Modelos de Lançamento" e GF - GE - 1484 - Faixa final dos "Modelos de Lançamento" conforme a seção cadastro do modelo.

Para facilitar a busca do modelo podemos digitar o código ou a descrição do modelo no campo de pesquisa, também podemos filtrar por tipo sendo eles Receber, Pagar, Entrada ou Saída. Localizado o modelo, selecione-o para abrir a tela de criação.

Portal Financeiro 00056.png

Na tela de criação serão apresentados todos dados previamente cadastrados no modelo restando apenas os campos de preenchimento final, como valor, previsão, documento e complemento. Mesmo nos campos com valores ja informados no cadastro do modelo (como empresa, portador e conta) podemos alterá-los conforme necessidade. Vale lembrar que neste ponto apenas conseguimos utilizar cadastros já existentes na base de dados, não permitindo a criação de novos cadastros de modelos de lançamento pelo portal. Apesar de não ser demonstrado em tela o histórico nesse momento, já estará configurado para utilizar o cadastrado no modelo. Abaixo descreveremos cada campo da tela de criação.

Portal Financeiro 00057.png

    • Unidade de negócio: Por padrão será utilizada a unidade de negócio cadastrada na configuração GE - AM - 21 - Unidade de negócio padrão, pode ser alterado para outra unidade já existente;
    • Empresa: Inicia com a empresa informada no cadastro do modelo, caso o modelo não tenha empresa informada iniciará em branco, pode ser alterado para outra empresa já existente;
    • Portador: Inicia com o portador informado no cadastro do modelo, caso o modelo não tenha portador informado iniciará em branco, pode ser alterado para outro portador já existente. Caso o checkbox "Exigir Portador" no cadastro do modelo estiver marcado o portador deve ser informado para a criação do lançamento;
    • Conta: Inicia com a conta informada no cadastro do modelo, caso o modelo não tenha conta informada iniciará em branco, pode ser alterado para outra conta já existente. A conta financeira deve ter rateio contábil completo para permitir a criação do lançamento, para mais informações consulte a seção Rateio Financeiro.
    • Projeto: Inicia com o projeto informado no cadastro do modelo, caso o modelo não tenha projeto informado iniciará em branco, pode ser alterado para outro projeto já existente;
    • Emissão: Por padrão inicia com a data atual, pode ser alterado para outra data seja anterior ou posterior;
    • Vencimento: Esse campo será habilitado e permitirá a modificação somente se o checkbox "Solicitar Vencimento" estiver marcado no cadastro do modelo, caso contrário, ficará desabilitado e o lançamento será gerado com vencimento na data da emissão.
    • Valor a Lançar: Inicia com o valor informado no cadastro do modelo, caso o modelo não tenha valor informado iniciará em branco, pode ser alterado e deve estar preenchido para a criação do lançamento.
    • Previsão: Habilitado apenas para modelos Receber ou Pagar. Define se o lançamento será oficial ou de previsão, clique no botão para torná-lo previsão.
    • Documento: Esse campo será habilitado somente se o checkbox "Solicitar Documento" estiver marcado no cadastro do modelo, com ele marcado o documento deve ser preenchido para a criação do lançamento.
    • Complemento: Esse campo será habilitado somente se o checkbox "Solicitar Complemento Histórico" estiver marcado no cadastro do modelo. O estado do checkbox terá os seguintes comportamentos:
      • Desmarcado: Campo "Complemento" na criação de lançamentos conforme modelo pelo portal ficará desabilitado, caso o modelo esteja cadastrado com o "Complemento Sugestão" preenchido esse dado será utilizado na criação do lançamento, caso contrário, o complemento histórico ficará vazio.

      • Marcado: Campo "Complemento" na criação de lançamentos conforme modelo pelo portal ficará habilitado permitindo a modificação. Caso o modelo esteja cadastrado com o "Complemento Sugestão" preenchido, essa informação não será mostrada na web mas será utilizada na criação do lançamento, se "Complemento" pela web informado e "Complemento Sugestão" no cadastro do modelo também preenchido o sistema irá concatenar os dados da seguinte forma: [complemento informado no portal] + [complemento sugestão no cadastro do modelo].

      Observação: o complemento no portal também permite a utilização das tags do complemento sugestão presentes no cadastro de modelos, abaixo teremos a legenda de cada tag disponibilizada:

Portal Financeiro 00041.png

Após todas informações do modelo serem devidamente informadas, clique em "Continuar" para confirmar e continuar criando lançamentos ou "Finalizar" para concluir a criação. Toda vez que você confirmar ou concluir a criação de um lançamento, primeiro ele será adicionado a lista de pré-lançamentos antes de ser criado efetivamente na base de dados, essa listagem servirá como uma fonte de consulta onde podemos ter vários pré-lançamentos e conferir se os lançamentos que se deseja criar foram preenchidos corretamente antes de assim efetivá-los.

Portal Financeiro 00058.png

Realizada a conferência dos pré-lançamentos, caso encontre alguma inconsistência em um dos títulos, basta deixá-lo desmarcado e criá-lo novamente selecionando o modelo na parte de seleção de modelos. Com os títulos já revisados e corretamente cadastrados, clique em "Efetivar selecionados" para dessa vez criar de fato os lançamentos que se mantiveram marcados na lista.

Importante: Os pré-lançamentos são apenas uma visualização prévia dos lançamentos que poderão ser criados se assim selecionados, portanto, não existindo de fato na base de dados como um lançamento financeiro gerado no Cigam. Para que o pré-lançamento se torne um lançamento financeiro na base de dados do Cigam, é necessário selecioná-lo e efetivá-lo, somente após essa etapa é que esse lançamento ficará visível tanto no portal financeiro através da pesquisa dinâmica, quanto por qualquer rotina do desktop, inclusive pela própria rotina de Lançamentos Financeiros (CG00003).

O Portal será recarregado e os novos lançamentos serão adicionados a pesquisa dinâmica, para visualizá-los selecione o lançamento e clique em "Visualizar".

Portal Financeiro 00059.png


Lançamento criado
Portal Financeiro 00060.png


Rateio contábil vinculado a conta financeira
Portal Financeiro 00061.png

Rateio Financeiro

[Versão 241007 1]Todo lançamento a ser criado pelo cria conforme modelo através do portal financeiro validará as seguintes configurações para o rateio financeiro:


Rateio Contábil:

Para a utilização do rateio contábil, um dos cadastros deve estar preenchido, sendo eles:

    • Campo "Contábil sugestão" do cadastro de contas financeiras.

Portal Financeiro 00045.png

    • Cadastro "Rateio Padrão Financeiro - Contábil". Este por sua vez, somente é utilizado caso o
    campo mencionado acima estiver em branco.

Portal Financeiro 00046.png


Rateio Gerencial

O rateio gerencial somente será utilizado quando for criado um rateio contábil para uma conta que esteja inserida no cadastro "Relacionamento Contábil x Gerencial".

O preenchimento do Rateio Gerencial no módulo financeiro é obtido através do cadastro de "Rateio Padrão" onde se aponta uma ou mais contas gerenciais a serem utilizadas em uma determinada conta contábil.

Portal Financeiro 00047.png


Validação do pré-lançamento

Havendo parametrização para exigir 100% do rateio, seja contábil ou gerencial, o pré-lançamento obrigatoriamente deve ter o rateio 100% completo, podendo ser através da conta financeira ou informando manualmente. Não sendo utilizado um rateio que atenda essa condição, a efetivação será bloqueada.

Portal Financeiro 00062.png

Para prosseguir recrie o lançamento utilizando uma conta financeira com rateio completo ou informe as contas contábeis/gerenciais manualmente através do botão "Rateio".

Portal Financeiro 00063.png

Clicando no botão "Rateio" entraremos na tela contábil, onde será permitido a inserção de uma ou mais contas contábeis com suas respectivas porcentagens. Havendo relacionamento contábil x gerencial, o botão gerencial será habilitado, e assim como na tela contábil, a tela gerencial permitirá a inserção das contas gerenciais. Ambas as telas irão solicitar o preenchimento de 100% do rateio, impedindo a saída caso a condição não seja atendida. Ao final, retornando a tela de pré-lançamentos nosso lançamento de exemplo terá o checkbox habilitado, e assim, permitindo sua efetivação.

Observação: as contas contábeis e gerenciais devem ser previamente cadastradas na base de dados, considerando que o portal apenas utiliza dados já existentes não disponibilizando o cadastro dos mesmos.


Validação de rateios para lançamentos de previsão

Em cenários onde a configuração GF - GE - 1067 - Permitir rateio para lançamentos de previsão está desmarcada, para manter a integridade do lançamento, o botão "Rateio" será desabilitado da tela de pré-lançamentos já que o lançamento de previsão não será contabilizado. Caso contrário, com a configuração marcada, o botão será habilitado e executará as mesmas validações mencionadas no tópico anterior.

Dashboards

No menu Relatórios/Dashboards disponibilizamos os principais dashboards financeiros. Para mais informações de cada dashboard consulte os seguintes manuais:

Portal Financeiro 00023.png


Documentos Relacionados

Versões

Versão 240506

  1. ↑ Liberado a partir da OS 716991/4.
  2. ↑ Liberado a partir da OS 716991/11.

Versão 241007

  1. ↑ Liberado a partir da OS 716991/15.
Disponível em "https://www.cigam.com.br/wiki/index.php?title=GF_-_Como_Fazer_-_Portal_Financeiro&oldid=136020"