vtol core - manual de usuario 3.8.0

VTOL CORE - Manual de usuario 3.8.0.4

VTOL Core

Manual de Usuario

Cambios por revisiones

Fecha Versión Cambios – Motivo

23/02/2010 3.7.0.2 Creación del documento

21/06/2012 3.7.1.1 Se utiliza Framework v3.2.0

16/08/2012 3.7.2.0 Actualización de pantallas Framework

24/04/2014 3.7.2.2 Se agrega la funcionalidad de Activación de Cajas y Reporte de Cajas Inactivas

12/07/2014 3.7.2.3 Actualización ingreso de usuario

20/02/2015 3.7.2.5 Incorporación de indicador tiendas virtuales y descripción de funcionalidad auto-commit.

26/02/2016 3.7.3.7 Agregado de descripción de propiedades de configuración de backend

29/02/2016 3.7.3.8 Agrego funcionalidad de búsqueda de transacción por numero único

22/08/2016 3.7.3.9 Se agrega generación de Configuración en VTOL CORE.

21/10/2016 3.8.0.0 Ajustes en el documento conforme a las normas PCI DSS 3.2 y PA DSS 3.2

01/04/2019 3.8.0.4 Agregado de configuración de interfaces por compañías.

03/04/2019 3.8.0.4 Agregado de la configuración de Backend para la validación de código de compañía en la mensajería.

Índice

Acerca del manualPropósito y alcanceReferencias tipográficas

IntroducciónQué es VTOL Core?Componentes

Consola de administraciónIntroducciónConexión a la consolaComenzar a utilizar la consolaMenú propio de la consola RSEstructura de las pantallas de la consolaTemporizadoresPaginaciónBúsquedasConfirmación de accionesOrdenamiento de elementos

SeguridadGrupos

Acceso:Descripción de la página:Funcionalidad:

Búsqueda de gruposAlta de gruposModificación de gruposEliminación de grupos

PermisosAcceso:Descripción de la página:Funcionalidad:

Búsqueda de permisosUsuarios


Búsqueda de usuariosAlta de usuariosModificación de usuariosEliminación de usuarios

Modificación de contraseñasAdministración

AuditoríaAcceso:Descripción de la página:Funcionalidad:

BúsquedaAuditoría de acciones efectuadas

ConfiguraciónAcceso:Descripción de la página:Funcionalidad:

Búsqueda de propiedadesModificación de propiedadesRevertir propiedades modificadas

AlertasAcceso:Descripción de la página:Funcionalidad:

Búsqueda de alertasCreación de alertasModificación de alertasEliminación de alertas

Planificación de procesosAcceso:Descripción de la página:Funcionalidad:

Búsqueda de procesos planificadosModificación de la planificación

Descargar Archivos de LogAcceso:Descripción de la página:ConfiguraciónFuncionalidad:

DescargarMonitoreo

Estado General del SistemaAcceso:Descripción de la página:Funcionalidad:

Filtrado de informaciónVisualización de cantidad de transaccionesReseteo de contadores de transacciones

ConfiguraciónCompañías

Acceso:Descripción de la página:Funcionalidad

Búsqueda de compañíasAlta de compañíasModificación de compañíasBaja de compañíasHabilitación de compañías

LocalesAcceso:Descripción de la página:Funcionalidad:

Búsqueda de localesAlta de localesConfiguración de información asociada al localModificación de localesBaja de locales

CajasAcceso:Descripción de la páginaConfiguraciónFuncionalidad:

Búsqueda de cajasAlta de cajasModificación de cajasHabilitación de cajaEliminación de cajas

Activación de CajasAccesoFuncionalidad:

Activar cajasGeneración Configuración POS

AccesoInterfaces

Generación de InterfacesAcceso:Descripción de la página:Funcionalidad:

Generar interfazListado de interfaces generadas


Listado de interfazRegenerar Interfaz

Configuración avanzada de interfacesConfiguración de Interfaces por Compañías


Configurar interfaces por CompañíasReportes

Reporte de Cajas InactivasBúsqueda por Número Único

Configuración de BackendHabilitación del sistemaComunicación ServidorComunicación Encriptada simétricaComunicación SSL/TLSLogueoCaracterísticas de tiendas y terminalesControl de uso de nodo/cajaInformación sensibleReportesP2PEAuditoría TransaccionalMonitoreoNúmero único de transaccionesValidación de código de Compañía en mensajería

Acerca del manual

Propósito y alcance

El presente manual tiene por finalidad la capacitación de los usuarios que deseen utilizar la consola de administración del producto VTOL Core.

Brinda la información necesaria, con el nivel suficiente de detalle para que el usuario pueda monitorear el estado del sistema, así como también obtener información sobre el procesamiento de las transacciones y realizar las tareas de administración correspondientes. El manual se encuentra dividido en los siguientes capítulos:

Capítulo 1- Acerca del manualProvee una visión global del manual, brindado información sobre el contenido del mismo.

Capítulo 2 – IntroducciónExplica en qué consiste el producto VTOL Core y los componentes que abarca.

Capítulo 3 – Consola de administraciónBrinda los pasos iniciales para el comenzar a interactuar con la consola de administración, tales como la conexión y la conformación del menú.

Capítulo 4 – SeguridadBrinda información para el manejo de grupos, usuarios y asignación de permisos a los mismos.

Capítulo 5 – AdministraciónProvee información detallada de la funcionalidad de auditoría, configuración avanzada, eventos del sistema, alertas y planificación de procesos.

Capítulo 6 – MonitoreoExplica las opciones disponibles para el monitoreo general del sistema.

Capítulo 7 – ConfiguraciónExplica la forma de configurar todos los elementos requeridos para el correcto funcionamiento de la aplicación VTOL Core.

Capítulo 8 – InterfacesExplica la forma de generar, regenerar y listar las interfaces generadas por el sistema.

Capítulo 9 – ReportesDescribe los diversos reportes que ofrece el sistema y menciona los datos de salida que entrega.

Capítulo 10 – Configuración de BackendMenciona la configuración del sistema con respecto a las reglas de negocio y el comportamiento del sistema.

Referencias tipográficas

En este manual se utilizan las siguientes convenciones:

Numeración (1., 2., 3...): Indica la secuencia de pasos a seguir dentro de un procedimiento.*Viñetas ():* Indican opciones y características.

Se utiliza para especificar los niveles de menú (Ej.: Archivo Abrir)Signo mayor (>): > indica los nombres de elementos interface (Ej.: botón ) y de cualquier otro ítem que requiera énfasis.Estilo de fuente "negrita": Aceptar se utilizará para mencionar a los ejemplos.Estilo de fuente " :cursiva"

se utilizará para resaltar tips o accesos rápidos para la operatoria o procedimiento que se encuentre realizando. Consejo práctico: se utilizará para resaltar aclaraciones sobre el tema en curso.Nota:

se utilizará para indicar al usuario sobre precauciones / cuestiones relevantes que deberá tener en cuenta el usuario.Importante:

Introducción

Qué es VTOL Core?

VTOL Core es una validador de Servicios en Línea, especializado en la industria del Retail y sus operaciones financieras.

Se comporta como un Gateway multipropósito que conduce transacciones electrónicas desde y hacia diferentes participantes (locales físicos y virtuales, banca, proveedores) a través de redes heterogéneas en forma rápida, segura y eficiente.Brinda un marco de trabajo estándar donde uno o más módulos pueden ser integrados fácilmente. Cada módulo es una unidad funcional orientada a extender la funcionalidad de VTOL Server como Gateway multipropósito.

Componentes

VTOL Core se encuentra constituido por tres componentes:

Consola de administración:

La consola cuenta con una interfaz gráfica Web por medio de la cual el usuario puede acceder a funciones de monitoreo y administración de la solución y de sus módulos.

Permite efectuar el monitoreo centralizado de los niveles de procesamiento de transacciones, incluyendo el estado de cada uno de los servidores involucrados en dicho procesamiento. También por medio de ella se pueden efectuar las tareas de administración del producto y operaciones sobre el procesamiento de las transacciones.La consola de administración centraliza la información de transacciones provenientes de los distintos locales que componen la cadena del Retailer.

Componente cliente:

El componente cliente se encarga del envío de las transacciones que se efectúan en el POS al servidor VTOL, en un determinado formato.

Componente servidor:

El componente servidor es responsable del manejo de las transacciones, llevándose a cabo en él todo el procesamiento requerido para la autorización de la transacción. Esta acción es realizada por los módulos definidos en el Core.

1.

Consola de administración

Introducción

En el presente capítulo se describen los pasos para interactuar con la consola de administración y acceder a la funcionalidad ofrecida por la misma.

Conexión a la consola

La consola de administración es una herramienta Web, por lo cual la conexión a la misma podrá ser remota o local, a través del uso de un browser como Internet Explorer o Mozilla Firefox.

