Você está vendo a versão antiga da página. Ver a versão atual.

Comparar com o atual Ver Histórico da Página

« Anterior Versão 5 Próxima »




VTOL CRÉDITO / DÉBITO



Manual de Usuario





Cambios por revisiones

Fecha

Revisión

Cambios – Motivo

19/11/2009

1.0

Creación del documento

24/02/2011

1.1

Link al manual de usuario del VTOL Core

30/12/2011

1.2

Agregado de reportes de "Movimientos de tarjetas"

27/12/2012

1.3

Modificación imágenes de consola

20/05/2013

1.4

Agregado parámetros Prefijos y opciones de pago

11/11/2013

1.5

Agregado de Configuración de Autorizador, y actualización de pantalla de definición de lote.

23/04/2014

1.6

Agregado Activación de Terminales

23/04/2014

1.7

Agregado Reporte Estado de Terminales

23/06/2014

1.8

Revisión anual de documentación

21/08/2014

1.9

Actualización de Claves de encriptación para cumplimiento de Norma PA-DSS

12/02/2016

2.0

Agregado de Reportes de Canales y Configuración de Locales.

21/10/2016

2.1

Revisión anual de documentación y ajustes en el documento conforme a las normas PCI DSS 3.2 y PA DSS 3.2

04/08/2017

2.2

Agregado de campo Promocional en Opciones de Pago

29/11/2017

2.3

Agregado de apartado Validaciones Crédito Débito

01/02/2018

2.4

Agregado de detalle en el apartado Visualización del tráfico por canal

30/08/20182.5Agregado de configuración, reportes, planificación de proceso y propiedades de configuración relacionados a la funcionalidad PEI
10/01/20192.6Agregado de apartado Búsqueda de cupones por consola
11/02/20192.7Agregado de configuración, reportes, planificación de proceso y propiedades de configuración relacionados a la funcionalidad Billeteras Electrónicas (Mercado Pago y Todo Pago)
22/02/20192.8Agregado de configuración y propiedades de configuración relacionados a la funcionalidad Tokenización




Indice



 1. Acerca del manual


1.1 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 Crédito / Débito.
Brinda la información necesaria, con el nivel de detalle suficiente para que el usuario pueda monitorear el estado del sistema y los canales, 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 manual
Provee una visión global del manual, brindado información sobre el contenido del mismo.


Capítulo 2 – Introducción
Explica en qué consiste el producto VTOL Crédito / Débito y los componentes que abarca.


Capítulo 3 – Conceptos generales de VTOL
Contiene los términos básicos y conceptos utilizados en VTOL Crédito / Débito necesarios para comprender las explicaciones brindadas en el resto del manual.


Capítulo 4 – Acceso consola de administración
Brinda 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 5 – Administración
Provee información detallada de la funcionalidad de auditoría, configuración avanzada, eventos del sistema, alertas y planificación de procesos.


Capítulo 6 – Monitoreo
Explica las opciones disponibles para el monitoreo general del sistema y del módulo crédito-débito, como ser: tráfico de canales, estado de locales, etc.


Capítulo 7 – Interfaces
Brinda información sobre los pasos a seguir para generar / regenerar interfaces y listar aquellas que ya fueron generadas.


Capítulo 8 – Cierres
Provee información sobre la manera de confirmar transacciones pendientes y luego cerrar las mismas.


Capítulo 9 – Reportes
Presenta los reportes disponibles para el módulo VTOL CR/DB, explicando el propósito de cada uno de ellos, así como sus características específicas.


Capítulo 10 – Configuración
Explica la forma de configurar todos los elementos requeridos para el correcto funcionamiento de la aplicación VTOL CR/DB.


Capítulo 11 – Manejo de Errores
Menciona las formas de detectar los motivos de los errores ocurridos en la aplicación VTOL CR/DB.


Capítulo 12 – Configuración PEI
Explica la forma de configurar los elementos requeridos para el correcto funcionamiento de PEI (Pago electrónico inmediato).


Capítulo 13 – Búsqueda de cupones
Presenta las funcionalidades de buscar, descargar y visualizar cupones digitales.


Capítulo 14 – Configuración Billeteras Electrónicas
Explica la forma de configurar los elementos requeridos para el correcto funcionamiento de la operatoria de Billeteras Electrónicas (Mercado Pago y Todo Pago).


Capítulo 15 – Configuración Tokenización
Explica la forma de configurar los elementos requeridos para el correcto funcionamiento de la operatoria de Tokenización.


1.2 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.
  • Signo mayor ( > ): Se utiliza para especificar los niveles de menú (Ej.: Archivo > Abrir)
  • Estilo de fuente "negrita": indica los nombres de elementos interface (Ej.: botón Aceptar) y de cualquier otro ítem que requiera énfasis.
  • Estilo de fuente "cursiva": se utilizará para mencionar a los ejemplos.
  • Consejo práctico: se utilizará para resaltar tips o accesos rápidos para la operatoria o procedimiento que se encuentre realizando.
  • Número en color azul: indica una referencia a un área de la pantalla en la que se encuentra colocado ese número. (Ej: tabla que se encuentra en el área 1 de la pantalla)
  • Nota: se utilizará para resaltar aclaraciones sobre el tema en curso.
  • Importante: se utilizará para indicar al usuario sobre precauciones / cuestiones relevantes que deberá tener en cuenta el usuario.

1.3 Documentación de VTOL

La documentación principal relacionada al producto es la siguiente:

  • Manual de usuario de VTOL Core ("VTOL-CORE-Manual de usuario.pdf")
  • Guía de implementación de VTOL CR/DB ("VTOLCR-DB-Guía de implementación.pdf")


Consejo: Antes de comenzar la lectura de éste documento se aconseja primero leer el documento "VTOL-CORE-Manual de usuario.pdf". Dicho manual realiza una introducción y explicación de la funcionalidad básica que provee la aplicación.

 2. Introducción


2.1 Qué es VTOL Crédito / Débito?

VTOL es un 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.

2.2 Componentes

VTOL CR/ DB 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.
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, incluyendo el intercambio de mensajes necesario con el correspondiente centro autorizador.

 3. Conceptos generales de VTOL

3.1 Qué es VTOL Core?

El "VTOL Core" es el componente principal de cualquier implementación/instalación de VTOL.
El "VTOL Core" se encarga de cargar los módulos de VTOL configurados, como por ejemplo, el "Módulo Crédito Débito" que se explica en éste documento.

Consejo: "VTOL Core" al ser un componente base, provee funcionalidades en común que estarán presentes en cualquier VTOL por lo que se aconseja primero leer el documento "VTOL-CORE-Manual de usuario.pdf". Dicho manual realiza una introducción y explicación de la funcionalidad básica que provee la aplicación. Referirse a "1.3 Documentación de VTOL"

3.2 Qué es una interfaz?

Una interfaz es un archivo de cierre que almacena las transacciones autorizadas, el cual servirá para la conciliación con aquellos centros autorizadores que requieran dicho archivo.

3.3 Qué es un centro autorizador?

Un centro autorizador es la entidad responsable de la autorización de la transacción. VTOL intercambia mensajes con los centros autorizadores de manera de poder determinar si una cierta transacción puede autorizarse o no.

3.4 Qué es un autorizador?

En algunos casos, un centro autorizador reenviará la transacción a una tercera entidad que será la que finalmente realice la autorización de la misma. Esta entidad que autoriza la transacción es el Autorizador.

3.5 Qué es una tarjeta?

Es la entidad que provee el servicio de financiación a la tarjeta habiente. Ejemplos son: Visa, Mastercard.

3.6 Qué es un tipo de tarjeta?

Es la clasificación que se le asigna a una tarjeta de acuerdo a lo definido por el emisor de la misma. Esta puede ser de crédito o de débito por ejemplo.

3.7 Qué es una opción de pago?

Es una combinación de moneda / plan / cantidad de cuotas / condición de pago para una determinada tarjeta. Una tarjeta puede poseer varias opciones de pago según la combinación ya mencionada. Por ejemplo, se podría crear una opción de pago con la siguiente combinación: Tarjeta: Visa, Código de Plan: 0, Moneda: Pesos, Cantidad de cuotas: 1.
VTOL realiza la validación de las transacciones según las opciones de pago, es por esto que deben estar configuradas todas las opciones habilitadas de cada centro autorizador.

3.8 Qué es una definición de lote?

Una definición de lote es un agrupamiento de uno o más opciones de pago para una determinada tarjeta.

3.9 Qué es una terminal?

Una terminal es una identificación lógica de una caja física, según una definición de lote, desde el punto de vista de un determinado centro autorizador. Por ende una caja física puede poseer uno o más números de terminales, según las definiciones de lote que existan. Cada Terminal se corresponde con una única definición de lote y posee un identificador propio (número de serie de terminal)

3.10 Qué es un canal?

Un canal es una vía lógica por la cual VTOL se comunica con el centro autorizador y envía a este las transacciones pertenecientes a ciertas tarjetas.

3.11 Qué es un boletín protectivo?

Un boletín protectivo es un archivo que contiene números de tarjetas. Es brindado por los proveedores de tarjetas. Los dos propósitos más importantes a los que sirve un boletín protectivo son:

  • Autorización off-line: existen boletines que contienen los prefijos de tarjetas que están / no están autorizadas a efectuar transacciones y VTOL CR / DB las empleas cuando se encuentra autorizando en modo off-line, es decir, sin conexión con el centro autorizador.
  • Diferenciación de tarjetas de crédito de las de débito: existen algunos proveedores de tarjetas que usan los mismos prefijos para las tarjetas de crédito y débito, por lo cual existen bines que contienen los números de tarjetas que corresponden a débito para permitir diferenciarlas de las de crédito.

3.12 Qué es un prefijo o BIN?

Un prefijo o BIN (Bank Identification Number) es una identificación conformada por los primeros N dígitos del número de una tarjeta financiera. Estos dígitos identifican a qué red pertenece la tarjeta así como también la entidad que la brinda.

4. Acceso consola de administración


Consejo: Para acceder a la consola de administración se aconseja primero leer el documento "VTOL-CORE-Manual de usuario.pdf". Dicho manual realiza una introducción y explicación de la funcionalidad básica que provee la aplicación. Además explica cómo se accede a la consola de administración.

5. Administración

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

Se desplegarán varias opciones de menú a las que se podrá acceder haciendo click sobre la elegida:
Herramientas administrativas > Claves de Encriptación
A continuación se explicará la funcionalidad y uso de cada una de las opciones mencionadas anteriormente.
Importante: Dentro del menú "Herramientas administrativas" se visualizan más opciones que las mencionadas en este apartado. Esto se debe a que son funciones base del producto VTOL. Para mayor información referirse al manual de usuario del producto o a la sección 1.3 Documentación de VTOL

5.1 Claves de Encriptación

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


Descripción de la página:
Esta página permite acceder a la funcionalidad de encriptación de contraseñas, las cuales son utilizadas para mantener en forma segura información sensible (números de tarjeta, etc.).

5.1.1 Generar Clave de Encriptación

Desde la consola de administración se podrá generar la clave que se utilizará para encriptar la información en la base de datos siguiendo lo recomendado por PA-DSS.
Esta clave se genera automáticamente presionando el botón "Crear" del menú "Claves de encriptación"
Esta ejecución debe estar a cargo de un custodio según lo recomendado por PA-DSS, el cual será el encargado de generar esta clave.
La clave generada será actualizada por el sistema en un horario nocturno (o el que se quiera definir) al ejecutarse el proceso de actualización de las claves.


Consejo: Se recomienda la correcta asignación de los permisos para que ciertos usuarios puedan generar claves de encriptación.
Para más información en detalle referirse al documento "VTOLCR-DB-Guía de implementación.pdf" apartado "12.2 Administración de claves para el almacenamiento de datos sensibles".


5.2 Planificación

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


Descripción de la página:
Esta página permite acceder a la funcionalidad de planificación de ejecución procesos.

5.2.1 Proceso de Cierre PEI

Desde la consola de administración se podrá configurar la periodicidad en la que se efectuará el proceso de cierre PEI (Pago electrónico Inmediato).

El proceso planificado es "/VtolServer/PEICloseProcess". Por defecto, los cierres se efectúan todos los días a las 2 AM.




Nota: Si bien Link que es la entidad autorizadora de PEI no posee un proceso de cierre diario, VTOL genera este cierre para migrar las transacciones de la tabla FinancialTransaction a la tabla ClosedFinancialTransaction.


 6. Monitoreo


Para acceder a la funcionalidad de monitoreo específica del módulo CR / DB, presionar la opción denominada "Monitoreo" dentro del menú "Módulo CR / DB" (VTOL > Módulo CR / DB > Monitoreo).
Se desplegarán cuatro opciones de menú a las que se podrá acceder haciendo click sobre la elegida:
Monitoreo > Estado del Módulo
Monitoreo > Tráfico de Canales
Monitoreo > Estado de Locales

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

6.1 Estado del módulo

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Estado del Módulo" dentro de "Monitoreo" (VTOL > Módulo CR / DB > Monitoreo > Estado del Módulo)
Descripción de la página:
Esta página permite visualizar rápidamente el estado del módulo CR / DB en lo que respecta al tráfico de transacciones y condición en la que se encuentran los canales.

6.1.1 Filtrado de información

