...
- Visión general
- Ejemplo de utilización
- Requisitos mínimos
- Appserver
- DBAccess
- nTOTVS Mingle
- ConfiguracionesConfiguraciones - Clientes pilotos
- Información técnica
- Entrar (Login)
- Sincronismo
- Tablas utilizadas
- Asuntos relacionados
...
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. TPortal Gestión de ventas esta disponible a partir del release 12.1.33 |
Aviso |
---|
|
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 |
---|
|
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.
Expandir |
---|
| Haga click aquí para expandir.. | 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 |
---|
title | Restricció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 |
---|
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.
![](/download/attachments/658749116/Gest%C3%A3o%20de%20Vendas%20-%20Indicadores%20de%20Venda.gif?version=1&modificationDate=1641554689487&api=v2)
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).
![](/download/attachments/658749116/Gest%C3%A3o%20de%20Vendas%20-%20Notifica%C3%A7%C3%B5es.gif?version=1&modificationDate=1641554692657&api=v2)
- 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.
![](/download/attachments/658749116/02-%20EXEMPLO%20DE%20UTILIZACAO-PRINCIPAL.gif?version=1&modificationDate=1641554695870&api=v2)
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.
![](/download/attachments/658749116/Meus%20Pedidos.gif?version=1&modificationDate=1641554707703&api=v2)
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 Removed
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 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 |
---|
|
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 |
---|
|
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 |
---|
|
El TOTVS Portal Gestión de ventas utiliza la configuracón de configuración de Appserver 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í. |
Aviso |
---|
|
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í. |
Expandir |
---|
title | Expandir origen para visualizar ejemplo de appserver.ini |
---|
|
Bloco de código |
---|
title | ejemplo appserver.ini |
---|
|
|
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 |
---|
|
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.
Expandir |
---|
title | Expandir origen para visualizar el ejemplo del dbaccess.ini |
---|
|
Bloco de código |
---|
firstline | 1 |
---|
title | Ejemplo dbaccess.ini |
---|
linenumbers | true |
---|
|
| collapse | true | [General]
Port=7890
[MSSQL]
environments=environment
[MSSQL/environment]
UseRowStamp=1 |
|
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.
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.
![](/download/attachments/658749116/Login.gif?version=1&modificationDate=1641554766757&api=v2)
![](/download/attachments/658749116/ALTERAR_USUARIO.gif?version=1&modificationDate=1641554767347&api=v2)
- 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.
![](/download/attachments/658749116/Vendedor.gif?version=1&modificationDate=1641554768297&api=v2)
...
...
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
- 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
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>
|