Para conectarse a la consola es necesario ingresar a la página * donde:http://IP-SERVER:8080/rs-console*IP-SERVER deberá ser reemplazado por la dirección IP de la máquina en la cual se encuentre en ejecución el application Server (en la imagen ejemplo: 127.0.0.1).8080: es el puerto de conexiónrs-console es el nombre de la aplicación de la consola.

Consejo práctico: Sólo en aquellos casos en los cuales la ejecución del application server se encuentre en la máquina con la cual se está conectando a la consola (local), podrá utilizar la dirección http://localhost:8080/rs- o console http://127.0.0.1:8080/rs-console

2. Una vez conectado a la consola, se deberá ingresar el nombre de usuario, el primer ingreso por defecto es usuario suser y contraseña suser123, en los campos habilitados, una vez completo el campo usuario para moverse al próximo campo podrá utilizar la tecla TAB o mediante un click del mouse en el campo siguiente contraseña.

3. Cuando se complete el usuario y contraseña mencionado, el sistema automáticamente le pedirá el ingreso de un nuevo usuario y una nueva contraseña, para comenzar a operar la aplicación.

http://IP-SERVER:8080/rs-console*

http://localhost:8080/rs-console

http://localhost:8080/rs-console

http://127.0.0.1:8080/rs-console

Login inicial

Cambio de usuario

El usuario por defecto dado de alta en el sistema es suser, con contraseña suser123. La cuenta suser es creada de forma automática al instalar la aplicación, ésta se crea por defecto. El sistema le pedirá Importante:cambiar el usuario y contraseña, en donde heredará los mismos permisos y quedará deshabilitado el usuario suser, cumpliéndose con las normas PA-DSS.

Nota: Para complementar la autenticación de los usuarios, ver punto del documento ."12. Administración de usuarios y claves de la aplicación" "VTOLCR-DB-Guía de implementación.doc"

Comenzar a utilizar la consola

Para comenzar a utilizar la consola de administración de VTOL Core, se deberán presionar puntos de menú que se encuentran en la parte izquierda de la pantalla.

:Importante Al usuario por defecto (suser) se encuentran asignados permisos de acceso a la consola RS pero no a funcionalidad específica de VTOL. La asignación de estos permisos podrá hacerse vinculando un grupo al usuario o brindando permisos al mismo (ver sección ).4. Seguridad

Menú propio de la consola RS

Este menú se emplea para todos los productos que utilicen la consola de administración de la suite RS de Synthesis. Las opciones disponibles en el mismo son las siguientes:

Seguridad > GruposSeguridad > PermisosSeguridad > UsuariosHerramientas administrativas > AuditoríaHerramientas administrativas > Configuración

Seguridad: incluye la funcionalidad de alta, baja y modificación de usuarios y grupos, así como también la asignación de permisos a usuarios y grupos.Herramientas administrativas: incluye las siguientes funciones:

Auditoría: a través de esta opción se tiene acceso a la información de las acciones realizadas por los usuarios en el sistema, pudiéndose conocer de las mismas la identificación del usuario que las efectuó, la fecha y hora en que se realizaron, el tipo de evento del cual se trata (consola, seguridad, etc.) y la severidad del evento (Error, Warning, Info)Configuración: esta funcionalidad permite configurar las propiedades de la aplicación a través de la consola de administración, como ser el máximo número de reintentos de distribución, tamaño mínimo del password, etc.

Estructura de las pantallas de la consola

Todas las pantallas de la consola del producto cuentan con un determinado layout que se explicará a continuación.

Cada pantalla posee un título que la identifica y refleja la funcionalidad básica de la misma. En la parte superior de la pantalla se encuentran los campos de búsqueda disponibles (si la pantalla requiere búsqueda). En la parte central se ubican los resultados obtenidos de la búsqueda efectuada (para pantallas con búsqueda) o la información principal a ser mostrada en la pantalla. Por último, en la parte inferior, se presentan las acciones que pueden ser realizadas a través de la pantalla. Específicamente en las pantallas que proveen alta de elementos (fundamentalmente las pantallas de configuración), se dispone de un área en la cual efectuar dicha acción bajo el título "Agregar un / una nnn", siendo nnn el nombre del elemento a cargar (ejemplo: Caja, Local, etc)

Temporizadores

Las pantallas de monitoreo que muestran información dinámica poseen un temporizador que permite indicar cada cuántos segundos se refresca dicha información.

En el cuadro de texto se deberá ingresar la cantidad de segundos cada la cual se desea que se refresque la información mostrada en la pantalla. Una vez ingresada la cantidad elegida, presionar "Actualizar cada:""Aceptar" para que el cambio tenga efecto.

Paginación

En todas las pantallas en las cuales se despliegue gran cantidad de datos, se contará con el paginado de la información, para facilitar su navegación.

En la parte inferior de cada pantalla se mostrará lo siguiente para poder navegar entre las páginas:

Navegación de las páginas:

Al accederse a una pantalla en la que se presentan números de página, siempre la primera página que será visualizada por el usuario será la número 1.Para acceder a las páginas restantes:

para acceder a la página que sigue a la actual, presionar el botón

para acceder a la página anterior, presionar el botón Existen dos atajos para acceder a la primera y última página:

para acceder a la primera página, clickear el link ."Primero"para acceder a la última página clickear el link ."Ultimo"

Búsquedas

Todas las páginas de la consola del producto que lo requieren, cuentan con distintos filtros, es decir, campos en base a los cuales se puede efectuar la búsqueda de información a ser presentada en la pantalla. Cuando una página dispone de más de un campo por el cual se puede filtrar la información de la misma, dichos filtros se combinan con la operación lógica . Esto quiere decir que los datos que se muestran como resultado de una andbúsqueda serán aquellos que concuerden con los valores ingresados en los filtros de la pantalla.todosPara efectuar una búsqueda primero se completan los campos que actúan como filtro y luego se presiona el botón "Buscar".Para los filtros de fecha así como también aquellos filtros en los que se busca por similitud, se dispone de la opción de dejarlos vacíos cuando no se desea filtrar por ellos. En el caso de rangos de fechas, en los que se dispone de dos filtros (uno para fecha desde y otro para fecha hasta), se pueden dejar vacíos ambos filtros o uno de los dos (si se desea filtrar por fecha desde y no por fecha hasta o viceversa) Para los demás filtros existe la opción "Todas / os" que indica que el usuario no desea restringir la búsqueda por ese campo, aceptando todos los posibles valores del mismo como resultado.

Confirmación de acciones

La consola solicitará confirmación de todas las actividades potencialmente riesgosas que puedan efectuarse a través de la misma, como ser, por ejemplo, las eliminaciones de elementos del sistema (tarjetas, planes, usuarios, etc) La confirmación se presenta como un mensaje, consultando si se está seguro de realizar la acción en cuestión. Si se quiere que la acción tenga lugar, presionar , caso contrario, presionar ."Aceptar" "Cancelar"

Ordenamiento de elementos

Cuando el encabezado de una columna de una tabla se encuentra resaltado, esto indica que es posible ordenar los elementos contenidos en la misma, de forma ascendente / descendente. Esto puede hacerse clickeando sobre la palabra resaltada. Al lado de la palabra aparecerá una flecha indicando el sentido del ordenamiento (flecha hacia arriba: ascendente / fecha hacia abajo: descendente)

SeguridadPara acceder a las opciones de seguridad disponibles, presionar dentro del menú.Seguridad

Se desplegarán tres opciones de menú a las que se podrá acceder haciendo click sobre la elegida:Seguridad > GruposSeguridad > PermisosSeguridad > Usuarios

A continuación se explicará la funcionalidad y uso de cada una de las opciones de seguridad mencionadas anteriormente.

Grupos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Grupos" dentro de "Seguridad" (Seguridad > ) Grupos

Descripción de la página:

A través de esta página es posible efectuar el alta, eliminación y modificación de los grupos de usuarios que se manejarán en el sistema.

A cada grupo le pueden ser asignados permisos Un permiso brinda el acceso a una determinada funcionalidad del sistema., los cuales indican los permisos que los usuarios de ese grupo poseerán en el uso del sistema.

Funcionalidad:

Búsqueda de grupos

Para buscar un grupo ingresar el nombre del mismo y presionar el botón "Buscar".

Al hacer esto en la tabla se mostrarán sólo aquellos grupos que posean un nombre igual o similar al ingresado.

Alta de grupos

Para crear un grupo, presionar el botón ante lo cual se desplegará la siguiente pantalla:"Crear"

Se deberá ingresar un nombre para el grupo el cual tendrá que ser distinto a todos los nombres de los grupos dados de alta en el sistema. Luego será necesario seleccionar los permisos que le serán asignados al grupo. Para hacer esto se deberá tildar el check box correspondiente al permiso que se le desea brindar al grupoPresionar para finalizar la creación del grupo o si no se desea que el grupo sea creado."Aceptar" "Cancelar"