La información de cantidad de transacciones y canales presentadas en esta pantalla de monitoreo puede ser filtrada por empresa. Para ello se debe seleccionar la empresa deseada en el combo "Compañía" y la pantalla será automáticamente refrescada con la información correspondiente a la empresa elegida. Al filtrarse por empresa sólo se visualizarán las transacciones correspondientes a dicha empresa y los canales que se encuentran habilitados para ella.

6.1.2 Visualización de cantidad de transacciones

Se brinda la siguiente información:

  • Comunicación POS – VTOL CR / DB:
    • Cantidad de transacciones recibidas por el módulo VTOL CR / DB.
    • Cantidad de transacciones respondidas por el módulo VTOL CR / DB.


  • Estado de cada canal y tiempo de permanencia en el estado actual:
    • Verde: indica que VTOL CR / DB tiene conexión con centro autorizador. El canal se encuentra conectado y listo para transaccionar.
    • Amarillo: indica que la conexión con el canal se está estableciendo. El canal se encuentra esperando conexión o conectado pero no habilitado para transaccionar. Este estado tiene lugar sólo en aquellos canales que manejan mensaje de eco. En estos canales, cuando se levantan los mismos, VTOL CR / DB necesita establecer una conexión lógica que implica enviar un mensaje de eco al centro autorizador. Hasta que el centro autorizador no conteste este mensaje indicando su aceptación, el canal permanece en el estado marcado con el color amarillo. Cuando el centro autorizador contesta afirmativamente el eco (esto quiere decir que acepta la conexión porque también podría rechazarla) entonces el canal pasa a color verde. Si el eco es rechazado, el estado del canal es indicado por el color rojo.
    • Rojo: indica que VTOL CR / DB no posee comunicación con el centro autorizador. El canal está desconectado, no se puede transaccionar.


6.1.3 Reseteo de contadores de transacciones

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

6.2 Tráfico de canales

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Tráfico de Canales" dentro de "Monitoreo" (VTOL > Módulo CR / DB > Monitoreo > Tráfico de Canales)
Descripción de la página:
Esta página brinda información del estado en que se encuentra cada uno de los canales y del tráfico de transacciones que tiene lugar a través de ellos.

6.2.1 Visualización del tráfico por canal

Para cada canal es posible visualizar la siguiente información:

  • Canal: indica el nombre del canal.
  • Estado:
    • Verde: indica que VTOL CR / DB tiene conexión con centro autorizador. El canal se encuentra conectado y listo para transaccionar
    • Amarillo: indica que la conexión con el canal se está estableciendo. El canal se encuentra esperando conexión o conectado pero no habilitado para transaccionar. Este estado tiene lugar sólo en aquellos canales que manejan mensaje de eco. En estos canales, cuando se levantan los mismos, VTOL CR / DB necesita establecer una conexión lógica que implica enviar un mensaje de eco al centro autorizador. Hasta que el centro autorizador no conteste este mensaje indicando su aceptación, el canal permanece en el estado marcado con el color amarillo. Cuando el centro autorizador contesta afirmativamente el eco (esto quiere decir que acepta la conexión porque también podría rechazarla) entonces el canal pasa a color verde. Si el eco es rechazado, el estado del canal es indicado por el color rojo.
    • Rojo: indica que VTOL CR / DB no posee comunicación con el centro autorizador. El canal está desconectado, no se puede transaccionar.
  • Fecha de última caída: fecha y hora en la que se registró la última caída del canal.
  • Trx financieras enviadas: cantidad de transacciones financieras enviadas al centro autorizador por VTOL CR / DB.
  • Trx financieras respondidas: cantidad de transacciones financieras para las cuales el centro autorizador envió una respuesta a VTOL CR / DB.
  • Trx de red Ejemplos de transacciones de red son los mensajes de eco, login. enviadas: cantidad de transacciones de red enviadas al centro autorizador por VTOL CR / DB.
  • Trx de red respondidas: cantidad de transacciones de red para las cuales el centro autorizador envió una respuesta a VTOL CR / DB.
  • Offline pendientes: cantidad de transacciones off-line que se encuentran sin respuesta por parte del centro autorizador. Es la diferencia entre las transacciones enviadas al centro autorizador y las respondidas por éste.
  • Online pendientes: cantidad de transacciones on-line que se encuentran sin respuesta por parte del centro autorizador.



Al hacer clic en el link de cada canal, se muestra una pantalla en donde se visualiza la siguiente información:

  • Resumen de transacciones procesadas (misma información que se encuentra en la página de "Tráfico de Canales")
  • Detalle de cada nodo:
    • Estado (verde, amarillo y rojo)
    • Fecha última caída: indica la fecha en la que el canal pasó al estado desconectado (estado en color rojo).
    • Tiempo de permanencia en estado: indica el tiempo transcurrido en que el canal pasó al estado activo.


6.3 Estado de locales

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Estado de Locales" dentro de "Monitoreo" (VTOL > Módulo CR / DB > Monitoreo > Estado de Locales)
Descripción de la página:
Esta página provee información del estado en el cual se encuentra cada uno de los locales del retailer. Presente un esquema drill-down por el cual se puede observar el estado de las empresas y luego descender a un nivel mayor de detalle para conocer el estado de cada uno de los locales que componen cada empresa.

6.3.1 Indicadores de actividad por región y local

Al acceder a la página puede observarse el estado en el cual se encuentra cada empresa del retailer. El estado de la empresa se calcula en base al peor caso, es decir que se muestra siempre el estado más grave de los locales de esa empresa. Por ejemplo: si el estado de un local dentro de la empresa es rojo (inactivo), entonces el estado de la empresa será rojo por más que los otros locales de la empresa se encuentren en verde (activos).




Para acceder al estado de los locales de una empresa se debe presionar el link que contiene el nombre de la empresa deseada. 
Al hacer esto se despliega una tabla mostrando la siguiente información por cada local perteneciente a la compañía seleccionada:

  • Estado:
    • Rojo: indica que el local se encuentra inactivo, es decir, se ha superado el tiempo máximo tolerable sin que VTOL CR / DB reciba transacciones de ese local. Esto puede ser indicio de alguna falla en la comunicación con el local.
    • Verde: indica que el local se encuentra activo.
  • Tiempo de inactividad: cantidad de tiempo transcurrido sin que VTOL CR / DB reciba transacciones del local.

Los locales se ordenan automáticamente por tiempo de inactividad, de mayor a menor. Si se desea detener este ordenamiento automático, presionar el botón "Detener ordenamiento".

 7. Interfaces


Para acceder a las opciones de administración de interfaces, presionar la opción del menú "Interfaces" dentro del menú "Módulo CR / DB" (VTOL > Módulo CR / DB > Interfaces)

7.1 Generación de interfaces

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Generación de Interfaz" dentro de "Interfaces" (VTOL > Módulo CR / DB > Interfaces > Generación de Interfaz).


Descripción de la página:
A través de esta página es posible acceder a la generación de las interfaces implementadas en el sistema.



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

  • Tipo de interfaz que deseamos generar (Ej: AMEX)
  • 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".
Si la interfaz se genera exitosamente se creará un archivo de texto con los datos de las transacciones que se deberán enviar al centro autorizador correspondiente.

7.2 Listado de interfaces generadas

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Listado de Interfaces Generadas" dentro de "Interfaces" (VTOL > Módulo CR / DB > Interfaces > Listado de Interfaces Generadas)


Descripción de la página:
A través de esta página es posible acceder a las interfaces que fueron generadas en el sistema.

7.2.1 Visualización de las interfaces generadas

Seleccionando el tipo de interfaz y la fecha en que la misma fue generada y luego presionando "Buscar" se puede acceder a un listado de las interfaces que se generaron en el sistema y que cumplen con los criterios de búsqueda ingresados.
Para cada interfaz se muestran los siguientes datos:

  • Ruta del archivo de interfaz generado.
  • Tipo de interfaz.
  • Definición de la interfaz.
  • Fecha y hora en la que se generó la interfaz.


7.2.2 Regeneración de la interfaz

Para regenerar alguno de los archivos de interfaz, efectuar click con el mouse sobre el nombre de la interfaz que se quiera regenerar.

7.3 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 "Interface" con la siguiente estructura:

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 "#MODULE_PATH#/" que será reemplaza dinámicamente por el PATH del módulo, luego hay que indicar el PATH dentro del módulo.
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 "InterfaceDefinition" y tiene la siguiente estructura:

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.
NOTA: 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 recarga. Esta funcionalidad tiene el objetivo de poder realizar la configuración manual de forma más dinámica.

 8. Cierres


Para acceder a las opciones de cierre de transacciones, presionar la opción "Cierre" dentro del menú "Módulo CR / DB" (VTOL > Módulo CR / DB > Cierres)

8.1 Transacciones pendientes

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Transacciones Pendientes" dentro de "Cierres" (VTOL > Módulo CR / DB > Cierres > Transacciones Pendientes)


Descripción de la página:
A través de esta página es posible confirmar o reversar las transacciones que se encuentran pendientes de confirmación.

8.1.1 Búsqueda de transacciones pendientes

Se cuenta con la posibilidad de efectuar una búsqueda de las transacciones que se encuentran en estado pendiente, según los siguientes criterios: compañía, local, definición de lote y código de caja. Para la búsqueda por local se dispone de dos opciones: buscar por código o por nombre de local. Para elegir uno u otro criterio de búsqueda se debe seleccionar el radio button correspondiente a la opción deseada.
Una vez completados los criterios de búsqueda, presionar el botón "Buscar" para que la búsqueda se lleve a cabo y los resultados sean presentados.

8.1.2 Visualización de información de las transacciones pendientes


Por cada transacción pendiente de confirmación se brinda la siguiente información:

  • Nombre y código del local al que corresponde.
  • Código de la caja en la cual se generó.
  • Tipo de transacción.
  • Definición de lote a la que corresponde.
  • Fecha en la que tuvo lugar la transacción.
  • Número de tarjeta.
  • Importe.
  • Información detallada (a la cual se puede acceder haciendo click sobre el link "Ver") Esta información consiste en datos del mensaje de requerimiento y de la respuesta.


8.1.3 Confirmación de transacciones pendientes

Para confirmar una transacción pendiente primero se debe seleccionar la misma haciendo click sobre el checkbox ubicado en la columna "Acción". Al hacer esto aparecerá un tilde en dicho checkbox indicando que se encuentra seleccionado y se habilitarán los botones "Confirmar" y "Reversar". Presionar el botón correspondiente dependiendo de la acción que se desee efectuar sobre la transacción elegida. Al presionar "Confirmar" se solicitará, mediante una ventana, que ratifique la confirmación del cierre.

Consejo práctico: Si se desea confirmar / reversar todas las transacciones presentes en la página, en lugar de elegirlas una a una, es posible hacer click sobre el checkbox que se encuentra en el encabezado de la columna "Acción". De esta manera con un único clic del mouse quedarán todas las transacciones seleccionadas.

8.2 Cierre por definición de lote

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Cierre por Definición de Lote" dentro de "Cierres" (VTOL > Módulo CR / DB > Cierres > Cierre por Definición de Lote)


Descripción de la página:
A través de esta página es posible realizar el cierre manual de las transacciones. Dicho cierre se efectúa por definición de lote.

8.2.1 Búsqueda de transacciones a cerrar

Se cuenta con la posibilidad de efectuar una búsqueda de las transacciones que aún no han sido cerradas, según los siguientes criterios: compañía, local, definición de lote y canal. Para la búsqueda por local se dispone de dos opciones: buscar por código o por nombre de local. Para elegir uno u otro criterio de búsqueda se debe seleccionar el radio button vinculado con la opción deseada y el sistema habilitará el combo de selección correspondiente ("nombre de local" ó "código de local")
Una vez completados los criterios de búsqueda, presionar el botón "Buscar" para que la búsqueda se lleve a cabo y los resultados sean presentados.

8.2.2 Cierre de transacciones por definición de lote

Para efectuar el cierre se debe seleccionar la definición de lote a cerrar, haciendo click en el checkbox correspondiente a la misma, ubicado en la columna "Acción". Al hacer esto aparecerá una tilde en el checkbox indicando que el mismo se encuentra seleccionado. Luego, para que el cierre tenga lugar, presionar el botón "Cerrar".
Si se desea visualizar las cajas vinculadas con una cierta definición de lote, se puede hacer esto accediendo al link "Ver más" de la columna "Cajas con la definición de lote". Al hacer esto se podrá ver la cantidad de transacciones pendientes de confirmación para cada caja correspondiente a la definición de lote seleccionada. Presionando "Volver" se podrá regresar a la pantalla de cierre de transacciones por definición de lote.
Al presionar "Cerrar", se solicitara, mediante una ventana, que ratifique la confirmación del cierre.


En caso de existir transacciones pendientes para la caja, aparecerá un link sobre la cantidad de transacciones pendientes, en la columna "Trx pendientes". Haciendo click sobre el mismo se podrá acceder a la página de confirmación de transacciones pendientes, para confirmarlas / reversarlas.
Importante: recordar que para que el cierre pueda llevarse a cabo exitosamente no deben existir transacciones pendientes de confirmación correspondientes a la definición de lote que se desea cerrar.

8.3 Cierre por caja

Acceso:
Para acceder a esta pantalla se debe seleccionar la opción del menú denominada "Cierre por Caja" dentro de "Cierres" (VTOL > Módulo CR / DB > Cierres > Cierre por Caja)


