Manual de Integración POS Intergrado (Último)

MANUAL DE DESARROLLO POS INTEGRADO

Manual Integración POS Integrado

Versión 2.2

Contenido CONTROL DE CAMBIOS ................................................................................................................................ 4 1.

OBJETIVO ............................................................................................................................................. 6

2.

REQUERIMIENTOS DE HARDWARE ....................................................................................................... 6

3.

TRANSACCIONES SOPORTADAS............................................................................................................ 7 3.1 TRANSACCIÓN DE VENTA ................................................................................................................................. 7 3.2 TRANSACCIÓN ÚLTIMA VENTA ......................................................................................................................... 8 3.3 TRANSACCIÓN ANULACIÓN VENTA .................................................................................................................... 8 3.4 TRANSACCIÓN DE CIERRE. ............................................................................................................................... 9 3.5 TRANSACCIÓN DETALLE DE VENTAS ................................................................................................................... 9 3.6 TRANSACCIÓN TOTALES .................................................................................................................................. 9 3.7 TRANSACCIÓN CARGA DE LLAVES ...................................................................................................................... 9 3.8 TRANSACCIÓN DE POOLING............................................................................................................................ 10 3.9 CAMBIO DE MODALIDAD A POS NORMAL ........................................................................................................ 10

4.

DIAGRAMAS DE SECUENCIA ............................................................................................................... 10 4.1 VENTA ....................................................................................................................................................... 10 4.2 ÚLTIMA VENTA ........................................................................................................................................... 11 4.3 ANULACIÓN ................................................................................................................................................ 12 4.4 CIERRE....................................................................................................................................................... 13 4.5 CARGA DE LLAVES ........................................................................................................................................ 14 4.6 POOLING .................................................................................................................................................... 15

5.

ESPECIFICACIÓN DE PROTOCOLO DE COMUNICACIÓN CAJA - POS ..................................................... 15 5.1 ESQUEMA DE COMUNICACIÓN CAJA - POS ....................................................................................................... 15 5.2 FLUJO DE LA COMUNICACIÓN CAJA - POS ........................................................................................................ 16

6.

MENSAJERÍA DE COMANDOS ............................................................................................................. 16 CONSIDERACIONES GENERALES DE MENSAJERÍA ...................................................................................................... 16 6.1 VENTA ....................................................................................................................................................... 17

Página 2


Versión 2.2

6.2 ÚLTIMA VENTA ........................................................................................................................................... 19 6.3 ANULACIÓN ................................................................................................................................................ 21 6.4 CIERRE....................................................................................................................................................... 22 6.5 DETALLE DE VENTAS ..................................................................................................................................... 23 6.6 TOTALES .................................................................................................................................................... 26 6.7 CARGA DE LLAVES ........................................................................................................................................ 27 6.8 POOLING .................................................................................................................................................... 28 6.9 CAMBIO DE MODALIDAD A POS NORMAL ........................................................................................................ 28 7.

VOUCHER ........................................................................................................................................... 29

8.

FLUJOS DE VENTA Y OTROS ................................................................................................................ 30 8.1 FLUJO TX 3.20 CON BOLETA, PROPINA, EMPLEADO ............................................................................................ 30 8.2 FLUJO TX 3.20 SIN BOLETA, PROPINA, EMPLEADO.............................................................................................. 30 8.4 FLUJO TX 3.40 SIN BOLETA, PROPINA, EMPLEADO.............................................................................................. 32 8.6 CAMBIO DE MODALIDAD POS INTEGRADO A POS NORMAL ................................................................................. 33

9.

TIPOS DE CONEXIÓN A POS ................................................................................................................ 34 9.1 CONEXIÓN POS CON CABLE SERIAL ................................................................................................................. 34 9.2 CONEXIÓN POS CON CABLE LAN PARA COMUNICACIÓN CON TRANSBANK .............................................................. 35 9.3 CONEXIÓN POS CON CABLE TELEFÓNICO PARA COMUNICACIÓN CON TRANSBANK ................................................ 36

10.

TABLA ABREVIACIÓN DE TARJETAS................................................................................................. 37

11.

TABLA DE RESPUESTAS ................................................................................................................... 38

12.

ANEXO 1 ......................................................................................................................................... 39

13.

ANEXO 2: DETALLE CAMPOS DE CADA TRANSACCIÓN .................................................................... 42

Página 3

Manual Integración

Versión 2.2

POS Integrado

Control de Cambios

Versión 1.1

Cambio 

Manual original de equipo VX-700.

Responsable

Fecha

Andrés

Oct-2011

Villalobos 1.2



Andrés

Se incorpora funcionalidad de Cuadratura.

Feb-2012

Villalobos 1.3

1.4

1.5



Se modifica tabla con funciones del POS

Andrés



Se incorpora información de seguridad a petición de H&M.

Villalobos



Se incorpora la explicación de las variables que utilizan los

Andrés

comandos.

Villalobos



Se actualiza el flujo cambio de modalidad POS Integrado.

Andrés



Se incorpora tabla con abreviación de tarjetas a petición de

Villalobos



Se elimina la opción de envío de mensajes intermedios.



Se elimina la opción de enviar Cuotas en una transacción

Andrés

de venta.

Villalobos

Mar-2012

Abr-2012

Jun-2012

