VTOL
Especificación Interfaces de salida
Cambios por revisiones
Fecha | Revisión | Cambios – Motivo |
---|---|---|
07/09/2020 | 1.0 | Creación del documento |
Índice
1. Introducción
1.1 Acerca de este documento
El presente documento ofrece una explicación de los formatos de archivo que exporta VTOL al generar las Interfaces de salida. VTOL permite informar las transacciones realizadas de forma automática y manual. Esto gracias al proceso de “interfaz de salida”.
Las transacciones se informan una sola vez, es decir, una vez que son generadas en una interfaz de salida, ya no podrán ser generadas en otras diferentes. No obstante, una vez generada una interfaz, con algún tipo de formato, la misma puede ser regeneradas en caso de ser necesario.
Las interfaces de salida de VTOL poseen diferentes formatos, que se describen a continuación.
2. Interfaces de salida de VTOL
En esta sección, se explicará de forma detallada cada formato de interfaz que genera VTOL, indicando cada campo que se exporta y la posición que ocupa cada uno dentro de los archivos de salida.
2.1 Interfaz Auditar V1
Descripción de la Interfaz
Desde la consola administrativa de VTOL es posible ejecutar la Interfaz de Auditar V1, la cual generará un archivo con todas las transacciones de tarjeta de crédito. Tendrá las siguientes características.
2.1.1 Nombre del archivo
TCaaaammddAR10####
Donde:
- TC: Nombre fijo del módulo para tiendas
- aaaammdd: Fecha de proceso (año, mes y día)
- AR10: Sociedad
- ####: Numeración secuencial entre archivos
2.1.2 Estructura de campos del registro
Se generará un archivo plano con la siguiente estructura:
Registro Cabecera (1 por Archivo)
Registro para Control de Totales
Descripción del Campo | Tipo Dato | Longitud | Observación |
---|---|---|---|
Fecha y hora del Archivo | NUM | 12 | ddmmaaaahhmm |
Cantidad de Registros del Archivo | NUM | 8 | ceros a la izquierda |
Importe total de Archivo | NUM | 12 | ceros a la izquierda; últimos dos dígitos son decimales |
Nota: El importe total del Archivo es teniendo en cuenta que los cupones suman y las NC restan.
Registro Detalle (N por Archivo) Cada registro representa una venta realizada con Tarjeta de Crédito.
Descripción del Campo | Tipo Dato | Longitud | Observación |
---|---|---|---|
Sucursal | CHAR | 6 |
|
Caja | CHAR | 3 | Nro. de caja que realizó la venta |
Maquina/Terminal | NUM | 10 | Nro. de terminal |
Comercio VTOL | NUM | 15 | Nro. Comercio según la tarjeta |
Fecha Cupón | NUM | 8 | aaaammdd |
Hora Cupón | NUM | 6 | hhmmss |
Tarjeta | CHAR | 3 | Código de tarjeta |
Plástico | CHAR | 20 | Nro. enmascarado: 6 dígitos + n * + 4 dígitos |
Nro. Cupón | NUM | 4 |
|
Cod. Autorización | CHAR | 6 |
|
Cuotas | NUM | 2 |
|
Importe | CHAR | 12 | 2 decimales sin signo ni puntos y comas |
Cupón = 01 / Anulaciones = 02 / NC = 03 | CHAR | 2 |
|
Moneda= P (Pesos) | CHAR | 1 |
|
Fecha cierre lote | NUM | 8 | aaaammdd |
Nro. Lote | NUM | 3 |
|
Usuario | CHAR | 8 |
|
Hora cierre lote | CHAR | 6 |
|
Debito=D/Crédito=C | CHAR | 1 |
|
Valor Fijo "A" | CHAR | 1 |
|
Factura | CHAR | 13 |
|
Nro.Ticket de pago | CHAR | 4 |
|
Tipo de Plan A=Acelerado / M=Mes a Mes | CHAR | 1 |
|
Intereses | CHAR | 2 | Fijo “SI” si el plan es con Intereses, sino, blanco |
Vacío 1 | CHAR | 23 | Antes era 25 |
Vacío 2 | CHAR | 25 |
|
Ejemplo de archivo de salida
A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:
07092020091500000007000000123870 000011003000000000300000000012345620200901030026EL 454073******6054 00011234560100000000509001P20200907001 091511DA A 000011002000000000200000000012345620200901034234EL 454073******6054 00011234560100000010000001P20200907001 091511DA A 000011001000000000100000000012345620200901034414EL 454073******6054 00011234560100000000509001P20200907001 091511DA A 000011002000000000200000000012345620200902060843VI 450799******0010 00021234560100000000509001P20200907001 091511CA A 000012001000000001100000002345678920200907090825VI 450979******1495 00011234560100000000400001P20200907001 091511CA A 000012001000000001100000002345678920200907091448VI 450979******1495 00021234560100000000450001P20200907001 091511CA A 000012001000000002200000000074185220200907092018MC 532360******9999 00010123450100000001000001P20200907001 092221CA A
Archivo en forma .txt
2.2 Interfaz Auditar V1.3c2
Descripción de la interfaz
Desde la consola administrativa de VTOL es posible ejecutar la Interfaz de Auditar V1.3c2, la cual generará un archivo con todas las transacciones de tarjeta de crédito. Tendrá las siguientes características.
Los registros que se graban en el archivo de salida, se duplican, desdoblando las transacciones que tienen cashback para poder informarlas por separado y agregando un campo que indique cual es cada una.
2.2.1 Nombre del archivo
CLddmmaaaa.txt
Donde:
- CL: Nombre fijo del módulo para tiendas
- ddmmaaaa: Fecha de proceso (día, mes, año)
2.2.2 Estructura de campos del registro
Se generará un archivo plano con la siguiente estructura:
Registro Detalle (N por Archivo) Cada registro representa una venta o devolución realizada con Tarjeta de Crédito.
Cada campo estará separado por pipe "|"
Descripción del Campo | Tipo Dato | Obligatorio | Observación |
---|---|---|---|
Empresa | Texto | Si | Una cadena que identifica la empresa. Debe coincidir con el campo Alias del formulario de actualización de empresas. |
Tarjeta | Texto | Si | Una cadena que identifica la tarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo) |
Establecimiento | Texto | Si | Una cadena que corresponde al número de comercio. Debe coincidir con el campo Alias Según Tarjeta del formulario de actualización de establecimientos. |
Fecha de Operación | Fecha | Si | Fecha del cupón. No lleva hora. Formato: ddmmaaaa |
Importe | Importe | Si | Importe de la operación. Las devoluciones se indican con importe negativo. |
Moneda | Numérico | Si | Moneda de la operación (Valores posibles: 1=Pesos, 2=Dólares) |
Cantidad de Cuotas | Numérico | Si | Cantidad de cuotas en las que se realizó la venta. Si la operación no fue en cuotas debe completarse con el valor '1'. |
OFF_LINE | Lógico | Si | Indica si la forma de presentación del cupón fue Offline. Disponible a partir de la VERSION=1 Valores posibles: S --> indica presentación offline N --> indica presentación online |
Fecha de Cierre | Fecha | Si | Fecha y hora en la cual se realizó el cierre de lote de la terminal del cupón. Formato: ddmmaaaahhmmss |
Plástico | Texto | No | Número de tarjeta del cupón de la operación. Enmascarado. Se podrá configurar AudiTar para que este dato venga encriptado. |
Nro. de Cupón | Texto | No | Número del cupón de la operación. |
Lote | Texto | No | Número del lote de la operación. |
Terminal | Texto | No | Terminal de la operación. |
Datos Cupón | Texto | No | Datos adicionales del cupón. Pueden no completarse. |
Subtarjeta | Texto | Si | Una cadena que identifica la subtarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo) |
Porcentaje de Promoción | Importe | Si | Este campo no se utiliza más. Se completa con cero por compatibilidad con los extractores de ventas de los clientes. |
Código de Autorización | Texto | No | Código de Autorización de la operación. |
Indicador de cashback | Numérico | No | Si es una venta sin cashback se informa con el agregado del |2. Si es una transacción con ExtraCash, se crea un registro del tipo |2 con el monto de la transacción de venta (sin la suma del cashback) y un registro del tipo |6 con el monto del cashback. |
Ejemplo de archivo de salida
A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:
Walmart|MASTER|789456|11092020|10000|1|1|S|11092020050329|510550xxxxxx7785|12|2|00000001|170154|MASTER|0|012345 Walmart|MASTER|789456|11092020|10000|1|1|S|11092020050329|510550xxxxxx7785|12|2|00000001|170154|MASTER|0|012345|2 Walmart|MASTER|789456|11092020|9000|1|1|S|11092020050329|510550xxxxxx7785|12|2|00000001|170154|MASTER|0|012345|6 Walmart|VISA|123456|11092020|21000|1|1|S|11092020050329|450799xxxxxx7787|4|2|00000011|170210|VISA|0|123456 Walmart|VISA|123456|11092020|21000|1|1|S|11092020050329|450799xxxxxx7787|4|2|00000011|170210|VISA|0|123456|2 Walmart|VISA|123456|11092020|-21000|1|1|S|11092020050329|450799xxxxxx7787|5|2|00000011|170210|VISA|0|123456 Walmart|VISA|123456|11092020|-21000|1|1|S|11092020050329|450799xxxxxx7787|5|2|00000011|170210|VISA|0|123456|2 Walmart|VISA|123456|11092020|15500|1|1|S|11092020050329|450979xxxxxx1495|6|2|00000011|170223|VISA|0|123456 Walmart|VISA|123456|11092020|15500|1|1|S|11092020050329|450979xxxxxx1495|6|2|00000011|170223|VISA|0|123456|2 Walmart|VISA|123456|11092020|10900|1|1|S|11092020050329|450979xxxxxx1495|7|2|00000011|170249|VISA|0|123456 Walmart|VISA|123456|11092020|10900|1|1|S|11092020050329|450979xxxxxx1495|7|2|00000011|170249|VISA|0|123456|2
2.3 Interfaz Auditar V1.4
Descripción de la interfaz
Desde la consola administrativa de VTOL es posible ejecutar la Interfaz de Auditar V1.4, la cual generará un archivo con todas las transacciones de tarjeta de crédito. Tendrá las siguientes características.
2.3.1 Nombre del archivo
CLddmmaaaa.txt
Donde:
- CL: Nombre fijo del módulo para tiendas
- ddmmaaaa: Fecha de proceso (día, mes, año)
2.3.2 Estructura de campos del registro
Se generará un archivo plano con la siguiente estructura:
Registro Detalle (N por Archivo) Cada registro representa una venta o devolución realizada con Tarjeta de Crédito.
Cada campo estará separado por pipe "|"
Descripción del Campo | Tipo Dato | Obligatorio | Observación |
---|---|---|---|
Empresa | Texto | Si | Una cadena que identifica la empresa. Debe coincidir con el campo Alias del formulario de actualización de empresas. |
Tarjeta | Texto | Si | Una cadena que identifica la tarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo) |
Establecimiento | Texto | Si | Una cadena que corresponde al número de comercio. Debe coincidir con el campo Alias Según Tarjeta del formulario de actualización de establecimientos. |
Fecha de Operación | Fecha | Si | Fecha del cupón. No lleva hora. Formato: ddmmaaaa |
Importe | Importe | Si | Importe de la operación. Las devoluciones se indican con importe negativo. |
Moneda | Numérico | Si | Moneda de la operación (Valores posibles: 1=Pesos, 2=Dólares) |
Cantidad de Cuotas | Numérico | Si | Cantidad de cuotas en las que se realizó la venta. Si la operación no fue en cuotas debe completarse con el valor '1'. |
OFF_LINE | Lógico | Si | Indica si la forma de presentación del cupón fue Offline. Disponible a partir de la VERSION=1 Valores posibles: S --> indica presentación offline N --> indica presentación online |
Fecha de Cierre | Fecha | Si | Fecha y hora en la cual se realizó el cierre de lote de la terminal del cupón. Formato: ddmmaaaahhmmss |
Plástico | Texto | No | Número de tarjeta del cupón de la operación. Enmascarado. Se podrá configurar AudiTar para que este dato venga encriptado. |
Nro. de Cupón | Texto | No | Número del cupón de la operación. |
Lote | Texto | No | Número del lote de la operación. |
Terminal | Texto | No | Terminal de la operación. |
Datos Cupón | Texto | No | Datos adicionales del cupón. Pueden no completarse. |
Subtarjeta | Texto | Si | Una cadena que identifica la subtarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo) |
Porcentaje de Promoción | Importe | Si | Este campo no se utiliza más. Se completa con cero por compatibilidad con los extractores de ventas de los clientes. |
Código de Autorización | Texto | No | Código de Autorización de la operación. |
Arancel | Importe | Si | Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS Arancel de la operación. |
Costo Financiero | Importe | Si | Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS Costo Financiero de la operación. |
Descuento por Promoción | Importe | Si | Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS Descuento por Promoción de la operación. |
Alias Banco | Texto | No | Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS |
Alias Promoción | Texto | No | Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS |
Ejemplo de archivo de salida
A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:
Walmart|VISA|123456|01092020|5090|1|3|S|07092020091511|454073xxxxxx6054|1|1|00000003|150026|VISA ELECTRON|0|123456|000|000|000|| Walmart|VISA|123456|01092020|100000|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000002|154234|VISA ELECTRON|0|123456|000|000|000|| Walmart|VISA|123456|01092020|5090|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000001|154414|VISA ELECTRON|0|123456|000|000|000|| Walmart|VISA|123456|02092020|5090|1|1|S|07092020091511|450799xxxxxx0010|2|1|00000002|180843|VISA|0|123456|000|000|000|| Walmart|VISA|23456789|07092020|4000|1|1|S|07092020091511|450979xxxxxx1495|1|1|00000011|090825|VISA|0|123456|000|000|000|| Walmart|VISA|23456789|07092020|4500|1|1|S|07092020091511|450979xxxxxx1495|2|1|00000011|091448|VISA|0|123456|000|000|000|| Walmart|MASTER|741852|07092020|10000|1|1|S|07092020092221|532360xxxxxx9999|1|1|00000022|092018|MASTER|0|012345|000|000|000|| Walmart|VISA|23456789|11092020|21000|1|1|S|11092020105722|450799xxxxxx7787|3|2|00000011|105538|VISA|0|123456|000|000|000|| Walmart|VISA|23456789|11092020|-21000|1|1|S|11092020105722|450799xxxxxx7787|4|2|00000011|105538|VISA|0|123456|000|000|000||
2.4 Interfaz Auditar V1.4 AdditionalData
Descripción de la interfaz
La interface Auditar 1.4 AdditionalData es una extensión de la interface Auditar 1.4, que permite incluir en la interface el valor recibido en el campo AdditionalData del mensaje enviado por el Punto de Venta.
El valor del campo se incluye en la interface tal como viene desde el Punto de Veta. Es decir, no se le realiza ninguna operatoria adicional.
2.4.1 Nombre del archivo
CLddmmaaaa.txt
Donde:
- CL: Nombre fijo del módulo para tiendas
- ddmmaaaa: Fecha de proceso (día, mes, año)
2.4.2 Estructura de campos del registro
La estructura del archivo generado es el mismo al de la interface Auditar 1.4, con el agregado del campo AdditionalData. Dicho campo se incluye al final del archivo.
A continuación se especifica el campo AdditionalData:
Descripción del Campo | Tipo Dato | Obligatorio | Observación |
---|---|---|---|
AdditionalMessageData | Texto | No | Se guarda un código de 6 dígitos que viene informado desde el POS. |
Ejemplo de archivo de salida
A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:
Walmart||123456|01092020|5090|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000003|150026||0|123456|000|000|000|||| Walmart||123456|01092020|100000|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000002|154234||0|123456|000|000|000|||| Walmart||123456|01092020|5090|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000001|154414||0|123456|000|000|000|||| Walmart|VISA|123456|02092020|5090|1|1|S|07092020091511|450799xxxxxx0010|2|1|00000002|180843|VISA|0|123456|000|000|000|||| Walmart|VISA|23456789|07092020|4000|1|1|S|07092020091511|450979xxxxxx1495|1|1|00000011|090825|VISA|0|123456|000|000|000|||| Walmart|VISA|23456789|07092020|4500|1|1|S|07092020091511|450979xxxxxx1495|2|1|00000011|091448|VISA|0|123456|000|000|000|||| Walmart|MASTER|741852|07092020|10000|1|1|S|07092020092221|532360xxxxxx9999|1|1|00000022|092018|MASTER|0|012345|000|000|000|||| Walmart|VISA|23456789|11092020|21000|1|1|S|11092020105722|450799xxxxxx7787|3|2|00000011|105538|VISA|0|123456|000|000|000|||| Walmart|VISA|23456789|11092020|-21000|1|1|S|11092020105722|450799xxxxxx7787|4|2|00000011|105538|VISA|0|123456|000|000|000||||
2.5 Interfaz Auditar V1.4 AdditionalData TrxType
Descripción de la interfaz
La interface Auditar 1.4 AdditionalData TrxType es una extensión de la interface Auditar 1.4, que permite incluir en la interface el valor recibido en el campo AdditionalData del mensaje enviado por el Punto de Venta y un código que representa el tipo de transacción.
El valor del campo se incluye en la interface tal como viene desde el Punto de Veta. Es decir, no se le realiza ninguna operatoria adicional.
2.4.1 Nombre del archivo
CLddmmaaaa.txt
Donde:
- CL: Nombre fijo del módulo para tiendas
- ddmmaaaa: Fecha de proceso (día, mes, año)
2.4.2 Estructura de campos del registro
La estructura del archivo generado es el mismo al de la interface Auditar 1.4, con el agregado de los campos AdditionalData y TrxType. Dichos campos se incluyen al final del archivo.
A continuación se especifica los campos específicos de esta interfaz:
Descripción del Campo | Tipo Dato | Obligatorio | Observación |
---|---|---|---|
AdditionalMessageData | Texto | No | Se guarda un código de 6 dígitos que viene informado desde el POS. |
Tipo de Transacción (trxType) | Texto | Si | Valor que permite identificar el tipo de transacción de la transacción, por ejemplo: Sale = Compra VoidSale = Anulación de venta Refund = Devolución (ver anexo tabla tipo de transacciones) |
Ejemplo de archivo de salida
A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:
Walmart|VISA|123456|01092020|5090|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000003|150026|VISA ELECTRON|0|123456|000|000|000||||000 Walmart|VISA|123456|01092020|100000|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000002|154234|VISA ELECTRON|0|123456|000|000|000||||000 Walmart|VISA|123456|01092020|5090|1|1|S|07092020091511|454073xxxxxx6054|1|1|00000001|154414|VISA ELECTRON|0|123456|000|000|000||||000 Walmart|VISA|123456|02092020|5090|1|1|S|07092020091511|450799xxxxxx0010|2|1|00000002|180843|VISA|0|123456|000|000|000||||000 Walmart|VISA|23456789|07092020|4000|1|1|S|07092020091511|450979xxxxxx1495|1|1|00000011|090825|VISA|0|123456|000|000|000||||000 Walmart|VISA|23456789|07092020|4500|1|1|S|07092020091511|450979xxxxxx1495|2|1|00000011|091448|VISA|0|123456|000|000|000||||000 Walmart|MASTER|741852|07092020|10000|1|1|S|07092020092221|532360xxxxxx9999|1|1|00000022|092018|MASTER|0|012345|000|000|000||||000 Walmart|VISA|23456789|11092020|21000|1|1|S|11092020105722|450799xxxxxx7787|3|2|00000011|105538|VISA|0|123456|000|000|000||||000 Walmart|VISA|23456789|11092020|-21000|1|1|S|11092020105722|450799xxxxxx7787|4|2|00000011|105538|VISA|0|123456|000|000|000||||300
2.3 Anexo de Interfaces de Auditar
Tipo de transacciones
Tipo de transacciones | ||
---|---|---|
Código | Valor | Descripción |
000 | Sale | Compra |
002 | VoidSale | Anulación de Venta |
300 | Refund | Devolución |
302 | VoidRefund | Anulación de devolución |
020 | SaleCashBack | Compra con extracción de efectivo solamente |
022 |
| Anulación Compra con extracción de efectivo solamente |
200 | CashBanck | Extracción de efectivo |
202 | VoidCashBack | Anulación de extracción de efectivo |
500 | ServicePayment | Pago de servicio |
502 | VoidServicePayment | Anulación de pago de servicio |
Alias de tarjetas
Tarjetas principales
Alias de Tarjetas | Alias de Subtarjetas |
---|---|
VISA | VISA ELECTRON |
MASTER
| MASTER |
MAESTRO | |
LIDER | |
AMEX | AMEX |
DINERS | DINERS |
NARANJA | NARANJA |
CABAL | CABAL |
CREDENCIAL
| CREDENCIAL |
CORDOBESA | |
EFICAZ | |
MONTEMAR |
Otras tarjetas
Alias de Tarjetas | Alias de Subtarjetas |
---|---|
BANCAT | BANCAT |
CARTA_AUTOMATICA | CARTA_AUTOMATICA |
CETELEM | CETELEM |
CONFIABLE | CONFIABLE |
CONFINA | CONFINA |
CREDENCIAL | CREDENCIAL |
CREDIAL | CREDIAL |
CREDICASH | CREDICASH |
DATA2000 | DATA2000 |
ELEBAR | ELEBAR |
EMPRESUR | EMPRESUR |
FAVACARD | FAVACARD |
FIEL | FIEL |
ITALCRED | ITALCRED |
KADICARD | KADICARD |
MONTEMAR | MONTEMAR |
NEVADA | NEVADA |
PATAGONIA | PATAGONIA |
PLATINO | PLATINO |
REDONDA | REDONDA |
SALTCARD | SALTCARD |
SOL | SOL |
SUCREDITO | SUCREDITO |
TSHOPPING | TSHOPPING |
WALMART | WALMART |