Descripción de la página:
A través de esta página es posible realizar el cierre manual de las transacciones. El mismo se efectúa por caja, cerrándose todas las terminales lógicas correspondientes a la caja seleccionada.

8.3.1 Búsqueda de transacciones a cerrar

Se cuenta con la posibilidad de efectuar una búsqueda de las transacciones que aún no han sido cerradas, según los siguientes criterios: compañía, local, caja y canal. Para la búsqueda por local se dispone de dos opciones: buscar por código o por nombre de local. Para elegir uno u otro criterio de búsqueda se debe seleccionar el radio button vinculado con la opción deseada y el sistema habilitará el combo de selección correspondiente ("nombre de local" ó "código de local") Para la búsqueda por caja se dispone de la opción de ingresar una cierta caja, un rango o seleccionar la opción "todas las cajas".
Una vez completados los criterios de búsqueda, presionar el botón "Buscar" para que la búsqueda se lleve a cabo y los resultados sean presentados.


8.3.2 Cierre de transacciones por caja

Para efectuar el cierre se debe seleccionar la caja a cerrar, haciendo click en el checkbox correspondiente a la misma, ubicado en la columna "Acción". Al hacer esto aparecerá una tilde en el checkbox indicando que el mismo se encuentra seleccionado. Luego, para que el cierre tenga lugar, presionar el botón "Cerrar". 
Si se desea acceder a las transacciones pendientes de una caja puede hacerse esto mediante el link presente en la columna "Trx pendientes" (este link se encuentra presente sólo cuando la cantidad de transacciones pendientes es mayor a cero). Al hacer esto se podrán ver las transacciones pendientes de la caja, con la posibilidad de confirmarlas / reversarlas.

Importante: recordar que para que el cierre pueda llevarse a cabo exitosamente no deben existir transacciones pendientes de confirmación correspondientes a la caja que se desea cerrar.
Al seleccionar "Cerrar" se solicitara, mediante una ventana, la confirmación del cierre.

 9. Reportes


Para acceder a la funcionalidad de los reportes de VTOL CR / DB, se debe presionar la opción "Reportes" dentro del menú Módulo CR/DB (VTOL > Módulo CR / DB > Reportes). De esta manera se mostrarán los tipos de reportes que se pueden obtener, mismos que se detallan a continuación.

9.1 Reportes Generales Crédito Débito

Acceso:
Para acceder a la funcionalidad de reportes de VTOL CR / DB, presionar la opción "Reportes CD Generales" dentro del menú "Reportes" (VTOL > Módulo CR / DB > Reportes > Reportes CD Generales)


Descripción de la página:
A través de esta página es posible generar los distintos reportes que brinda el producto VTOL CR / DB. Cada uno de los reportes cuenta con un conjunto de criterios de filtrado de la información presentada en el mismo, como se describirá a continuación en mayor detalle.
Funcionalidad:
Los reportes provistos por la aplicación, así como también los criterios para filtrado y ordenamiento presentes en cada uno de ellos se describen a continuación. Cada reporte podrá ser obtenido en uno de los siguientes formatos: HTML, PDF o Excel.

9.1.1 Reportes compactos de transacciones

  • Descripción: este tipo de reportes brindan información de la cantidad de transacciones e importe que tuvieron lugar en cada local, sumarizado por tipo de transacción y por otro criterio adicional como ser: canal, moneda, plan y cuotas, etc.
  • Criterios de filtrado:
    • Compañía.
    • Local.
    • Tipo de transacción.
    • Estado: Closed (cerrada) / NotClosed (no cerrada)
    • Moneda.
    • Número de comercio (filtrado por similitud)
    • Modo de autorización: online / offline.
    • Código de respuesta.
    • Se proporciona la opción para seleccionar únicamente las transacciones aprobadas. Al seleccionar esta opción el contenido del combo se pasa por alto (se desactiva) y se obtienen únicamente las transacciones que coincidan con códigos de respuesta de aprobación para cada canal.
    • Tarjeta.
    • Número de serie de terminal (filtrado por similitud)
    • Fecha de la transacción (rango)
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Tipo de transacción.
    • Cantidad de transacciones.
    • Importe de transacciones.


9.1.2 Reportes detallados de transacciones

  • Descripción: brinda información a nivel de detalle de cada una de las transacciones que tuvieron lugar en cada local del retailer, mostrando las mismas agrupadas por distintos criterios, como ser: canal, tarjeta, moneda, plan y cuotas, etc.
  • Criterios de filtrado:
    • Compañía.
    • Local.
    • Tipo de transacción.
    • Estado: Closed (cerrada) / NotClosed (no cerrada)
    • Moneda.
    • Número de comercio (filtrado por similitud)
    • Modo de autorización: online / offline.
    • Código de respuesta.
      • Se proporciona la opción para seleccionar únicamente las transacciones aprobadas. Al seleccionar esta opción el contenido del combo se pasa por alto (se desactiva) y se obtienen únicamente las transacciones que coincidan con códigos de respuesta de aprobación para cada canal.
    • Tarjeta.
    • Número de tarjeta (filtrado por similitud)
    • Número de serie de terminal (filtrado por similitud)
    • Fecha de la transacción (rango)
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Fecha de la transacción.
    • Tipo de transacción.
    • Tarjeta.
    • Número de tarjeta.
    • Código de plan de pago.
    • Cuotas.
    • Código de respuesta.
    • Importe de la transacción.
    • Modo de ingreso (MSR, manual, etc.)


9.1.3 Reporte compacto de control de transacciones

  • Descripción: brinda información de la cantidad total de transacciones que tuvieron lugar en cada uno de los locales del retailer. Este reporte se encuentra orientado a aquellos retailers que disponen de un contrato de facturación por cantidad de transacciones con Synthesis. Cuenta con un dígito verificador del reporte que sirve para la validación de su autenticidad.
  • Criterios de filtrado:
    • Compañía.
    • Local.
    • Fecha de la transacción (rango)
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Nombre de local
    • Código de local.
    • Cantidad de transacciones del local.


9.1.4 Reporte detallado de control de transacciones

  • Descripción: brinda información de la cantidad total de transacciones, divididas por tipo, que tuvieron lugar en cada uno de los locales del retailer. Amplía la información brindada por el reporte compacto de control de transacciones. Este reporte se encuentra orientado a aquellos retailers que disponen de un contrato de facturación por cantidad de transacciones con Synthesis. Cuenta con un dígito verificador del reporte que sirve para la validación de su autenticidad.
  • Criterios de filtrado:
    • Compañía.
    • Local.
    • Fecha de la transacción (rango)
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Tipo de transacción.
    • Cantidad de transacciones de cada tipo.


9.2 Reporte de Movimientos de Tarjeta


Acceso:
Para acceder a la funcionalidad de reportes de VTOL CR / DB, presionar la opción "Reporte Movimientos Tarjeta" dentro del menú "Reportes" (VTOL > Módulo CR / DB > Reportes > Reporte Movimientos Tarjeta)


Descripción de la página:
A través de esta página es posible generar un reporte de los detalles de movimientos de una tarjeta en específico. Esta búsqueda se realiza utilizando algunos de los filtros utilizados para el reporte de Crédito Débito. A continuación se describe con detalle los filtros utilizados para la búsqueda.
Funcionalidad:
Este reporte brinda la posibilidad de obtener todas las transacciones que se han realizado con un número de tarjeta específico. El filtro de número de tarjeta brinda la flexibilidad de poder buscar únicamente una porción del número. En conjunción con el filtro de Método de búsqueda, se puede establecer si el número ingresado en el campo de número de tarjeta, es la parte inicial o la final de la tarjeta. En caso de contar con el número completo de la tarjeta, el filtro de método de búsqueda se pasa por alto y por lo tanto la opción seleccionada no afectará en la búsqueda.
Cada reporte podrá ser obtenido en uno de los siguientes formatos: HTML, Excel.

  • Criterios de filtrado:
    • Fecha de la transacción (rango)
    • Compañía.
    • Local.
    • Estado: Closed (cerrada) / NotClosed (no cerrada)
    • Código de respuesta.
    • Número de tarjeta
    • Método de Búsqueda


  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Fecha de la transacción.
    • Tipo de transacción.
    • Tarjeta.
    • Número de tarjeta.
    • Código de plan de pago.
    • Cuotas.
    • Código de respuesta.
    • Importe de la transacción.
    • Modo de ingreso (MSR, manual, etc)



En la siguiente figura se puede apreciar la composición de la interfaz con los criterios antes mencionados.

9.3 Reporte Estado de Terminales


Acceso:
Para acceder a la funcionalidad de reportes de VTOL CR / DB, presionar la opción "Reporte de Estado de Terminales" dentro del menú "Reportes" (VTOL > Módulo CR / DB > Reportes > Reporte de Estado de Terminales)


  • Criterios de filtrado:
    • Compañía.
    • Nombre / Código de Local.
    • Estado de la Terminal
    • Definición de Lote
    • Duración en Estado


Funcionalidad:
Este reporte brinda la posibilidad de obtener un listado de las Terminales con sus respectivos estados. Los filtros disponibles permiten realizar el reporte por Nombre o Código particular de un Local, por una determinada definición de lote, un estado y/o el tiempo de permanencia de la terminal en ese estado.
El reporte podrá ser obtenido en uno de los siguientes formatos: HTML, PDF, RTF y Excel.

9.4 Reporte de Canales



Acceso:
Para acceder a la funcionalidad de reportes de VTOL CR / DB, presionar la opción "Reporte de Canales" dentro del menú "Reportes" (VTOL > Módulo CR / DB > Reportes > Reporte de Canales)


  • Criterios de filtrado:
    • Reporte (Este filtro permite seleccionar los dos reportes disponibles con información sobre los canales, que son Reporte de Canales Desconectados y Reporte de estado de canales).
    • Formato del reporte
    • Nodo.
    • Canal.
    • Fecha Desde/Hasta
    • Duración


Funcionalidad:
Reporte de Canales Desconectados: El objetivo de este reporte es conocer, para un determinado lapso de fechas, los momentos en que un canal estuvo desconectado.
Reporte de Estado de Canales: El Objetivo es ofrecerle al usuario el detalle de los cambios de estado en los canales gracias a reportes en la consola de administración de VTOL CR DB.
Ambos reportes podrán ser obtenido en uno de los siguientes formatos: HTML, PDF, RTF y Excel.


9.5 Reportes PEI

Acceso:
Para acceder a la funcionalidad de reportes PEI de VTOL, presionar la opción "Reportes PEI" dentro del menú "Reportes" (VTOL > Módulo Crédito-Débito > Reportes > Reportes PEI).



Descripción de la página:
A través de esta página es posible generar los distintos reportes que brinda el producto PEI. Cada uno de los reportes cuenta con un conjunto de criterios de filtrado de la información presentada en el mismo, como se describirá a continuación en mayor detalle.



Funcionalidad:
Los reportes provistos por la aplicación, así como también los criterios para filtrado y ordenamiento presentes en cada uno de ellos se describen a continuación. Cada reporte podrá ser obtenido en uno de los siguientes formatos: HTML, PDF, XLS, RTF o CSV.

9.5.1 Reporte compacto de transacciones PEI

  • Descripción: este tipo de reporte brinda información de la cantidad de transacciones e importes totales que tuvieron lugar en cada local, sumarizado por tipo de transacción.
  • Criterios de filtrado:
    • Compañía
    • Local
    • Fecha desde y hasta de la transacción (rango)
    • Tipo de transacción PEI
    • Estado: NotReversed (no reversadas) / Reversed (reversadas) / Todas
    • Estado de transacción: Closed (cerrada) / NotClosed (no cerrada)
    • Tipo de respuesta
    • Moneda
    • Terminal PEI
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Tipo de transacción
    • Importe de transacciones
    • Cantidad de transacciones

9.5.2 Reporte detallado de transacciones PEI

  • Descripción: este tipo de reporte brinda información detallada de las transacciones que tuvieron lugar en cada local, sumarizado por tipo de transacción.
  • Criterios de filtrado:
    • Compañía
    • Local
    • Fecha desde y hasta de la transacción (rango)
    • Tipo de transacción PEI
    • Estado: NotReversed (no reversadas) / Reversed (reversadas) / Todas
    • Estado de transacción: Closed (cerrada) / NotClosed (no cerrada)
    • Tipo de respuesta
    • Moneda
    • Terminal PEI
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Tipo de transacción
    • Importe de transacciones
    • Cantidad de transacciones


9.6 Reportes Billeteras Electrónicas

Acceso:
Para acceder a la funcionalidad de reportes Billeteras Electrónicas de VTOL, presionar la opción "Reportes Billeteras Electrónicas" dentro del menú "Reportes" (VTOL > Módulo Crédito-Débito > Reportes > Reportes Billeteras Electrónicas).


Descripción de la página:
A través de esta página es posible generar los distintos reportes que brinda el producto Billeteras Electrónicas. Cada uno de los reportes cuenta con un conjunto de criterios de filtrado de la información presentada en el mismo, como se describirá a continuación en mayor detalle.


Funcionalidad:
Los reportes provistos por la aplicación, así como también los criterios para filtrado y ordenamiento presentes en cada uno de ellos se describen a continuación. Cada reporte podrá ser obtenido en uno de los siguientes formatos: HTML, PDF, XLS, RTF o CSV.