Ópticas Schilling.

1.6



Jun-2012

Se elimina la opción de enviar el voucher pintado para las transacciones de POS Integrado.

1.7



Se

eliminan mensajes

de

envío

de

voucher

para

transacciones de detalle de ventas y total de ventas. 

Se detalla proceso de envío de Detalle de Transacciones.



Se incorpora la funcionalidad de Mensajes Intermedios

Andrés

Jul-2012

Villalobos

para una transacción de Venta. 

Se incorpora comando para cambio de modalidad a POS Normal

1.8



Cambio de estructura del documento.

Sebastián



Se eliminan referencias en texto y mensajería a impresión

González

de Voucher opcional (Solo imprime POS). 

Se elimina información detallada de Voucher.



Se ajusta mensajería de transacciones a aplicativo POS.



Las cuotas son ingresadas en el POS.



Actualización Flujos de Venta y Otros.



Excel Incrustado se agrega como anexo en el documento.

Página 4

Oct-2012

Manual Integración

Versión 2.2

POS Integrado

1.9

 

Se agregan los siguientes campos en la transacción de

Andrés

venta; Empleado, Propina

Villalobos

Oct-2012

Se agregan los siguientes campos en la transacción de Ultima Venta; Numero Cuotas, Monto Cuotas, Empleado, Propina



Se agregan los siguientes campos en la transacción de Detalle de Ventas; Empleado, Propina, Monto Cuotas, Numero Cuotas.



Estos cambios permiten obtener la misma información de respuesta a la caja en las tres transacciones mencionadas



Se agrega el comando que permite informar a la caja que la transacción fue cancelada desde el POS.

2.0



Se remplaza la palabra HOST por Autorizador

Andres

Ene-2013

Villalobos 2.2



Se elimina la referencias a modelo POS Vx510

Marcelo



Se cambian imágenes de conexión de Vx510 por Vx520 sin

Oteiza

hacer referencia a él.

Página 5

Julio-2014


Versión 2.2

1. Objetivo El siguiente documento tiene por objetivo especificar las funcionalidades que debe implementar un proveedor de software para utilizar un POS Integrado, y realizar transacciones con tarjetas Crédito/Debito con Transbank utilizando la comunicación serial de un PC o Caja.

Las transacciones soportadas por los equipos POS de Transbank son: 

Carga de Llaves.



Venta.



Cierre.



Anulación.



Ultima Venta.



Detalle de Ventas.



Totales.



Pooling.



Cambio de modalidad a POS Normal.

La comunicación con Transbank y la lógica del procesamiento de una transacción financiera es realizada por los equipos POS, facilitando así la integración con un sistema de caja.

2. Requerimientos de Hardware 

La Caja o PC debe tener disponible una puerta serial RS232 para la conexión con el POS de Transbank.



Enchufe con 220 Volts para alimentación del POS.

Página 6


Versión 2.2

3. Transacciones Soportadas.

3.1 Transacción de Venta Comando enviado por la caja solicitando la ejecución de una venta. El comando de venta soporta los siguientes parámetros que pueden ser enviados desde la caja: 

Monto de la Transacción: Monto en pesos informado al POS. Este monto será enviado a Transbank para realizar la autorización.



Número Ticket/Boleta: Este número lo imprime el POS en el voucher que genera por la venta.



Enviar Mensajes: Parámetro que le indica al POS si debe enviar mensajes intermedios a la Caja mientras se realiza el proceso de venta. Los mensajes intermedios que envía el POS y que deben ser mostrados por la Caja, deben corresponder según los siguientes códigos: o

Lectura de Tarjeta

 Código 78

o

Confirmación de Monto

 Código 80

o

Selección de Cuotas

 Código 79

o

Ingreso de Pinpass

 Código 81

o

Envío de Tx a Transbank

 Código 82

Excepciones: La transacción de Reversa se mantiene igual, es decir, en caso de enviar una solicitud y no tener respuesta del Autorizador, se guarda una reversa y es enviada en la siguiente transacción que se realice.

Página 7


Versión 2.2

3.2 Transacción Última Venta Comando enviado por la caja, solicitando al POS los datos de la última venta realizada.

Excepciones Al momento de ejecutar un cierre se borran todas las transacciones almacenadas en la memoria del POS.

Si el POS recibe el comando Última Venta y no existen transacciones en memoria del POS, se envía la respuesta a la caja indicando el error (ver Tabla de Respuestas).

3.3 Transacción Anulación Venta La transacción de anulación siempre será de responsabilidad de la caja y es quien decide cuando realizar una anulación, considerando que sólo pueden ser anuladas las transacciones que se encuentran en la memoria del POS.

El comando de anulación soporta los siguientes parámetros que pueden ser enviados desde la caja. 

Número de Operación: Valor enviado al POS, impreso en el Voucher de Venta. Le indica al POS la transacción en memoria que se desea anular.

Como respuesta el POS enviará código de aprobación correspondiente al campo 38 del ISO, y además de un código de aprobación correspondiente (ver Tabla de Respuestas), y en caso de ser rechazada el código de rechazo enviado corresponde al tipo de rechazo definido (ver Tabla de Respuestas).

Página 8


Versión 2.2

