ÍNDICE

  1. Visión general
  2. Ejemplo de utilización
  3. Requisitos mínimos
  4. Configuraciones
    1. DBAccess
    2. Configuraciones iniciales
    3. Appserver
    4. TOTVS Mingle
  5. Informaciones técnicas
    1. Entrar (Login)
    2. Carga inicial
    3. Validación de versión
    4. Salir
  6. Tablas utilizadas
  7. Parámetros utilizados
  8. Puntos de entrada
  9. Asuntos relacionados
  10. Qué hay de nuevo


"Aviso de alerta de riesgo: tome cuidado al utilizar el parámetro de configuración con la clave Security=0, porque esto ocasionará que las integraciones (API) no exijan autenticación, consecuentemente, los datos de su entorno podrán consultarse sin ningún control de autorización."

01. VISIÓN GENERAL

El Portal Gestión de ventas está disponible a partir del release 12.1.33.

Para una mejor experiencia en el Portal Gestión de ventas, estamos actualizando el enlace de acceso a una cuenta Totvs en la AWS. Por ello, necesitamos que acceda hasta el 07/12/23,  por el enlace https://gestaodevendasprotheus.totvs-solucoes.com.br Si estuviera accediendo de un tablet o celular, será necesario crear un nuevo acceso directo en su área de trabajo.

El Portal Gestión de ventas no está disponible para el Mercado Internacional.

Para configurar el TOTVS Mingle, el servidor Appserver debe tener un IP público.

Debido a las recientes actualizaciones en la versión de la biblioteca de componentes POUI, pueden ocurrir variaciones de colores en los GIF presentados en nuestras documentaciones. Estos cambios no afectan la funcionalidad del sistema.


El Portal Gestión de ventas (PGV) es una plataforma Web para usuarios del TOTVS Backoffice Línea Protheus que utilicen el módulo Facturación (SIGAFAT) para administrar sus ventas.


Con este, el vendedor puede consultar sus Indicadores de venta, sus Clientes (Incluso el estatus financiero, riesgo de crédito, títulos pendientes y porcentaje de insolvencia en el Protheus), recibir Notificaciones sobre sus Pedidos de Ventas y Administrar sus Pedidos de ventas (Modificar, incluir, Borrar y Visualizar).


Sepa cómo utilizar el Portal Gestión de ventas en modo Off Line no permite. Para más información acceda a la página  DR - Portal Gestión de Ventas Off Line.


Enlace del Portal de Gestión de Ventas: https://gestaodevendasprotheus.totvs-solucoes.com.br

02. EJEMPLO DE UTILIZACIÓN

Aquí puede visualizar un ejemplo práctico de las principales funcionalidades del Portal Gestión de Ventas.


En el Portal Gestión de ventas, es posible configurar privilegios para un usuario. Estos privilegios sirven para decir al sistema a cuáles opciones de menú del PGV tendrá acceso al usuario. Estos pueden configurarse utilizando las opciones de la rutina TGVA004, de acuerdo con las siguientes instrucciones:

Los privilegios se cargan al portal después del login del vendedor. Si el privilegio se modifica, la modificación se reflejará en el PGV solamente a partir del próximo login del vendedor.

Para configurar, basta acceder al menú Privilegios, ubicado en el módulo Configurador (SIGACFG) → Usuarios → Contraseñas → Privilegios → Incluir:

  1. En Reglas por transacción/rutina, complete el campo Transacción/Rutina con el código de la rutina TGVA004.
  2. En Funcionalidades de las transacciones/rutina seleccione si el usuario (Vendedor) tendrá acceso Permitido o Negado a los ítems del menú del Portal Gestión de ventas.


En este ejemplo, se negará el acceso a la página de Mis Notificaciones.

Acceda al registro de usuarios del módulo Configurador (SIGACFG) y agregue el privilegio al usuario seleccionado.

SIGACFG → Usuarios → Contraseñas → Usuarios → Ubicar al usuario deseado → Otras acciones → Privilegios


En Restricciones de acceso seleccione la regla registrada anteriormente (Paso 1).

Al acceder al portal Gestión de ventas el Vendedor no tendrá acceso a la página y también al menú, en este ejemplo el Vendedor no tiene acceso a la página Mis Notificaciones.



Si el Vendedor intenta acceder a la página utilizando la URL en el navegador, se mostrará la siguiente pantalla:



