Versões comparadas

Versão antiga 2

changes.mady.by.user José Daniel Valor

Gravado em

comparado com

Nova versão 3

changes.mady.by.user José Daniel Valor

Gravado em

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.




VTOL

Especificación Interfaces de salida



Cambios por revisiones

Fecha

Revisión

Cambios – Motivo

07/09/2020

1.0

Creación del documento

09/04/20211.1Agregado de interfaz Auditar para billetera Cuenta DNI
27/06/20221.2Agregado de Interfaz Auditar V1.5 Multiempresa



Índice

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

Âncora
IAV14
IAV14
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:

Bloco de código
languagetext
linenumberstrue
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

View file
nameTC20200907AR100002.txt
height150


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:

Bloco de código
languagetext
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:

Bloco de código
languagetext
linenumberstrue
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:

Bloco de código
languagetext
linenumberstrue
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:

Bloco de código
languagetext
linenumberstrue
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.6 Interfaz Auditar Billeteras electrónicas - Cuenta DNI

Descripción de la interfaz

Desde la consola administrativa de VTOL es posible ejecutar la Interfaz de Auditar Billeteras electrónicas, para Cuenta DNI, la cual generará un archivo con todas las transacciones de Cuenta DNI. 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 operación realizada con Cuenta DNI.

Descripción del Campo

Tipo Dato

Longitud

Observación

Sucursal

CHAR

6

N/A 

Caja

CHAR

3

N/A

Número de Terminal

NUM

10

peiTerminalId

Número de Comercio

NUM

15

peiCommerceId

Fecha de transacción (YYYYMMDD)

NUM

8

clientDate (solo fecha) formato: aaaammdd

Hora de transacción (HHMMSS)

NUM

6

clientDate (solo hora) formato: hhmmss

Tarjeta

CHAR

3

Enviar siempre: CD (Cuenta DNI)

Número de tarjeta

CHAR

20

IdOperationPEI

Nro. Cupón

NUM

4

N/A 

Cod. Autorización

CHAR

6

N/A 

Cuotas

NUM

2

N/A 

Importe

CHAR

12

amount

Tipo de operación

CHAR

2

(01 = COMPRA, 02 = ANULACION, 03 = DEVOLUCION)

Moneda= P (Pesos)

CHAR

1

currencyPosCode (convertir a P) 

Fecha cierre lote

NUM

8

N/A

Nro. Lote

NUM

3

N/A 

Código de respuestaNUM2responseMessage (transformación a número)
Modo operaciónNUM1Enviar siempre: N (Online)

Legajo del cajero

CHAR

8

N/A

Hora cierre lote

CHAR

6

N/A 

Tipo de tarjeta Debito=D/Crédito=C

CHAR

1

N/A 

Modo de ingreso

CHAR

1

 posInputMode (S = SoftToken o B = BarCode)

Factura

CHAR

12

bankingRefNum 

Nro.Ticket de pago

CHAR

4

N/A 

Código de banco

CHAR

3

N/A 

Carriage return

CHAR

3

N/A

Line free

CHAR

25

N/A


EJEMPLO DE ARCHIVO DE SALIDA

A continuación se muestra un ejemplo de un archivo de salida generado por VTOL:

Bloco de código
languagetext
linenumberstrue
07042021105600000001000000001000
0000000000000000001       2suc177720210407105612 CD 4969999999999999496000000000000        100001P0000000000000N000000000000000B      12345600000000000000000000000000000000000


2.7 Interfaz Auditar V1.5 Multiempresa.

Descripción de la interfaz

Desde la consola administrativa de VTOL es posible ejecutar la Interfaz de Auditar V1.5 Multiempresa , la cual generará un archivo de salida con todas las transacciones de tarjeta de crédito - débito por cada compañía que tenga habilitada la interfaz. Esta versión también permite habilitar el envío de SFTP. A continuación, se detallan las características:

2.7.1 Nombre del archivo de salida

