Linha Microsiga Protheus

Árvore de páginas

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

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

Visã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.

Configuração

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


01. REST

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.

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


02. 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 API's diretamente, permitindo que os aplicativos as consumam de forma controlável. Para maiores informações acesse a página no TDN.

Rede 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 (Clique aqui para ver o exemplo).

IMPORTANTE

O Mingle permite o vínculo de um ALIAS somente a uma empresa ou grupo de empresas do Protheus. Caso você possua mais de uma empresa ou grupo de empresas, é necessário a criação de um ALIAS para cada uma dessas entidades (empresa ou grupo de empresas).

  • 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 (Clique aqui para ver o exemplo).

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


03. PARAMETROS UTILIZADOS

 Após recebimento do e-mail como citado no tópico acima, deverão ser atualizados os seguintes parâmetros:

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.

 


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

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


04. LICENÇAS

Para utilização do Portal do Cliente, é necessário possuir uma licença, conforme detalhamento abaixo:


  • TOTVS I: caso sua empresa tenha contratado o ERP Protheus sob licença Tradicional.
  • APP Backoffice Vendas: caso sua empresa tenha contratado o ERP Protheus sob licença Intera.
  • Nenhuma licença adicional: caso sua empresa tenha contratado licença Corporativa.


Para maiores detalhes, contate seu ESN TOTVS (Executivo de Soluções de Negócios).

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

01. VISÃO GERAL

Cadastro de usuário para acesso ao Portal do cliente.

Importante

As tabelas relacionadas ao usuário de portal devem possuir o mesmo compartilhamento.

As tabelas utilizado no portal do cliente são:  AI3 (Usuários do Portal) , AI4 (Usuários do Portal x Cliente ) e AI6 (Direitos).

02. WEB SERVICES

Cadastro responsável pela manutenção de Web Services do Portal (FATA230), que irá ser utilizado para comunicação com o Mingle

A criação do Web Service "PORTALCLIENTEMINGLE", irá ocorrer de forma automática em todas as filiais do Grupo de Empresas, assim que for acessada a rotina de Usuários de portal (FATA220).


Importante

  • Usuários com acesso ao Portal do Cliente através do direito "PORTALCLIENTEMINGLE" têm permissão exclusiva para utilizar este portal, não sendo permitido adicionar outros direitos para uso em portais diferentes.

03. USUÁRIOS

Cadastro responsável pela manutenção de Usuários do Portal, rotina FATA220:


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 aba "Direitos", informe o web service "PORTALCLIENTEMINGLE".

Na aba "Clientes", informe os clientes que esse usuário terá permissão de visualizar os dados no portal.

  • Para inclusão e alteração de usuário, ao inserir um código de cliente, se na aba "Direitos" o web servise "PORTALCLIENTEMINGLE" estiver preenchido o sistema busca outras lojas do mesmo código de cliente e caso encontre será apresentada opção para que sejam preenchidas as próximas linhas com as outras lojas automaticamente. Da mesma maneira ocorre com grupo de vendas (A1_GRPVEN). caso o cliente possua grupo de vendas, será apresentada opção para que sejam preenchidas as próximas linhas com outros códigos e lojas de clientes do mesmo grupo de vendas.


Importante

  • O Login e Senha deverá repetir-se em todas as filiais em que deseja que o usuário tenha acesso, devido ao fato do 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 Web Service "PORTALCLIENTEMINGLE", a operação será integrada a plataforma, ou seja, o usuário no Mingle também será afetado.


A partir da expedição continua de Dezembro/2022 será possível enviar e-mail para o cliente com os acessos previamente configurados como Usuários do Portal, rotina FATA220:

Criação do parâmetro MV_FMINGAL que será responsável por armazenar o Alias de acesso ao mingle ( Para mais informação sobre o Alias e o mingle acesse a documentação - Conheça o Mingle ), caso o parâmetro não exista ou não tiver conteúdo não será enviado o e-mail para o cliente.

Para que o e-mail seja enviado também é preciso informar o e-mail de destino no campo E-mail (AI3_EMAIL) do cadastro do usuário.


Layout do e-mail que será enviado:

Ao acessar o link pelo e-mail, o alias de acesso ao mingle do parâmetro MV_FMINGAL estará preenchido:


Importante

Para o correto envio do e-mail se faz necessário a Configuração do Servidor de E-mail/Proxy (CFGSETMAIL - SIGACFG)

O e-mail é disparado quando um novo usuário é cadastrado ou quando a senha de um usuário já existente sofre alteração.

A partir da expedição continua de Dezembro/2022 será possível, ao incluir um cliente, logo em seguida vincular este cliente a um Usuários do Portal, rotina FATA220:


No cadastro de cliente - rotina CRMA980 foi criado um "pergunte" - F12:

Cadastra Usuário Portal ?


Com o pergunte como Sim, e o parâmetro MV_MINGTOK configurado, ao confirmar a inclusão do cliente será apresentada tela para selecionar os usuários:

  • Para usuário que já existem na base, buscar pelo campo Código
  • Para incluir usuário novo, deixar o campo código em branco (o campo código será preenchido no final do processo) e preencher o restante dos campos.


Na próxima tela é possível selecionar/adicionar os clientes.

  • Caso exista outras lojas para o mesmo código de cliente, o sistema apresenta opção caso deseje carregar as outras lojas automaticamente.

  • Caso o cliente possua grupo de vendas (A1_GRPVEN) o sistema apresenta opção caso deseje carregar outros clientes do mesmo grupo de vendas automaticamente.


Ao finalizar, o sistema adicionará todos clientes a todos os usuários, usuários novos serão criados, e a todos os usuários será adicionado direito ao portal do mingle:


Importante

Importante: Todos os clientes selecionados serão adicionados a todos os usuários selecionados.

Caso o ambiente esteja configurado para mandar e-mail automático, o mesmo somente será enviado caso seja realizada a criação de um novo usuário. (É necessário que os usuários possuam o campo de e-mail configurado).

Funcionalidades

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


LICENCIAMENTO

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