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

Versão 1 Próxima »


image2018-8-28_13-20-49.png


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.

TarjetaTextoSiUna cadena que identifica la tarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo)
EstablecimientoTextoSi

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ónFechaSi

Fecha del cupón. No lleva hora. Formato: ddmmaaaa

ImporteImporteSi

Importe de la operación.

Las devoluciones se indican con importe negativo.
MonedaNuméricoSiMoneda de la operación (Valores posibles: 1=Pesos, 2=Dólares)
Cantidad de CuotasNuméricoSiCantidad de cuotas en las que se realizó la venta. Si la operación no fue en cuotas debe completarse con el valor '1'.
OFF_LINELógicoSi

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 CierreFechaSi

Fecha y hora en la cual se realizó el cierre de lote de la terminal del cupón. Formato: ddmmaaaahhmmss

PlásticoTextoNo

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ónTextoNoNúmero del cupón de la operación.
LoteTextoNoNúmero del lote de la operación.
TerminalTextoNoTerminal de la operación.
Datos CupónTextoNoDatos adicionales del cupón. Pueden no completarse.
SubtarjetaTextoSi

Una cadena que identifica la subtarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo)

Porcentaje de PromociónImporteSiEste campo no se utiliza más. Se completa con cero por compatibilidad con los extractores de ventas de los clientes.
Código de AutorizaciónTextoNoCódigo de Autorización de la operación.
Indicador de cashbackNuméricoNo

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.

TarjetaTextoSiUna cadena que identifica la tarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo)
EstablecimientoTextoSi

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ónFechaSi

Fecha del cupón. No lleva hora. Formato: ddmmaaaa

ImporteImporteSi

Importe de la operación.

Las devoluciones se indican con importe negativo.
MonedaNuméricoSiMoneda de la operación (Valores posibles: 1=Pesos, 2=Dólares)
Cantidad de CuotasNuméricoSiCantidad de cuotas en las que se realizó la venta. Si la operación no fue en cuotas debe completarse con el valor '1'.
OFF_LINELógicoSi

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 CierreFechaSi

Fecha y hora en la cual se realizó el cierre de lote de la terminal del cupón. Formato: ddmmaaaahhmmss

PlásticoTextoNo

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ónTextoNoNúmero del cupón de la operación.
LoteTextoNoNúmero del lote de la operación.
TerminalTextoNoTerminal de la operación.
Datos CupónTextoNoDatos adicionales del cupón. Pueden no completarse.
SubtarjetaTextoSi

Una cadena que identifica la subtarjeta. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo)

Porcentaje de PromociónImporteSiEste campo no se utiliza más. Se completa con cero por compatibilidad con los extractores de ventas de los clientes.
Código de AutorizaciónTextoNoCódigo de Autorización de la operación.
ArancelImporteSi

Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS

Arancel de la operación.
Costo FinancieroImporteSi

Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS

Costo Financiero de la operación.
Descuento por PromociónImporteSi

Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS

Descuento por Promoción de la operación.
Alias BancoTextoNo

Solo para formato de archivo de Cupones AUDITAR CON CONCEPTOS

Alias PromociónTextoNo

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)		TextoSi

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


  • Sem rótulos