Image Added
ÍNDICE
- Visión general
- Ejemplo de utilización
- Requisitos mínimos
- Configuraciones - Clientes pilotos
- Información técnica
- Entrar (Login)
- Sincronismo
- Tablas utilizadas
- Asuntos relacionados
Âncora |
---|
| VISION_GENERAL |
---|
| VISION_GENERAL |
---|
|
01. VISIÓN GENERAL
Aviso |
---|
title | Herramienta en homologación |
---|
|
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.
Informações |
---|
|
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. |
Âncora |
---|
| EJEMPLOS_DE_UTILIZACION |
---|
| EJEMPLOS_DE_UTILIZACION |
---|
|
02. EJEMPLO DE UTILIZACIÓN
Aquí puede visualizar un ejemplo práctico de las principales funcionalidades del TOTVS Gestión de ventas.
Expandir |
---|
title | Haga click aquí para expandir... |
---|
|
Expandir |
---|
title | Indicadores 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.
Image Added
Informações |
---|
title | 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 consulte el documento de referencia de la rutina haciendo clic aquí.
|
Expandir |
---|
| 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).
Image Added
- Para más información consulte el documento de referencia de la rutina haciendo clic aquí.
|
Expandir |
---|
| 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.
Image Added
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 |
---|
| 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.
Image Added
Informações |
---|
| 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 |
---|
| 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 Added
Informações |
---|
| 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
Aviso |
---|
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. |
Aviso |
---|
|
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). |
Aviso |
---|
|
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:
Âncora |
---|
| APPSERVER_REST |
---|
| APPSERVER_REST |
---|
|
- 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.
Informações |
---|
|
El TOTVS Gestión de ventas utiliza la configuracón de REST 2.0. |
Aviso |
---|
|
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í. |
Bloco de código |
---|
firstline | 1 |
---|
title | Ejemplo APPSERVER.INI |
---|
linenumbers | true |
---|
collapse | true |
---|
|
[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 |
---|
|
- 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.
Bloco de código |
---|
firstline | 1 |
---|
title | Ejemplo dbaccess.ini |
---|
linenumbers | true |
---|
collapse | true |
---|
|
[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
Card documentos |
---|
Informacao | Las funcionalidades mencionadas anteriormente, estarán disponibles únicamente a partir del Release de la Línea Microsiga Protheus 12.1.33 |
---|
Titulo | IMPORTANTE! |
---|
|
Âncora |
---|
| CONFIG_PILOTO |
---|
| CONFIG_PILOTO |
---|
|
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.
Aviso |
---|
|
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)
- 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
Âncora |
---|
| TABLAS_UTILIZADAS |
---|
| TABLAS_UTILIZADAS |
---|
|
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