Linha Microsiga Protheus - Espanhol

Atalhos

Árvore de páginas

1) Esta funcionalidad está disponible a partir del release 12.1.33.

2) Para la utilización del Portal del Cliente a partir del es obligatoria la utilización del LIB mayor o igual al  


Visión general

Con el Portal del cliente - Backoffice Linha Protheus, el usuario consigue de forma ágil e intuitiva administrar sus actividades financieras, imprimir boletas y visualizar las facturas electrónicas que se emitieron, garantizando de esta manera una mejor visibilidad de su salud financiera.

Configuración

Para utilizar el portal del cliente, debe estar habilitado en el entorno REST y tener un ALIAS registrado en el Mingle 


01. REST

Incluir las secciones en el appserver.ini de acuerdo con el siguiente ejemplo. Para más información sobre esta configuración, acceda a la 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 es la plataforma puesta a disposición como servicio para el sostenimiento de aplicaciones TOTVS. Resuelve tres principales necesidades de los clientes, Autenticación, API Gateway y Métricas. Hace esto sin que los productos tengan que exponer sus API directamente, permitiendo que las aplicaciones las consuman de forma controlable. Para más información acceda a la página en en TDN.

Red interna

Para la comunicación del Mingle con el Protheus es necesario configurar la seguridad de red para aceptar la entrada del rango de IP referente al DNS  mingle.totvs.com.br 


Para el acceso al Portal del cliente debe solicitarse un ALIAS y un token de acuerdo con los siguientes pasos:

Acceda al enlace Mingle, haga clic en "solicite su Alias" y complete la información de acuerdo con la imagen:


Donde:

  • E-mail: dirección de e-mail que se vinculará a su registro en el Mingle.
  • Seleccione el App: debe seleccionarse "Portal del cliente".
  • Seleccione su backend: debe informarse la dirección pública de su backend, de acuerdo con las configuraciones REST previamente realizadas.
  • Nombre del servidor: identificación del servidor en el Mingle.
  • Registrar/Editar empresas y sucursales: debe informarse el código de la empresa y sucursal base para el backend (Haga clic aquí para ver el ejemplo).

IMPORTANTE

El Mingle permite el vínculo de un ALIAS solamente a una empresa o grupo de empresas del Protheus. Si usted tiene más de una empresa o grupo de empresas, es necesaria la creación de un ALIAS para cada una de estas entidades (empresa o grupo de empresas).

  • Registrar credenciales de autenticación: debe informarse el login y contraseña del Protheus que será el usuario base de autenticación en el Mingle (Haga clic aquí para ver el ejemplo).

Espere devolución por medio del ticket con el ALIAS y Token creados por el área de atención responsable por el Mingle.


03. PARÁMETROS UTILIZADOS

 Después de recibir el e-mail como se menciona en el ítem anterior, deben actualizar los siguientes parámetros:

MV_MINGIUS: Login del usuario utilizado en las credenciales de autenticación.

Utilice el mismo usuario Protheus informado en las credenciales de autenticación en el portal del Mingle, para completar el valor del parámetro MV_MINGIUS.

 


MV_MINGTOK: Token de acceso para requisiciones al Mingle.

Copie el Token recibido por e-mail dentro del parámetro: MV_MINGTOK.


04. LICENCIAS

Para utilización del Portal del Cliente, es necesario tener una licencia, de acuerdo con el siguiente detalle:


  • TOTVS I: si su empresa ha contratado el ERP Protheus bajo licencia Tradicional.
  • APP Backoffice Vendas: si su empresa ha contratado el ERP Protheus bajo licencia Intera.
  • Ninguna licencia adicional: si su empresa ha contratado una licencia Corporativa.


Para más detalles, entre en contacto con su ESN TOTVS (Ejecutivo de Soluciones de Negocios).




Para definir el usuario que utilizará el Portal del cliente utilizamos la funcionalidad ya existente en el Protheus - Usuarios de portal FATA220 

01. VISIÓN GENERAL