9.6.1 Reporte compacto de transacciones Billeteras Electrónicas

  • Descripción: este tipo de reporte brinda información de la cantidad de transacciones e importes totales que tuvieron lugar en cada local, sumarizado por tipo de transacción.
  • Criterios de filtrado:
    • Compañía
    • Local
    • Fecha desde y hasta de la transacción (rango)
    • Tipo de transacción Billeteras Electrónicas
    • Estado: NotReversed (no reversadas) / Reversed (reversadas) / Todas
    • Tipo de Billetera: Todos / Mercado Pago / Todo Pago
    • Estado de transacción: Closed (cerrada) / NotClosed (no cerrada)
    • Tipo de respuesta
    • Moneda
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Tipo de transacción
    • Monto
    • Cantidad de transacciones

9.6.2 Reporte detallado de transacciones Billeteras Electrónicas

  • Descripción: este tipo de reporte brinda información detallada de las transacciones que tuvieron lugar en cada local, sumarizado por tipo de transacción.
  • Criterios de filtrado:
    • Compañía
    • Local
    • Fecha desde y hasta de la transacción (rango)
    • Tipo de transacción Billeteras Electrónicas
    • Estado: NotReversed (no reversadas) / Reversed (reversadas) / Todas
    • Tipo de Billetera: Todos / Mercado Pago / Todo Pago
    • Estado de transacción: Closed (cerrada) / NotClosed (no cerrada)
    • Tipo de respuesta
    • Moneda
  • Ordenamiento: se puede obtener este tipo de reporte ordenado de manera ascendente (asc) o descendente (desc) por:
    • Fecha de transacción
    • Código de respuesta
    • Monto


 10. Configuración


Existen dos niveles de configuración:

  • A nivel del producto VTOL: en este nivel se cargan las empresas, locales y nodos que manejará el sistema.
  • A nivel de un módulo específico (en este caso crédito –débito). En este nivel se configuran todos aquellos elementos que corresponden al módulo.

Para acceder a la funcionalidad de configuración específica del módulo CR / DB, presionar la opción denominada "Configuración" dentro del menú "Módulo CR / DB" (VTOL > Módulo CR / DB > Configuración)
A 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.
Importante: Antes de continuar con la configuración del módulo CR / DB es importante realizar la configuración base del sistema o producto.

10.1 Configuración por local

Acceso:
Para acceder a la configuración de los locales, seleccionar la opción "Configuración por local" dentro del menú de VTOL (VTOL > Módulo Crédito-Débito > Configuración por local)


Descripción de la página:
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 CR / DB para funcionar. Tener en cuenta que antes de acceder a esta configuración se deberán cargar las definiciones de lote y las opciones de pago que manejará el sistema.
Importante: Antes de poder realizar la configuración asociada al local se es requerido haber configurado los locales. La configuración de los locales es una función base del producto por lo que se aconseja leer primero el manual de usuario del producto o a dirigirse la sección 1.3 Documentación de VTOL

10.1.1 Números de comercio de cierre


Por cada local, canal y definición de lote se deberá ingresar el número de comercio de cierre correspondiente. Presionar "Aceptar" para que los números cargados se almacenen en el sistema. Si no se desea que esto ocurra, presionar "Cancelar". Por medio del botón "Volver" se puede regresar a la pantalla inicial de administración de locales.

10.1.2 Números de comercio y definición de lote


Por cada opción de pago se debe indicar la definición de lote y el número de comercio que VTOL empleará para la misma. Se cuenta con un conjunto de campos (tarjeta, plan, cantidad de cuotas, moneda y condición de pago) que permiten buscar las definiciones de lote y los números de comercio cargados en el sistema para el local.


Además, se dispone de una opción rápida de carga cuando se quiera ingresar la misma definición de lote y número de comercio para varias opciones de pago. Para ello se cuenta con los campos ubicados bajo el título "Carga de definición de lote y número de comercio para todas las opciones de pago mostradas". Mediante esta funcionalidad es posible cargar en una única vez la definición de lote y número de comercio para todas las opciones de pago que se muestren en la página. Recodar que las opciones de pago que se muestran en la página son el resultado de la búsqueda que se haya efectuado. Si se desea cargar la misma definición de lote para todas las opciones de pago pero no el mismo número de cierre, se puede dejar vacío el text box correspondiente a este último. Lo mismo es válido si sólo se desea cargar el número de serie (seleccionar la opción en blanco en el combo de definiciones de lote)
Presionar "Aceptar" para que los valores cargados se almacenen en el sistema. Si no se desea que esto ocurra, presionar "Cancelar". Por medio del botón "Volver" se puede regresar a la pantalla inicial de administración de locales.

10.1.3 Datos de Local por canal


Para cada local se deben ingresar por canal los siguientes datos:

    • País al cual pertenece el local.
    • Ciudad a la que pertenece el local.
    • Código postal.
    • Actividad desempeñada por el local.
    • Institución adquiriente.
    • Dueños del local.
    • Grupo del retailer.
    • Región del retailer.


Presionar "Aceptar" para que los valores cargados se almacenen en el sistema. Si no se desea que esto ocurra, presionar "Cancelar". Por medio del botón "Volver" se puede regresar a la pantalla inicial de administración de locales.




Además, se dispone de una opción rápida de carga cuando se quiera ingresar los mismos datos en varios locales "Configurar Todos".
Mediante esta funcionalidad es posible cargar en una única vez los datos de los locales que se muestren en la página. Recodar que los locales que se muestran en la página son el resultado de la búsqueda que se haya efectuado.

10.1.4 Terminales

Acceso:
Para acceder a la configuración de las terminales que se manejarán en el sistema, seleccionar la opción "Terminales" dentro del menú de Configuración (Módulo CR / DB > Configuración > Configuración por local > Terminales).
Descripción de la página:
Esta página permite efectuar la carga, eliminación y modificación de las terminales lógicas que serán utilizadas por VTOL CR / DB.

10.1.4.1 Búsqueda de terminales

Se cuenta con la opción de buscar las terminales dadas de alta en el sistema, indicando la compañía y local al que corresponde la terminal e ingresando la definición de lote y el número de serie de terminal (búsqueda por similitud). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.

10.1.4.2 Alta de terminales

Para cargar una terminal se debe ingresar la compañía y el local al cual corresponde la misma, así como también la definición de lote a la cual se encontrará asociada y el número de serie que la identificará. Estos datos deben ser ingresados en el área de la pantalla destinada a la incorporación de nuevas definiciones de lote (bajo el título "Agregar una terminal") y luego presionar "Guardar".
Para el alta de las terminales se dispone de dos opciones: ingresar las terminales una a una o ingresar varias a la vez (un rango de terminales) para un mismo local. La última opción es posible sólo cuando los números de serie de terminal son secuenciales.

  • Para ingresar un rango de terminales, se debe colocar el primer número de serie del rango en el campo "desde" y el último número de serie en el campo "hasta". El sistema cargará todas las terminales que se encuentren en ese rango 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 terminales con códigos 1, 2, 3 y 4 respectivamente.
  • Cuando no se desee ingresar un rango sino una única terminal, efectúe la búsqueda de la definición de lote y caja a la cual se asociará la terminal y complete el número de serie de terminal en el textbox ubicado en la columna "Número de serie de terminal". Presionar "Aceptar" para que el valor ingresado se guarde en el sistema. Presionar "Cancelar" si no se desea guardarlo. Otra opción para ingresar una única terminal es completar en el campo "desde" el número de serie correspondiente a la terminal y dejar el campo "hasta" vacío, presionando luego "Guardar".


10.1.4.3 Modificación de terminales

Para modificar el número de serie de una terminal se debe cambiar. Ante esto el sistema mostrará los datos asociados a la terminal, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.
Al presionar "Guardar" en la creación o "Aceptar" en la modificación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana.


10.1.4.4 Eliminación de terminales

Para eliminar una terminal se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar". Tener en cuenta que no podrá efectuarse la eliminación si existen transacciones pendientes de cierre asociadas a dicha Terminal (3). Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.

10.1.5 Activación de Terminales


Acceso:
Para acceder a la Activación de Terminales que se encuentran bloqueadas en el sistema, seleccionar la opción "Activación de Terminales" dentro del menú de Configuración (Módulo CR / DB > Configuración > Configuración por local > Activación de Terminales)
Descripción de la página:
Esta página permite observar las terminales Bloqueadas en sistema, permitiendo la activación de las mismas.


Nota: La funcionalidad de activación de terminales va a mostrar la lista de todas las terminales que estén en estado Closing con entradas en la ClosingEntry y que superen el umbral máximo de permanencia para poder activarse.

10.1.5.1 Activar Terminales

El sistema muestra en esta pantalla las terminales disponibles para poder Activarse, los datos que se visualizan son los siguientes:

  • Nombre de la Compañía
  • Nombre del Local a al que pertenece
  • Código Local
  • Código de Caja.
  • Descripción del Problema


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

 10.2 Tarjeta

Acceso:
Para acceder a la configuración de las tarjetas manejadas por el sistema, seleccionar la opción "Tarjetas" dentro del menú de Configuración (Módulo CR / DB > Configuración > Tarjetas)


Descripción de la página:
A través de esta página puede llevarse adelante la administración de las tarjetas que manejará el sistema.

10.2.1 Búsqueda de tarjetas

El sistema brinda la opción de buscar las tarjetas que se encuentran cargadas, por medio del campo "Nombre de tarjeta" (búsqueda por similitud). Una vez completado este campo se debe presionar "Buscar" para que la búsqueda se lleve adelante.

10.2.2 Alta de tarjetas

Para cargar una tarjeta en el sistema se debe completar el campo "Nombre de tarjeta" "Código Tarjeta" y "Medio de Pago" que se encuentra en el área de la pantalla destinada a la incorporación de nuevas tarjetas (bajo el título "Agregar una tarjeta") y presionar "Guardar". La tarjeta nueva cargada se mostrará en la última posición del listado de tarjetas presentado por consola. Al presionar "Guardar" se solicitará confirmación de la creación de la tarjeta mediante el despliegue de una ventana.

10.2.3 Modificación de tarjetas

Para modificar una tarjeta se deberá presionar el link "Modificar" correspondiente a la misma. Ante esto el sistema mostrará los datos de la tarjeta, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.
Al presionar "Aceptar" en la modificación o "Guardar" en la creación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana.

10.2.4 Eliminación de tarjetas

Para eliminar una tarjeta del sistema se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar". Si la tarjeta posee opciones de pago asociadas el sistema lo informará y no permitirá darla de baja hasta tanto no se eliminen las opciones de pago que la referencian. Tampoco se podrá eliminar una tarjeta para la cual existen transacciones pendientes de cierre. Recordar que si se elimina una tarjeta del sistema VTOL CR / DB ya no será capaz de operar con la misma hasta tanto no sea dada de alta nuevamente.


45

El sistema solicita confirmación de la eliminación:

10.3 Tipos de tarjeta

Acceso:
Para acceder a la configuración de los tipos de tarjeta manejados por el sistema, seleccionar la opción "Tipos de Tarjeta" dentro del menú de Configuración (Módulo CR / DB > Configuración > Tipos de Tarjeta)


Descripción de la página:
A través de esta página puede llevarse a cabo la administración de los tipos de tarjeta que se utilizarán en el sistema.

10.3.1 Búsqueda de tipos de tarjeta

El sistema brinda la opción de buscar los tipos de tarjeta que se encuentran cargadas, por medio del campo "Descripción" (búsqueda por similitud). Una vez completado este campo se debe presionar "Buscar" para que la búsqueda se lleve a cabo.

10.3.2 Alta de tipos de tarjeta

Para cargar una tarjeta en el sistema se debe completar el campo "Descripción" y "Es débito?" que se encuentra en el área de la pantalla destinada a la incorporación de nuevas tarjetas (bajo el título "Agregar tipo de tarjeta") y presionar "Guardar". La tarjeta nueva cargada se mostrará en la última posición del listado de tarjetas presentado por consola.
El parámetro Es débito que se solicita, es utilizado para indicar si el tipo de tarjeta seleccionado es de una tarjeta de débito o no. Esto es utilizado por ciertos procesos del sistema por lo que es necesario completar la información según corresponda.
La validación que se lleva a cabo es que no se permite dar de alta un tipo de tarjeta que use una descripción igual a la de una ya existente.

10.3.3 Modificación de tipos de tarjeta

Para modificar una tarjeta se deberá presionar el link "Modificar" correspondiente a la misma. Ante esto el sistema mostrará los datos del tipo de tarjeta, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.
Al presionar "Aceptar" en la modificación o "Guardar" en la creación de tipos de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana

10.3.4 Eliminación de tipos de tarjeta

Para eliminar una tarjeta del sistema se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar". A continuación se muestran las restricciones existentes para el borrado de tipos de tarjeta:

  • Prefijos asignados, se deberá borrar el prefijo seleccionado (siguiendo las restricciones correspondientes del mismo) o bien cambiar la asignación del tipo de tarjeta a los prefijos existentes y posteriormente borrar el tipo de tarjeta.
  • Transacciones relacionadas (cerradas y no cerradas). En el caso de las transacciones no cerradas, se deberá esperar el cierre correspondiente. Para el caso de las transacciones cerradas será necesario depurar la base de datos.
  • Tipo de tarjeta base (no puede ser borradas). El sistema precarga 3 tipos de tarjeta que son Crédito, débito y sin clasificar. Estos tipos de tarjeta no podrán ser borrados del sistema ya que representan la base de la funcionalidad, por lo que si se intentan borrar se mostrará un mensaje notificando al usuario que no se pueden borrar dichos elementos.