3.4 Transacción de Cierre. Este comando es gatillado por la caja y no recibe parámetros. El POS ejecuta la transacción de cierre contra el Autorizador (no se contempla Batch Upload). Como respuesta a la caja se enviará un aprobado o rechazado (ver Tabla de Respuestas).

Excepciones Para el cierre no se solicita tarjeta supervisora.

3.5 Transacción Detalle de Ventas Este comando debe ser gatillado por la caja para solicitar al POS todas las transacciones que se han realizado y permanecen en la memoria del POS.

Importante: Un Cierre de Terminal, vacía la memoria del POS.

El comando de Detalle de Ventas soporta los siguientes parámetros que pueden ser enviados desde la caja: 

Detalle a la Caja: Valor enviado al POS, indica si el POS realizara sólo la impresión del detalle de ventas o debe enviar el detalle de ventas a la Caja (transacción por transacción).

3.6 Transacción Totales Esta transacción es gatillada por la caja para solicitar al POS el Total de las transacciones que se han realizado y permanecen en memoria (Un cierre de terminal, vacía la memoria).

3.7 Transacción Carga de Llaves

Página 9

Manual Integración

Versión 2.2

POS Integrado

Esta transacción solo será utilizada por la caja como una prueba de conexión con Transbank como respuesta el POS enviará un aprobado o rechazado (ver Tabla de Respuestas).

3.8 Transacción de Pooling Esta transacción es enviada por la caja para saber si el POS está conectado. El POS responde con un ACK.

3.9 Cambio de Modalidad a POS Normal Este comando le permitirá a la caja, realizar el cambio de modalidad a través de un comando. El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.

4. Diagramas de Secuencia 4.1 Venta

CAJA

PINPAD

HOST

Requer. (Venta) ACK/NAK Requer. Venta (0200) Resp. Venta (0210) Resp. (Venta) ACK/NAK

Descripción 

La caja envía el requerimiento y espera como respuesta ACK/NACK, en caso de que llegue un NACK, debe reintentar el envío del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.

Página 10

Manual Integración

Versión 2.2

POS Integrado



El POS solicita los datos al usuario, y envía requerimiento al Autorizador, en caso de ser aprobada, se guarda en Batch y se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el error (ver Tabla de Respuestas).



La caja al recibir la respuesta envía un ACK si el mensaje esta correcto, o un NACK para el caso en que el LRC no corresponde.



El POS al recibir el ACK vuelve al inicio a esperar un nuevo comando, para el caso que recibe un NACK vuelve a enviar la respuesta 2 veces más.

4.2 Última Venta

Caja

Pinpad

Req. última venta ACK/NAK Resp. última venta ACK/NAK

Descripción 

La caja envía el requerimiento y espera como respuesta ACK, Si recibe un ACK la caja debe esperar la respuesta del POS, en caso de recibir un NACK debe reintentar enviando el comando 2 veces.



Una vez recibida la respuesta, la caja calcula el LRC del mensaje y lo compara con el recibido, si coinciden la caja envía un ACK al POS dando por finalizado el comando, en caso contrario envía un NACK, y vuelve a esperar la respuesta del POS.

Página 11

Manual Integración

Versión 2.2

POS Integrado

4.3 Anulación

Caja

Pinpad

Host

Req Anulación ACK Req Anulación Resp Anulación Resp Host Anulación ACK

Descripción 

La caja envía el requerimiento y espera como respuesta ACK/NACK, encaso de que llegue un NACK, debe reintentar el envío del requerimiento 2 veces. Si recibe un ACK debe esperar la respuesta de la transacción.



El POS envía requerimiento al Autorizador, en caso de ser aprobada, se guarda en Batch y se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el error.







Página 12

Manual Integración

Versión 2.2

POS Integrado

4.4 Cierre

Caja

Pinpad

Host

Req (Cierre) Respuesta (ACK) Req Cierre(0500) Resp Cierre (0510) Resp (Cierre) ACK

Descripción 




El POS envía requerimiento al Autorizador, en caso de ser aprobada, se borra Batch y se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el error.







Página 13

Manual Integración

Versión 2.2

POS Integrado

4.5 Carga de Llaves

Caja

Pinpad

Host

Req (Carga Llaves) Respuesta (ACK) Req Carga Llaves(0800) Resp Carga Llaves (0810) Resp (Carga Llaves) ACK

Descripción 




El POS envía requerimiento al Autorizador, en caso de ser aprobada, se guarda nueva llave y se envía respuesta a la caja. En caso de ser rechazada se envía respuesta a la caja indicando el error.







Página 14

Manual Integración

Versión 2.2

POS Integrado

4.6 Pooling

Caja

Pinpad

Requerimiento (Pooling) Respuesta (ACK)

Descripción 

La caja envía el requerimiento y espera como respuesta ACK, Si recibe un ACK indica que el POS está funcionando y listo para recibir un comando, en caso de no recibir el ACK, indica que el POS esta con problema y debe reintentar enviando el comando de pooling al menos 3 veces.

5. Especificación de Protocolo de Comunicación Caja - POS La comunicación es a través de una puerta serial RS232, a velocidades que van desde los 1200 Bps hasta 115200 Bps (8N1).

5.1 Esquema de Comunicación Caja - POS

REQ. DATOSLRC Timeout1

ACK/NAK PINPAD

CAJA RESP. DATOSLRC Timeout2

ACK/NAK

