Versões comparadas

Chave

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

...

  1. Visión general
  2. Ejemplo de utilización
  3. Requisitos mínimos
    1. Appserver
    2. DBAccess
    3. nTOTVS Mingle
    4. ConfiguracionesConfiguraciones - Clientes pilotos
  4. Información técnica
    1. Entrar (Login)
    2. Sincronismo
  5. Tablas utilizadas
  6. Asuntos relacionados

...

Aviso
titleHerramienta en homologación

El TOTVS Gestión de ventas aún está en fase de homologación y solo está liberado para clientes pilotos TPortal Gestión de ventas esta disponible a partir del release 12.1.33

Aviso
titleMingle

Para configurar el TOTVS Mingle, el servidor Appserver debe tener un IP publico.


El Portal El TOTVS Gestión de ventas (TGVPGV) es una plataforma Web para usuarios del 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 (Incluyendo 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).

Además, la aplicación también permite que el usuario trabaje de modo off-line, permitiendo utilizar las principales funcionalidades de la aplicación, como por ejemplo Incluir un Pedido de venta o incluso consultar un Cliente.

Informações
titleImportante

Algunas funcionalidades no estarán disponibles si el usuario opta por trabajar en el modo off-line, como por ejemplo, la consulta de Títulos por cobrar y consulta de Insolvencia del cliente.


Enlace del Portal de Gestión de ventas: https://bopgestaodevendas.com/


Âncora
EJEMPLOS_DE_UTILIZACION
EJEMPLOS_DE_UTILIZACION

...

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


Haga click aquí para expandir..
Expandir
Expandir
title
Cambio de sucursal

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

Al hacer clic en la tercera opción, esta abrirá una ventanita con dos opciones:

Image Added

Al hacer clic en la opción 'Cambiar de sucursal', se abrirá una ventana que informa la sucursal actual del vendedor y dos campos para cumplimentar: un campo para indicar el Grupo de empresas y otro campo para indicar la sucursal (las sucursales se devolverán de acuerdo con el Grupo de empresa que se seleccionó). Al seleccionar la sucursal deseada, basta hacer clic en la opción 'Confirmar' y se realizará el cambio de sucursal.

Image Added

Aviso
titleRestricción de acceso

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

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 consulte el documento de referencia de la 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 consulte el documento de referencia de la rutina haciendo clic  aquí.
Expandir
titleMis Clientes

Al acceder a la opción de menú Mis Clientes, el usuario puede Consultar 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 únicamente si el Usuario está Online.


  • Para más información consulte el documento de referencia de la 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 consulte el documento de referencia de la rutina haciendo clic aquí.
Expandir
titleMis Presupuestos

Al acceder a la opción de menú Mis Presupuestos, el usuario puede Consultar todos sus Presupuestos y también incluir un Nuevo presupuesto.

Image Removed

Informações
titleDetalles

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


  • Para más información consulte el documento de referencia de la rutina haciendo clic aquí.

Âncora
REQUISITOS
REQUISITOS

03. REQUISITOS MÍNIMOS 


Aviso

El TOTVS 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 Agosto/2020.

Aviso
titleCompatibilizador

Para el correcto funcionamiento del TOTVS El Portal Gestión de ventas es necesaria la inclusión de las Tablas de Notificaciones y Control de la cola de pedidos de venta y del Número externo del pedido (C5_NUMEXT). necesita del último paquete de la Expedición continua de la facturación, para mantener su versión actualizada. 

Aviso
titleClientes pilotos

Para Para el correcto funcionamiento del TOTVS del Portal Gestión de ventas, es necesario aplicar los paquetes de expedición continua de los módulos de Facturación y Libros fiscales, además de esto, será  es necesario ejecutar el programa SetupTGV este . Este programa tiene como finalidad actualizar todas las tablas utilizadas por el TOTVS el Portal Gestión de ventas con ventas con los campos S_T_A_M_P_ y  y también alimentar el campo Número externo (C5_NUMEXT/CJ_NUMEXT) con un identificador único del registrolas tablas A1V (Schemas) y A1W (Campos de los Schemas).


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

...

Âncora
APPSERVER_REST
APPSERVER_REST