En general para llevar a cabo la eliminación de la tarjeta se debe tildar el tipo de tarjeta deseado y posteriormente oprimir el botón Eliminar. Se solicitará una confirmación acerca del borrado. Si se selecciona la opción aceptar el proceso eliminará el o los tipos de tarjeta seleccionados. De lo contrario, se cancelará y el listado permanecerá intacto.


10.4 Tarjetas por Compañías

Acceso:
Para acceder a la configuración de las tarjetas por compañías manejados por el sistema, seleccionar la opción de menú de Configuración (Módulo CR / DB > Configuración > Tarjetas por Compañías)

Descripción de la página:
A través de esta página puede llevarse a cabo la administración de las tarjetas por compañías que se utilizarán en el sistema.

10.4.1 BÚSQUEDA DE tarjetas por compañías

El sistema brinda la opción de buscar las tarjetas por compañías que se encuentran cargadas, por medio de los campos "Compañía" y "Tarjeta". Una vez completado estos filtros se debe presionar "Buscar" para que la búsqueda se lleve adelante. Como resultado se mostrará la configuración que posee cada tarjeta asociada a una Compañía.

10.4.3 MODIFICACIÓN DE tarjetAS por compañías


Al oprimir la acción "Modificar" correspondiente a un registro de Compañía Tarjeta, se mostrará la pantalla "Modificar tarjeta por compañía" donde se mostrarán los siguientes datos:

  • Compañía: campo con el nombre de la compañía
  • Tarjeta: campo con el nombre de la tarjeta

y los siguientes campos con su correspondiente información:

Permitir operar Off-line (checkbox)

Monto límite de transacción Off-line (textbox)

Permitir operar Cashback (checkbox)Monto límite Cashback (textbox)
Monto de comisión Cashback (textbox)Monto de comisión CardPayment (textbox)
Monto límite QPS (textbox)Permitir acumulación de Puntos de lealtad (checkbox)

El botón de acción "Aceptar" persistirá los cambios mientras que el de "Cancelar" volverá a la pantalla de "Tarjetas por Compañía".


10.4 Monedas

Acceso:
Para acceder a la configuración de las monedas manejadas por el sistema, seleccionar la opción "Monedas" dentro del menú de Configuración (Módulo CR / DB > Configuración > Monedas)
 


Descripción de la página:
A través de esta página puede llevarse adelante la administración de las monedas que manejará el sistema.

10.4.1 Búsqueda de monedas

El sistema brinda la opción de buscar las monedas que se encuentran cargadas, por medio del campo "Nombre de moneda". Una vez completado este campo se debe presionar "Buscar" para que la búsqueda se lleve adelante.

10.4.2 Alta de monedas

Para cargar una tarjeta en el sistema se deben completar los siguientes campos en el área de la pantalla destinada a la incorporación de nuevas monedas (bajo el título "Agregar una moneda").

  • Nombre de la moneda.
  • Código para identificar la moneda empleado en la comunicación con el centro autorizador.
  • Símbolo que identifica a la moneda. Ej: $ para pesos.

Completados los datos anteriores, presionar "Guardar". La moneda nueva cargada se mostrará en la última posición del listado de monedas presentado en la pantalla.

10.4.3 Modificación de monedas

Para modificar una moneda se deberá presionar el link "Modificar" correspondiente a la misma (3) Ante esto el sistema mostrará los datos de la moneda, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.


Al presionar "Aceptar" en la modificación o "Guardar" en la creación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana

10.4.4 Eliminación de monedas

Para eliminar una moneda del sistema se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar". Tener en cuenta que el sistema no permitirá eliminar una moneda que se encuentre vinculada con una opción de pago o para la cual existan transacciones no cerradas.


El sistema solicita confirmación para eliminar las monedas seleccionadas:

10.5 Modos de ingreso

Acceso:
Para acceder a la configuración de los modos de ingreso manejados por el sistema, seleccionar la opción "Modos de ingreso" dentro del menú de Configuración (Módulo CR / DB > Configuración > Modos de ingreso)


Descripción de la página:
A través de esta página puede llevarse adelante la administración de los modos de ingreso de la información de la tarjeta que manejará el sistema.

10.5.1 Búsqueda de modos de ingreso

El sistema brinda la opción de buscar los modos de ingreso cargados, por medio del campo "Nombre del modo de ingreso" (búsqueda por similitud). Una vez completado este campo se debe presionar "Buscar" para que la búsqueda se lleve adelante.



10.5.2 Alta de modos de ingreso

Para cargar un modo de ingreso se debe completar el nombre único con el cual se identificará el mismo, en el área de la pantalla destinada a la incorporación de nuevos modos de ingreso (bajo el título "Agregar un modo de ingreso"). Efectuado esto se debe presionar "Guardar". El modo de ingreso nuevo cargado se mostrará en la última posición del listado de modos de ingreso presentado en la pantalla.

10.5.3 Modificación de modos de ingreso

Para modificar un modo de ingreso se deberá presionar el link "Modificar" correspondiente al mismo. Ante esto el sistema mostrará los datos del modo de ingreso, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.
Al presionar "Guardar" en la creación o "Aceptar" en la modificación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana.

10.5.4 Eliminación de modos de ingreso


Para eliminar un modo de ingreso se deberá seleccionar el mismo haciendo click sobre el checkbox correspondiente a él y luego presionar "Eliminar". Tener en cuenta que el sistema no permitirá la eliminación de un modo de ingreso mientras existan transacciones pendientes de cierre que poseen el mismo. 

El sistema solicita confirmación para eliminar los modos de ingreso seleccionados:

10.6 Modos de ingreso por canal

Acceso:
Para acceder a la configuración de los modos de ingreso que serán manejados por cada uno de los canales, seleccionar la opción "Modos de ingreso por canal" dentro del menú de Configuración (Módulo CR / DB > Configuración > Modos de ingreso por canal)


Descripción de la página:
A través de esta página puede llevarse adelante la asignación a cada canal de los modos de ingreso soportados por el mismo y de los códigos de identificación correspondientes definidos por el centro autorizador.

10.6.1 Búsqueda de modos de ingreso

El sistema brinda la opción de buscar los modos de ingreso que se encuentran asociados a cada canal, por medio de los campos "Canal" y "Nombre del modo de ingreso". Una vez seleccionados los valores deseados se debe presionar "Buscar" para que la búsqueda se lleve adelante.

10.6.2 Asociación de un modo de ingreso a un canal

Para asociar un modo de ingreso a un canal se debe seleccionar el nombre del canal, el nombre del modo de ingreso y cargar el código lo identificará en ese canal. Estos datos se cargarán en los campos que se encuentran bajo el título "Asociar un modo de ingreso a un canal". Efectuado esto se debe presionar "Guardar".

10.6.3 Modificación de la asociación modo de ingreso – canal

Para modificar una asociación de un modo de ingreso con un canal se deberá presionar el link "Modificar" correspondiente a la misma. Ante esto el sistema mostrará los datos: nombre del canal, nombre del modo de ingreso y código, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.


Al presionar "Guardar" en la creación o "Aceptar" en la modificación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana.

10.6.4 Eliminación de la asociación modo de ingreso - canal

Para eliminar una asociación de un modo de ingreso con un canal se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar".


El sistema solicita confirmación para elimina la asociación canal – modo de ingreso:

10.7 Autorizadores

Acceso:
Para acceder a la configuración de los autorizadores manejados por el sistema, seleccionar la opción "Autorizador" dentro del menú de Configuración (Módulo CR / DB > Configuración > Autorizador)


Descripción de la página:
A través de esta página puede llevarse adelante la administración de los autorizadores que manejará el sistema.

10.7.1 Búsqueda de autorizadores

El sistema brinda la opción de buscar los autorizadores que se encuentran cargados, por medio del campo "Nombre autorizador". Una vez completado este campo se debe presionar "Buscar" para que la búsqueda se lleve adelante.



10.7.2 Alta de autorizadores

Para cargar un autorizador se debe seleccionar el botón Crear (2) en la pantalla de Autorizadores. Se mostrará la pantalla de creación de Alta de Autorizador y deberá completar todos los campos solicitados.

  • Nombre Autorizador
  • TPDU
  • Network ID

Completados los datos anteriores, presionar "Aceptar". Se mostrará un mensaje de confirmación, dar clic en "Aceptar" El nuevo autorizador será creado y se mostrará nuevamente la pantalla de Autorizadores.

10.7.3 Modificación de autorizadores

Para modificar un autorizador se deberá presionar el link "Modificar" correspondiente al mismo. Ante esto el sistema mostrará la pantalla de Modificar el Autorizador con los datos del Autorizador seleccionado, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.


Al presionar "Aceptar" en la modificación al igual que al presionar "Guardar" en la creación de autorizadores, se solicitará la confirmación de la acción mediante el despliegue de una ventana

10.7.4 Eliminación de autorizadores

Para eliminar un autorizador del sistema se deberá seleccionar el mismo haciendo clic sobre el checkbox correspondiente a él y luego presionar "Eliminar". Tener en cuenta que el sistema no permitirá eliminar un autorizador que se encuentre vinculado con una Definición de Lote.


El sistema solicita confirmación para eliminar los autorizadores seleccionados:

10.8 Definiciones de lote

Acceso:
Para acceder a la configuración de las definiciones de lote que se manejarán en el sistema, seleccionar la opción "Definiciones de lote" dentro del menú de Configuración (Módulo CR / DB > Configuración > Definiciones de lote)


Descripción de la página:
Esta página permite cargar, modificar y eliminar las definiciones de lote que serán empleadas en el sistema.

10.8.1 Búsqueda de definiciones de lote

El sistema brinda la opción de buscar las definiciones de lote que se encuentran cargadas en el mismo, por medio de los campos "Compañía""Canal" y "Nombre definición de lote" (búsqueda por similitud). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


10.8.2 Alta de definiciones de lote

Para cargar una definición de lote se deben ingresar la Compañía, el Canal al cual la misma corresponde e ingresar el nombre que la identificará. Opcionalmente se puede seleccionar un Autorizador asociado a la definición de lote que se va a crear. Estos datos deben ser ingresados en el área de la pantalla destinada a la incorporación de nuevas definiciones de lote (bajo el título "Agregar una definición de lote") y luego presionar "Guardar". La nueva definición de lote cargada se mostrará en la última posición del listado de definiciones de lote presentado en la página.

10.8.3 Modificación de definiciones de lote

Para modificar una definición de lote se deberá presionar el link "Modificar" correspondiente a la misma. Ante esto el sistema mostrará los datos de la definición de lote (Compañía, canal, nombre, formato nro. terminal y autorizador), permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para no realizar cambios.


Al presionar "Guardar" en la creación o "Aceptar" en la modificación de definición de lote, se solicitará la confirmación de la acción mediante el despliegue de una ventana.

10.8.4 Eliminación de definiciones de lote

Para eliminar una definición de lote del sistema se deberá seleccionar la misma haciendo click sobre el checkbox correspondiente a ella y luego presionar "Eliminar". Si la definición de lote está siendo utilizada dentro de una opción de pago el sistema no permitirá darla de baja hasta tanto no se eliminen las opciones de pago que la referencian. Tampoco podrá efectuarse la eliminación si existen transacciones pendientes de cierre que corresponden a esa definición de lote.



El sistema solicita confirmación para efectuar la eliminación:

10.9 Planes

Acceso:
Para acceder a la configuración de los planes que se manejarán en el sistema, seleccionar la opción "Planes" dentro del menú de Configuración (Módulo CR / DB > Configuración > Planes)


Descripción de la página:
Esta página permite efectuar la carga, eliminación y modificación de todos los planes que serán utilizados por el sistema.

10.9.1 Búsqueda de planes

Se cuenta con la opción de buscar los planes cargados en el sistema, por medio de los campos "Código de plan" y "Descripción" (búsqueda por similitud). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


10.9.2 Alta de planes

Para cargar un plan se debe ingresar el código que identifica al mismo así como también una descripción para éste. Estos datos deben ser ingresados en el área de la pantalla destinada a la incorporación de nuevas definiciones de lote (bajo el título "Agregar un plan") y luego presionar "Guardar". La nueva definición de lote cargada se mostrará en la última posición del listado de definiciones de lote presentado en la página.

10.9.3 Modificación de planes

Para modificar un plan se deberá presionar el link "Modificar" correspondiente al mismo. Ante esto el sistema mostrará los datos del plan, permitiendo cambiarlos.
Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.


Al presionar "Guardar" en la creación o "Aceptar" en la modificación de tarjetas, se solicitará la confirmación de la acción mediante el despliegue de una ventana.

10.9.4 Eliminación de planes

Para eliminar un plan se deberá seleccionar el mismo haciendo click sobre el checkbox correspondiente a él y luego presionar "Eliminar". Si el plan está siendo utilizada dentro de una opción de pago el sistema no permitirá darla de baja hasta tanto no se eliminen las opciones de pago que la referencian. Tampoco podrá efectuarse la eliminación si existen transacciones pendientes de cierre para dicho plan.


El sistema solicita confirmación para realizar la eliminación de los planes:

10.10 Prefijos

Acceso:
Para acceder a la configuración de los prefijos que se manejarán en el sistema para cada tarjeta, seleccionar la opción "Prefijos" dentro del menú de Configuración (Módulo CR / DB > Configuración > Prefijos)