Página 15

POS VX-700


Versión 2.2

Todos los comandos que se envían desde la Caja al POS deben cumplir con este flujo.

5.2 Flujo de la Comunicación Caja - POS 

ACK: Lo envía el POS o la caja como aviso de recepción OK (valor Hexa 0x06).



NACK: Lo envía el POS o la caja cuando el LRC calculado no corresponde al enviado (valor Hexa 0x15).



Timeout1: Es el tiempo de espera del ACK o NACK para reintentar el envió del requerimiento por la caja y la respuesta desde el POS.



El formato para los requerimientos y respuestas: .



LRC: Es un byte que se concatena luego del y que se calcula realizando un XOR byte a byte del mensajes, incluyendo DATA + ETX.



Timeout2: Es el tiempo de espera de la respuesta por la caja luego de recibir el ACK del requerimiento.



STX: Indica el INICIO del mensaje (valor Hexa 0x02).



ETX: Indica el FIN del mensaje (valor Hexa 0x03).

6. Mensajería de Comandos Consideraciones Generales de Mensajería La separación entre campos se realiza con el carácter “|” (valor Hexa 0x7C), evitando rellenar los datos, es decir; para rescatar la información tanto la caja como el POS, debe buscar este carácter.

Ejemplo:

Transacción

de

Venta

<0x02>0200|5000|0|0<0x03>LRC,

Respuesta

<0x02>0210|00|0|597001600148|65000010|123456|5000|x|1234|1|C|MC|11032010|095500|xxxxxx xxxxx<0x03>LRC

Página 16

Manual Integración

Versión 2.2

POS Integrado

6.1 Venta 6.1.1 Solicitud Venta DATO

LARGO

COMENTARIO

1

Indica inicio de comando Valor Hexa 0x02

4

Valor 0200

Separador de campo

1

Valor “|” Hexa 0x7c

Monto

9

Valor Numérico

Separador de campo

1

Comando

Número Ticket/Boleta


20

Valor alfanumérico

Separador de campo

1


Separador de campo

1


Separador de campo

1


1

Indica si el POS debe enviar mensajes de estatus

Enviar Mensajes

de la transacción (1=Envía Mensajes, 0=No envía mensajes).

1

Indica Fin de comando Valor Hexa 0x03

1

Byte resultado de la operación XOR del mensaje

6.1.2 Mensajes Intermedios La cantidad de mensajes intermedios dependerá del tipo de venta que se está realizando.

DATO

Comando Separador de campo

Código Mensaje

LARGO

COMENTARIO

1


4

Valor 0900

1


2

Valor Numérico (Ver Tabla de Respuestas)

1


1


Página 17

Manual Integración

Versión 2.2

POS Integrado

6.1.3 Respuesta Venta DATO

LARGO 1


Código Respuesta Separador de campo

Código de comercio Separador de campo

Terminal ID Separador de campo

Número Ticket/Boleta Separador de campo

Código Autorización Separador de campo

Monto Separador de campo

Numero de Cuotas Separador de campo

Monto Cuota

COMENTARIO Indica inicio de comando Valor Hexa 0x02

4 1

Valor 0210 Valor “|” Hexa 0x7c

2 1

Valor Numérico Valor “|” Hexa 0x7c

12 1


8 1

Valor Alfanumérico Valor “|” Hexa 0x7c

20 1

Valor alfanumérico Valor “|” Hexa 0x7c

6 (Máximo) 1


9 (Máximo) 1


2 1


9

Valor Numérico

(Máximo) Separador de campo

Últimos 4 Dígitos Tarjeta Separador de campo

Número Operación Separador de campo

Tipo de Tarjeta

1


4 1

6 (Máximo) 1


Correlativo de Transacción del Terminal Valor “|” Hexa 0x7c

2

CR=Crédito

(Crédito/Debito) Separador de campo

Fecha Contable Separador de campo

Número de Cuenta

DB=Debito 1

6 1

19


Valor Ascci. Se utiliza si es tarjeta Debito Valor “|” Hexa 0x7c

Valor Ascci. Se utiliza si es tarjeta Debito

Página 18

Manual Integración

Versión 2.2

POS Integrado

Separador de campo


1

Abreviación Tarjeta

2

Separador de campo

Ver Tabla de Abreviación de Tarjetas Valor “|” Hexa 0x7c

1

Fecha Transacción

8

Separador de campo

Formato DDMMAAAA Valor “|” Hexa 0x7c

1

Hora Transacción

6

Separador de campo

Formato HHMMSS Valor “|” Hexa 0x7c

1

Empleado

4

Separador de campo

Valor Numerico Valor “|” Hexa 0x7c

1

Propina

9(Máximo)

Separador de campo

1 (opcional)


1


1


6.2 Última Venta 6.2.1 Solicitud Última Venta DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0250

Separador de campo

1


1


1


6.2.2 Respuesta Última Venta DATO

LARGO

COMENTARIO

1


Comando

4

Página 19

Valor 0260

Manual Integración

Versión 2.2

POS Integrado

Separador de campo







Numero de Cuotas Separador de campo

Monto Cuota Separador de campo


Número Operación

1

2 1

12 1

8 1

20 1

6 (Máximo) 1

9 (Máximo) 1

2 1

9(Máximo) 1

4 1