Los permisos de accesos solamente se cargan al acceder al Portal Gestión de ventas.

Si el usuario ya estuviera utilizando el portal Gestión de ventas, será necesario realizar un login nuevamente para recibir las actualizaciones de los privilegios.

Para más información sobre los privilegios, haga clic  aqui.

El portal Gestión de ventas permite cambiar la sucursal utilizada después.

Al realizar el Login, el sistema tiene un Toolbar (barra de herramientas) en la parte superior. En esta tenemos la información de conexión con internet (1° ícono), notificaciones recibidas (2° ícono) y vendedor conectado (3° ícono).


En la barra de herramientas, haga clic en la opción con el ícono de usuario.

La barra de herramientas está ubicada en la parte superior de la página.

A continuación, acceda a la opción de menú Cambiar de sucursal.


Al acceder al menú Cambiar de sucursal se muestra una ventana donde el Vendedor podrá seleccionar la Empresa y Sucursal deseada.


Al hacer clic en la opción Confirmar, el Vendedor será dirigido a la página de Carga de datos del Portal Gestión de ventas.


Solamente se listan Empresas y Sucursales a las que el Vendedor tiene acceso en el TOTVS BackOffice Protheus®.

Para que sea posible el cambio de sucursal, el usuario del vendedor conectado debe tener vínculo de vendedor en la sucursal de destino también.

Al acceder a la Página inicial (Home) el Usuario puede visualizar sus Indicadores de ventas, pudiendo filtrar por los períodos: Anual o Mensual.



  • Al seleccionar la opción Anual, el Vendedor puede informar un período de hasta diez años.
  • Al seleccionar la opción Mensual, el Vendedor puede informar un período de hasta doce meses.


  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

Al acceder a la opción de menú Mis Notificaciones, el Usuario puede Consultar todas sus Notificaciones, teniendo como opción visualizar en el formato de Tabla (Estándar Desktop) o Card (Estándar Mobile).



  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

Al acceder a la opción de menú Mis Clientes, el Usuario Consulta sus Clientes, pudiendo visualizar el Estatus financiero y los otros Detalles del cliente por medio de la opción Visualizar detalles.



Algunas funcionalidades estarán disponibles solamente si el Usuario estuviera Online.


  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

Al acceder a la opción de menú Mis Prospects, el Usuario puede Consultar sus Prospects y visualizar los otros Detalles del Prospect por medio de las opciones Visualizar detalles o Razón social.



Algunas funcionalidades estarán disponibles únicamente si el Usuario estuviera Online.


  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

Al acceder a la opción de menú Mis Pedidos, el Usuario puede Consultar todos sus Pedidos de ventas y también incluir un Nuevo pedido.



Al acceder a la opción Visualizar detalles, el Usuario además de Visualizar el Resumen del Pedido de venta, podrá acceder a las opciones Modificar y Borrar.


  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

Al acceder a la opción de menú Mis Presupuestos, el usuario puede consultar todos sus Presupuestos de venta y/o incluir un Nuevo presupuesto:

Al hacer clic en 'Visualizar detalles', es posible visualizar la información del presupuesto y también Generar PDF, Modificar y/o Borrar el presupuesto.

  • Para más información, acceda al documento de referencia de esta rutina haciendo clic aquí.

03. REQUISITOS MÍNIMOS 

El Portal Gestión de ventas necesita del Microsiga Protheus® Release 12.1.33 o Superior y archivos binarios con fecha de expedición igual o superior a Octubre/2021.

El Portal Gestión de ventas necesita del último paquete de la Expedición continua de Facturación, para mantener su versión actualizada. 

El Portal Gestión de ventas utiliza la configuración de Appserver REST 2.0.

Para configurar el TOTVS Mingle, el servidor Appserver debe tener un IP público.

04. CONFIGURACIONES

El Portal Gestión de ventas es una plataforma de web integrada con el módulo Facturación (SIGAFAT) del Microsiga Protheus®, para realizar esta integración es necesario que su entorno esté configurado correctamente con los siguientes requisitos previos:

Recomendamos la utilización del License Server con fecha igual o superior al 14/06/2022.

Para sincronizar los datos, las API del Portal Gestión de ventas utilizan el campo S_T_A_M_P_ como parámetro de búsqueda, siendo necesaria la inclusión de la clave UseRowStamp en el TOTVS DBAccess.