Descripción de la página:
Esta página permite efectuar la carga, eliminación y modificación de los prefijos de las tarjetas que serán utilizadas por VTOL CR / DB.

10.10.1 Búsqueda de prefijos

Se cuenta con la opción de buscar prefijos dados de alta en el sistema, indicando la tarjeta a la que pertenecen y si se encuentran o no habilitados. Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.

10.10.2 Alta de prefijos


Para cargar un prefijo se debe presionar el botón "Crear", ante lo cual el sistema solicitará el ingreso de los siguientes datos:

  • Tarjeta a la que corresponde.
  • Rango del prefijo (desde – hasta)
  • Largo correspondiente al número de tarjeta.
  • Condición de identificación: es una identificación adicional para aquellas tarjetas que no se pueden distinguir únicamente mediante sus prefijos.
  • Permitir operar off-line: indica si la validación off-line se encuentra habilitada para el rango de prefijos.
  • Monto límite para transacciones efectuadas en modo off-line.
  • Si el prefijo requiere validación de: largo del CVC, dígito verificador y / o fecha de vencimiento.
  • Largo del CVC: debe ser indicado sólo en el caso que el prefijo requiera de validación de CVC.
  • Si el prefijo estará habilitado / deshabilitado
  • Si se requiere el envío del track 1.
  • Si el prefijo requiere el ingreso del Pin.
  • Si el prefijo debe validar los N últimos números.
  • Cantidad de N últimos números a validar en caso de estar activada esta validación.
  • Si el prefijo requiere el tipo de cuenta.
  • Si el prefijo solicita el número de cuenta.
  • Se debe seleccionar el tipo de tarjeta


Presionar "Aceptar" para que el alta tenga lugar, caso contrario presionar "Cancelar". Al presionar "Aceptar" se solicitará la confirmación de la creación del prefijo, mediante el despliegue de una ventana.

10.10.3 Modificación de prefijos

Para modificar un rango de prefijos ingresado se deberá presionar el link "Modificar" (3) correspondiente al mismo. Ante esto el sistema mostrará los datos asociados al prefijo, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos.


Al presionar "Aceptar" se solicitará confirmación de la modificación del prefijo, mediante el despliegue de una ventana.

10.10.4 Eliminación de prefijos

Para eliminar un prefijo se deberá seleccionar el mismo haciendo click sobre el checkbox correspondiente a él y luego presionar "Eliminar".
45


El sistema solicita confirmación para proceder a eliminar los prefijos seleccionados:

10.11 Opciones de pago

Acceso:
Para acceder a la configuración de las opciones de pago que serán empleadas, seleccionar la opción "Opciones de pago" dentro del menú de Configuración (Módulo CR / DB > Configuración > Opciones de pago)


Descripción de la página:
Esta página permite efectuar la carga, eliminación y modificación de las opciones de pago que serán utilizadas por VTOL CR / DB.

10.11.1 Búsqueda de opciones de pago

Se cuenta con la posibilidad de buscar opciones de pago dadas de alta en el sistema, a través de diferentes campos: compañía, tarjeta, definición de lote, código de plan, cantidad de cuotas, moneda, condición de pago y si es promocional. Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.




10.11.2 Alta de opciones de pago

Para cargar en el sistema una nueva opción de pago se debe presionar el botón "Crear" y luego completar los siguientes datos:

  • Compañía
  • Definición de lote.
  • Tarjeta.
  • Código de plan.
  • Cantidad de cuotas: en este campo se puede ingresar un único valor, un rango en la forma desde – hasta y también varios valores separados por coma. Ejemplos: 1 – 4 (significa que se darán de alta opciones de pago de 1, 2, 3 y 4 cuotas), 2, 4, 8 (indica que se darán de alta opciones de pago de 2, 4 y 9 cuotas)
  • Moneda.
  • Condición de pago: funciona como una especie de "comodín" permitiendo ingresar un dato adicional que se requiera para la opción de pago.
  • Monto mínimo: Es el monto mínimo que se debe superar para poder usar la opción de pago.
  • Interés %: Es el porcentaje de interés de la opción de pago.
  • Monto máximo con interés: Es el monto que al superarse, deja de aplicar el interés en la opción de pago.
  • Promocional: Indica que esa opción de pago tiene una promoción asociada



Presionar "Aceptar" para que el alta tenga lugar, caso contrario presionar "Cancelar".
Al presionar "Aceptar" se solicitará la confirmación de la creación de la opción de pago, mediante el despliegue de una ventana emergente.

10.11.3 Modificación de opciones de pago

Para modificar una opción de pago ingresada se deberá presionar el link "Modificar" correspondiente a la misma. Ante esto el sistema mostrará los datos asociados a la opción de pago elegida, permitiendo cambiarlos. Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará confirmar la modificación de la opción de pago, mediante el despliegue de una ventana emergente.

10.11.4 Eliminación de opciones de pago

Para eliminar una opción de pago se deberá seleccionar el mismo haciendo click sobre el checkbox correspondiente a él y luego presionar "Eliminar". Tener en cuenta que la eliminación de la opción de pago no se llevará a cabo si existen transacciones pendientes de cierre vinculadas con la misma.


El sistema solicita confirmación de la eliminación:

10.12 Boletines Protectivos

Acceso:
Para acceder a la administración de los boletines protectivos que serán empleados por el sistema, seleccionar la opción "Boletines protectivos" dentro del menú de Configuración (Módulo CR / DB > Configuración > Boletines protectivos)


Descripción de la página:
Esta página permite observar los boletines protectivos que se encuentran cargados en el sistema así como efectuar la carga de nuevos.

10.12.1 Búsqueda de boletines protectivos

Para buscar un boletín protectivo que se encuentra cargado en el sistema, se cuenta con los siguientes criterios de búsqueda: tarjeta, nombre del boletín (nombre del archivo), rango de fechas en el cual el boletín es válido. Completados los campos con los valores deseados, presionar "Buscar".

10.12.2 Carga de boletines protectivos

Para cargar un boletín protectivo basta con sólo indicar la ruta del archivo, ingresándola manualmente o seleccionándola por medio del botón "Browse". Luego se debe presionar el botón "Cargar boletín". No se requiere ingresar ningún dato adicional del boletín dado que la restante información se encuentra contenido dentro del archivo del boletín. Si el boletín se cargó correctamente, se visualizará un mensaje en la pantalla informándolo, como puede verse a continuación:

10.13 Validaciones Crédito Débito

Acceso:
Para acceder a la administración de las validaciones crédito débito que serán empleados en el sistema, seleccionar la opción "Validaciones Crédito Débito" dentro del menú de Configuración (Módulo CR / DB > Configuración > Validaciones Crédito Débito).


Descripción de la página:
Esta página permite configurar límites en el sistema para que al momento de operar se efectúen las correspondientes validaciones.

10.13.1 Búsqueda de validaciones

Para buscar las validaciones que se encuentran creadas en el sistema, se cuenta con los siguientes criterios de búsqueda:

  • Compañía
  • Nombre del local
  • El tipo de validación:
    • Límite por periodo
    • Límite por transacción

Completados los campos con los valores deseados, presionar "Buscar".

10.13.2 Alta de validaciones

Para crear una validación de crédito débito, se debe presionar el botón "Crear" y completar los siguientes datos:

  • Tipo de validación a efectuarse:
    • Límite por periodo
    • Límite por transacción
  • Compañía
  • Local
  • Si sobre escribe o no jerarquía (cuando no se especifica un local)
  • Monto límite
  • Periodo en que se ejecutará la validación (cuando el tipo de validación es por periodo):
    • Diario
    • Semanal
    • Quincenal
    • Mensual


Presionar "Aceptar" para que el alta tenga lugar, caso contrario presionar "Cancelar". Al presionar "Aceptar" se solicitará la confirmación de la creación de la validación, mediante el despliegue de una ventana.

11. Manejo de Errores

En el caso que se presente un error al utilizar la consola Web, la pantalla de Auditoría ofrece la posibilidad de identificar el tipo de error, ya que la misma ofrece un listado de acciones que efectúan los usuarios a través de la consola de administración, posibilitando llevar un control detallado de las mismas.


Listado de acciones del usuario en la pantalla Auditoria
Para ver más detalles sobre los errores que pueden aparecer en la utilización del sistema, el usuario puede acceder a los datos que se encontrarán registrados en un archivo de log, el cual al igual que auditoria, también registra las actividades pero en forma más detallada.
El archivo se encuentra en la carpeta llamada LOG, se puede acceder a ella a través del directorio {INSTALACION}/log. Allí el usuario podrá tener acceso al archivo server.log con los datos necesarios para identificar el error.

Ubicación del Server.log para el seguimiento de errores

Para más detalles sobre este tema, ver el punto "Guía de resolución de problemas" del documento "VTOLCR-DB-Guía de implementación.pdf".


12. Configuración PEI


PEI (Pago Electrónico Inmediato) son pagos inmediatos que se efectúan con tarjetas de débito y se transfieren y acreditan de manera instantánea. El centro autorizador con el que se comunica VTOL es Link.


12.1 Configuración de negocio

Una vez configurado en VTOL la compañía, el local y las cajas, se podrá iniciar la configuración de PEI.

Para acceder a la funcionalidad de configuración específica de PEI, presionar la opción denominada "PEI" dentro del menú "Módulo CR / DB" (VTOL > Módulo Crédito-Débito > PEI).

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

12.1.1 Comercios PEI

Acceso:
Para acceder a la configuración de los Comercios PEI que se manejarán en el sistema, seleccionar la opción "Comercios" dentro del menú de PEI (VTOL > Módulo CR / DB > PEI > Comercios).

Descripción de la página:
Esta página permite efectuar la carga, consulta, eliminación y modificación de los comercios PEI que serán utilizados por VTOL CR / DB.

12.1.1.1 Búsqueda de Comercios PEI

Se cuenta con la opción de buscar los Comercios PEI dados de alta en el sistema, seleccionando la compañía a la que corresponde el comercio PEI e ingresando el código de comercio PEI. Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


12.1.1.2 Alta de Comercios PEI

Para cargar un Comercio PEI se debe oprimir el botón "Crear" y seleccionar una compañía e ingresar el código de comercio informado por Link.
La relación será: una compañía podrá poseer un código de comercio PEI y un código de comercio PEI podrá ser asociado a una compañía.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.1.3 Modificación de Comercios PEI

Para modificar un Comercio PEI, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados al Comercio PEI, permitiendo cambiarlos.
Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.1.4 Eliminación de Comercios PEI

Para eliminar un Comercio PEI se deberá seleccionar la misma haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana. Tener en cuenta que no podrá efectuarse la eliminación si existen datos relacionados al comercio PEI.


12.1.2 Sucursales PEI

Acceso:
Para acceder a la configuración de las Sucursales PEI que se manejarán en el sistema, seleccionar la opción "Sucursales" dentro del menú de PEI (VTOL > Módulo CR / DB > PEI > Sucursales).

Descripción de la página:
Esta página permite efectuar la carga, consulta, eliminación y modificación de las sucursales PEI que serán utilizadas por VTOL CR / DB.

12.1.2.1 Búsqueda de Sucursales PEI

Se cuenta con la opción de buscar las Sucursales PEI dadas de alta en el sistema, seleccionando la compañía y el local a la que corresponde la sucursal PEI e ingresando el código de comercio PEI o el código de sucursal PEI. Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


12.1.2.2 Alta de Sucursales PEI

Para cargar una Sucursal PEI se debe oprimir el botón "Crear" y seleccionar una compañía, un local e ingresar el código de sucursal informado por Link.
La relación será: un local podrá poseer un código de sucursal PEI y un código de sucursal PEI podrá ser asociado a un local.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.2.3 Modificación de Sucursales PEI

Para modificar una Sucursal PEI, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados a la Sucursal PEI, permitiendo cambiarlos.
Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.2.4 Eliminación de Sucursales PEI

Para eliminar una Sucursal PEI se deberá seleccionar la misma haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana. Tener en cuenta que no podrá efectuarse la eliminación si existen datos relacionados a la sucursal PEI.


12.1.3 Terminales PEI

Acceso:
Para acceder a la configuración de las Terminales PEI que se manejarán en el sistema, seleccionar la opción "Terminales" dentro del menú de PEI (VTOL > Módulo CR / DB > PEI > Terminales).

Descripción de la página:
Esta página permite efectuar la carga, consulta, eliminación y modificación de las terminales PEI que serán utilizadas por VTOL CR / DB.

12.1.3.1 Búsqueda de Terminales PEI

Se cuenta con la opción de buscar las Terminales PEI dadas de alta en el sistema, seleccionando la compañía, el local y la caja a la que corresponde la terminal PEI e ingresando el código de comercio PEI, el código de sucursal PEI o el código de terminal PEI. Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


12.1.3.2 Alta de Terminales PEI

Para cargar una Terminal PEI se debe oprimir el botón "Crear" y seleccionar una compañía, un local, una caja e ingresar el código de terminal informado por Link.
La relación será: una caja podrá poseer un código de terminal PEI y un código de terminal PEI podrá ser asociado a una caja.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.3.3 Modificación de Terminales PEI

Para modificar una Terminal PEI, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados a la Terminal PEI, permitiendo cambiarlos.
Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


12.1.3.4 Eliminación de Terminales PEI

