Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Aviso
titleImportante

1) Esta funcionalidade está disponível a partir do release 12.1.33.

2) Para utilização do Portal do Cliente a partir de será obrigatório a utilização de LIB mínima (22-10-10-LIB_LABEL_10102022_P12_HARPIA)

                                                                     

Índice
maxLevel4

01. VISÃO GERAL

Conjunto de funcionalidades para o próprio cliente gerir as atividades financeiras de forma ágil com uma interface moderna.

O Portal do Cliente pode ser acessado no endereço: http://portalfinanceiroprotheus.totvs-solucoes.com.br/

02. CONFIGURAÇÃO

REST ADVPL

  • Incluir as seções no appserver.ini conforme exemplo abaixo.

Para mais informações sobre essa configuração acesse a página Application Server - REST ADVPL.

Bloco de código
languagejava
themeMidnight
titleAppServer.ini
[HTTPV11] 
Enable=1 
Sockets=HTTPREST 
 
[HTTPREST] 
Port=8084
URIs=URIHTML
SECURITY=1
 
[URIHTML]
URL=/html-protheus/rest
PrepareIn=All
Instances=2,2
CORSEnable=1
AllowOrigin=*

[ONSTART]
jobs=HTTPJOB
RefreshRate=30 

[HTTPJOB]
MAIN=HTTP_START
ENVIRONMENT=environment 

Mingle

Mingle é a plataforma disponibilizada como serviço para a sustentação de aplicativos da TOTVS. Resolve três principais necessidades dos clientes, Autenticação, API Gateway e Métricas. Faz isso sem que os produtos tenham que expor suas APIs diretamente, permitindo que os aplicativos as consumam de forma controlável. Para maiores informações acesse a página no TDN.


Informações
titleRede interna

Para a comunicação do Mingle com o Protheus é necessário configurar a segurança de rede para aceitar a entrada da faixa de IP referente ao DNS mingle.totvs.com.br 


Para o acesso do Portal do Cliente deverá ser solicitado um ALIAS e um token conforme os passos abaixo:


Acessar o link Mingle e clique em "solicite seu Alias" e preencha as informações conforme imagem:


Onde:


  • E-mail: endereço de e-mail que será vinculado ao seu cadastro no Mingle.
  • Selecione o App: deverá ser selecionado "Portal do Cliente.
  • Selecione o seu backend: deverá ser informado o endereço público do seu backend, de acordo com as configurações REST previamente feitas.
  • Nome do Servidor: identificação do servidor no Mingle.
  • Cadastrar/Editar empresas e filiais: deverá ser informado o código da empresa e filial base para o backend (vide exemplo abaixo).
  • Cadastrar credenciais de autenticação: deverá ser informado o login e senha do Protheus que será o usuário base de autenticação no Mingle (vide exemplo abaixo).



Cadastrar/Editar empresas e filiais

Empresas e Filiais

Credenciais de Autenticação (Usuário criado no configurador)

Credenciais de Autenticação

  • MV_MINGIUS: Login do Usuário utilizado nas Credenciais de Autenticação.

Utilize o mesmo usuário Protheus informado nas credenciais de autenticação no portal do Mingle, para preencher o valor do parâmetro MV_MINGIUS.

 

Aguarde retorno via ticket com o ALIAS e Token criados pela área de atendimento responsável pelo Mingle.

Deverão ser atualizados os seguintes parâmetros com os dados recebidos no e-mail:

  • MV_MINGTOK: Token de Acesso para requisições ao Mingle.

Copie o Token recebido por e-mail para dentro do parâmetro: MV_MINGTOK.


03. CADASTROS

WEB SERVICES

Totvs custom tabs box
tabsConceito,Imagens
idswebservices_conceito,webservices_imagens
Totvs custom tabs box items
defaultyes
referenciawebservices_conceito

Cadastro responsável pela manutenção de Web Services do Portal, rotina FATA230, disponível nos seguintes módulos:

  • SIGAFAT (5)
  • SIGATCF (18)
  • SIGARSP (20)
  • SIGATEC (28)
  • SIGAPLS (33)
  • SIGATMS (43)
  • SIGAPMS (44)
  • SIGAGAC (59)
  • SIGAVDF (86)

Ao acessar a rotina de Usuário do Portal (FATA220) será incluso o Web Service em todas as filiais do Grupo de Empresas com o código do Web Service "PORTALCLIENTEMINGLE".


USUÁRIOS DO PORTAL

Totvs custom tabs box
tabsConceito,Imagens
idsusuarios_conceito,usuarios_imagens
Totvs custom tabs box items
defaultyes
referenciausuarios_conceito