6 (Máximo)











Correlativo de Transacción del Terminal

Separador de campo

Tipo de Tarjeta

1

2


Fecha Contable


CR=Crédito DB=Debito

1


6


Separador de campo

Número de Cuenta

1

19



Separador de campo


1

2


Ver Tabla de Abreviación de Tarjetas

Separador de campo

1

Página 20


Manual Integración

Versión 2.2

POS Integrado

Fecha Transacción Separador de campo

Hora Transacción Separador de campo

Empleado Separador de campo

8 1

6 1

4 1

Propina

9(Máximo)

Separador de campo

1(opcional)

1




Valor Numerico Valor “|” Hexa 0x7c Indica Fin de comando Valor Hexa 0x03

1


6.3 Anulación 6.3.1 Solicitud Anulación DATO

LARGO

COMENTARIO

1



Número Operación

4 1

6 (Máximo)



Separador de campo

1


1


1


6.3.2 Respuesta Anulación DATO

LARGO

COMENTARIO

1

Indica inicio de comando Valor

Página 21

Manual Integración

Versión 2.2

POS Integrado

Hexa 0x02






Número Operación

4 1

2 1

12 1

8 1

6 (Máximo) 1

6 (Máximo)







1


1


6.4 Cierre 6.4.1 Solicitud de Cierre DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0500

Separador de campo

1


Separador de campo

1


1


1


Página 22

Manual Integración

Versión 2.2

POS Integrado

6.4.2 Respuesta de Cierre DATO

LARGO 1

COMENTARIO Indica inicio de comando Valor Hexa 0x02


4

Separador de campo

2


1



1

Código Respuesta

Valor 0510

12


1

Terminal ID

Valor Numérico

8

Valor Alfanumérico

Separador de campo

1 (opcional)


1


1


6.5 Detalle de Ventas Este comando le permitirá a la Caja, tener la data de todas las transacciones que fueron ejecutadas en el POS y que aún se encuentran en la memoria de este. En este caso el campo de solicitud “Detalle a la Caja” indica si el POS realizará sólo la impresión del detalle de ventas en el POS o enviará a la caja el detalle de ventas, transacción por transacción

Las dos opciones que maneja este comando para obtener el detalle de transacciones en memoria del equipo son: o

Valor 0: El POS imprime voucher con el detalle completo de transacciones que existen en memoria.

o

Valor 1: El POS envía a la Caja el detalle de transacciones realizadas y almacenadas en la memoria del POS. Entre cada transacción la Caja debe enviar

Página 23

Manual Integración

Versión 2.2

POS Integrado

un ACK al POS. El POS en la última trx que envía responde con el mismo formato de mensaje pero el código de autorización en blanco.

Detalle a la Caja

Valor

Imprime POS

0

Envía Data a la Caja

1

6.5.1 Solicitud Detalle de Ventas DATO

LARGO

COMENTARIO

1



Detalle a la Caja

4 1

1


Valor Numérico

Separador de campo

1


1


1


6.5.2 Respuesta Detalle de Ventas DATO

LARGO

COMENTARIO

1






4 1

2 1

12 1

8 1

Página 24





Manual Integración

Versión 2.2

POS Integrado





Número Operación

20 1

6 (Máximo) 1

9 (Máximo) 1

4 1

6 (Máximo)






Separador de campo

Tipo de Tarjeta

1

2


Fecha Contable


CR=Crédito DB=Debito

1


6


Separador de campo

Número de Cuenta

1

19



Separador de campo


1

2


Ver Tabla de Abreviación de Tarjetas

Separador de campo

Fecha Transacción Separador de campo

Hora Transacción Separador de campo

Empleado Separador de campo

Propina Separador de campo

Monto Cuota Separador de campo

Numero de Cuotas

1

8 1

6 1

4 1

9(Máximo) 1

9(Máximo) 1

2

Página 25







Valor Numérico

Manual Integración

Versión 2.2

POS Integrado

Separador de campo

1(opcional) 1

Valor “|” Hexa 0x7c Indica Fin de comando Valor Hexa 0x03

1


6.6 Totales Esta operación le permitirá a la caja tener un resumen de totales con las transacciones que fueron procesadas.

Además la Caja podrá determinar si existen transacciones que no fueron informadas desde el POS, haciendo una comparación de los Totales que tiene la Caja y el POS.

La impresión del Voucher de totales será realizada por el POS.

6.6.1 Solicitud Totales: DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0700

Separador de campo

1


Separador de campo

1


1


1


6.6.2 Respuesta Detalle de Totales DATO

LARGO

COMENTARIO

1

Indica inicio de comando Valor

Página 26

Manual Integración

Versión 2.2

POS Integrado

Hexa 0x02


Número de TX

4 1

3



Separador de campo

1

Totales

9

Valor Numérico

1

Indica Fin de comando Valor

Hexa 0x03

1


6.7 Carga de Llaves 6.7.1 Solicitud Carga de Llaves DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0800

1


1


6.7.2 Respuesta Carga de Llaves DATO

LARGO

COMENTARIO

1




Código de comercio

4 1

2 1

12

Página 27



Valor Numérico

Manual Integración

Versión 2.2

POS Integrado

Separador de campo

1


Terminal ID

8

Valor Alfanumérico

Separador de campo

1 (opcional)