Para eliminar una Terminal PEI se deberá seleccionar la misma haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana. Tener en cuenta que no podrá efectuarse la eliminación si existen datos relacionados a la terminal PEI.


12.2 Configuración de propiedades

Se deberán configurar parámetros para poseer una comunicación óptima con Link.

Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú "Herramientas administrativas" (Herramientas administrativas > Configuración).

Esta página permite configurar las distintas propiedades disponibles para PEI 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. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".

A continuación, se explicarán las propiedades relacionadas a PEI.


PropiedadTipoDescripciónRequiere reiniciar?
URL de conexión con CA Link #0 Nodo 01 (al Nodo 10)AlfanuméricoURL del centro autorizador Link #0 por el cual se establecerá la comunicación del NodoNo
URL de conexión con CA Link #1 Nodo 01 (al Nodo 10)AlfanuméricoURL del centro autorizador Link #1 por el cual se establecerá la comunicación del NodoNo
Usuario PEI canal LinkAlfanuméricoUsuario PEI utilizado para conectarse con el canal LinkNo
Clave PEI canal LinkAlfanuméricoClave PEI utilizada para conectarse con el canal LinkNo
ClientId PEI canal LinkAlfanuméricoClientId PEI utilizado para conectarse con el canal LinkNo
ClientSecret PEI canal LinkAlfanuméricoClientSecret PEI utilizado para conectarse con el canal LinkNo
IP SV PEI canal LinkAlfanuméricoDirección IP Server PEI utilizado para conectarse con el canal LinkNo
Expiracion en segundos token PEI canal LinkEnteroExpiracion en segundos del token PEI utilizado para conectarse con el canal LinkNo
Timeout para autorización PeiEnteroTiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización PEINo
Habilita al proceso de cierre de transacciones PEItrue / falseHabilita el proceso de cierre de transacciones PEINo
Timeout de escritura para autorización PeiEnteroTiempo maximo en milisegundos de escritura de un requerimiento una transacción de autorización para PEINo
Timeout de conexión para autorización PeiEnteroTiempo maximo en milisegundos que se esperara para conectarse una transacción de autorización para PEINo
Timeout en segundos de solicitud token PEI al autorizadorEnteroTimeout en segundos que se espera la respuesta de una solicitud de Token PEI al autorizador No


13. Búsqueda de cupones

Acceso:
Para acceder a la búsqueda de cupones digitales que se encuentran cargados en el sistema, seleccionar la opción "Búsqueda de vouchers" dentro del menú: VTOL > Módulo Crédito-Débito.


13.1 Funcionalidad

Esta página permite efectuar la búsqueda y descarga de cupones digitalizados.


13.1.1 Búsqueda de Cupones

El sistema cuenta con la opción de buscar los cupones digitales cargados, gracias a los siguientes filtros:

  • Compañía
  • Fecha desde y hasta del cupón
  • Tarjeta
  • Últimos 4 dígitos de la tarjeta
  • Importe de la transacción

Además como filtros adicionales, para que un retailer localice un comprobante en caso de que aparezcan varios con una fecha, tarjeta e importe, se muestran los filtros:

  • Número de comercio
  • Número de lote
  • Cupón


Una vez completados estos campos se debe presionar el botón "Buscar" para que la búsqueda sea efectuada.

Tener en cuenta que se buscarán los comprobantes que contengan los valores de los filtros ingresados. En caso de que no existan resultados para la búsqueda, se mostrará la leyenda "No existen cupones con los criterios seleccionados".

Posterior búsqueda se mostrará una grilla de resultados con los siguientes valores:

  • Compañía
  • Local
  • Operación
  • Fecha del comprobante
  • Tarjeta
  • Últimos 4 dígitos
  • Importe
  • Número de comercio
  • Número de lote
  • Cupón
  • Transacción
  • Componente checkbox


La columna "Transacción" mostrará por cada registro un hipervínculo que desplegará un pop-up (ventana emergente) con el detalle del cupón seleccionado.

13.1.2 Descarga de cupones

Al seleccionar uno o más registros mediante el componente checkbox de la grilla de resultados y oprimiendo el botón "Descargar", se descargarán el o los comprobantes seleccionados. Los archivos que se descargan tendrán formato .POS.


13.2 Configuración de acceso

Se deberá configurar el acceso a la búsqueda de cupones para que los usuarios tengan habilitada la opción en el menú.

Para acceder a la configuración, presionar la opción "Usuarios" dentro del menú "Seguridad".

Buscar el usuario al cual se quiere dar acceso al menú de "Búsqueda de cupones" y presionar la acción "Modificar". Luego buscar dentro de la grilla "Permisos" la opción "Acceso a voucher de tarjetas". Se debe tildar dicha opción y luego presionar el botón "Aceptar".



14. Configuración Billeteras Electrónicas


Las Billeteras Electrónicas son formas de pago donde se hace uso de aplicaciones como Mercado Pago o Todo Pago instaladas en dispositivos smartphones. Estas aplicaciones poseen las tarjetas enroladas de un cliente, por lo que se puede abonar en un comercio sin la necesidad de tener presente una tarjeta.


14.1 Configuración de Certificados

Para comunicarse con Mercado Pago y/o Todo Pago, VTOL Server debe implementar un certificado de seguridad en el servidor del retailer, emitido por una entidad autorizadora, ya que tanto Mercado Pago como Todo Pago lo requieren para no devolver error de confianza.

El retailer que implemente Pagos con QR deberá disponibilizar una comunicación entrante.

En el caso de la solución con Mercado Pago, se hace sobre internet. VTOL deja levantado un puerto visible desde internet público.

En el caso de la solución con Todo Pago, es igual que Mercado Pago, pero se hace sobre una VPN.

Como dato para la gestión, el certificado emitido por la entidad autorizadora deberá ser cargado en VTOL utilizando la tool nativa de JAVA KeyTool.

Cada entidad autorizadora trabaja con diferentes formatos, por lo que quizás sea necesario adaptar el certificado en un formato válido para el KeyTool


Tramitar certificado en VTOL

Se necesita una llave privada en formato CRT para poder armar el keystore que requiere VTOL para poder servir el certificado y la cadena de confianza.

 El procedimiento sería el siguiente: 

  1. En un archivo de texto vacío
    1. copiar el contenido de la llave privada, formato CRT
    2. a continuación, copiar el contenido del certificado emitido para el dominio X, formato CRT
    3. a continuación, copiar el contenido del certificado intermedio, formato CRT
    4. por último y también a continuación, copiar el contenido del certificado ROOT (quién emitió el certificado), formato CRT
  2. Guardar el archivo como “server.pem”
  3. Utilizar la tool OPEN SSL, y ejecutar el siguiente comando:
    1. openssl pkcs12 -export -in server.pem -inkey [llave privada PEM o CRT] -name mi_dominio -out mi_dominio.p12
  4. Construir un Java KEYSTORE con el certificado generado en el paso anterior. Usar java 8
    1. keytool -importkeystore -deststorepass nosotros -destkeystore synthesis.keystore -srckeystore mi_dominio.p12 -srcstoretype PKCS12
  5. Dará como resultado un archivo llamado “synthesis.keystore”
  6. Reemplazar archivo en ruta:
    1. ..\wildfly-10.1.0.Final\[VTOL_DIR]\configuration
  7. Reiniciar VTOL 

Una vez realizado esto, utilizando un navegador web, acceder a la URL https://[mi_dominio]:[puerto abierto]/vtol

Se podrá verificar el certificado válido y una comunicación HTTPS.

Se puede usar la siguiente tool en línea para validar que todo esté OK: https://www.sslshopper.com/ssl-checker.html


Redirección de puerto:

VTOL sale a través de internet a una URL pública de Mercado Pago. Por otro lado, cuando el cliente hace el pago con el celular, Mercado Pago envía a VTOL Server la notificación de pago, también a través de internet. Para que esa notificación sea posible, debe haber un puerto publicado en internet que se redirija a un puerto de VTOL Server (por defecto el 8585, aunque se puede cambiar). Esa comunicación es HTTPS y es servida por VTOL Server.

Para configurar la URL de notificación en VTOL, ver apartado: 14.4 Configuración de propiedades > OPCIONES DE CONFIGURACIÓN DE MERCADO PAGO > Propiedad: URL Base de notificacion que usará mercado pago.

14.2 Configuración de Credenciales

14.2.1 Pasos para operar con mercado pago

Los pasos para poder operar son los siguientes:

  1. Ya debemos tener creado un usuario VENDEDOR en Mercado Pago, con dicho usuario acceder a: https://www.mercadopago.com/mla/account/credentials
    1. obtendremos el Acces Token de los ambientes Sandbox y Producción:


  2. Luego se debe crear un usuario COMPRADOR. Para ello con el acceso token de modo sandbox/producción ejecutamos lo siguiente (se debe tener instalado la tool CURL)
    1. curl -X POST -H "Content-Type: application/json" "https://api.mercadopago.com/users/test_user?access_token=ACCESS_TOKEN" -d "{'site_id':'MLA'}"

    2. obtendremos lo siguiente:

  3. Luego se debe crear el código QR para la caja que se quiera usar (cada caja debe tener su propio código QR).  Para ello acceder a la siguiente URL:
    1. https://api.mercadopago.com/mpmobile/instore/merchant/qr/COLLECTOR_ID/PUNTO_DE_VENTA?access_token=ACCES_TOKEN

    2. El collector_id es el número de usuario de la cuenta de Mercado Pago, son los últimos 9 dígitos del access_token, posterior al guión medio.

    3. obtendremos lo siguiente:

    4. hacer clic en la URL del QR y se podrá visualizar el QR generado para esa caja:


  4. El siguiente paso consiste en configurar:
    1. En la consola de VTOL:
      1. La URL de conexión
      2. El Access Token del VENDEDOR
    2. En la App mobile del celular:
      1. El usuario COMPRADOR
      2. La contraseña del COMPRADOR
    3. Disponibilizar el código QR en el punto de venta para que el COMPRADOR lo pueda escanear al querer pagar.
  5. A continuación se detallan las configuraciones que se deben realizar en la consola de VTOL para poder operar con Billeteras Electrónicas.

14.3 Configuración de negocio

Una vez configurado en VTOL la compañía, el local y las cajas, se podrá iniciar la configuración de Billeteras Electrónicas.

Para acceder a la funcionalidad de configuración específica de Billeteras Electrónicas, presionar la opción denominada "Billeteras Electrónicas" dentro del menú "Módulo CR / DB" (VTOL > Módulo Crédito-Débito > Billeteras electrónicas).

A continuación, se explicará la funcionalidad y uso de cada una de las Billeteras Electrónicas. Se aconseja efectuar la configuración de la aplicación siguiendo el orden de las secciones que se presenta en este manual.

14.3.1 Mercado Pago

Acceso:
Para acceder a la configuración de Mercado Pago que se manejará en el sistema, seleccionar la opción "Mercado Pago" dentro del menú de Billeteras electrónicas (VTOL > Módulo CR / DB > Billeteras electrónicas > Mercado Pago).

14.3.1.1 Configuración Datos de compañía

Descripción de la página:

Esta página permite efectuar la carga, consulta, eliminación y modificación de las compañías para Mercado Pago que serán utilizados por VTOL CR / DB.


14.3.1.1.1 Búsqueda de Datos de compañía MP

Se cuenta con la opción de buscar las compañías MP dadas de alta en el sistema, seleccionando la compañía a la que corresponde la cuenta de MP e ingresando el identificador de la cuenta del vendedor (el identificador MP del retailer). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


14.3.1.1.2 Alta de Datos de compañía MP

Para cargar una Compañía MP se debe oprimir el botón "Crear" y seleccionar una compañía cargada en el sistema, ingresar el código identificador de la cuenta vendedor, el access token del entorno correspondiente para la comunicación (estos datos los provee MP) y la URL de notificación donde MP notificará a VTOL las respuestas de los pagos realizados.

El Identificador de la cuenta del vendedor es asignado por Mercado Pago a nivel compañía/empresa.

El Acces token es el token de acceso de la cuenta de Mercado Pago a la cual se acreditarán los cobros. Es asignado por Mercado Pago.

La relación será: una compañía podrá poseer un identificador de cuenta vendedor y una cuenta vendedor/retailer de MP podrá ser asociado a una compañía.

Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.1.1.3 Modificación de Datos de compañía MP

Para modificar, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados a la compañía MP, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.1.1.4 Eliminación de Datos de compañía MP

Para eliminar, se deberá seleccionar la misma haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana. Tener en cuenta que no podrá efectuarse la eliminación si existen datos relacionados a la compañía MP.


14.3.1.2 Configuración Datos de punto de venta

Descripción de la página:

Esta página permite efectuar la carga, consulta, eliminación y modificación de los puntos de venta para Mercado Pago que serán utilizados por VTOL CR / DB.


14.3.1.2.1 Búsqueda de Datos de punto de venta MP

Se cuenta con la opción de buscar los puntos de venta MP dados de alta en el sistema, seleccionando la compañía a la que corresponde la cuenta de MP, el nombre del local, la caja e ingresando el identificador del punto de venta (el identificador MP del punto de venta del retailer). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.

14.3.1.2.2 Carga automática de Datos de punto de venta MP

Para realizar una carga automática de datos de punto de venta MP, se debe seleccionar una Compañía del combo Compañía, y luego presionar el botón "Carga automática". No hace falta realizar una búsqueda previa. La Compañía es el único campo obligatorio que se debe completar. 