Registro de usuario para acceso al Portal del cliente.

Importante

Las tablas relacionadas con el usuario del portal deben tener el mismo uso compartido.

Las tablas utilizadas en el portal del cliente son:  AI3 (Usuarios do Portal), AI4 (Usuarios del Portal vs. Cliente ) y AI6 (Derechos).

02. WEB SERVICES

Registro responsable por el mantenimiento de Web Services del Portal (FATA230), que se utilizará para comunicación con el Mingle

La creación del Web Service "PORTALCLIENTEMINGLE", ocurrirá de forma automática en todas las sucursales del Grupo de empresas, después de acceder a la rutina Usuarios del portal (FATA220).

Importante

  • Usuarios con acceso al Portal del cliente por medio del derecho "PORTALCLIENTEMINGLE" tienen permiso exclusivo para utilizar este portal, no siendo permitido agregar otros derechos para uso en portales diferentes.

03. USUARIOS

Registro responsable por el mantenimiento de Usuarios del portal, rutina FATA220:


El sistema muestra la ventana de inclusión, dividida en encabezado e ítems.

En el encabezado de la parte superior de la ventana, se informan los datos de identificación del usuario. Observe los siguientes campos:

Usuario

Informe en este campo el texto que identificará al usuario en el Portal.

Contraseña

Informe la contraseña del usuario. Aunque este usuario tenga privilegio de grupo, es obligatoria la creación de una contraseña para el grupo, pues se trata de la contraseña que el administrador del grupo utilizará para su mantenimiento.

Nombre

Informe el nombre del usuario que se está creando.

Privilegio

Informe en este campo el tipo del usuario, que puede ser:

Usuario - usuario común que puede acceder al portal con los derechos configurados en esta pantalla.

Administrador - usuario con derechos de administrador; podrá crear/modificar/borrar nuevos usuarios en el portal.

Grupo - usuario que se comporta como un grupo; facilitará la atribución de los derechos a los usuarios que formarán parte del grupo.

Usuario interno

Si este usuario fuera un empleado de la empresa, como un vendedor, técnico, etc, es necesario vincularlo a un usuario interno.

Grupo de usuarios

Para vincular este usuario a un grupo, haga clic en Búsqueda para seleccionarlo, y a continuación, haga clic en Carga derechos, para que se hereden todos los derechos del grupo.

Se solicita una confirmación para sobrescribir los derechos del usuario por los derechos del grupo.


En la solapa "Derechos", informe el web service "PORTALCLIENTEMINGLE".

En la solapa "Clientes", informe los clientes a los que este usuario tendrá permiso de visualizar sus datos en el portal.

  • Para inclusión y modificación de usuario, al incluir un código de cliente, si en la solapa "Derechos" el web servise "PORTALCLIENTEMINGLE" estuviera informado, el sistema buscará otras tiendas con el mismo código de cliente y, si las encuentra, se mostrará la opción para que se completen las próximas líneas con las otras tiendas automáticamente. De la misma manera ocurre con el grupo de ventas (A1_GRPVEN), si el cliente tiene un grupo de ventas, se mostrará una opción para que se informen las próximas líneas con otros códigos y tiendas de clientes del mismo grupo de ventas.


Importante

  • El Login y Contraseña debe repetirse en todas las sucursales dónde el usuario desea tener acceso, debido a que el registro de Usuarios del portal es exclusivo entre sucursales.
  • Al incluir, modificar o borrar un Usuario del portal que utilice en la solapa "Derechos" el Web Service "PORTALCLIENTEMINGLE", la operación se integrará a la plataforma, es decir, el usuario en el Mingle también se verá afectado.


A partir de la expedición continua de Diciembre/2022 será posible enviar e-mail al cliente con los accesos previamente configurados como Usuarios del portal, rutina FATA220:

Creación del parámetro MV_FMINGAL que será responsable por almacenar el Alias de acceso al mingle ( Para más información sobre el Alias y el mingle acceda a la documentación - Conozca el Mingle ), si el parámetro no existe o no tiene contenido no se enviará el e-mail al cliente.

