Histórico da Página

Image Added

Í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

Âncora
VISION_GENERAL VISION_GENERAL

01. VISIÓN GENERAL

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.

02. EJEMPLO DE UTILIZACIÓN

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

Âncora
REQUISITOS REQUISITOS

03. REQUISITOS MÍNIMOS 

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:

• Comunicación REST
  • El TOTVS 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.

[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

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

[General]
Port=7890

[MSSQL]
environments=environment

[MSSQL/environment]
UseRowStamp=1

• TOTVS Mingle
  • La plataforma TOTVS 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 Gestión de ventas.
  • El Usuario debe recibir la clave de acceso por e-mail.

Image Added

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

Image Added

a. CONFIGURACIONES - CLIENTES PILOTOS

Es necesario efectuar algunas configuraciones antes de utilizar el TOTVS 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 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 registro.
• Habilitar el REST 2.0 en el AppServer, de acuerdo con lo descrito anteriormente.
• Solicitar un Alias en el TOTVS Mingle.

04. INFORMACIÓN TÉCNICA

a. ENTRAR (LOGIN)

• 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 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 modifica el usuario.

Image Added

Image Added

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

Image Added

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. 

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 Added

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 Added

05. TABLAS UTILIZADAS

• A1S - Notificaciones del vendedor
• A1T - Control de integración de pedidos/presupuestos
• A1V - Schemas 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

06. ASUNTOS RELACIONADOS

• Indicadores de venta
• Mis Notificaciones
• Mis Clientes
• Mis Pedidos
• Mis Presupuestos
• TOTVS Mingle
• Procesamiento de pedidos TOTVS Gestión de ventas
• Schedule - Cómo programar en agenda la ejecución de rutinas
• REST ADVPL
• Para entender las novedades del REST (2.0)
• REST con ERP Microsiga Protheus
• DBAccess - Sección [Environment], clave UseRowStamp
• Control de datos protegidos - Protheus 12
• Schemas TOTVS Gestión de ventas