Modificación de grupos

Para modificar un grupo se debe presionar el link correspondiente al grupo en cuestión. "Modificar"

A través de la pantalla de modificación se podrá visualizar una lista con los usuarios asignados al grupo, con la posibilidad de acceder a su edición. También se podrá cambiar el nombre del grupo y los permisos asociados a él

Una vez efectuada las modificaciones presionar para guardar los cambios o para ignorarlos."Aceptar" "Cancelar"

Eliminación de grupos

Para eliminar un grupo primero se debe tildar el check box correspondiente al grupo, presente en la columna "Eliminación" y luego presionar el botón "Eliminar". Si se desea eliminar todos los grupos presentes en la página, en lugar de elegirlos uno a uno es posible hacer click sobre el checkbox que se encuentra en el encabezado de la columna "Eliminación". De Consejo práctico:

esta manera con un único clic del mouse quedarán todos seleccionados. Al presionar el sistema solicitará la confirmación de la eliminación."Eliminar"

Permisos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Permisos" dentro de "Seguridad" (Seguridad > )Permisos


A través de esta página puede accederse a la gestión de los permisos disponibles en el sistema. Un permiso puede ser entendido como un acceso que se concederá a un grupo o a un usuario de la aplicación a cierta funcionalidad del sistema.

Funcionalidad:

Búsqueda de permisos

Para buscar un permiso ingresar el nombre del mismo y presionar el botón Se mostrarán como resultado sólo aquellos permisos cuyo nombre sea similar al ingresado."Buscar".

Por cada permiso podrá visualizarse los usuarios y grupos que lo poseen.

Usuarios

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Usuarios" dentro de "Seguridad" (Seguridad > )Usuarios


A través de esta página es posible efectuar el alta, eliminación y modificación de los usuarios que tendrán acceso al sistema.

A cada usuario le pueden ser asignados el / los grupos / s a los cuales el mismo pertenecerá (no es obligatorio asignar un grupo al usuario) La pertenencia de un usuario a un grupo implica que heredará todos los permisos que le fueron asignados al grupo, contándose también con la opción de asignar a ese usuario permisos adicionales o quitarle ciertos permisos.

Un usuario activo en la consola de administración no tiene permitido editar sus propios permisos. La asignación de permisos o de grupos lo deberá efectuar otro usuario con permisos de administrador.Importante:

Funcionalidad:

Búsqueda de usuarios

Para buscar un usuario, ingresar el nombre del mismo y presionar el botón "Buscar".

Al hacer esto en la tabla se mostrarán sólo aquellos usuarios que posean un nombre igual o similar al ingresado.

Alta de usuarios

Para crear un nuevo usuario, se deberá:

Asignar un nombre al mismo, el cual debe ser único, es decir, distinto al de los usuarios que se encuentran dados de alta en el sistemaIndicar el nombre y apellido del usuarioIngresar una clave (password) con la cual este se logueará a la consola de administraciónReingresar la clave para validar que está bien ingresadaComo dato opcional, el email del usuario (si se utilizarán el sistema de alertas es requerido proporcionar un email válido)Indicar si la contraseña del usuario expira y debe ser cambiada cada una X cantidad de tiempoIndicar si para éste usuario se validará el periodo de inactividad que bloquea la cuentaIndica si en el próximo inicio de sesión el usuario nuevo debe cambiar la contraseñaSi el usuario está habilitado para iniciar sesión

Nota: El usuario con permisos de administrador que facilite el alta de usuarios deberá tildar la opción para que el nuevo usuario creado tras acceder pueda modificar "Debe cambiar la contraseña en próximo inicio de sesión"la misma.

Luego, opcionalmente, pueden seleccionarse uno o más grupos a los cuales el usuario pertenecerá. Si se desea asignar al usuario un grupo que no se encuentra dado de alta en el sistema, se puede acceder a la creación de este grupo desde la pantalla de alta del usuario, presionando el link ."Nuevo grupo"

Cuando se asignan grupos a un usuario, los permisos que posea el mismo serán el resultado de la suma de los permisos de cada uno de los grupos a los cuales pertenece. También se dispondrá de la opción de editar estos permisos pudiendo agregar o quitar permisos al usuario, tanto para el caso que el usuario tenga un grupo asignado como para el caso en el que no se haya seleccionado ningún grupo para él. Recordar que si a un usuario se le quita el grupo , no podrá acceder a la consola de administración del producto. También tener en cuenta que si un usuario no posee el permiso de de una página, entonces no Acceso Consola visualizaciónpodrá acceder a la misma. Por ejemplo: si el usuario no tiene el permiso "Visualizar compañías" no podrá acceder a la página de compañías y ni siquiera la verá en el menú.

: para poder acceder a la consola de VTOL se deberá tener el permiso " ". También el usuario deberá ser habilitado mediante el checkbox de " "Importante Acceso Consola Usuario habilitadoPara finalizar la creación del usuario presionar . Si no se desea llevar adelante la creación, presionar ."Aceptar" "Cancelar"

Modificación de usuarios

Para cambiar los datos asociados a un usuario se debe seleccionar el mismo presionando el link Al hacer esto se mostrará la pantalla de modificación de usuario."Modificar"

En esta pantalla se podrán modificar los datos ingresados para el usuario (nombre, password) como así también los grupos a los cuales éste pertenece y sus permisos.Además se presentan dos CheckBox:

Expiración de contraseña habilitadaIndica si la contraseña expira luego de una X cantidad de días configurable en el sistema.

Bloqueo de usuario sin actividad habilitadoIndica si el usuario puede ser bloqueado automáticamente por el sistema luego de superar una cantidad X (días) de inactividad.

Debe cambiar contraseña en próximo inicio de sesiónIndica si el usuario debe cambiar la contraseña en su próximo inicio de sesión

Usuario bloqueadoEsta opción se activa automáticamente cuando el usuario supero la cantidad máxima de intentos de login, por lo que la cuenta queda bloqueada temporalmente o hasta tanto un super-usuario destilde ésta opción.

Usuario habilitadoPor medio de ésta opción se puede deshabilitar a un usuario para que no pueda realizar el login.

: En esta modificación se podrá además deshabilitar al usuario mediante el checkbox " " o desbloquear un usuario que el sistema haya bloqueado por error en los ingresos de la contraseña. Esto Importante Usuario habilitadoes válido antes del periodo de bloqueo del sistema (30 minutos). Para realizarlo, utilizar el checkbox " " Usuario bloqueadoUna vez modificados los datos deseados, presionar para guardar los cambios o para desecharlos."Aceptar" "Cancelar"

Eliminación de usuarios

Un usuario puede ser eliminado seleccionando el check box correspondiente al usuario en cuestión, presente en la columna de la tabla de usuarios y luego presionando El check box "Eliminación" "Eliminar"correspondiente al usuario que se encuentra logueado en la consola se muestra deshabilitado (en color gris) dado que un usuario no puede eliminarse a sí mismo.

Al presionar se desplegara una ventana, solicitando confirmación de la eliminación en progreso."Eliminar"

Modificación de contraseñas

En el caso que el usuario desee realizar la modificación de la contraseña de un usuario en particular, se debe acceder a la modificación del usuario.

Una vez validada que la última contraseña no coincida con la anterior, el usuario podrá continuar con el resto de los pasos. Para que la clave sea válida debe tener caracteres y números que sean imprimibles, por ejemplo: ! " # $ % & / ( ) = ? ¡ _ - . : ; , { }En caso de que el usuario quiera modificar su propia contraseña, lo hará desde la edición de su perfil ubicado en la parte superior y central de la pantalla: "Mi Perfil".

AdministraciónPara acceder a las opciones disponibles de administración de la consola, presionar dentro del menú. Herramientas administrativas

Se desplegarán las siguientes opciones de menú a las que se podrá acceder haciendo click sobre la elegida:

A continuación se explicará la funcionalidad y uso de cada una de las opciones mencionadas anteriormente.

Auditoría

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Auditoría" dentro de "Herramientas administrativas" (Herramientas administrativas > )Auditoría


Esta página permite conocer las acciones que efectúan los usuarios a través de la consola de administración, posibilitando llevar un control detallado de las mismas.

Funcionalidad:

Búsqueda

Es posible realizar una búsqueda de las acciones efectuadas por medio de la consola de administración, filtrando por

fecha y horanombre de usuariotipo de eventofuente del eventohost remotodirección host

Para ello se deben completar los filtros deseados y luego presionar el botón ."Buscar"

Auditoría de acciones efectuadas

Se presentará de cada una de las acciones realizadas a través del sistema, la siguiente información:

Tipo de evento que tuvo lugar. Este dato se emplea para diferenciar distintas clases de acciones que pueden realizarse en el sistema. Actualmente existen dos tipos: seguridad, la cual abarca acciones vinculadas con ABM de grupos, usuarios y permisos y consola, la que engloba el resto de las acciones en la consola base.Código que identifica al tipo de evento. Este código se brinda como una forma rápida de identificar una clase de acción.Fecha y hora en la que se realizó la acción.Usuario que la efectuó.Descripción que explica en qué consistió la acción realizada.Fuente del evento. Indica en que componente del sistema ocurrió el evento.Dirección Host nos muestra la dirección IP desde donde se accedió.Host remoto indica el nombre del host desde el que se accedió.Estado indica si la transacción resultó OK o con error.Detalle en el caso de que el estado fuese distinto de OK.

Configuración

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Configuración" dentro de "Herramientas administrativas" (Herramientas administrativas > )Configuración


Esta página permite configurar las distintas propiedades disponibles en la aplicación, ingresando el valor correspondiente para cada una de ellas. Está orientada a un usuario que tenga un perfil de administrador puesto que brinda opciones de configuración avanzada del sistema.

Funcionalidad:

Búsqueda de propiedades

Dado que el producto VTOL Core cuenta con numerosas propiedades que pueden ser configuradas, resulta de utilidad contar con la posibilidad de efectuar búsquedas. Para ello se dispone de dos campos de búsqueda: nombre y categoría de la propiedad. La categoría de la propiedad se emplea para efectuar un agrupamiento de propiedades afines que corresponden a una misma parte del sistema, de manera de facilitar el proceso de configuración.

Para efectuar la búsqueda, se deben completar los campos deseados y luego presionar "Buscar".

Modificación de propiedades

Cada propiedad se encuentra configurada con un valor por defecto que puede ser modificado por el usuario.

Para cambiar el valor asignado a una propiedad se debe presionar el link " " asociado a la propiedad en cuestión.Modificar

En la pantalla de modificación se muestra el valor que tenía la propiedad antes de ser modificada: "valor anterior" y se dispone de una columna en la cual ingresar el nuevo valor para dicha propiedad: "valor nuevo". También se cuenta con una descripción de la propiedad que indica el significado y utilidad de la misma.Para cambiar el valor de la propiedad se deberá ingresar el valor deseado en la columna "nuevo valor" y presionar el botón " ".Aceptar

Para que los cambios realizados sobre las propiedades tengan efecto se deberá presionar el botón "Aceptar". Al hacer esto se abrirá una ventana en la cual se mostrará el nombre de las propiedades modificadas, solicitándose confirmación para llevar adelante los cambios.

Para que la modificación se realice, presionar "Aceptar", caso contrario, presionar "Cancelar".

Nota: para configurar aquellas propiedades que consisten en una lista de valores se emplea la siguiente sintaxis: \['valor1', 'valor2', 'valorN'\]

VTOL trae por defecto la configuración que cumple con las normativas PCI. En caso de que el cliente efectúe modificaciones, la aplicación incumpliría con PCI DSS.

Revertir propiedades modificadas

Las propiedades que fueron modificadas pueden ser regresadas a sus valores anteriores mediante la opción revertir. Para ello se deberá seleccionar el check box de la propiedad cuyo valor desea revertirse y presionar el botón Los check box de las propiedades que han sido modificadas son los únicos que se mostrarán habilitados."Revertir".

Alertas

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Alertas" dentro de "Administración" (Administración > ).Alertas


En esta página se pueden crear, modificar y eliminar las alertas que el sistema manejará ante los distintos escenarios de error o posible falla que se presenten en el sistema. Un alerta funciona como un aviso de la ocurrencia de tales episodios.

Funcionalidad:

Búsqueda de alertas

Para conocer las alertas que se encuentran activas en el sistema se puede efectuar una búsqueda por el nombre de la alerta. Para ello se debe completar el campo y presionar el botón ."Nombre del alerta" "Buscar"

Creación de alertas

Crear una alerta implica indicar que ante la ocurrencia de un determinado error o eventual falla se efectuará una cierta acción informativa para que el usuario se encuentre bajo conocimiento de lo sucedido.

Para crear una alerta se debe presionar el botón presente en la parte inferior de la pantalla. Luego se deberá ingresar los datos solicitados por el sistema para la alerta:"Crear"

Nombre de la alerta: nombre único que permite identificar a una alerta. Se aconseja emplear un nombre significativo que brinde una visión clara del propósito de la alerta.Acción a efectuarse: es la acción que tendrá lugar cuando ocurra el evento que dispara la alerta. Actualmente la acción disponible es el envío de un mail.Evento disparador: es el suceso que hace que se dispare la alerta.Usuarios a los que se notificará la alerta: cuando la acción de la alerta es el envío de un mail se deben seleccionar los usuarios a los cuales les será enviado dicho mail.

Presionar para que la creación de la alerta sea efectuada. Presionar si no se desea crear la alerta. Al presionar se desplegará una ventana pidiendo confirmación de la creación. "Aceptar" "Cancelar" "Aceptar"

Modificación de alertas

Para modificar una alerta se debe presionar el link correspondiente a la misma. Es posible cambiar el nombre de la alerta, así como también la acción efectuada por la misma y los usuarios a los cuales se "Modificar"notifica.

Si se desea que los cambios efectuados tengan lugar se debe presionar . Caso contrario presionar "Aceptar" "Cancelar".

Al presionar se desplegará una ventana pidiendo confirmación de la modificación."Aceptar"

Eliminación de alertas

Para eliminar un alerta, primero se debe seleccionar la misma marcando el checkbox que se encuentra en la columna y luego presionar el botón . De esta forma la alerta ya no tendrá vigencia en el "Eliminación" "Eliminar"sistema, debiéndose crear nuevamente si se desea que vuelva a avisarse de la ocurrencia del evento a los usuarios.

Al presionar " ", se desplegará una ventana pidiendo confirmación de la eliminación de la/s alerta/s.Aceptar

Planificación de procesos

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Planificación" dentro de "Administración" (Administración > ).Planificación


Esta página permite acceder a la funcionalidad de planificación de procesos de negocio efectuados por VTOL Core o bien por alguno de sus módulos. Para estos procesos es posible configurar la frecuencia con la cual los mismos se efectúan. Esta funcionalidad está orientada a un usuario administrador con conocimientos avanzados de la solución VTOL Server y sus operaciones, puesto que configurar erróneamente los valores de planificación puede llevar a escenarios no deseados en el funcionamiento del producto.

Funcionalidad:

Búsqueda de procesos planificados

Es posible efectuar la búsqueda de procesos disponibles para ser planificados, a través del campo de búsqueda Seleccionada una opción para este campo, presionar para que la "Nombre del proceso". "Buscar"búsqueda tenga lugar.

Modificación de la planificación

Para modificar los valores de planificación ingresados para un proceso se debe hacer click sobre el link denominado correspondiente al proceso deseado. Para cada proceso puede cambiarse el tipo de "Modificar"ejecución del mismo, lo cual se vincula con la frecuencia con la cual el proceso se ejecuta.

Los tipos de ejecución disponibles son:

Diariamente a las… : permite configurar que el proceso se ejecute todos los días en un determinado horario en formato (hh:mm:ss)

Intervalo y cant. de ejecuciones: permite indicar el intervalo de tiempo entre ejecuciones del proceso y también la cantidad de veces que el proceso se ejecutará.

Expresión avanzada: permite ingresar una cron expression. Se puede obtener ayuda sobre la formación de cron expressions mediante el ícono de Ayuda.

Si se desea guardar los cambios se debe presionar , caso contrario presionar En cualquiera de los casos al presionar , se solicitara, mediante una ventana, la confirmación de la "Aceptar" "Cancelar". "Aceptar"modificación del proceso.

Descargar Archivos de Log

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Descargar Archivo de Log" dentro de "Herramientas administrativas" (Herramientas administrativas > )Descargar Archivo de Log


Esta página permite descargar archivos de log del sistema en forma comprimida. En primera instancia se debe seleccionar el nodo del Cluster y presionar el botón . Luego seleccionarlos en la lista y Buscar Archivospresionar el botón .Descargar

El objetivo es facilitar la recolección de log del sistema cuando es requerido realizar algún tipo de análisis, por ejemplo, ante un problema de conexión o de procesamiento de una transacción.

1. 2. 3. 4.

1. 2.

Configuración

Para el correcto funcionamiento de ésta funcionalidad es requerido previamente haber configurado la propiedad que se lista a continuación, usando como guía el apartado " ":5.2 Configuración

Propiedad Categoría Descripción

Máximo que pueden sumar en MBytes los archivos de log a comprimir y descargar

VTOLCore Cantidad máxima en MB que podrán sumar los archivos a bajar desde el sistema. Superada ésta cantidad el sistema no permitirá la descarga

Funcionalidad:

Descargar

La única función que presenta ésta pantalla es descargar uno o más archivos de logs del sistema.

La forma de operar es la siguiente:

presionar el botón " ", que listará los existentes logs en el sistemaBuscar Archivosseleccionar, mediante los checkbox, uno o más archivos de logs.Presionar el botón " "DescargarEl sistema comprimirá los archivos seleccionados y luego pedirá al usuario seleccionar una ubicación para poder descargar el resultado.

Notas:

No se podrá sobrepasar el tamaño máximo configurado en MB. Si se sobrepasa, el sistema lo indicará por medio de un mensaje.El archivo resultante podrá ser abierto por una aplicación compatible con ZIP.

MonitoreoEl monitoreo que proporciona VTOL Core es a nivel del producto. Por lo tanto brinda información sobre la cantidad de transacciones manejadas por el sistema para todos los módulos de VTOL que se encuentren instalados. Esto permite tener una visión del estado del sistema en su totalidad.

Para acceder a las opciones de monitoreo a nivel del producto VTOL, presionar la opción del menú "Estado General del Sistema" dentro de VTOL (VTOL > )Estado General del SistemaA continuación se explicará la funcionalidad y uso de cada una de las opciones de monitoreo mencionadas anteriormente.

Estado General del Sistema

Acceso:

Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Estado General del Sistema" dentro de "VTOL" (VTOL > )Estado General del Sistema


Esta página brinda una visión global del estado del sistema en su totalidad, ofreciendo información de tráfico de transacciones sumarizada para todos los módulos del producto VTOL que se encuentren instalados.

Funcionalidad:

Filtrado de información

La información de cantidad de transacciones presentadas en esta pantalla de monitoreo puede ser filtrada por empresa. Para ello se debe seleccionar la empresa deseada en el combo " " y la pantalla será Compañíaautomáticamente refrescada con la información correspondiente a la empresa elegida.

Visualización de cantidad de transacciones

Se brinda la siguiente información:

Comunicación POS – VTOL:Cantidad de transacciones recibidas por VTOL.Cantidad de transacciones respondidas por VTOL.

Detalle del tráfico:Confirmadas: número de transacciones que fueron confirmadas por el POS.Reversadas: número de transacciones que fueron reversadas por el POS.

Pendientes: número de transacciones para las que aún no se ha recibido el mensaje del POS confirmándolas o reversándolas.Total: indica la cantidad total de transacciones recibidas por VTOL.Chequeo de pendientes: cantidad de transacciones de chequeo de pendientes enviadas por VTOL.Autorización: cantidad de transacciones de autorización recibidas por VTOL.

Estado de servidoresServidor: indica el nombre del servidor perteneciente al clusterDescripción: descripción del nodo del cluster.Estado: indica en qué estado está el servidor.Nodo Maestro: indica si el nodo en cuestión es o no el nodo maestro del clusterTiempo Activo/Inactivo: tiempo de permanencia en ese estado.

Nota: cada vez que se reinicia el sistema las cantidades de transacciones se resetean, es decir, vuelven a cero.

Reseteo de contadores de transacciones

El usuario puede, cuando lo desee, colocar en cero los contadores de transacciones que se muestran en la página. Para ello se debe presionar el botón "Limpiar"

ConfiguraciónA continuación se explicará la funcionalidad y uso de cada una de las opciones de configuración. Se aconseja efectuar la configuración de la aplicación siguiendo el orden de las secciones que se presenta en este manual.

Compañías

Acceso:

Para acceder a la configuración de las compañías, seleccionar la opción dentro del menú de VTOL (VTOL > )"Compañías" Compañías


A través de esta página es posible administrar las compañías con las cuales trabajará el sistema.

Funcionalidad

Búsqueda de compañías

Para obtener la información de una compañía específica cargada en el sistema se dispone de la opción de buscarla por medio del campo de búsqueda denominado presente en la parte superior de la pantalla. "Compañía"Una vez seleccionado el valor de este campo presionar ."Buscar"

En la consola de Multiempresa se ofrece además el campo de búsqueda " ".País

Alta de compañías

Para cargar una compañía en el sistema se debe presionar el botón Hecho esto la aplicación solicitará el ingreso del nombre de la compañía (debe ser único) y de los usuarios que tendrán acceso a la información y "Crear".a la realización de operaciones sobre las transacciones de dicha compañía. Para seleccionar un usuario se debe hacer click en el checkbox presente en la columna correspondiente al usuario en cuestión. "Selección"Aparecerá un tilde en el checkbox indicando que el mismo se encuentra seleccionado.

En la consola de Multiempresa se solicitará el ingreso del código de compañía y el país de la misma.

Presionar para concluir el alta de la compañía. Presionar si no se desea que la compañía se cargue en el sistema."Aceptar" "Cancelar"

Modificación de compañías

Para modificar una compañía, hacer click sobre el link correspondiente a la misma. El sistema permitirá cambiar el nombre de la compañía y los usuarios con permisos sobre la misma."Modificar"

En la consola de Multiempresa se ofrecerá también el campo código de compañía.

Baja de compañías

Se debe indicar la compañía que se desea borrar seleccionando el checkbox correspondiente a la misma presente en la columna y luego presionar el botón Tener en cuenta que el sistema no "Eliminación" "Eliminar".permitirá eliminar una compañía para la cual existen transacciones pendientes de cierre.

Al presionar el sistema solicitará la confirmación de la eliminación:"Eliminar"

Habilitación de compañías

En la consola de Multiempresa, las compañías poseerán un estado de habilitada o no habilitada. Las mismas pueden ser habilitadas o deshabilitadas según sea necesario bajo demanda.

Para habilitar o deshabilitar una compañía es necesario seleccionar, en " ", las compañías que se quieren habilitar o deshabilitar. Luego hay que presionar el botón " " y se realizará la acción Selección Habilitar/Deshabilitaropuesta al estado en que esté la compañía al momento de realizar la acción. El estado actual está indicado por el valor de la columna " ".Habilitado

Locales

Acceso:

Para acceder a la configuración de los locales, seleccionar la opción dentro del menú de VTOL (VTOL > )"Locales" Locales


A través de esta página es posible administrar los locales de cada compañía con los cuales trabajará el sistema.

Funcionalidad:

Búsqueda de locales

Para obtener la información de un local específico se dispone de la opción de buscarlo por medio de los siguientes criterios: compañía a la que pertenece, nombre del local (búsqueda por similitud), código de local (búsqueda por similitud), indicador de tiendas virtuales. Ingresar los valores deseados en los campos de búsqueda y presionar ."Buscar"

Alta de locales

Para cargar un local en el sistema se debe presionar el botón Hecho esto la aplicación solicitará el ingreso de la compañía a la que pertenece el local, el nombre del local, el código del mismo y el indicador de "Crear".tienda virtual. También solicitará la selección de los usuarios que tendrán acceso a la información y a la realización de operaciones sobre las transacciones de dicho local. Para seleccionar un usuario se debe hacer click en el checkbox presente en la columna correspondiente al usuario en cuestión. Aparecerá un tilde en el checkbox indicando que el mismo se encuentra seleccionado. Tener en cuenta que si un usuario no tiene "Permisos"permisos para una compañía, entonces no tendrá permisos de acceso a la información de ninguno de sus locales.

Presionar " " para concluir el alta del local. Presionar " " si no se desea que el local se cargue en el sistema.Aceptar Cancelar

Configuración de información asociada al local

Una vez efectuada el alta de un local es necesario cargar cierta configuración vinculada con el mismo, la cual será utilizada por el módulo que haya agregado dichas entradas.

Cada módulo deberá cargar a gusto dichas entradas de ser necesaria una configuración asociada a un local en particular. Para mayor información de dichos vínculos ver documentación relacionada al módulo en cuestión.

Modificación de locales

Para modificar un local, hacer click sobre el link correspondiente al mismo. El sistema permitirá cambiar los datos del local y los usuarios con permisos sobre el mismo."Modificar"

Sólo los usuarios con el permiso podrán realizar el cambio de la propiedad que indica si la tienda es virtual."Acceso a propiedad virtual en modificación de locales"

Baja de locales

Se debe indicar el local que se desea borrar seleccionando el checkbox correspondiente al mismo, presente en la columna , y luego presionar el botón Tener en cuenta que el sistema no permitirá "Eliminación" "Eliminar".eliminar un local para el cual existen transacciones pendientes de cierre.

Cajas

Acceso:

Para acceder a la configuración de las cajas de venta, seleccionar la opción dentro del menú de VTOL (VTOL > )"Cajas" Cajas

Descripción de la página

A través de esta página es posible administrar cajas (puntos de venta) con las cuales operará el sistema.

Configuración

El sistema cuenta con un control de cantidad de Rollback que una caja (terminal física o POS) puede realizar en un cierto tiempo. Si ésta cantidad es superada el sistema bloquea la caja (no puede seguir operando) y lanza un evento, para que un operador realice un procedimiento manual.