CLddmmaaaa_COMPANY1.txt.

Donde:

  • CL: Nombre fijo del módulo para tiendas
  • ddmmaaaa: Fecha de proceso (día, mes, año)
  • COMPANY1: código de la compañía.

2.7.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 -  Debito.

Cada campo estará separado por pipe "|". Se especifican todos los campos que tiene el archivo de salida y en color azul los cambios definidos en la versión 2 del documento de especificación de ventas para Auditar que corresponde a cambios en las columnas "Cantidad de cuotas" y "Marca campaña", como se muestra a continuación:

Campo (columna)

Formato

Obligatorio

Descripción del campo

Empresa

Texto

SI

Una cadena que identifica la empresa. Debe coincidir con el campo Alias del formulario de actualización de empresas.

Se recomiendan nombres simples, cortos, sin puntos, espacios, etc. Con este mismo alias, el usuario va a tener un directorio, así que hay que pensar en su comodidad.

Adquirente

Texto

NO

Disponible a partir de la versión 6.5 que incorpora la multi-adquirencia.

Por compatibilidad con versiones anteriores este dato no es obligatorio.

Si no viene AudiTar trata de deducirlo a partir del Medio de Pago y del Establecimiento.

Medio de Pago

Texto

SI

Una cadena que identifica el medio de pago. Debe coincidir con los alias válidos definidos por AudiTar. (Ver anexo)

Establecimiento

Texto

SI

Una cadena que identifica el establecimiento. Debe coincidir con el campo Alias Según Tarjeta del formulario de actualización de establecimientos.

Para saber que datos enviar, consultar las liquidaciones que su empresa recibe impresas actualmente, donde figuran los códigos de establecimientos.

Fecha de Operación

Fecha

SI

Fecha del cupón.

Atención: Ver formato fecha. No lleva hora.

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=Peso Argentino, 2=Dólar, 3=Peso Uruguayo, 4=Peso Mexicano.

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

Para el caso de los planes Ahora se deberá informar las cuotas reales. Por ejemplo, si el plan ahora corresponde a 3 cuotas, deberá completarse la columna "Cantidad Cuotas" del txt con el valor 3 y así respectivamente con los planes de 6, 12, 18 y 24 cuotas. 

OFF_LINE

Lógico

SI

Indica si la forma de presentación del cupón fue OffLine.

S   --> indica presentación offline

N ó cualquier otro valor  --> indica presentación online

Fecha de Cierre de Lote

Fecha-Hora

SI

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

Ver recomendación debajo de este cuadro.

Plástico/ID

Texto

NO

Número de Plástico o Identificador.

Se podrá configurar AudiTar para que este dato venga encriptado. Ver Anexo “Encriptación de Número de Tarjeta” para detalles sobre modo de encriptación.

Nro. de Cupón

Texto

NO

Número del cupón de la operación. No puede superar los 40 caracteres.

Ver Observaciones MP si está implementando el Medio de Pago Mercado Pago.

Lote

Texto

NO

Número del lote de la operación. No puede superar los 40 caracteres.

Terminal

Texto

NO

Terminal de la operación. No puede superar los 40 caracteres.

Datos Cupón

Texto

NO

Datos adicionales del cupón. Pueden no completarse. Máximo 400 caracteres. En caso de ser necesario colocar más de un dato en el mismo campo se puede utilizar algún separador que no coincida con que se haya elegido como principal y que cumpla con las mismas restricciones descriptas más arriba. Tener en cuenta que el valor indicado no será dividido en diferentes campos en AudiTar y no se utilizará como dato conciliatorio.

Submedio de pago

Texto

SI

Este campo se mantiene por compatibilidad y debe coincidir con el valor informado en la columna Medio de Pago (Alias del medio de pago).

Porcentaje de Promoción

Importe

SI

Valor que permite informar si la venta está promocionada a través de una entidad bancaria.