El sistema creará automáticamente un identificador único de punto de venta por Caja para todos los Locales de la Compañía seleccionada, esto realiza una asociación de Caja VTOL con Caja MP. El identificador creado se visualiza en la columna "Identificador punto de venta" y el mismo se genera de la siguiente manera: se concatena el código de la caja VTOL con el código de local VTOL, por ejemplo, si tenemos el local 2, y la caja 20, el código creado será: 00000000020000000020. 

La generación automática de los códigos de punto de venta se realizará sobre las cajas que no tengan generado un código. Si una caja ya tiene un código generado, entonces para esa caja no se volverá a generar. 

A su vez, ese código se puede modificar de forma manual y definir otro identificador.

Mercado Pago puede solicitar información del POS sobre los campos external_id y store_id. En VTOL estos campos se corresponden a:

  • external_id: es el Identificador de punto de venta creado en VTOL que identifica inequívocamente cada caja. Por ejemplo, si tenemos el local 2, y la caja 20, el código será: 00000000020000000020
  • store_id: es el código del Local creado en VTOL. Para el caso anterior, sería 0000000020


14.3.1.2.3 Generar código QR

Desde la consola de VTOL es posible generar códigos QR para cada caja, accediendo a la pantalla de Configuración de datos de punto de venta. Para ello se debe tener configurado el Identificador de punto de venta. Al presionar la acción "Descargar QR" el sistema generará un QR para la caja seleccionada. El mismo se podrá descargar e imprimir.


14.3.1.2.4 Alta de Datos de punto de venta MP

Para cargar un punto de venta MP se debe oprimir el botón "Crear" y seleccionar una compañía, el local, la caja e ingresar el código de identificador del punto de venta MP.

El Identificador punto de venta es un identificador único del punto de venta. Es un código alfanumérico definido por el retailer a nivel compañía y caja. No puede contener espacios ni caracteres especiales, y no se distinguen las mayúsculas de las minúsculas. Se podrá ingresar hasta 40 caracteres.

La relación será: una caja poseerá un identificador de punto de venta de MP y un punto de venta de MP podrá ser asociado a una caja del retailer.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.1.2.5 Modificación de Datos de punto de venta MP

Para modificar, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados al punto de venta MP, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.1.2.6 Eliminación de Datos de punto de venta MP

Para eliminar, se deberá seleccionar el registro haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.


14.3.2 Todo Pago

Acceso:
Para acceder a la configuración de Todo Pago que se manejará en el sistema, seleccionar la opción "Todo Pago" dentro del menú de Billeteras electrónicas (VTOL > Módulo CR / DB > Billeteras electrónicas > Todo Pago).

14.3.2.1 Datos de compañía

Descripción de la página:

Esta página permite efectuar la carga, consulta, eliminación y modificación de las compañías para Todo Pago que serán utilizados por VTOL CR / DB.


14.3.2.1.1 Búsqueda de Datos de compañía TP

Se cuenta con la opción de buscar las compañías TP dadas de alta en el sistema, seleccionando la compañía a la que corresponde la cuenta de TP e ingresando el identificador de la cuenta del vendedor (el identificador TP del retailer). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


14.3.2.1.2 Alta de Datos de compañía TP

Para cargar una compañía TP se debe oprimir el botón "Crear" y seleccionar una compañía e ingresar el código de identificatorio de la cuenta vendedor.

La relación será: una compañía podrá poseer un identificador de cuenta vendedor y una cuenta vendedor/retailer de TP podrá ser asociado a una compañía.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.2.1.3 Modificación de Datos de compañía TP

Para modificar, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados a la compañía TP, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartar. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.2.1.4 Eliminación de Datos de compañía TP

Para eliminar, se deberá seleccionar la misma haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana. Tener en cuenta que no podrá efectuarse la eliminación si existen datos relacionados a la compañía TP.


14.3.2.2 Datos de punto de venta

Descripción de la página:

Esta página permite efectuar la carga, consulta, eliminación y modificación de los puntos de venta para Todo Pago que serán utilizados por VTOL CR / DB.


14.3.2.2.1 Búsqueda de Datos de punto de venta TP

Se cuenta con la opción de buscar los puntos de venta TP dados de alta en el sistema, seleccionando la compañía a la que corresponde la cuenta de TP, el nombre del local, la caja e ingresando el identificador del punto de venta (el identificador TP del punto de venta del retailer). Una vez completados estos campos se debe presionar "Buscar" para que la búsqueda sea efectuada.


14.3.2.2.2 Alta de Datos de punto de venta TP

Para cargar un punto de venta TP se debe oprimir el botón "Crear" y seleccionar una compañía, el local, la caja e ingresar el código de identificatorio del punto de venta TP.

La relación será: una caja poseerá un identificador de punto de venta TP y un punto de venta de TP podrá ser asociado a una caja del retailer.
Presionar "Aceptar" para que el valor ingresado se guarde en el sistema o "Cancelar" si no se desea guardarlo. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.2.2.3 Modificación de Datos de punto de venta TP

Para modificar, se debe oprimir el botón "Modificar" correspondiente al registro seleccionado. Ante esto el sistema mostrará un formulario con los datos asociados al punto de venta TP, permitiendo cambiarlos.

Presionar "Aceptar" para guardar los cambios o "Cancelar" para descartarlos. Al presionar "Aceptar" se solicitará la confirmación de la acción mediante el despliegue de una ventana.


14.3.2.2.4 Eliminación de Datos de punto de venta TP

Para eliminar, se deberá seleccionar el registro haciendo clic sobre el checkbox correspondiente y luego presionar "Eliminar". Al presionar "Eliminar" se solicitará la confirmación de la eliminación mediante el despliegue de una ventana.


14.4 Configuración de propiedades

Se deberán configurar parámetros para poseer una comunicación óptima con los canales Mercado Pago y Todo Pago.

Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú: (Herramientas administrativas > Configuración).

Esta página permite configurar las distintas propiedades disponibles para las billeteras electrónicas 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. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".

A continuación, se explicarán las propiedades relacionadas a Billeteras Electrónicas.


Opciones de configuración de Mercado Pago:

PropiedadTipoDescripciónRequiere reiniciar?
Timeout para autorización Mercado PagoEnteroTiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización para Mercado PagoSi
Timeout de escritura para autorización Mercado PagoEnteroTiempo maximo en milisegundos de escritura de un requerimiento una transacción de autorización para Mercado PagoSi
Timeout de conexión para autorización Mercado PagoEnteroTiempo maximo en milisegundos que esperara para conectarse una transacción de autorización para Mercado PagoSi
Url de conexión con CA Mercado Pago para la ventaAlfanumérico

URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la venta.

Configurar con el valor: https://api.mercadolibre.com

Si
Url de conexión con CA Mercado Pago para la consulta de ventaAlfanumérico

URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la consulta de la venta.

Configurar con el valor: https://api.mercadolibre.com

Si
Url de conexión con CA Mercado Pago para la devolución de la ventaAlfanumérico

URL del centro autorizador Mercado Pago por el cual se establecerá la comunicación de la devolución de la venta.

Configurar con el valor: https://api.mercadolibre.com

Si
Maxima cantidad de dias para realizar devolución en Mercado PagoEnteroMaximo cantidad de dias para hacer devolucion en Mercado Pago 90 días desde su acreditacionSi
Maximo número de devoluciones parciales en Mercado PagoEnteroMaximo número de devoluciones parciales en Mercado Pago para un mismo pagoSi
Tiempo maximo de espera para notificación de venta en Mercado PagoEnteroTiempo maximo de espera para notificacion de venta en la billetera de Mercado PagoSi
Habilita al proceso de pasaje a historico de transacciones de billeteraTrue/FalseHabilita al proceso de pasaje a historico de transacciones de billeteraSi
Habilita el servicio de notificaciones SSL con Mercado PagoTrue/False

Indica si se encuentra habilitada la comunicación SSL/TLS entre Mercado Pago y VTOL.

Configurar con el valor: True.

Si
SSL: Almacen de certificados del servidor en Mercado PagoAlfanumérico

Ruta donde está el keystore que contiene los certificados del servidor para la comunicación segura SSL/TLS entre Mercado Pago y VTOL.

Ejemplo: D:\tools\wildfly-10.1.0.Final\CD3803\configuration\synthesis.keystore

Si
SSL: Contraseña del almacen de certificados del servidor con Mercado PagoAlfanuméricoContraseña de acceso al keystore que contiene los certificados del servidor para la comunicacion entre Mercado Pago y VTOLSi
URL Base de notificacion que usará mercado pagoAlfanumérico

URL donde VTOL recibira las notificaciones de Mercado Pago. A la misma se le adiciona la compania al final de la URL.

Ejemplo: locahost:8585/vtol/mpNotification/

Si


Info

Para el caso de Mercado Pago, es requerido abrir un puerto para que la plataforma de Mercado Pago llegue al servicio REST publicado por VTOL donde recibirá notificaciones de pago, bajo el protocolo seguro HTTPS (el puerto por defecto que VTOL abre es el 8585).


Opciones de configuración Todo Pago

PropiedadTipoDescripciónRequiere reiniciar?
Timeout para autorización Todo PagoEnteroTiempo de espera máximo en milisegundos para la recepción de la respuesta de una transacción de autorización desde Todo PagoSi
Habilita el servicio de notificaciones SSL con Todo PagoTrue/False

Indica si se encuentra habilitada la comunicación SSL/TLS entre Todo Pago y VTOL.

Configurar con el valor: True

Si
SSL: Almacen de certificados del servidor con Todo PagoAlfanuméricoRuta donde está el keystore que contiene los certificados del servidor para la comunicacion segura SSL/TLS entre Todo Pago y VTOLSi
SSL: Contraseña del almacen de certificados del servidor con Todo PagoAlfanuméricoContraseña de acceso al keystore que contiene los certificados del servidor para la comunicación entre Todo Pago y VTOLSi
Timeout de la notificación Todo PagoEnteroTimeout de la notificación de solicitud de compra enviada desde TodoPagoSi
Timeout para la Devolucion Todo PagoEnteroTiempo de espera máximo en milisegundos para la recepción de la respuesta de una Devolución desde Todo PagoSi
URL de conexión con CA TodoPago #0 (Nodo 01 al Nodo 10)AlfanuméricoURL del centro autorizador TodoPago #0 por el cual se establecerá la comunicación del Nodo 01 al Nodo 10Si
Timeout maximo de venta Todo PagoEnteroTiempo de espera máximo en milisegundos para completar la autorización de venta en Todo Pago, por defecto 5 minutosSi


15. Configuración Tokenización


La tokenización es un servicio utilizado para dotar de seguridad a las tarjetas, donde el número de tarjeta de crédito o débito (PAN) del cliente se sustituye por una serie de números generados aleatoriamente y algorítmicamente llamado "token". Esta herramienta se utiliza para evitar la duplicidad de datos de la tarjeta en un medio digital.


15.1 Configuración de números de comercio

La configuración de Tokenización es la misma para pagos con tarjetas.

Se deberán configurar los números de comercio para efectuar los pagos puntuales y también los números de comercio con la condición de pago de "Pagos recurrentes" para los pagos recurrentes; esto se realiza desde el punto de menú "Números de comercio y definición de lote".


15.2 Configuración de propiedades

Se deberán configurar los siguientes parámetros para que la funcionalidad de Tokenización funcione de forma adecuada.

Para acceder a la configuración de propiedades, presionar la opción denominada "Configuración" dentro del menú "Herramientas administrativas" (Herramientas administrativas > Configuración).

Esta página permite configurar las distintas propiedades disponibles para las billeteras electrónicas 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. Para operar adecuadamente la página, dirigirse al manual "VTOL CORE - Manual de usuario 3.8".

A continuación, se explicarán las propiedades relacionadas a Tokenización.


PropiedadTipoDescripciónRequiere reiniciar?
Timeout de escritura para envios de Token VISAEnteroTiempo máximo en milisegundos de escritura de un requerimiento de Token VISANo
Timeout de conexión para conexiones con el Token VISAEnteroTiempo máximo en milisegundos de conexión de un requerimiento de Token VISANo
Timeout de lectura para envios de Token VISAEnteroTiempo máximo en milisegundos de lectura de un requerimiento de Token VISANo
URL Token Publico VISAAlfanuméricoURL Token Publico VISA por el cual se establecerá la comunicaciónNo
URL Token Privado VISAAlfanuméricoURL Token Privado VISA por el cual se establecerá la comunicaciónNo
Tiempo maximo de espera para tokenizarEnteroTiempo máximo de espera para la tokenización de una tarjetaNo
Intervalo de tiempo para el envio de alertas por error de tokenizacionEnteroIntervalo de tiempo para el envío de alertas por si se producen erroresNo
Cantidad de errores para envio de alerta en tokenizacionEnteroCantidad de errores máximo para envió de alerta por error de tokenizaciónNo
Días conservación de token generados automaticamenteEnteroCantidad de días que se desea mantener la información de token (públicos y privados) generados automáticamente antes de ser depuradosNo
Proceso de depuracion token habilitadoTrue/FalseHabilita la depuración de token que se generaron automáticamente luego de un tiempo configuradoNo
IP utilizada para enviar en mensajes isoAlfanuméricoIP utilizada para enviar en mensajes ISO tokenizadosNo



  • Sem rótulos