Árvore de páginas

Versões comparadas

Chave

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

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

Aviso

O Novo Portal do Cliente está em fase de homologação e liberado apenas para clientes pilotos.

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

...

titleAtenção

...

release 12.1.33

...

.

...

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 

Seção HTTP

  • Incluir as seções no appserver.ini conforme exemplo abaixo.
  • Extrair projeto buildado no diretório configurado na seção HTTP.
  • Editar o arquivo appConfig.json, alterado o serverBackend conforme IP e Porta do REST - ADVPL configurado, conforme exemplo abaixo.

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

Bloco de código
languagejava
themeMidnight
titleAppServer.ini
[HTTP]
enable=1
port=8080
path=D:\TOTVS\Protheus_Data\web\portal-cliente
defaultpage=index.html

Bloco de código
languageyml
themeMidnight
titleappConfig.json
{
  "name": "Portal do Cliente",
  "version": "12.1.27-0.1.0",
  "serverBackend": "http://localhost:8084/",
  "restEntryPoint": "",
  "versionAPI": "",
  "productLine": "Protheus"
}

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.

Para o acesso do Portal do Cliente deverá ser solicitado o ALIAS único conforme 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).

Empresas e FiliaisImage RemovedCredenciais de AutenticaçãoImage Removed

Aguarde retorno via e-mail com o ALIAS criado e demais informações.

Deverão ser atualizados os seguintes parâmetros com os dados recebidos pela equipe do Mingle:

  • MV_MINGTOK: Token de Acesso para requisições ao Mingle.
  • MV_MINGIUS: Login do Usuário utilizado nas Credenciais de Autenticação.

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 "PORTALCLIENTE".

Totvs custom tabs box items
defaultno
referenciawebservices_imagens

Image Removed

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 "PORTALCLIENTE" referente ao Mingle, será integrado junto à plataforma o usuário de acordo com a operação executada.

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.
  • PCMNLOGO - Permite alterar o logo do menu do Portal do Cliente.
  • PCBROWSE - Permite incluir opções de menu para listagem de itens customizados no Portal do Cliente.
  • PCINVQRY - Query personalizada para listagem das notas fiscais 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

...

defaultno
referenciausuarios_imagens

Image Removed

Image Removed

04. FEATURES

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.

Títulos em aberto: gráfico com percentual e valores dos títulos a receber em aberto.

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

Valores dos títulos: gráfico que contém os valores totais por mês dos títulos a receber.

Totvs custom tabs box items
defaultno
referenciahome_imagens

Image Removed

Notas fiscais

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

Lista de Notas Fiscais de Saída.

Busca avançada com os principais campos.

Totvs custom tabs box items
defaultno
referencianotas_imagens

Image Removed

Totvs custom tabs box items
defaultno
referenciafiltro_notas

Image Removed

Títulos

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

Lista de Títulos a Receber.

Busca avançada com os principais campos.

Totvs custom tabs box items
defaultno
referenciatitulos_imagens

Image Removed

Totvs custom tabs box items
defaultno
referenciafiltro_titulos

Image Removed

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

...


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>