Cadastro responsável pela manutenção de Usuários do Portal, rotina FATA220, disponível nos seguintes módulos:

  • SIGAFAT (5)
  • SIGATCF (18)
  • SIGATEC (28)
  • SIGAPLS (33)
  • SIGATMS (43)
  • SIGAPMS (44)
  • SIGAGAC (59)
  • SIGAVDF (86)


O sistema apresenta a janela de inclusão, dividida em cabeçalho e itens.

No cabeçalho da parte superior da janela, são informados os dados de identificação do usuário. Observe os seguintes campos:

Usuário

Informe nesse campo o texto que identificará o usuário no Portal.

Senha

Informe a senha do usuário. Mesmo que esse usuário tenha privilégio de grupo, é obrigatória a criação de uma senha para o grupo, pois se trata da senha que o administrador do grupo utilizará para sua manutenção.

Nome

Informe o nome do usuário que está sendo criado.

Privilégio

Informe nesse campo o tipo do usuário, que pode ser:

Usuário - usuário comum que pode acessar o portal com os diretos configurados nesta tela;

Administrador - usuário com direitos de administrador; poderá criar/alterar/excluir novos usuários no portal;

Grupo - usuário que se comporta como um grupo; facilitará a atribuição dos direitos aos usuários que farão parte do grupo.

Usuário Interno

Caso esse usuário seja um funcionário da empresa, como um vendedor, técnico, etc., é necessário vinculá-lo a um usuário interno.

Grupo de Usuários

Para vincular esse usuário a um grupo, clique em Pesquisa para selecioná-lo e, em seguida, clique em Carrega direitos, para que sejam herdados todos os direitos do grupo.

É solicitada confirmação para sobrescrever os direitos do usuário pelos direitos do grupo.


Na área de itens, defina a quais clientes esse usuário terá acesso, pois os dados que serão visualizados no Portal do Cliente são dos clientes anteriormente selecionados.


O Login e Senha deverá repetir-se em todas as filiais em que deseja que o usuário tenha acesso, devido ao fato de o cadastro de Usuários do Portal ser exclusivo entre filiais.

Ao incluir, alterar ou excluir um Usuário de Portal que use na Aba "Direitos" o "PORTALCLIENTEMINGLE" referente ao Mingle, será integrado junto à plataforma o usuário de acordo com a operação executada.

Totvs custom tabs box items
defaultno
referenciausuarios_imagens



04. FEATURES

Informações
titleAlias na URL

É possível carregar a tela de login com o ALIAS já preenchido, para isso bastar informar na URL de login o seu ALIAS.

Exemplo:

Alias: MINHAEMPRESA

Como fica o link: https://portalfinanceiroprotheus.totvs-solucoes.com.br/login/minhaempresa

Login

Totvs custom tabs box
tabsConceito,Imagens
idslogin_conceito,login_imagens
Totvs custom tabs box items
defaultyes
referencialogin_conceito

Página Inicial de Login, com os seguintes campos de preenchimento:

Usuário: Login do Usuário conforme criado no Cadastro de Usuários de Portal (FATA220).

Senha: Senha do Usuário conforme criada no Cadastro de Usuários de Portal (FATA220).

Identificador da Empresa: ALIAS conforme cadastrado no Mingle.

Totvs custom tabs box items
defaultno
referencialogin_imagens


Home

Totvs custom tabs box
tabsConceito,Imagens
idshome_conceito,home_imagens
Totvs custom tabs box items
defaultyes
referenciahome_conceito

Painel com informações financeiras para visualização rápida.

Valores em aberto: gráfico com os valores em aberto.

Títulos à vencer: gráfico com percentual e valores dos títulos à vencer.

Títulos em atraso: gráfico com percentual e valores dos títulos em atraso.

Totvs custom tabs box items
defaultno
referenciahome_imagens


Mensagem personalizada

Totvs custom tabs box items
defaultno
referenciahome_imagens

É possível escrever uma mensagem dinâmica para que o cliente veja a mesma, assim que acessar o Portal do cliente. Para isso escreva a mensagem em texto ou html nos parametrôs: MV_FPCMSG1 e MV_FPCMSG2.

Caso escolha por escrever em HTML, as tags permitidas são: b, i, em, strong, a, br, ul, li, ol.

Notas fiscais

Totvs custom tabs box
tabsConceito,Imagens,Filtro,Detalhes
idsnotas_conceito,notas_imagens,filtro_notas,detalhes_notas
Totvs custom tabs box items
defaultyes
referencianotas_conceito

Lista de Notas Fiscais de Saída. (As notas fiscais de saída que são do tipo beneficiamento ou devolução não irão aparecer no portal do cliente)

Busca avançada com os principais campos.

Totvs custom tabs box items
defaultno
referencianotas_imagens

