ÍNDICE

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


01. VISIÓN GENERAL

El TOTVS Gestión de ventas aún está en fase de homologación y solo está liberado para clientes pilotos


El TOTVS Gestión de ventas (TGV) 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.


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.


02. EJEMPLO DE UTILIZACIÓN


Aquí puede visualizar un ejemplo práctico de las principales funcionalidades del TOTVS Gestión 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.



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

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

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.



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

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

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



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

03. REQUISITOS MÍNIMOS 


El TOTVS 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.

Para el correcto funcionamiento del TOTVS 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).

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.


El TOTVS 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:


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

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

[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

[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1








a. CONFIGURACIONES - CLIENTES PILOTOS

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



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.


04. INFORMACIÓN TÉCNICA

a. ENTRAR (LOGIN)






b. SINCRONISMO

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. 



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.



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.


05. TABLAS UTILIZADAS

06. ASUNTOS RELACIONADOS