La finalidad de ésta funcionalidad consiste en detectar cajas con problemas. No es normal que una caja haga sucesivos Rollback de transacciones. Para que un usuario/operador sea correctamente notificado de éste evento, es necesario que se configure la alerta utilizando el evento que se muestra a continuación, utilizando como guía de configuración el apartado "5.4

Alerta".

Para el correcto funcionamiento de ésta funcionalidad es requerido previamente haber configurado las propiedades que se listan a continuación, usando como guía el apartado " ":5.2 Configuración

Propiedad Categoría Descripción

Fusible Rollback: Maxima cantidad de rollback por nodo permitido VTOLCore Cantidad maxima de rollbacks permitidos por nodo dentro del umbral de tiempo definido antes de bloquear o deshabilitar el nodo.

Fusible Rollback: Umbral de tiempo de conteo de rollbacks VTOLCore Tiempo en segundos en que se contaran los últimos rollback realizados por un nodo para evaluar el bloqueo del mismo.

Fusible Rollback: Control de rollback habilitado VTOLCore Habilita o deshabilita la funcionalidad de monitoreo de cantidad de rollback de nodos.

Funcionalidad:

Búsqueda de cajas

El sistema brinda la opción de buscar una caja ingresando:

compañíalocal a los que pertenececódigo identificatorio (búsqueda por similitud).Si está o no habilitada.

Una vez completados los campos de búsqueda presionar ."Buscar"

Alta de cajas

Para cargar una caja en el sistema se deben completar los siguientes datos: compañía y local al cual corresponde la caja y el código que la identifica. Estos datos deben ser ingresados en el área de la página destinada a la carga de nuevas cajas (bajo el título " ") Agregar una caja

Para efectuar el alta de las cajas se dispone de dos opciones: ingresar las cajas una a una o ingresar varias a la vez (un rango de cajas) La última opción es posible sólo cuando los códigos de las cajas son numéricos y secuenciales.

Para ingresar un rango de cajas, se debe colocar el primer código de caja del rango en el campo y el último código en el campo . El sistema cargará todas las cajas que se encuentren en ese rango "desde" "hasta"asociándolas a la compañía y local que se hayan indicado. Por ejemplo: si se ingresa como valor desde el 1 y valor hasta el 4, el sistema dará de alta cuatro cajas con códigos 1, 2, 3 y 4 respectivamente (rellenando con la cantidad de ceros correspondiente dependiendo de la longitud que se haya configurado para la caja)Cuando no se desee ingresar un rango sino una única caja, completar en el campo el código correspondiente a la caja y dejar el campo vacío."desde" "hasta"

Presionar para concluir el alta de la caja. Presionar si no se desea que la caja se cargue en el sistema."Aceptar" "Cancelar"

Por defecto, las cajas creadas están habilitadas.

Modificación de cajas

Para modificar una compañía, hacer click sobre el link correspondiente a la misma. El sistema permitirá cambiar el código identificatorio asignado a la caja, así como también el local al que pertenece. No está "Modificar"permitido cambiar la compañía a la que corresponde una caja.

Habilitación de caja

Las cajas pueden ser habilitadas o deshabilitadas según sea necesario.

Además el sistema cuenta con un control (el mismo tiene que estar habilitado) o fusible que permite deshabilitar una caja automáticamente en los casos en que el POS envíe simultáneos rollback en una ventana de tiempo configurada. Este control sirve para evitar que un POS en mal funcionamiento siga autorizando transacciones. Para mayor información recurrir al apartado " ".7.3.3 ConfiguraciónPara habilitar o deshabilitar una caja es necesario seleccionar, en " ", las terminales o nodos que se quieren habilitar o deshabilitar. Luego hay que presionar el botón " " y se realizará la acción Selección Habilitar/Deshabilitaropuesta al estado en que esté la terminal al momento de realizar la acción. El estado actual está indicado por el valor de la columna " ".Habilitado

Eliminación de cajas

Se debe indicar la caja que se desea borrar seleccionando el checkbox correspondiente a la misma presente en la columna y luego presionar el botón Tener en cuenta que el sistema no permitirá "Eliminación" "Eliminar".eliminar una caja para la cual existen transacciones pendientes de cierre.

El sistema solicita confirmación para efectuar la eliminación de las cajas seleccionadas:

Activación de Cajas

Acceso

Acceso:Para acceder a la Activación de Cajas que se encuentran bloqueadas en el sistema, seleccionar la opción dentro del menú VTOL (VTOL > ). "Activación de Cajas" Activación de Cajas

Descripción de la página:Esta página permite observar las cajas Bloqueadas en sistema, permitiendo la activación de las mismas.

Nota: La página muestra la lista de todas las cajas que están en estado y superen el umbral de tiempo para poder activarse.Process

Funcionalidad:

Activar cajas

El sistema muestra en esta pantalla las cajas disponibles para poder Activarse, visualizando una lista con los siguientes datos:

Nombre de Compañía

Nombre del Local al que perteneceCódigo LocalCódigo de Caja.

Para realizar la activación de las cajas, el sistema permite seleccionar las que se desean activar (una o varias, e inclusive Todas tildando el Check Box ACTIVAR) en la lista. Luego se debe presionar el botón , lo "Activar"que visualiza una ventana de dialogo para la confirmación de la acción.

Generación Configuración POS

Acceso

Acceso:Para acceder a la generación de Configuración POS, seleccionar la opción dentro del menú VTOL (VTOL > ). "Generar Configuración" Generar Configuración

Descripción de la página:Esta página permite generar una nueva Versión de configuración.

Al hacer clic en el botón generar configuración, el sistema generará la configuración propia de CORE y de los módulos que también dispongan de dicha funcionalidad.

InterfacesA continuación se explicará la funcionalidad y uso de cada una de las opciones para manejar las interfaces.

Las opciones disponibles son las siguientes:

Las Interfaces por lo general son archivos de texto que contienen información transaccional, con un formato definido, que sirven como información de entrada en otros sistemas de conciliación o procesamiento de datos.

Generación de Interfaces

Acceso:

Para acceder a la pantalla de generación de interfaces, seleccionar la opción dentro del menú de VTOL > Interfaces > ."Generación de Interfaz" Generación de Interfaz


A través de esta página es posible generar interfaces para las compañías existentes en el sistema.

Importante: Las compañías podrán generar los tipos de interfaz que tengan habilitado. Ver apartado "Configuración de interfaces por compañía".sólo

Funcionalidad:

Generar interfaz

Para generar una interfaz primero se deben completar los datos solicitados por el sistema:

Compañía, a la cual se le va a generar la interfaz.Tipo de interfaz, son los tipos de interfaces propios del módulo crédito-débito.Definición de la interfaz: puede ser Pesos, Dólares, Default, etc. según la configuración de cada centro autorizador.Fecha de generación: disponible sólo en aquellos casos que se haya configurado en el sistema que la generación de interfaz se efectúa por fecha. Esto implica que la interfaz incluirá sólo las transacciones correspondientes a la fecha indicada.

Una vez ingresados los datos anteriores, presionar "Generar" y el sistema comenzará la generación de interfaz.Finalizada la acción el sistema comunicará, en la misma pantalla, un mensaje con el resultado de la operación. Si la interfaz se genera exitosamente se creará un archivo de texto con los datos de las transacciones, el detalle del resultado podrá ser consultado en el listado de interfaces generadas.

Listado de interfaces generadas

Acceso:

Para acceder a la pantalla de listado de interfaces generadas, seleccionar la opción dentro del menú de VTOL > Interfaces > ."Listado de interfaces generadas" Listado de interfaces generadas


A través de esta página es posible listar las interfaces generadas y regenerar una interfaz que ya había sido generada anteriormente.

Funcionalidad:

Listado de interfaz

Para listar las interfaces generadas se podrá filtrar por los siguientes campos:

CompañíaTipo de interfaz que se desea listarEstado de la interfazFecha de generación de la interfaz.

Una vez que se completan los filtros de búsqueda, hay que pulsar el botón " " y el sistema listará, como se muestra en la imagen, las interfaces generadas, o bien un mensaje indicando que para los filtros Buscarseleccionados no existen resultados.

La información mostrada por cada interfaz es la siguiente:

Compañía: es la compañía a la que pertenece la interfaz generada.Tipo de interfaz: tipo al que pertenece la interfaz seleccionada. Son los tipos de interfaces propias del módulo crédito-débito.Nombre del archivo: nombre y ubicación física del archivo generado que representa a la interfaz.Definición: la definición que se utilizó para generar la interfaz.Fecha de generación: indica la fecha en que se generó la interfaz.Estado: es el estado de la interface generada. Si resultó con error o se generó correctamente. Los valores posibles a mostrar son:

ERROR FINALIZED NO_TRX NO_GENERATED OK PROCESSING TO_PROCESS UPDATING