1

Indica Fin de comando Valor

Hexa 0x03

1


6.8 Pooling 6.8.1 Solicitud Pooling DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0100

1


1


6.8.2 Respuesta Pooling DATO

LARGO 1

COMENTARIO Comando recibido OK Valor Hexa 0x06

6.9 Cambio de Modalidad a POS Normal Esta función le permitirá a la caja, realizar el cambio de modalidad a través de un comando. El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.

Página 28

Manual Integración

Versión 2.2

POS Integrado

6.9.1 Solicitud Cambio Modalidad a POS Normal: DATO

LARGO

COMENTARIO

1


Comando

4

Valor 0300

Separador de campo

1


1


1


6.9.2 Respuesta Cambio Modalidad a POS Normal:

DATO

LARGO 1

COMENTARIO Comando recibido OK Valor Hexa 0x06

7. Voucher Los voucher serán impresos por el POS para todos los casos.

Página 29

Manual Integración

Versión 2.2

POS Integrado

8. Flujos de Venta y Otros

8.1 Flujo TX 3.20 con boleta, propina, empleado

Si el parámetro propina, boleta o empleado esta habilitado.

TRANSBANK 1. VISA-AMEX-DINERS-MC 2. REDCOMPRA 3. OTRAS

Monto Propina Total Boleta Empleado

Deslice o Inserte Tarjeta

Monto Cuota $2.000

$5.000 $1.000 $6.000 :12398 :1001

Sin Cuotas 3 Cuotas Sin Interes Cuotas Normal Cuotas Comercio

CONFIRME CUOTA

Informe a la Caja Conectando...

Ingrese Clave ****

8.2 Flujo TX 3.20 sin boleta, propina, empleado

Monto Cuota $2.000



Sin Cuotas 3 Cuotas Sin Interes Cuotas Normal Cuotas Comercio

Venta Sin Interes PROMOCION EMISOR CONFIRME CUOTA

Informe a la Caja Conectando...

Ingrese Clave ****

Página 30

Venta Sin Interes PROMOCION EMISOR

ENTREGUE POS

ENTREGUE POS

Manual Integración

Versión 2.2

POS Integrado

8.3 Flujo TX 3.40 con boleta, propina, empleado Si el parámetro propina, boleta o empleado esta habilitado. Sin Cuotas

Sin Cuotas

Monto Cuota $2.000

Transbank 1. Visa-MC-AMEX-DINERS 2. REDCOMPRA 3. OTRAS



$5.000 $1.000 $6.000 :12398 :1001


F1: Sin Cuotas

ENTREGUE POS

CONFIRME CUOTA

F2: Con Cuotas Consulta de Cuota

Con Cuotas

Ingrese Cuota:

Ingrese Clave **** Calculo de Cuota en el POS

Conectando...

Informe a la Caja

Página 31

Manual Integración

Versión 2.2

POS Integrado

8.4 Flujo TX 3.40 sin boleta, propina, empleado Si el parámetro propina, boleta o empleado esta habilitado. Sin Cuotas

Sin Cuotas

Monto Cuota $2.000

Transbank 1. Visa-MC-AMEX-DINERS 2. REDCOMPRA 3. OTRAS



$5.000 $1.000 $6.000 :12398 :1001


F1: Sin Cuotas

ENTREGUE POS

CONFIRME CUOTA

F2: Con Cuotas Consulta de Cuota

Con Cuotas

Ingrese Cuota:

Ingrese Clave **** Calculo de Cuota en el POS

Conectando...

Informe a la Caja

Página 32

Manual Integración

Versión 2.2

POS Integrado

8.5 Cambio de modalidad POS Normal a POS Integrado

TRANSBANK TRANSBANK 1. VISA-AMEX-DINERS-MC 2. REDCOMPRA 3. OTRAS

TRANSBANK

TRANSBANK

1. ANULACION 2. REIMPRIMIR 3. REPORTES 4.ACTUALIZACION 5. ENVÍO CUPON 6. POS INTEGRADO

1. VENTA 2. CIERRE 3. COMERCIO 4.CONFIGURACION

1. ACTIVAR 2. SETEO DE COM 3. VELOCIDAD COM

Nota: Este flujo es referencial ya que el menú que se muestra en el paso 3 dependerá de los productos que el comercio tenga activados.

8.6 Cambio de modalidad POS Integrado a POS Normal

TRANSBANK TRANSBANK

TRANSBANK Presiona Tecla #

ESCUCHANDO...

1. DESACTIVAR 2. SETEO DE COM 3. VELOCIDAD COM

SI


Página 33

NO ESCUCHANDO...

Manual Integración

Versión 2.2

POS Integrado

9. Tipos de Conexión a POS

9.1 Conexión con Cable Serial Los equipos de POS Integrado tienen una conexión serial en la parte posterior identificado como RS232 donde se conecta el cable serial provisto por Transbank.

El otro extremo debe ir conectado al PC en su puerto serial.

Conexión Corriente

RS232: Cable Serial

ETH = Ethernet

POS/Caja

Conexión LAN Internet

Página 34


Versión 2.2

Todos los cables conectados deberían estar de la siguiente forma:

9.2 Conexión POS Integrado con cable LAN para comunicación con Transbank El equipo por defecto viene configurado para recibir las IP por DHCP. Tambien esta la posibilidad de configurar la IP de manera fija (Debe consultar a Transbank).

