Versões comparadas

Versão antiga 1

changes.mady.by.user José Daniel Valor

Gravado em

comparado com

Nova versão 2

changes.mady.by.user José Daniel Valor

Gravado em

Chave

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


image2018-8-28_13-20-49.pngImage RemovedImage Added



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

...

  • 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

...

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

...

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

...

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

...

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

Image Added

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:

Image Added

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