Í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
  11. Vídeos How To


01. VISIÓN GENERAL

Importante

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

Cambios para AWS

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.

Funcionalidades de registros Clientes, Prospect y Contactos están en la versión 1.8.0

Las funcionalidades de registros de Clientes, Prospects y Contactos están disponibles únicamente para la versión 1.8.0 con actualización de la expedición continua a partir del (02/02/2024) (La versión 1.8.0 está disponible únicamente para el enlace https://gestaodevendasprotheus.totvs-solucoes.com.br).

Importante

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

Mingle

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

Cambios en la interfaz

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


Uso Offline

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:

¡Importante!

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:



Importante

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.

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

Restricción de acceso

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.



Filtro de indicadores

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



Detalles

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. 

REST 2.0

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

Alias TOTVS Mingle

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:

License Server

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.


Configuración ODBC

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

Ejemplo dbaccess.ini
[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.


Clave de seguridad

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



Clave PrepareIn

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

Clave Instances

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.

Importante

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

ejemplo appserver.ini
[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

Alias TOTVS Mingle

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.


Empresa/Sucursal

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.


Importante

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


Importante

El parámetro MV_GVPLFIN está en etapa de homologación y está previsto que se pondrá a disposición a partir del 01/07/2024 para su utilización en el PGV.

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

Con este parámetro, usted puede indicar las informaciones que no desea que sean seleccionadas por el usuario en los Pedidos de ventas (SC5) y Presupuestos (SCJ). Usted puede bloquear únicamente los campos de forma de pago (C5_CONDPAG y CJ_CONDPAG) y la lista de precio (C5_TABELA y C5_CONDPAG).

C5_TABELA | CJ_CONDPAG

MV_APICCGC

Cumplimentación de los principales campos del registro de Clientes / Prospects 

.T.

MV_GVPLFIN

Habilita la opción Planilla financiera PGV

1 ,1


08. PUNTOS DE ENTRADA


09. ASUNTOS RELACIONADOS