Descripción Estado: es la descripción del estado de la interface generada. Los valores posibles a mostrar son:ERROR = Procesado con errorFINALIZED = FinalizadoNO_TRX = Sin transaccionesNO_GENERATED = No generadoOK = Generado correctamentePROCESSING = En procesoTO_PROCESS = Para procesarUPDATING = Actualizando

Estado de envío: Estado que indicará si el archivo de interface generado pudo ser enviado al servidor por FTP. Los valores posibles a mostrar son:No requerido (aplica cuando las interfaces no generan envíos por FTP).

OK (indica que el archivo fue enviado correctamente al FTP).Error (indica que hubo un error al enviar el archivo al FTP).

Descripción: información adicional proporcionada por cada interfaz. Este valor dependerá de cómo esté desarrollada la interfaz.Regenerar: Acción que permitirá regenerar una interfaz previamente generada.

Regenerar Interfaz

El sistema brinda la posibilidad de volver a generar una interfaz que ha resultado con error. Para regenerar una interfaz se debe hacer click en la acción "Regenerar" sobre la interfaz deseada y el sistema procesará y regenerará la misma.Finalizado el procesamiento el sistema indicará con un mensaje si se pudo regenerar. Luego se podrá consultar el estado de la misma, en el listado de interfaces generadas.

Configuración avanzada de interfaces

Debido a que cada cliente tiene la necesidad de generar un archivo de interfaces propio utilizando una configuración especial para cada canal y con datos particulares por cada tienda, se puede configurar a VTOL para que utilice la configuración de forma aislada y separada de la instalación de VTOL.Para lograr esto hay que configurar a VTOL por medio de unos valores en la base de datos con el fin de que entre cada reinstalación de VTOL no se pise la configuración de VTOL ni la de las interfaces particulares del cliente.A continuación se explica cómo lograr esto: VTOL cuenta con una tabla llamada " " con la siguiente estructura:Interface

NOMBRE COLUMNA

DESCRIPCIÓN

ID Clave primaria de la base de datos. Debe ser única

NAME Nombre de la interface. Se debe corresponder con el valor utilizado en el archivo de configuración.

VTOLINTERFACESCLASS

Clase encargada de generar la interface. La clase debe estar cargada en el CLASSPATH de la aplicación.

INTERFACESVALIDATIONCLASS

Clase que se ejecutará antes de generar la interface que se encargará de validar que se pueda generar la interface.

CONFIGURATIONFILE

Nombre del archivo de configuración de la interface que se utilizará. Este archivo tiene que contener el PATH y el nombre del archivo. El PATH podrá ser relativo a la configuración de VTOL o bien absoluto. Para indicar PATH relativo se utiliza la variable " " que será reemplaza dinámicamente por el PATH del módulo, luego hay que indicar el PATH dentro del módulo. #MODULE_PATH#/Para utilizar un PATH absoluto hay que indicarlo directamente.

CONFIGURATIONRULESFILE

Este archivo indica la manera en la que se va a leer el archivo de configuración indicado en CONFIGURATIONFILE. Utiliza la misma lógica de configuración que en CONFIGURATIONFILE. NOTA: es recomendable no tocar esta configuración.

Por otro lado existe otra tabla donde se definen las "definiciones de interfaces". Por medio de esta se indica que definiciones existen para cada una de las interfaces declaradas en la tabla anterior.La tabla es la " " y tiene la siguiente estructura:InterfaceDefinition

NOMBRE COLUMNA DESCRIPCIÓN

ID Clave primaria de la base de datos. Debe ser única

NAME Nombre de la definición de la interface. Se debe corresponder con el valor utilizado en el archivo de configuración.

INTERFACEID Clave primaria utilizada en la definición de la interface de la tabla "Interface". Debe existir previamente a esta definición.

SCHEDULED Valor numérico que indica si la generación de la interface se debe planificar para ser generada automáticamente. 1=verdadero 0=falso

SCHEDULEDTIME Expresión que indica el período en que se debe generar esta interface. La expresión debe cumplir con la especificación de Quartz. Ejemplo: "00 01 03 * * ?" = todos los días a las 03:01:00 AM

Utilizando estas tablas y variando su configuración se puede independizar la configuración de cada interface según requiera el cliente y evitando que en cada actualización o reinstalación de VTOL se pise la configuración de las interfaces.

: tener en cuenta que para la generación y la re-generación de las interfaces no es necesario reiniciar VTOL ya que se cuenta con una lógica donde se verifica si la configuración ha cambiado y de ser así, la misma se NOTArecarga. Esta funcionalidad tiene el objetivo de poder realizar la configuración manual de forma más dinámica.

Configuración de Interfaces por Compañías

Acceso:

Para acceder a la pantalla de configuración de interfaces por compañías, seleccionar la opción dentro del menú de VTOL > Interfaces > .Configuración de Interfaces por Compañías


A través de esta página es posible configurar las interfaces que cada compañía podrá generar. Una compañía sólo podrá generar los tipos de interfaces que tengan habilitados.

Funcionalidad:

Configurar interfaces por Compañías

Para configurar una interfaz se debe seleccionar:

CompañíaTipo de interfaz

Una vez que se completen los filtros de búsqueda, pulsar el botón y el sistema listará, como se muestra en la imagen, las interfaces para configurar por compañía.."Buscar"

El resultado de la búsqueda mostrará los datos en las siguientes columnas:

CompañíaTipo de InterfazHabilitado, muestra si el tipo de interfaz se encuentra habilitado para la compañía seleccionada.Selección, campo de selección para poder aplicar la acción de Habilitar / Deshabilitar.

Una vez que se listan los resultados de la búsqueda, se podrá Habilitar o Deshabilitar el tipo de interface a una determinada compañía. Se debe presionar el campo Selección y luego hacer clic en el botón Habilitar / Deshabilitar. Se aplicará la acción contraria a la configuración que tiene en ese momento. Por ejemplo si tiene el checkbox seleccionado, entonces al presionar el botón, se deshabilitará. Se mostrará un mensaje de confirmación: "¿Está seguro que desea habilitar / deshabilitar las compañías para los tipos de interfaz seleccionadas?"

Al presionar el checkbox que se encuentra en la cabecera de la grilla de resultados, se seleccionarán todos los resultados que se muestran en la grilla.

Reportes

Reporte de Cajas Inactivas

Acceso:Para acceder al reporte, presionar la opción "Reporte de Cajas sin Actividad" dentro del menú "VTOL" (VTOL > )Reporte de Cajas Inactivas

Descripción de la página:A través de esta página es posible generar un reporte donde se visualizarán las cajas activas (no dadas de bajas) que NO posean transacciones en el rango seleccionado.

Criterios de filtrado:Fecha y Hora de la Operación (rango)Compañía.Nombre / Código de Local.

: FuncionalidadEste reporte brinda la posibilidad de obtener todas las cajas que no han realizado ninguna operación durante el rango específico de tiempo seleccionado. Cada reporte podrá ser obtenido en uno de los siguientes formatos: HTML, PDF, RTF y Excel.

Búsqueda por Número Único

Acceso:Para acceder a la página, presionar la opción "Buscar transacción por numero único" dentro del menú "VTOL" (VTOL > )Buscar transacción por numero único

Descripción de la página:A través de esta página es posible buscar y mostrar el detalle de una transacción a partir del número único de transacción o trxRefNumber, este número es generado por VTOL en todas aquellas transacciones que son aprobadas y es devuelto al POS en la mensajería POS-VTOL (Ver manual de mensajería POS-VTOL) para que cada cliente haga uso de este campo según sus necesidades.La finalidad de esta página es brindar al usuario la posibilidad de buscar una transacción por el número único y ofrecer el detalle con información de la transacción.El sistema avisara con un mensaje en caso de que no exista la transacción buscada. Nota: La búsqueda solo se realiza por Número Único y no acepta caracteres especiales.

La información detallada de la transacción se compone por información común a todas las transacciones

Transacción:Numero únicoTipo de transacción.Compania.TrxIdCajaNombre del ModuloFecha TransacciónTiendaEstado Transacción

Detalle de Transacción:AtributoValor

Estos atributos varían según el módulo de VTOL al que pertenecen. Ejemplo de transacción perteneciente al módulo Crédito Débito.

Configuración de BackendEn la presente sección se explicará la configuración del sistema con respecto a las reglas de negocio usadas en el procesamiento de transacciones o comportamientos asociados en general para todo el sistema.

Las mismas se acceden y se configuran a través de la pantalla de configuración. Para mayor detalle ver 7. Configuración

Habilitación del sistema

VTOL Core habilitado en True.

Comunicación Servidor

Esta comunicación servidor es la principal del sistema por la cual el sistema recibe las peticiones de autorizaciones o transacciones bajo el protocolo propietario "VTOL".

La configuración asociada a éste componente es la siguiente:

Propiedad

Comunicación no encriptada POS - VTOL habilitada

Puerto de comunicación no encriptada POS-VTOL

Comunicación Encriptada simétrica