Debe informarse en porcentaje de la promoción de acuerdo al formato de importes. (Ejemplo: Si es 5% enviar 500). Debe ser mayor o igual a cero.

Este campo no se utiliza mas. Poner en 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. No puede superar los 10 caracteres.

Marca Campaña

Texto

NO

Marca de la Campaña para identificar la Promoción que se aplica sobre el cupón. No puede superar los 10 caracteres. Este valor debe ser idéntico al que se utiliza en la configuración de la promoción respetando las mayúsculas y minúsculas.

Un caso particular de este campo será si se tiene implementado el uso de retiro en efectivo. Ver Anexo. También se puede presentar el caso de las ventas promocionadas a través de planes de Gobierno “Ahora_X”, en donde se deberá identificar cada plan con la cantidad de cuota real que corresponde y especificar la descripción en este campo con la siguiente información:  AHORA_3, AHORA_6, AHORA_12, AHORA_18 o AHORA_24.

Alias del Banco

Texto

NO

Alias del Banco al que corresponde la tarjeta. Se utiliza para determinar la promoción que aplica sobre el cupón. No puede superar los 40 caracteres. Este valor debe ser idéntico al que se utiliza en la configuración del banco respetando las mayúsculas y minúsculas.

Alias del Producto Bancario

Texto

NO

Alias del Producto Bancario al que corresponde la tarjeta. Se utiliza para determinar la promoción que aplica sobre el cupón. No puede superar los 40 caracteres.

Este valor debe ser idéntico al que se utiliza en la configuración del producto bancario respetando las mayúsculas y minúsculas.

Id. Externo

Texto

NO

Identificador externo para el caso de medios de pago que identifican las ventas con datos distintos a los estándar.

Para poder conciliar por Id.Externo es importante que el valor venga informado en los archivos de venta de la misma manera que lo arma el formato de liquidaciones correspondiente.

Consulte con New Technlogies cómo lo arman los formatos que lo utilizan.

Este dato está disponible a partir de la versión 6.2 de AudiTar.

Ver Observaciones MP si está implementando el Medio de Pago Mercado Pago.

Ejemplo de archivo de salida

2.7.3 Funcionalidad Habilitar el envío de SFTP

La Interfaz Auditar V1.5 Multiempresa permite habilitar la opción para realizar envíos de SFTP, para esto es necesario cargar primero los siguientes datos de configuración del SFTP:

  • Habilita SFTP: indica si se habilita o no el sftp para la compañía seleccionada. Existe la posibilidad de dejar configurado los datos para que luego el usuario pueda habilitar el envío del archivo a la ruta.
  • Url SFTP: IP o ruta del servidor donde se desea enviar el archivo.
  • Puerto, Usuarios y Clave SFTP: son datos necesarios que se tienen que indicar.
  • Tiempo de espera para sesión y tiempo de espera para canal SFTP. Si supera el tiempo descrito en los campos mencionados no se puede realizar la transferencia.
  • Archivo de host conocidos: se debe indicar el nombre del archivo de host conocidos con el path completo. A continuación, se muestra un ejemplo del archivo generado:
"[200.59.130.99]:22022 ssh-rsa AAAAB3NzaC1yc2EAAAABIwAAAIEAv0Y1dFjshmBOJQtnBuha4qy0gxRrIkIxHoa2++kkjg8v31xwuHbq4Ka7v0sLAKnn3q7ORuBb7wHR+vhyBf1QeMgSkxw5wOijqCAjhIHbVevh0lRLxzrwO6YeuGaG5fziT0aKNkeLHSuhgWACp2DiTdR89otraGQttwaX+k7X4I8="


Los datos se guardan en la tabla Tabla CoreInterfaceCompany de la base de datos.

A continuación se muestra la pantalla de la consola de VTOL donde se deben ingresar los datos:

3. Anexo de Interfaces de Auditar

Âncora
tipoTransaccion
tipoTransaccion
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