Árvore de páginas

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.
Informações

1)

...

titleImportante

Esta funcionalidade

...

está disponível a partir do release 12.1.33.

Í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:
Image Removed

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 FiliaisImage Removed

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

Credenciais de AutenticaçãoImage Removed

  • 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.

 Image Removed

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.

Image Removed

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

...

tabsConceito,Imagens
idsusuarios_conceito,usuarios_imagens

...

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.

...

defaultno
referenciausuarios_imagens

Image Removed

Image Removed

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 no endereço de login o seu ALIAS.

Exemplo: https://portalfinanceiroprotheus.totvs-solucoes.com.br/login/aliasteste

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

Image Removed

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

Image Removed

Mensagem personalizada

Totvs custom tabs box items
defaultno
referenciahome_imagens

Image Removed

Image Removed

É 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

Image Removed

Image Removed

Image Removed

Totvs custom tabs box items
defaultno
referenciafiltro_notas

Image Removed

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.

Image Removed

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

Image Removed

Image Removed

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

Image Removed

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

Image Removed

Títulos

...

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

Image Removed

...

defaultno
referenciafiltro_titulos

Image Removed

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"

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

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

Image Removed

Download de boletos pelo portal do cliente.

2) Para utilização do Portal do Cliente a partir de é obrigatório a utilização de LIB maior ou igual a  

Image Added

Painel
borderStylesolid
titleVisão geral

Com o Portal do cliente Backoffice Linha Protheus, o usuário consegue de forma ágil e intuitiva gerir suas atividades financeiras, imprimir boletos e visualizar as notas fiscais eletrônicas que foram emitidas, garantindo assim uma melhor visibilidade de sua saúde financeira.

Conector de Widget
urlhttp://youtube.com/watch?v=b7AtC0SNNuM

Painel
borderStylesolid
titleConfiguração
Expandir
titlePré-Requisitos

Para conseguir utilizar o portal do cliente deve estar habilitado no ambiente o REST e possuir um ALIAS cadastrado no Mingle 

Incluir Página
Configuração - Portal do cliente
Configuração - Portal do cliente

Expandir
titleUsuários de portal

Para definir o usuário que irá utilizar o Portal do cliente utilizamos a funcionalidade já existente no Protheus - Usuários de portal FATA220 

Incluir Página
Usuários de portal - FATA220 - Portal do cliente
Usuários de portal - FATA220 - Portal do cliente

Painel
borderStylesolid
titleFuncionalidades

Atualmente o Portal do Cliente possui as funcionalidades detalhadas abaixo e está em constante evolução.

  • Home - Pagina inicial que contem os valores dos títulos.
  • Notas fiscais - Possui todas as notas emitidas para o cliente.
  • Títulos- Possui todos os títulos gerados para o cliente.
  • Relatórios - É possível configurar relatórios que ficarão disponíveis para download.
  • Seleção de dados - Permite aplicar filtros (filiais e clientes) em todas as visões.
  • Pedidos - Possui todos os Pedidos relacionados ao cliente
Painel
borderStylesolid
titlePontos de entrada
  • PCREPORTS - Configuração de relatórios a serem disponibilizados no Portal do Cliente.
  • PCTITREL -Adiciona relatórios para download nas ações dos títulos.
  • PCTITOBS - Configuração de observações nos títulos do Portal do Cliente.
  • PCTITQRY - Query personalizada para listagem de títulos.
  • PCTITDOW - Habilita o download de anexos dos títulos no Portal do Cliente.
  • NGFBXBOL - Permite o download do boleto em PDF dos boletos personalizados.
  • NGFEMBOL - Permite o envio de e-mail com boletos personalizados.
  • PCINVREL - Adiciona relatórios para download nas ações das notas.
  • PCINVOBS  - Configuração de observações nas notas do Portal do Cliente.


Card documentos
InformacaoPara maiores detalhes sobre a regra de licenciamento do Portal do Cliente, consulte a seção "04 - Licenças" dentro do menu "Pré Requisitos" desta mesma página.
TituloLICENCIAMENTO

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”.

Image Removed

Image Removed

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.

Image RemovedImage RemovedImage Removed

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.

Image RemovedImage RemovedImage Removed

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”.

Image RemovedImage RemovedImage Removed

Image Removed

05. LICENCIAMENTO

...


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>