Comunicación del tipo servidor (por defecto desactivada) que permite realizar un encripción entre el POS y VTOL Server.


Propiedad

Comunicación encriptada POS-VTOL habilitada

Puerto de comunicación encriptada POS – VTOL

Algoritmo de desencriptación de la comunicación

Clave algoritmo de encriptación de la comunicación

Algoritmo de encriptación de la comunicación

Clave algoritmo de desencriptación de comunicación

En ella se podrá configurar que algoritmo de encripción (DES o 3DES) simétrico utilizar así como las claves de desencriptación (cuando el mensaje llega desde el POS) y de encriptación (cuando el mensaje es respondido al POS). Normalmente se usan los 2 con la misma configuración.

Comunicación SSL/TLS

Comunicación del tipo servidor (por defecto desactivada) que permite realizar un encripción entre el POS y VTOL Server del tipo SSL/TLS


Propiedad

SSL: Comunicación SSL/TLS POS - VTOL habilitada

SSL: Puerto de comunicacion SSL/TLS POS-VTOL

SSL: Protocolo SSL/TLS

SSL: Paquetes de cifrados habilitados

SSL: Almacén de certificados del servidor

SSL: Contraseña del almacen de certificados del servidor

SSL: Tipo de almacen de certificados del servidor

SSL: Algoritmo del manejador del almacen de certificados del servidor

SSL: Requiere autenticacion de cliente

SSL: Almacen de confianza del servidor

SSL: Contraseña del almacen de confianza del servidor

SSL: Tipo de almacen de confianza del servidor

SSL: Algoritmo del manejador del almacen de confianza del servidor

En términos generales las comunicaciones SSL/TLS realizan un túnel seguro entre extremos (en éste caso entre el POS y VTOL) para enviar los datos de forma segura.Al establecer la comunicación se realiza un intercambio de datos de criptografía (handshake) para que ambos extremos coordinen que algoritmos se utilizarán para el túnel seguro. Ambos extremos deben soportar los mismo algoritmos (eso dependerá de software y configuración, por ejemplo, la versión del a JVM). Una vez establecido el túnel seguro, se puede realizar una autenticación tanto del servidor (sirve para que los clientes confíen en el servidor) como del cliente (sirve para que el servidor confíe en el cliente). Esto sirve para validar que con quién nos estamos conectando (servidor y cliente) sean realmente ellos y no otro sistema no autorizado. Esta acción se realiza a través de certificados.Los certificados residen en los extremos que se desea autenticar. En el caso de VTOL, la autenticación del servidor , por lo tanto es obligatorio que el servidor disponga de un certificado cargado y validado por es obligatoriauna entidad autorizadora (también puede ser un certificado auto-firmado). En cambio, la autenticación del cliente es opcional. Entonces, las propiedades agrupadas en VERDE permiten configurar la . comunicación en generalLas propiedades en CELESTE permiten configurar la . Esta configuración es obligatoria si la comunicación está activa. autenticación del servidorY las propiedades en NARANJA permiten activar y configurar la . Esta configuración es opcional, ya que solo será necesaria si la autenticación del cliente está activa (el cliente deberá estar autenticación del clientecorrectamente configurado)

: el funcionamiento y configuración de SSL/TLS es algo complejo, por lo que se recomienda que lo haga una persona con experiencia en el tema.Consejo

Logueo

El logueo se refiere a las trazas que genera la aplicación a modo de dejar registrado acciones del sistema. Particularmente se generan unas tramas especiales asociadas al estado del sistema a bajo nivel donde se loguea:

Estado de la memoriaCantidad de threadsPerformance

Estas tramas permiten tener una visión general del estado del sistema a lo largo del tiempo como para realizar algún diagnóstico particular, como por ejemplo, detectar picos donde el sistema estuvo bajo de memoria a escaso de recursos y poder tomar las medidas adecuadas. La configuración asociada a éste componente es la siguiente:

Propiedad

Adiciona contenido en log del sistema

Tamaño máximo del log del sistema

Tamaño máximo de índice del log del sistema

Por otro lado, el sistema a nivel consola web, VTOL permite que el usuario pueda descargar los diferentes archivos de logs que genera. Es posible configurar el máximo que se puede descargar para no saturar la memoria del sistema. La configuración asociada a éste componente es la siguiente:

Propiedad

Máximo que pueden sumar en MBytes los archivos de log a comprimir y descargar

Características de tiendas y terminales

Los locales o tiendas y nodos o cajas o terminales pueden ser configurados en largo y en tipo de datos.


Propiedad

Largo del código de caja

Largo del código de local

Código de caja es numérico

Código de local es numérico

Control de uso de nodo/caja

Existen controles que se aplican sobre los nodos o cajas de VTOL. Por ejemplo, se puede habilitar un "fusible" que monitorea la cantidad de rollback que se ejecutan sobre una determinada caja. Si esa cantidad supera un umbral en una cantidad de tiempo X, entonces el sistema lanza una alerta y bloquea el nodo. Este bloqueo requiere de un administrador para desbloquearlo.Esta funcionalidad sirve como para controlar el mal funcionamiento de algún punto de venta, entre otras cosas. La configuración asociada a éste componente es la siguiente:

Propiedad

Fusible Rollback: Control de rollback habilitado

Fusible Rollback: Maxima cantidad de rollback por nodo permitido

Fusible Rollback: Umbral de tiempo de conteo de rollbacks

Información sensible

Por cuestiones de seguridad el sistema no logea ni almacena información sensible de tarjetas. Sin embargo, en algunos momentos y bajo la necesidad de algún diagnóstico, es requerido contar con dicha información. Para ello el sistema permite habilitar el logeo de información sensible.

Esto se hace a través de la siguiente propiedad de configuración:

Propiedad

Habilitación del logueo de información sensible

Nota: la información sensible será logeada de forma encriptada y por un lapso de tiempo corto y no configurable.

Reportes

A continuación se listan las propiedades generales que tomarán todos los reportes del sistema:

Propiedad

Máxima cantidad de páginas sin cambiar a PDF automáticamente

Rango máximo en días para las fechas en Reporte de Cajas Inactivas

P2PE

VTOL cuenta con la posibilidad de manejar cifrado asimétrico para lograr una encriptación entre el pinpad y VTOL Server.VTOL es el encargado de generar y renovar las claves asimétricas. Esta administración es manejada según las siguientes propiedades:

Propiedad

Indica si se renuevan las claves entre POS - VTOL por cantidad de usos

Indica si se renuevan las claves entre POS - VTOL por cantidad de horas

Cantidad maxima de usos de las claves entre POS – VTOL

Cantidad maxima en horas que pueden utilizarse las claves entre POS - VTOL

Nota: esta funcionalidad se usa para cuando el Pinpad, u otro dispositivo, está preparado para cargar un certificado RSA y encriptar los datos de la transacción.

Auditoría Transaccional

La auditoría transaccional es uno de los puntos clave de VTOL para estar continuamente sincronizado con los puntos de venta. Por ello se disponen de algunas características para control el buen funcionamiento:

Propiedad

Timeout de respuesta de transacción

Numero de minutos hacia atrás para buscar transacciones pendientes

Numero de reintentos para un tercer mensaje antes de enviar una alerta

Por otro lado, se puede desactivar la funcionalidad de "tercer mensaje" (el tercer mensaje permite confirmar o cancelar una transacciones aprobada en VTOL a modo de sincronización. Por ejemplo, ante una transacción aprobada el POS imprime comprobante. Si la impresión es exitosa se confirma la transacción, si falla se cancela). Al desactivarlo, todas las transacciones aprobadas quedan en estado COMMIT automáticamente, sin la necesidad de que el POS haga una confirmación. Esta flexibilidad se puede realizar a nivel de local físico o virtual.

Propiedad

Fusible Auto-Commit locales fisicos: Commit automático habilitado

Fusible Auto-Commit locales virtuales: Commit automático habilitado

Importante: se recomienda habilitar éste comportamiento si solo si es requerido y entiendo sus consecuencias ya que de está desactivando la auditoría transaccional de VTOL.

Monitoreo

Para que el monitoreo y el sistema de alertas funcione adecuadamente es necesario configurar correctamente las siguientes propiedades:

Propiedad

MailManager Servidor SMTP

Umbral de inactividad de local

Número único de transacciones

VTOL asignará un " " en todas aquellas transacciones que sea aprobadas. Sobre ésta funcionalidad se pueden configurar las siguientes propiedades:número único de transacción

Propiedad

Numero de referencia de la Transacción Completo

Validación de código de Compañía en mensajería

VTOL cuenta con la posibilidad de validar que en la mensajería entre POS y VTOL y entre POS e EMV Kit se envíe obligatoriamente el campo 0 (companyId) en todos los tipos de mensajes. Para esto es necesario configurar la siguiente propiedad:

Propiedad

Valida código de compañia

vtol core - manual de usuario 3.8.0

Documents