Para que el equipo logre comunicarse con los servidores de Transbank, es necesaria la habilitacion de los siguientes traficos en la RED del comercio:

DESARROLLO 

200.10.12.16 puerto 4100



200.10.12.216 puerto 8087

Página 35


Versión 2.2

9.3 Conexión POS Integrado con cable TELEFÓNICO para comunicación con Transbank

El equipo por defecto viene configurado para discar los números telefónicos del ambiente de desarrollo de Transbank. El equipo permite agregar un codigo PABX si la línea telefónica usada está conectada a una central. (Debe consultar a Transbank).

Página 36

Manual Integración

Versión 2.2

POS Integrado

10.

Tabla Abreviación de Tarjetas TARJETA

ABREVIACION

VISA

VI

MASTERCARD

MC

CABAL

CA

CREDENCIAL

CR

AMEX

AX

CERRADA

CE

DINNERS

DC

PRESTO

TP

MAGNA

MG

MAS

TM

RIPLEY

RP

EXTRA

EX

CMR

TC

REDCOMPRA

DB

Página 37

11.

Tabla de Respuestas Aprobado

00

Rechazado

01

Host no Responde

02

Conexión Fallo

03

Transacción ya Fue Anulada

04

No existe Transacción para Anular

05

Tarjeta no Soportada

06

Transacción Cancelada desde el POS

07

No puede Anular Transacción Debito

08

Error Lectura Tarjeta

09

Monto menor al mínimo permitido

10

No existe venta

11

Transacción No Soportada

12

Debe ejecutar cierre

13

Solicitando Conformar Monto

80

Solicitando Ingreso de Clave

81

Enviando transacción al Host

82

Página 38

12.

ANEXO 1

CONFIDENCIALIDAD DE LA INFORMACIÓN. De acuerdo a las normativas vigentes, las transacciones con Tarjeta de Crédito y Débito requieren la incorporación de los siguientes elementos de seguridad en el sistema: La información de la banda magnética leída en el punto de venta NO debe ser almacenada en ningún sistema. Para efectos de cuadratura e identificación de transacciones, se debe utilizar el NÚMERO DE TRANSACCIÓN.

TRATAMIENTO DE LOS TRACKS DE LA TARJETA La información grabada en el Track I y Track II será leída sólo por los dispositivos de seguridad (POS). Estos dispositivos procederán a encriptar el contenido del Track I y Track II para que esta información no quede en claro. El algoritmo de encriptación utilizado para los tracks I y II es DES.

TRATAMIENTO DE LA DATA SENSIBLE. Para asegurar la confidencialidad de la información, los mensajes de las transacciones o al menos los datos sensibles (además del PIN) deben viajar encriptados en los distintos tramos de la conexión, tanto en el requerimiento como en la respuesta. Como datos sensibles se consideran: número de tarjeta, fecha expiración, número de cuenta y monto de la transacción (dato validado en Autenticación de Mensajes o MAC).

EL MODELO MÁSTER/SESIÓN KEY El método actual de administración de llaves es el llamado Máster/Session Key, en el cual los PED (Pin Entry Device) son cargados en un ambiente seguro con una Master Key y en forma remota se carga la Working Key o Session Key. El procedimiento actual para cifrar en los Pin Pads un PinBlock es el siguiente: Se descifra la Working Key usando la Master Key que tiene cargado el PED. Con la Working Key, se cifra el PinBlock y se envía al servidor.

La Working Key se cambia en forma periódica (al menos en cada cierre), para evitar que sea descubierta por terceros. Este modelo de administración de llaves es el que se usará para las llaves MAC.

Nota: esta funcionalidad no se ve impactada por la incorporación de transacciones con Chip

Página 39

EL MODELO DUKPT – ENCRIPTACION DE PIN El nuevo método de administración de llaves para PIN que usará Transbank es el denominado ―Llave Única derivada por transacción‖ o DUKPT por sus iniciales en inglés. Bajo este método los PED son ―inicializados‖ en un ambiente seguro, con datos de identificación propios de cada PED (Identificador de la llave de derivación, Identificador de PED único y un contador de transacciones iniciado en cero), más una llave inicial que se calcula usando los datos propios de cada PED y la llave de derivación base. Con esta llave inicial se genera la próxima llave de cifrado para PIN. Este proceso se realiza con una función asimétrica (DUKPT del PinPad), es decir, una función de un solo sentido, de forma que el PED no sea capaz de generar ninguna llave anterior a la actual.

CALCULO DE MAC Para asegurar la integridad de la información que viaja desde y hacia el Autorizador de comercio, se introduce un código de autenticación de mensajes (MAC) el cual es enviado en el mensaje de requerimiento y validado por el Autorizador de Transbank al recibirlo. A su vez, el Autorizador de Transbank envía un código de MAC para el mensaje de respuesta, el cual debe ser validado por la caja. Si la validación que hace la caja del código de MAC es negativa debe generar una reversa. La transacción de reversa debe ser igual a la respuesta recibida pero con el campo RESPONSE CODE con el valor 989 y el campo MESSAGE SUBTYPE en R. Cuando el Autorizador de Transbank detecta un MAC inválido en el mensaje de requerimiento, envía un mensaje de respuesta con código de rechazo 898 (MAC inválido).