Para que el e-mail también se envié es necesario informar el e-mail de destino en el campo E-mail (AI3_EMAIL) del registro del usuario.


Layout del e-mail que se enviará:

Al acceder al enlace por el e-mail, el alias de acceso al mingle del parámetro MV_FMINGAL estará informado:


Importante

Para el correcto envío del e-mail es necesaria la Configuración del servidor de e-mail/Proxy (CFGSETMAIL - SIGACFG)

El e-mail se activa cuando un nuevo usuario se registra o cuando la contraseña de un usuario ya existente se modificó.

A partir de la expedición continua de Diciembre/2022 será posible, al incluir un cliente, inmediatamente después vincular este cliente a un Usuario del portal, rutina FATA220:


En el registro de cliente - rutina CRMA980 se creó una "pregunta" - F12:

¿Registra usuario portal?


Con la pregunta como Sí, y el parámetro MV_MINGTOK configurado, al confirmar la inclusión del cliente se muestra la pantalla para seleccionar los usuarios:

  • Para el usuario que ya existe en la base, busque el campo Código
  • Para incluir un usuario nuevo, deje el campo código en blanco (el campo código se completará al final del proceso) e informe el resto de los campos.


En la próxima pantalla es posible seleccionar/agregar los clientes.

  • Si existieran otras tiendas para el mismo código de cliente, el sistema mostrará una opción por si desea cargar las otras tiendas automáticamente.

  • Si el cliente tiene un grupo de ventas (A1_GRPVEN), el sistema muestra una opción por si desea cargar otros clientes del mismo grupo de ventas automáticamente.


Al finalizar, el sistema agregará todos los clientes a todos los usuarios, se crearán los usuarios nuevos, y a todos los usuarios se les agregará el derecho de entrada al portal del mingle:


Importante

Importante: Todos los clientes seleccionados se agregarán a todos los usuarios seleccionados.

Si el entorno estuviera configurado para mandar el e-mail automático, este solo se enviará si se realiza la creación de un nuevo usuario. (Es necesario que los usuarios tengan el campo de e-mail configurado).

Funcionalidades

Actualmente el Portal del cliente tiene las funcionalidades detalladas a continuación y están en constante evolución.

  • Home - Pagina inicial que contiene los valores de los títulos.
  • Facturas - Tiene todas las facturas emitidas para el cliente.
  • Títulos- Tiene todos los títulos generados para el cliente.
  • Informes - Es posible configurar informes que quedarán disponibles para download.
  • Selección de datos - Permite aplicar filtros (sucursales y clientes) en todas las visiones.
  • Pedidos - Tiene todos los Pedidos relacionados con el cliente
Puntos de entrada
  • PCREPORTS - Configuración de informes que se pondrán a disposición en el Portal del cliente.
  • PCTITREL - Agrega informes para download en las acciones de los títulos.
  • PCTITOBS - Configuración de observaciones en los títulos del Portal del cliente.
  • PCTITQRY - Query personalizada para listado de títulos.
  • PCTITDOW - Habilita el download de documentos adjuntos de los títulos en el Portal del cliente.
  • NGFBXBOL - Permite el download de la boleta en PDF de las boletas personalizadas.
  • NGFEMBOL - Permite el envío de e-mail con boletas personalizadas.
  • PCINVREL - Agrega informes para download en las acciones de las facturas.
  • PCINVOBS  - Configuración de observaciones en las facturas del Portal del cliente.
  • PCMNLOGO - Permite modificar el logotipo del menú del Portal del cliente.
  • PCBROWSE - Permite incluir opciones de menú para el listado de ítems personalizados en el Portal del cliente.
  • PCINVQRY - Query personalizada para listado de las facturas del Portal del cliente.


LICENCIAMIENTO

Para más detalles sobre la regla de licenciamiento del Portal del cliente, consulte la sección "04 - Licencias" dentro del menú "Requisitos previos" de esta misma página.