Para entornos que utilicen la base de datos PostgreSQL, recomendamos la configuración del ODBC de acuerdo con el siguiente documento.

Cómo crear una fuente de datos ODBC para uso con PostgreSQL

[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1
memoinquery=1

Comunicación REST

  • El Portal Gestión de ventas realizara la comunicación con el servidor Protheus por medio de requisiciones HTTP. Para que esta comunicación ocurra será necesario realizar algunas configuraciones en el servidor APPServer.
  • Para más información sobre REST consulte el documento de referencia de la rutina.


Si la Clave Security no existiera en el "appserver.ini" o estuviera informada con el valor 0 y não existiera en el RPO la API pgvcheckconfigappserver, no se validarán los permisos de acceso del usuario.

Si la Clave Security no existiera en el "appserver.ini" o estuviera informada con el valor 0 y la API pgvcheckconfigappserver existiera en el RPO, el usuario no conseguirá acceder al Portal Gestión de ventas, de acuerdo con el siguiente vídeo.

Para más información, consulte el documento de referencia sobre la Clave Security rutina haciendo clic aquí.



Si la clave PrepareIn está apuntando para empresas específicas, en la funcionalidad Cambio de sucursal, los usuarios tendrán acceso únicamente a las empresas informadas en esta clave. Si no es necesario este tipo de restricción, manténgala como "All".

Para más información, consulte la documentación haciendo clic aquí.

La clave Instances tiene que estar configurada de acuerdo con la cantidad de licencias disponibles para utilización del REST, consulte la documentación haciendo clic aquí.

Nuestro modelo de ejemplo está configurado para utilización como máximo 2 theads y 2 licencias, si la cantidad de licencias fuera menor que 2, el PGV puede presentar un comportamiento inesperado ocasionando lentitud en el sistema.

Recomendamos la configuración del REST de acuerdo con el siguiente ejemplo

[ENVIRONMENT]
	SourcePath=\TOTVS\apo\
	RootPath=\TOTVS\Protheus_data\
	StartPath=\system\
	RpoDb=Top
	RpoLanguage=multi
	RegionalLanguage=BRA
	RpoVersion=120
	dbserver=localhost
	dbdatabase=MSSQL
	dbalias=ENVIRONMENT
	dbport=7890
	TOPMemoMega=30

[Drivers]
	Active=TCP
	MultiProtocolPort=1	
	multiprotocolportsecure=0
	Secure=SSL

[HTTPJOB]
	ENVIRONMENT=ENVIRONMENT
	MAIN=HTTP_START

[HTTPREST]
	BUGS=0
	HSM=0	
	MaxQueue=10	
	Port=8282
	SECURITY=1
	SSL2=0
	SSL3=0
	State=0
	TLS1=0
	URIs=HTTPURI
	Verbose=0	

[HTTPURI]
	AllowOrigin=*
	CORSEnable=0
	Instances=1,2
	OnConnect=REST_CONNECT
	OnExit=REST_EXIT
	OnStart=REST_START
	PrepareIn=All
	URL=/rest/
	Stateless=1

[HTTPV11]
	ADVPL=0
	Enable=1
	Sockets=HTTPREST
	TimeOut=120
			
[HTTPSERVER]
	Enable=0
	Servers=HTTP_REST
​
[HTTP_REST]
	hostname=localhost
	port=9995
	locations=HTTP_ROOT
​
[HTTP_ROOT]
	Path=/rest/
	RootPath=root/web
	ThreadPool=THREAD_POOL
	​
[THREAD_POOL]
	Environment=ENVIRONMENT
	MinFreeThreads=1
	MinThreads=1
	MaxThreads=10

[OnStart]
	JOBS=HTTPJOB
	REFRESHRATE=120

Para configurar el TOTVS Mingle, el servidor Appserver debe tener un IP público.


  • La plataforma Portal Gestión de venta se almacena en una nube TOTVS. Para que la aplicación pueda comunicarse con el servidor Protheus es necesario realizar la configuración del TOTVS Mingle, que ejecuta el papel de un gateway entre la aplicación y el servidor Protheus. Además, al configurar el TOTVS Mingle, la aplicación utiliza los datos de Autenticación estándar del Protheus.
  • Para configurar el TOTVS Mingle, el servidor Appserver debe tener un IP público.
  • El Administrador del sistema debe solicitar un Alias, por medio de la página TOTVS MINGLE e informe el app Portal Gestión de ventas.
  • El Usuario debe recibir la clave de acceso por e-mail.


Informe por lo menos una empresa y sucursal en el registro del Mingle



  • El Alias recibido debe ser el mismo utilizado para acceder a la plataforma y debe incluirse junto con los datos del Login del usuario.




05. INFORMACIONES TÉCNICAS

Para acceder al Portal Gestión de ventas el Vendedor debe informar el mismo Usuario y Contraseña utilizado en el TOTVS Backoffice (Línea Protheus), además de informar el Alias utilizado por la empresa.



Para más información sobre el Alias acceda a la sesión requisitos mínimos.

Después de hacer clic en la opción Entrar, el Vendedor será dirigido a la página de Carga inicial de datos, está página carga algunas configuraciones utilizadas por el Portal Gestión de ventas.



Esta carga se realiza únicamente en el primer acceso o si se modifica el usuario.


Dependiendo de la cantidad de registros puestos a disposición en las tablas Lista de precio y Condición de pago (DA0, DA1 y SE4) puede demorarse como máximo 30 segundos para que se ponga a disposición la página home, pero las opciones Mis Pedidos, Mis Presupuestos y Mis Clientes se pondrán a disposición cuando el sincronismo se haya finalizado.

Al realizar el login en el Portal de Gestión de ventas, se ejecuta una verificación para evaluar si la versión del servidor Protheus es la misma que consta en el Portal del usuario. Si el Vendedor ( usuario ) recibe el siguiente mensaje, significa que debe actualizarse el Repositorio ( RPO ) aplicando el último paquete de la expedición continua que consta AQUÍ. El usuario quedará impedido de realizar el login hasta que el repositorio se actualice con su versión más reciente.


En la barra de herramientas, haga clic en la opción con el ícono de usuario.

La barra de herramientas está ubicada en la parte superior de la página.

A continuación, acceda a la opción de menú Salir.



En la barra de herramientas, haga clic en la opción con el ícono de conexión de datos.

La barra de herramientas está ubicada en la parte superior de la página.

A continuación, acceda a la opción de menú Realizar carga de datos. Aparecerá un modal preguntando si Desea realizar la carga de datos, haga clic en Confirmar.

Esto hará que el Portal Gestión de ventas realice una nueva carga de datos con el servidor trayendo los nuevos registros que se actualizaron. 




06. TABLAS UTILIZADAS

07. PARÁMETROS UTILIZADOS

Nombre

Descripción

Contenido (Ejemplo)

MV_PAISLOC

Indica la sigla del país donde está siendo utilizado el Sistema. Ej.: BRA = Brasil, ARG = Argentina, USA = Estados Unidos, etc.

BRA

MV_PGVBLQLInclusión de Cliente o Prospects en el Portal Gestión de ventas con bloqueo de uso. 0-No bloquea 1-Blq. Cliente/2-Blq. Prospect/3-Blq. Ambos     0
MV_PGVCSLDHabilitar consulta del saldo del producto en stock .T.
MV_PGVRISCRiesgo de crédito estándar al registrar un nuevo Cliente o Prospect por medio del Portal Gestión de ventasA
MV_PGVTPOPTipo de operación estándar utilizado en el Portal Gestión de ventas en las páginas Mis Pedidos y Mis Presupuestos de ventas
MV_PGVNATModalidad estándar que se considerará por el PGV.0001
MV_PGVVERSVersión actual del PGV que está compilada en el RPO del Protheus.                                         1.7.0

MV_PGVLFLD

Definir campos combobox  para realizar el bloqueo de la selección para los pedidos y presupuestos del PGV.

C5_TABELA | CJ_CONDPAG


08. PUNTOS DE ENTRADA


Todos los Puntos de entrada pueden utilizarse para las rutinas activadas a partir del Portal Gestión de ventas como Pedidos de venta, Presupuestos y Registro de clientes, con excepción de los que hacen activaciones de funciones de Interfaz.

Para identificar el origen de un Pedido de venta y si este se generó a partir del Portal Gestão de ventas, puede analizarse el campo Origen (C5_ORIGEM).


09. ASUNTOS RELACIONADOS

<!-- 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>