a. APPSERVER

  • Comunicación REST
    • El TOTVS Portal Gestión de ventas efectúa la comunicación con el servidor Protheus por medio de solicitudes HTTP. Para que esta comunicación ocurra, será necesario efectuar algunas configuraciones en el servidor APPServer.
    • Para más información sobre REST consulte el documento de referencia de la rutina.

...

Informações
titleREST 2.0

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

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 el documento de referencia de la rutina haciendo aquí.

Aviso
titleClave PrepareIn

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

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

true
Expandir
titleExpandir origen para visualizar ejemplo de appserver.ini
Bloco de código
titleejemplo appserver.ini
Bloco de código
firstline1
titleEjemplo APPSERVER.INI
linenumberstrue
collapse
[ENVIRONMENT]
	SourcePath=\TOTVS\apo\
	RootPath=\TOTVS\Protheus_data\
	StartPath=\system\
	RpoDb=Top
	RpoLanguage=Portuguese
	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/

[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


Âncora
DBACCESS_USEROWSTAMP
DBACCESS_USEROWSTAMP


b. DBACCESS


DBAccess - UseRowStamp


  • Habilitar la clave UseRowStamp.
  • Al habilitar la clave UseRowStamp se habilitará la creación de la columna S_T_A_M_P_ en las tablas del Protheus.


collapse
Expandir
titleExpandir origen para visualizar el ejemplo del dbaccess.ini
Bloco de código
firstline1
titleEjemplo dbaccess.ini
linenumberstrue
true
[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1


Âncora
MINGLE
MINGLE

c. TOTVS MINGLE


  • TOTVS Mingle
    • La plataforma TOTVS Portal Gestión de venta se almacena en una nube TOTVS. Para que la aplicación pueda comunicarse con el servidor Protheus, es necesario efectuar 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 pasa a utilizar 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 informar el app TOTVS Portal Gestión de ventas.
    • El Usuario debe recibir la clave de acceso por e-mail.

...

Âncora
CONFIG_PILOTO
CONFIG_PILOTO

...

d. CONFIGURACIONES

...

Es necesario efectuar algunas configuraciones antes de utilizar el TOTVS  Portal Gestión de ventas::


  • Configuraciones de la clave UseRowStamp en el TOTVS DBAccess de acuerdo con lo descrito anteriormente.
  • Será necesario ejecutar el programa inicial UPDDISTR para la creación de las tablas A1T, A1S y la inclusión de los campos C5_NUMEXT y CJ_NUMEXT.
  • Será necesario ejecutar el programa inicial UPDDISTR para la creación del campo A1T_ROTINA.
  • Aplicar los paquetes de expedición continua de los módulos Facturación y Libros fiscales.
  • Ejecutar el programa inicial SetupTGV para actualizar todas las tablas utilizadas por el TOTVS Portal Gestión de ventas con los campos S_T_A_M_P_ y actualizar el campo Número externo (C5_NUMEXT/CJ_NUMEXT) con un identificador único del registrolas tablas A1V (Schemas) y A1W (Campos de los Schemas).
  • Habilitar el REST 2.0 en el AppServer, de acuerdo con lo descrito anteriormente.
  • Solicitar un Alias en el TOTVS Mingle.

...

...

Para el correcto funcionamiento del TOTVS Gestión de ventas, es necesario aplicar los paquetes de expedición continua de los módulos de Facturación y Libros fiscales, además de esto, será necesario ejecutar el programa SetupTGV este programa tiene como finalidad actualizar todas las tablas utilizadas por el TOTVS Gestión de ventas con los campos S_T_A_M_P_ y también alimentar el campo Número externo (C5_NUMEXT/CJ_NUMEXT) con un identificador único del registro.


Âncora
TECNICAS
TECNICAS

04. INFORMACIÓN TÉCNICA

...

  • Para entrar en la plataforma, el Vendedor debe informar el mismo Usuario y Contraseña utilizados en el Protheus e informar el Alias, mencionado en la sesión requisitos mínimos.
  • Al entrar en el TOTVS Portal Gestión de ventas por la primera vez, la aplicación debe efectuar la carga inicial. Esta carga solo se realiza en el primer acceso o si se modifica el usuario.




  • Al realizar el Login e iniciar la carga inicial, el usuario es dirigido a los Indicadores de venta (Home).
  • En la barra superior es posible visualizar los datos del Vendedor, consultar el estatus de conexión con Internet (Online y off-line), consultar las Notificaciones y Salir de la aplicación.




Âncora

...

VERSAO

...

VERSAO

b. 

...

El TOTVS Gestión de ventas es una aplicación que puede trabajar en el modo online y off-line y, para que esto ocurra sin perder ninguna información, todos los datos son sincronizados entre la aplicación y el servidor Protheus. Este sincronismo ocurre en segundo plano, cada 60 segundos y garantiza que los usuarios utilicen siempre los datos actualizados, sin sufrir ningún perjuicio.

 

Para que este sincronismo ocurra correctamente, es necesario que se cree el campo S_T_A_M_P_, de acuerdo con lo informado en los Requisitos mínimos. Este campo se crea automáticamente en las tablas del Protheus y tiene la finalidad de almacenar la última fecha y hora en que se modificó el registro. Por medio de requisiciones HTTP/REST el TOTVS Gestión de ventas consigue actualizar solamente los registros que tuvieron algún tipo de actualización. 

 

La opción del menú "Mis Pedidos" tiene además del sincronismo del TOTVS Gestión de ventas, una cola de registros que se procesa por un JOB en el Protheus, este JOB puede configurarse de acuerdo con el documento de referencia de la rutina.

 

Al realizar operaciones de inclusión, modificación o borrado de pedido, su estatus quedará como No sincronizado hasta que efectivamente se realice la operación en el Protheus. Después de la confirmación (próxima sincronización) el estatus cambiará en la interfaz. 

Image Removed

VALIDAÇÃO DE VERSÃO (LOGIN)


Ao realizar o login no Portal de Gestão de Vendas, é executada uma verificação para avaliar se a versão do servidor Protheus é a mesma que consta no Portal do Usuário. Caso o Vendedor ( usuário ) receba a mensagem abaixo, significa que o deve ser atualizado o Repositório ( RPO ) aplicando o último pacote da expedição continua que consta AQUI. O usuário ficará impossibilitado de realizar o login até que o repositório seja atualizado com sua versão mais recente.

Image Added

Al realizar el logout de la aplicación, las modificaciones o nuevos pedidos pendientes de sincronización pueden anularse y, por lo tanto, no se enviarán al Protheus.

Image Removed

Si el acceso de la aplicación hubiera expirado y el TOTVS Mingle no hubiera conseguido autenticar nuevamente de forma automática, aparecerá el mensaje informando que la sesión expiró y el usuario tendrá que realizar el login nuevamente. Sin embargo, existe la opción de continuar utilizando la  aplicación en modo offline, de esta manera, el usuario podrá realizar sus modificaciones y estas quedarán pendientes de sincronización hasta que se realice el próximo login.

Image Removed


Âncora
TABLAS_UTILIZADAS
TABLAS_UTILIZADAS

...

  • A1S - Notificaciones del vendedor
  • A1TControl de integración de pedidos/presupuestos
  • A1VSchemas del Gestión de ventas
  • A1W - Campos del schema
  • AC8 - Relación de Contactos vs. Entidad
  • AGB - Teléfonos vs. Entidades
  • DA0 - Lista de precios
  • DA1 - Ítems de la lista de precios
  • SA1 - Clientes
  • SA3 - Vendedores
  • SA4 - Empresas de transporte
  • SB1 - Descripción genérica del producto
  • SB2 - Saldos físico y financiero
  • SC5 - Pedidos de venta
  • SC6 - Ítems de los pedidos de venta
  • SC9 - Pedidos liberados
  • SD2 - Ítems de venta de la factura  
  • SE1 - Cuentas por cobrar
  • SE4 - Condiciones de pago
  • SF2 - Encabezado de las facturas de salida  
  • SU5 - Contactos
  • SUS - Prospects
  • SX5 - Tablas genéricas
  • SYA - Países

Âncora
RELACIONADOS
RELACIONADOS

06. ASUNTOS RELACIONADOS



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>