MANEJO DE LLAVES MAC (MESSAGE AUTHENTICATION CODE) Las llaves criptográficas para la generación de MAC (working key de MAC) se maneja de acuerdo a lo siguiente: Las working key son generadas por el sistema de Transbank y transmitidas en línea para cada uno de los terminal ID definidos en el comercio cliente.

Para la carga y / o cambio de la working keys de MAC se utilizan las transacciones de CIERRE BATCH y CARGA DE LLAVE (Ver Transacciones Administrativas).

Las llaves working keys de MAC se actualizan en cada nueva transacción atendida por Transbank. Por lo que la caja debe registrar esta nueva llave para su uso en la siguiente transacción.

Página 40

Las llaves se deben cambiar automáticamente todos los días. Esto implica que debe existir un procedimiento de inicialización o cierre obligatorio en cada caja (terminal ID) que se ejecuta en forma automática todos los días y que como parte de este procedimiento se envía a Transbank una transacción de CIERRE BATCH o CARGA DE LLAVE por cada caja (terminal ID).

Las working keys (MAC) se transmiten encriptadas utilizando el algoritmo DES (dato a encriptar es la working key) con una llave de encriptación denominada master key, definida por Transbank. Transbank define una master key para PIN y otra master key para MAC.

Transbank carga inicialmente las master keys en cada PIN-PAD, operación que se realiza previamente a la instalación de éstos en las cajas.

Para la carga de las master keys de PIN y MAC, el modelo de PIN-PAD utilizado debe contar con un dispositivo cargador de llaves que será administrado por Transbank y que permite:

Ingresar las master keys en el dispositivo, la que no podrá ser modificada, violada o adulterada. Cargar las master keys conectando uno por uno los PIN-PAD al dispositivo MANEJO DE CLAVE TÉCNICO Para acceder a los menues de perfil técnico, deberá acreditarse con el RUT y la Clave que corresponde a este rut. Esta clave es de generación dinámica, con caducidad máxima en 31 dias. El algoritmo y el detalle de esta funcionalidad será entregado a demanda, por el carácter de confidencialidad del algoritmo. MANEJO DE CLAVE SUPERVISORA Hasta la versión 3.40, cada comercio tenía una tarjeta supervisora que le permitía autenticarse para realizar cierres, anulaciones y otras operaciones. A partir de la versión 4.0, durante el proceso de autoinstalación se solicitará la digitación de la clave supervisora, quedando esta almacenada hasta que el comercio desee cambiarla, siendo esta responsabilidad del mismo. Si el comercio olvida esta clave, existe una clave maestra de comercio que permite la digitación de una nueva clave de comercio. MANEJO DE CLAVE MAESTRA DE COMERCIO / ACTIVACION Hasta la versión 3.40, cada comercio tenía una tarjeta supervisora que le permitía autenticarse

Página 41

13.

Anexo 2: Detalle campos de cada transacción

1

Transacción Crédito/Debito Caja -> POS)

4

9

4

6

2

6

19

2

8

8

6

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

1

1

Venta (Desde Solicitud

0200 0210

x

2

Mensajes de estatus de la transacción (Desde Pinpad -> POS)

Respuesta

0900

x

3

Solicitud Última Venta (Desde Caja -> POS) (Desde POS -> Caja) Transacción Anulación de Venta (Desde Caja -> POS) (Desde POS -> Caja) Transaccion de Cierre (Desde Caja -> POS) (Desde POS -> Caja)

Solicitud

0250

Respuesta

0260

Solicitud

1200

Respuesta

1210

Solicitud

0500

Respuesta

0510

x

x

x

x

x x

x

x

x

x

x

Página 42

x

x

1

3

Totales

Numero de Tx

Detalle a la Caja

Enviar Mensajes

Parametro Impresión

Hora Real Transaccion

Fecha Real Transaccion

Abreviación Marca Tarjeta

Número de Cuenta

Fecha Contable

Tipo de Tarjeta

Numero Operación

12

Respuesta

5

6

Monto

2

(Desde POS -> Caja)

4

20

Últimos 4 Digitos Tarjeta

CAMPOS Largo del Campo

Codigo Autorizacion

Número de Ticket/Boleta

Terminal Id

Codigo Comercio

Codigo Respuesta

Funcion

Solicitud/Respuesta

LISTADO DE TRANSACCIONES

9

6

Transacción Detalle de Ventas (Desde Caja -> POS) (Desde POS -> Caja)

7

Transacción Totales (Desde Caja -> POS) (Desde POS -> Caja)

8

Transaccion Carga Llaves (Desde Caja -> POS) (Desde POS -> Caja)

9

Pooling -Probar comunicaciones con Pinpad (Desde Caja -> POS) (Reponde ACK)

10

Cambio de Modalidad a POS Normal (Desde Caja -> POS) (Reponde ACK)

Solicitud

0260

Respuesta

0261

Solicitud

0700

Respuesta

0710

Solicitud

0800

Respuesta

0810

Solicitud

0100

x x

x

x

x

x

x

x

x

x

x

x

x

x

x

x

Respuesta

Solicitud

x

0300

Respuesta

Página 43

x

x

x

Manual de Integración POS Intergrado (Último)

Recommend Documents