Versões comparadas

Chave

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

Í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. Puntos de entrada
  8. Asuntos relacionados
  9. Qué hay de nuevo


Âncora
VISION_GENERAL
VISION_GENERAL

01. VISIÓN GENERAL

Painel
Painel
Aviso
titleImportante

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

Aviso
titleImportante

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

Aviso
titleMingle

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


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

Informações
titleUso Offline

Sepa como 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://bopgestaodevendas.com/

Âncora
EJEMPLOS_DE_USO
EJEMPLOS_DE_USO

02. EJEMPLO DE UTILIZACIÓN

Painel

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


Expandir
Expandir
titlePrivilegios

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:

Informações
title¡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.

Totvs custom tabs box
tabsRegistro del privilegio, Registro de usuarios, Cómo agrgar el privilegio, Cómo acceder al Portal
idspaso1,paso2,paso3,paso4
Totvs custom tabs box items
defaultyes
referenciapaso1

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.

Totvs custom tabs box items
defaultno
referenciapaso2

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


Totvs custom tabs box items
defaultno
referenciapaso3

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

Totvs custom tabs box items
defaultno
referenciapaso4

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:



Informações
titleImportante

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

Informações

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.

Informações
titlePrivilegios

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

Expandir
titleCambio de sucursal

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


Totvs custom tabs box
tabsPaso 1, Paso 2
idscambioSucursal1,cambioSucursalFilial2
Totvs custom tabs box items
defaultyes
referenciatrocaFilial1

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.


Totvs custom tabs box items
defaultno
referenciacambioSucursal2

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.


Informações

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

Aviso
titleRestricció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.

Expandir
titleIndicadores de ventas

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.



Informações
titleFiltro 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í.
Expandir
titleMis Notificaciones

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í.
Expandir
titleMis Clientes

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.



Aviso

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í.
Expandir
titleMis Pedidos

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.



Informações
titleDetalles

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í.
Expandir
titleMis Presupuestos

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

Âncora
REQUISITOS
REQUISITOS

03. REQUISITOS MÍNIMOS 

Painel
Aviso

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.

Aviso

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

Informações
titleREST 2.0

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

Informações
titleAlias TOTVS Mingle

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

Âncora
CONFIG_PILOTO
CONFIG_PILOTO

04. CONFIGURACIONES

Painel

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:

Aviso
titleLicense Server

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

Totvs custom tabs box
tabs01 - DBAccess, 02 - Appserver, 03 - TOTVS Mingle
idsconfig1,config2,config3
Totvs custom tabs box items
defaultyes
referenciaconfig1

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.


Aviso
titleConfiguració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

Bloco de código
firstline1
titleEjemplo dbaccess.ini
linenumberstrue
[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1
memoinquery=1
Totvs custom tabs box items
defaultno
referenciaconfig2

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.


Aviso
titleClave de seguridad

Si la clave Security no se informa en el "appserver.ini" o se informa con el valor 0, no se validarán los permisos de acceso del usuario.

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

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

Aviso
titleClave 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.

Informações
titleImportante

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

Bloco de código
titleejemplo 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
Totvs custom tabs box items
defaultno
referenciaconfig3
Informações
titleAlias 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.


Informações
titleEmpresa/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.




Âncora
TÉCNICAS
TÉCNICAS

05. INFORMACIONES TÉCNICAS

Painel

Âncora
ENTRAR
ENTRAR

Totvs custom tabs box
tabsEntrar, Carga inicial, Versión, Salir, Nueva carga de datos
idsentrar1,entrar2,entrar3,entrar4,entrar5
Totvs custom tabs box items
defaultyes
referenciaentrar1

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.

Totvs custom tabs box items
defaultno
referenciaentrar2

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.


Aviso
titleImportante

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.

Totvs custom tabs box items
defaultno
referenciaentrar3

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.


Totvs custom tabs box items
defaultno
referenciaentrar4

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.



Totvs custom tabs box items
defaultno
referenciaentrar5

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




Âncora
TABLAS_UTILIZADAS
TABLAS_UTILIZADAS

06. TABLAS UTILIZADAS

Painel

Âncora
PUNTOS_DE_ENTRADA
PUNTOS_DE_ENTRADA

07. PUNTOS DE ENTRADA

Painel


Informações

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


Âncora
RELACIONADOS
RELACIONADOS

08. ASUNTOS RELACIONADOS

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