Totvs custom tabs box items
defaultno
referenciafiltro_notas

Totvs custom tabs box items
defaultno
referenciadetalhes_notas

É possível visualizar os detalhes de uma nota. Para isso clique no link "Detalhes" no registro que deseja visualizar o detalhamento.

Ao clicar será exibido os detalhes da nota com os dados da NF-e e os produtos

Para versões mais recentes é possível também visualizar os títulos referentes à nota fiscal

Caso a nota fiscal não tenha títulos relacionados a aba de títulos é desabilitada


Títulos

Totvs custom tabs box
tabsConceito,Imagens,Filtro,Detalhes
idstitulos_conceito,titulos_imagens,filtro_titulos,detalhes_titulos
Totvs custom tabs box items
defaultyes
referenciatitulos_conceito

Lista de Títulos a Receber.

Busca avançada com os principais campos.

As opções:

  • Copiar linha digitavél
  • Baixar boleto
  • Enviar boleto por e-mail

Estarão desabilitadas caso o titulo esteja totalmente baixado, ou seja, seu saldo é igual á 0.

Totvs custom tabs box items
defaultno
referenciatitulos_imagens

Totvs custom tabs box items
defaultno
referenciafiltro_titulos


Totvs custom tabs box items
defaultno
referenciadetalhes_titulos

É possível visualizar os detalhes do título em qualquer tabela de títulos. Para isso clique nas ações do registro da tabela e selecione a opção "Visualizar"

Ao Clicar na opção será exibido uma tela com os detalhes do título selecionado conforme mostrado na figura abaixo:

Também é possível visualizar as baixas (movimentos) desse título clicando na aba de "Baixas"

Nas movimentações é possível visualizar os registros relacionados à baixa (caso existam), para isso clique no ícone da seta para baixo da linha que deseja expandir

Para voltar para tela que o usuário estava basta clicar no botão "Voltar" ou clicar na seta para esquerda ao lado da palavra "Título"

Totvs custom tabs box items
defaultno
referenciafiltro_titulos

Download de boletos pelo portal do cliente.

Seleção de Dados

Nova funcionalidade para seleção de filial e cliente para a sessão do portal do cliente. Este recurso afetará os dados que serão exibidos no portal, respeitando as filiais e clientes selecionados.

Após logado no sistema clicar no botão de perfil do usuário, localizado na parte superior direita de qualquer tela, e selecionar a opção de “Seleção de Dados”.


Usuário será redirecionado para o passo a passo de “Seleção de Dados”, onde contém os seguintes passo: Filiais, Clientes e Confirmação.

Filiais

Nesse passo o usuário poderá selecionar uma ou mais filiais que serão usados no portal.

É obrigatório informar ao menos uma filial.

Após selecionar as filiais basta clicar no botão avançar para prosseguir para o próximo passo.

Clientes

Nesse passo o usuário deverá selecionar os clientes das filiais, podendo ser selecionado um ou mais clientes.

Também é obrigatório informar ao menos um cliente.

Após selecionar o cliente, basta clicar no botão avançar para prosseguir para o próximo passo.

Confirmação

Último passo do processo onde o usuário poderá visualizar todos os valores selecionados no passos anteriores, clientes e filiais. Os registros exibidos são resumidos pelos clientes selecionados, contendo as filiais do cliente. Para exibir as filiais basta clicar no registro do cliente.


Para finalizar o processo basta clicar no botão de confirmar.

Ao confirmar, o usuário será redirecionado para a tela de origem da requisição da “Seleção de Dados”, ou seja, a tela que o usuário estava antes de clicar em “Seleção de Dados”.


05. LICENCIAMENTO

O Portal do Cliente utiliza licenças do tipo "TOTVS I" e em breve com a "APP Backoffice Vendas". Para saber mais sobre aquisição de licenças, entre em contato com seu Executivo de Soluções TOTVS.


06. CONTEÚDOS RELACIONADOS

Através da funcionalidade de comunicação bancária via API é possível, via implementação de pontos de entrada, personalizar seu boleto e disponibilizá-lo no Portal do Cliente. Saiba mais clicando no link abaixo

JOB Transmissão e Envio de E-mail - FINA713




HTML
<!-- esconder o menu --> 


<style>
div.theme-default .ia-splitter #main {
    margin-left: 0px;
}
.ia-fixed-sidebar, .ia-splitter-left {
    display: none;
}
#main {
    padding-left: 10px;
    padding-right: 10px;
    overflow-x: hidden;
}

.aui-header-primary .aui-nav,  .aui-page-panel {
    margin-left: 0px !important;
}
.aui-header-primary .aui-nav {
    margin-left: 0px !important;
}
</style>