Manual Pos Integrado Final

MANUAL DE DESARROLLO
POS INTEGRADO
Versin 2.3 (Noviembre 2015)
Manual Integracin
Versin 2.3
POS Integrado
Contenido
1. CONTROL DE CAMBIOS...................................................................................................................... 5
2. OBJETIVO........................................................................................................................................... 7
3. REQUERIMIENTOS DE HARDWARE..................................................................................................... 7
4. TRANSACCIONES SOPORTADAS.......................................................................................................... 8
4.1 TRANSACCIN DE VENTA..................................................................................................................................8

4.2 TRANSACCIN LTIMA VENTA...........................................................................................................................9
4.3 TRANSACCIN ANULACIN VENTA......................................................................................................................9
4.4 TRANSACCIN DE CIERRE................................................................................................................................10
4.5 TRANSACCIN DETALLE DE VENTAS...................................................................................................................10
4.6 TRANSACCIN TOTALES..................................................................................................................................10
4.7 TRANSACCIN CARGA DE LLAVES.....................................................................................................................11
4.8 TRANSACCIN DE POOLING.............................................................................................................................11
4.9 CAMBIO DE MODALIDAD A POS NORMAL.........................................................................................................11
5. DIAGRAMAS DE SECUENCIA............................................................................................................. 12
5.1 VENTA.........................................................................................................................................................12
5.2 LTIMA VENTA.............................................................................................................................................13
5.3 ANULACIN..................................................................................................................................................14
5.4 CIERRE.........................................................................................................................................................15
5.5 CARGA DE LLAVES..........................................................................................................................................16
5.6 POOLING.....................................................................................................................................................17
6. ESPECIFICACIN DE PROTOCOLO DE COMUNICACIN CAJA POS....................................................18
6.1 ESQUEMA DE COMUNICACIN CAJA - POS.......................................................................................................18
7. MENSAJERA DE COMANDOS........................................................................................................... 19
CONSIDERACIONES GENERALES DE MENSAJERA.......................................................................................................19

7.1 VENTA.........................................................................................................................................................19
7.1.1 SOLICITUD VENTA.......................................................................................................................................19
7.1.2 MENSAJES INTERMEDIOS.............................................................................................................................20
7.1.3 RESPUESTA VENTA......................................................................................................................................20
Pgina 2
Manual Integracin
Versin 2.3
POS Integrado
7.2 LTIMA VENTA.............................................................................................................................................22

7.2.1 SOLICITUD LTIMA VENTA...........................................................................................................................22
7.2.2 RESPUESTA LTIMA VENTA..........................................................................................................................22
ANULACIN........................................................................................................................................................24
7.3.1 SOLICITUD ANULACIN................................................................................................................................24
7.3.2 RESPUESTA ANULACIN...............................................................................................................................24
7.4 CIERRE.........................................................................................................................................................25
7.4.1 SOLICITUD DE CIERRE..................................................................................................................................25
7.4.2 RESPUESTA DE CIERRE.................................................................................................................................26
7.5 DETALLE DE VENTAS.......................................................................................................................................26
7.5.1 SOLICITUD DETALLE DE VENTAS.....................................................................................................................27
6.5.2 RESPUESTA DETALLE DE VENTAS....................................................................................................................28
7.6 TOTALES.......................................................................................................................................................29
7.6.1 SOLICITUD TOTALES:...................................................................................................................................30
7.6.2 RESPUESTA DETALLE DE TOTALES...................................................................................................................30
7.7 CARGA DE LLAVES..........................................................................................................................................31
7.7.1 SOLICITUD CARGA DE LLAVES.......................................................................................................................31
7.7.2 RESPUESTA CARGA DE LLAVES.......................................................................................................................31
7.8 POOLING.....................................................................................................................................................32
7.8.1 SOLICITUD POOLING...................................................................................................................................32
7.9 CAMBIO DE MODALIDAD A POS NORMAL.........................................................................................................33
7.9.1 SOLICITUD CAMBIO MODALIDAD A POS NORMAL:..........................................................................................33
8. VOUCHER......................................................................................................................................... 34
9. FLUJOS DE VENTA Y OTROS............................................................................................................... 34
9.1 FLUJO TX 3.20 CON BOLETA, PROPINA, EMPLEADO.............................................................................................34

9.2 FLUJO TX 3.20 SIN BOLETA, PROPINA, EMPLEADO..............................................................................................34
9.3 FLUJO TX 3.40 CON BOLETA, PROPINA, EMPLEADO.............................................................................................35
9.4 FLUJO TX 3.40 SIN BOLETA, PROPINA, EMPLEADO..............................................................................................36
9.5 CAMBIO DE MODALIDAD POS NORMAL A POS INTEGRADO.................................................................................37
9.6 CAMBIO DE MODALIDAD POS INTEGRADO A POS NORMAL.................................................................................37
10. TIPOS DE CONEXIN A POS.......................................................................................................... 38
10.1 CONEXIN CON CABLE SERIAL.......................................................................................................................38
Pgina 3
Manual Integracin
Versin 2.3
POS Integrado
10.2 CONEXIN POS INTEGRADO CON CABLE LAN PARA COMUNICACIN CON TRANSBANK............................................40
10.3 CONEXIN POS INTEGRADO CON CABLE TELEFNICO PARA COMUNICACIN CON TRANSBANK..............................42
11. TABLA ABREVIACIN DE TARJETAS................................................................................................ 44
12. TABLA DE RESPUESTAS.................................................................................................................. 45
13. ANEXO 1....................................................................................................................................... 47
CONFIDENCIALIDAD DE LA INFORMACIN..................................................................................................47
TRATAMIENTO DE LOS TRACKS DE LA TARJETA.............................................................................................47
TRATAMIENTO DE LA DATA SENSIBLE...........................................................................................................47
EL MODELO MSTER/SESIN KEY................................................................................................................47
EL MODELO DUKPT ENCRIPTACION DE PIN...............................................................................................48
CALCULO DE MAC........................................................................................................................................48
MANEJO DE LLAVES MAC (MESSAGE AUTHENTICATION CODE)...................................................................49
MANEJO DE CLAVE TCNICO........................................................................................................................49
MANEJO DE CLAVE SUPERVISORA...............................................................................................................50
MANEJO DE CLAVE MAESTRA DE COMERCIO / ACTIVACION.......................................................................50
14. Anexo 2: Detalle campos de cada transaccin.......................................................................................51
Pgina 4
Manual Integracin
Versin 2.3
POS Integrado
1. Control de Cambios
Versin Cambio Responsable Fecha

1.1 Manual original de equipo VX-700. Andrs Oct-2011
Villalobos
1.2 Se incorpora funcionalidad de Cuadratura. Andrs Feb-2012
Villalobos
1.3 Se modifica tabla con funciones del POS Andrs Mar-2012
Se incorpora informacin de seguridad a peticin de H&M. Villalobos
1.4 Se incorpora la explicacin de las variables que utilizan los Andrs Abr-2012
comandos. Villalobos
1.5 Se actualiza el flujo cambio de modalidad POS Integrado. Andrs Jun-2012
Se incorpora tabla con abreviacin de tarjetas a peticin de Villalobos
pticas Schilling.
Se elimina la opcin de envo de mensajes intermedios.
1.6 Se elimina la opcin de enviar Cuotas en una transaccin Andrs Jun-2012
de venta. Villalobos
Se elimina la opcin de enviar el voucher pintado para las
transacciones de POS Integrado.
1.7 Se eliminan mensajes de envo de voucher para Andrs Jul-2012
transacciones de detalle de ventas y total de ventas. Villalobos
Se detalla proceso de envo de Detalle de Transacciones.
Se incorpora la funcionalidad de Mensajes Intermedios
para una transaccin de Venta.
Se incorpora comando para cambio de modalidad a POS
Normal
1.8 Cambio de estructura del documento. Sebastin Oct-2012
Se eliminan referencias en texto y mensajera a impresin Gonzlez
de Voucher opcional (Solo imprime POS).
Se elimina informacin detallada de Voucher.
Se ajusta mensajera de transacciones a aplicativo POS.
Las cuotas son ingresadas en el POS.
Actualizacin Flujos de Venta y Otros.
Excel Incrustado se agrega como anexo en el documento.
Pgina 5
Manual Integracin
Versin 2.3
POS Integrado
1.9 Se agregan los siguientes campos en la transaccin de Andrs Oct-2012

venta; Empleado, Propina Villalobos
Se agregan los siguientes campos en la transaccin de
Ultima Venta; Numero Cuotas, Monto Cuotas, Empleado,
Propina
Se agregan los siguientes campos en la transaccin de
Detalle de Ventas; Empleado, Propina, Monto Cuotas,
Numero Cuotas.
Estos cambios permiten obtener la misma informacin de
respuesta a la caja en las tres transacciones mencionadas
Se agrega el comando que permite informar a la caja que
la transaccin 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 Julio-2014
Se cambian imgenes de conexin de Vx510 por Vx520 sin Oteiza
hacer referencia a l.
2.3 Se agrega las transacciones NO soportadas. Ral Noviembre -
Se agrega informacin respecto a las transacciones a Bustamante 2015
anular.
Se modifican los diagramas. Se excluye el trmino HOST y
PINPAD. Se agrega los trminos POS y Autorizador.
Se modifica el valor del campo de boleta.
Se agregar procedimiento para seteo de IP fija.
Se Agregar procedimiento para cambio de Cdigo PABX
Se actualiza tabla de respuesta.
Pgina 6
Manual Integracin
Versin 2.3
POS Integrado
2. 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
Crdito/Debito con Transbank utilizando la comunicacin serial de un PC o Caja.
Las transacciones soportadas por los equipos POS de Transbank son:
Carga de Llaves.
Venta.
Cierre.
Anulacin.
Ultima Venta.
Detalle de Ventas.
Totales.
Pooling.
Cambio de modalidad a POS Normal.
Las transacciones NO soportadas por los equipos POS de Transbank son:
o Contacless
o Debito con vuelto.
La comunicacin con Transbank y la lgica del procesamiento de una transaccin financiera es

realizada por los equipos POS, facilitando as la integracin con un sistema de caja.
3. Requerimientos de Hardware
La Caja o PC debe tener disponible una puerta serial RS232 para la conexin con el POS
de Transbank.
Enchufe con 220 Volts para alimentacin del POS.
Pgina 7
Manual Integracin
Versin 2.3
POS Integrado
4. Transacciones Soportadas.
4.1 Transaccin de Venta
Comando enviado por la caja solicitando la ejecucin de una venta. El comando de venta soporta
los siguientes parmetros que pueden ser enviados desde la caja:
Monto de la Transaccin: Monto en pesos informado al POS. Este monto ser enviado a
Transbank para realizar la autorizacin.
Nmero Ticket/Boleta: Este nmero lo imprime el POS en el voucher que genera por la
venta.
Enviar Mensajes: Parmetro que le indica al POS si debe enviar mensajes intermedios a
la Caja mientras se realiza el proceso de venta. Los mensajes intermedios que enva el
POS y que deben ser mostrados por la Caja, deben corresponder segn los siguientes
cdigos:
o Lectura de Tarjeta Cdigo 78

o Confirmacin de Monto Cdigo 79
o Seleccin de Cuotas Cdigo 80
o Ingreso de Pinpass Cdigo 81
o Envo de Tx a Transbank Cdigo 82
Excepciones:
La transaccin 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 transaccin que se
realice.
Pgina 8
Manual Integracin
Versin 2.3
POS Integrado
4.2 Transaccin 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
enva la respuesta a la caja indicando el cdigo de respuesta 11. (ver Tabla de Respuestas).
4.3 Transaccin Anulacin Venta
La transaccin de anulacin siempre ser de responsabilidad de la caja y es quien decide cuando

realizar una anulacin. Las anulaciones slo pueden efectuarse para las transacciones de crdito y
que se encuentran en la memoria del POS.
El comando de anulacin soporta los siguientes parmetros que pueden ser enviados desde la
caja.
Nmero de Operacin: Valor enviado al POS, impreso en el Voucher de Venta. Le indica

al POS la transaccin en memoria que se desea anular.
Como respuesta el POS enviar cdigo de aprobacin correspondiente al campo 38 del ISO, y
adems de un cdigo de aprobacin correspondiente (ver Tabla de Respuestas), y en caso de ser
rechazada el cdigo de rechazo enviado corresponde al tipo de rechazo definido (ver Tabla de
Respuestas).
Pgina 9
Manual Integracin
Versin 2.3
POS Integrado
4.4 Transaccin de Cierre.
Este comando es gatillado por la caja y no recibe parmetros. El POS ejecuta la transaccin 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.
4.5 Transaccin 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, vaca la memoria del POS.
El comando de Detalle de Ventas soporta los siguientes parmetros que pueden ser enviados
desde la caja:
Detalle a la Caja: Valor enviado al POS, indica si el POS realizara slo la impresin del
detalle de ventas o debe enviar el detalle de ventas a la Caja (transaccin por transaccin).
4.6 Transaccin Totales
Esta transaccin 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, vaca la memoria).
Pgina
10
Manual Integracin
Versin 2.3
POS Integrado
4.7 Transaccin Carga de Llaves
Esta transaccin solo ser utilizada por la caja como una prueba de conexin con Transbank como
respuesta el POS enviar un aprobado o rechazado (ver Tabla de Respuestas).
4.8 Transaccin de Pooling
Esta transaccin es enviada por la caja para saber si el POS est conectado. El POS responde con
un ACK.
4.9 Cambio de Modalidad a POS Normal
Este comando le permitir a la caja, realizar el cambio de modalidad a travs de un comando.

El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.
Pgina
11
Manual Integracin
Versin 2.3
POS Integrado
5. Diagramas de Secuencia
5.1 Venta
Descripcin
La caja enva el requerimiento y espera como respuesta ACK/NACK, en caso de que llegue
un NACK, debe reintentar el envo del requerimiento 2 veces. Si recibe un ACK debe
esperar la respuesta de la transaccin.
El POS solicita los datos al usuario, y enva requerimiento al Autorizador, en caso de ser
aprobada, se guarda en Batch y se enva respuesta a la caja. En caso de ser rechazada se
enva respuesta a la caja indicando el error (ver Tabla de Respuestas).
La caja al recibir la respuesta enva un ACK si el mensaje est 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 ms.
Pgina
12
Manual Integracin
Versin 2.3
POS Integrado
5.2 ltima Venta
Descripcin
La caja enva 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 enva un ACK al POS dando por finalizado el comando, en
caso contrario enva un NACK, y vuelve a esperar la respuesta del POS.
Pgina
13
Manual Integracin
Versin 2.3
POS Integrado
5.3 Anulacin
Descripcin
El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda en Batch y

se enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja
indicando el error.
Pgina
14
Manual Integracin
Versin 2.3
POS Integrado
5.4 Cierre
Descripcin
El POS enva requerimiento al Autorizador, en caso de ser aprobada, se borra Batch y se

enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja indicando
el error.
Pgina
15
Manual Integracin
Versin 2.3
POS Integrado
5.5 Carga de Llaves
Descripcin
El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda nueva

llave y se enva respuesta a la caja. En caso de ser rechazada se enva respuesta a la caja
indicando el error.
Pgina
16
Manual Integracin
Versin 2.3
POS Integrado
5.6 Pooling
Descripcin
La caja enva 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.
Pgina
17
Manual Integracin
Versin 2.3
POS Integrado
6. Especificacin de Protocolo de Comunicacin Caja POS
La comunicacin es a travs de una puerta serial RS232, a velocidades que van desde los 1200
Bps hasta 115200 Bps (8N1).
6.1 Esquema de Comunicacin Caja - POS
POS
Todos los comandos que se envan desde la Caja al POS deben cumplir con este flujo.
6.2 Flujo de la Comunicacin Caja - POS
ACK: Lo enva el POS o la caja como aviso de recepcin OK (valor Hexa 0x06).
NACK: Lo enva 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 l envi del
requerimiento por la caja y la respuesta desde el POS.
El formato para los requerimientos y respuestas: <STX><DATA><ETX><LRC>.
LRC: Es un byte que se concatena luego del <ETX> 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).
Pgina
18
Manual Integracin
Versin 2.3
POS Integrado
7. Mensajera de Comandos
Consideraciones Generales de Mensajera
La separacin entre campos se realiza con el carcter | (valor Hexa 0x7C), evitando rellenar los
datos, es decir; para rescatar la informacin tanto la caja como el POS, debe buscar este carcter.
Ejemplo: Transaccin 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|xxxxxxxxxxx<0x03>LRC
7.1 Venta
7.1.1 Solicitud Venta
DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02
Comando 4 Valor 0200
Separador de campo 1 Valor | Hexa 0x7c
Monto 9 Valor Numrico
Nmero Ticket/Boleta 6 Valor alfanumrico
Enviar Mensajes 1 Indica si el POS debe enviar mensajes de estatus
de la transaccin (1=Enva Mensajes, 0=No enva
mensajes).
<ETX> 1 Indica Fin de comando Valor Hexa 0x03
<LRC> 1 Byte resultado de la operacin XOR del mensaje
Ejemplos Requerimientos:
<STX>0200|1000|||0|0<ETX>|
7.1.2 Mensajes Intermedios

La cantidad de mensajes intermedios depender del tipo de venta que se est realizando.
Pgina
19
Manual Integracin
Versin 2.3
POS Integrado

Cdigo Mensaje 2 Valor Numrico (Ver Tabla de Respuestas)
1.1.3 Respuesta Venta

Cdigo Respuesta 2 Valor Numrico
Cdigo de comercio 12 Valor Numrico
Terminal ID 8 Valor Alfanumrico
Cdigo Autorizacin 6 (Mximo) Valor Alfanumrico
Monto 9 (Mximo) Valor Numrico
Numero de Cuotas 2 Valor Numrico
Monto Cuota 9 Valor Numrico
(Mximo)
ltimos 4 Dgitos Tarjeta 4 Valor Numrico
Nmero Operacin 6 (Mximo) Correlativo de Transaccin del Terminal
Tipo de Tarjeta 2 CR=Crdito
(Crdito/Debito) DB=Debito
Fecha Contable 6 Valor ASCII. Se utiliza si es tarjeta Debito
Nmero de Cuenta 19 Valor ASCII. Se utiliza si es tarjeta Debito
Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de Tarjetas
Fecha Transaccin 8 Formato DDMMAAAA
Hora Transaccin 6 Formato HHMMSS
Empleado 4 Valor Numrico
Propina 9(Mximo) Valor Numrico
Separador de campo 1 (opcional) Valor | Hexa 0x7c
Pgina
20
Manual Integracin
Versin 2.3
POS Integrado
Ejemplos Respuesta:
<STX>0210|00|597029414300|75000804|1234|271653|1000|0||0972|000096|CR|||VI|30102015|
155118|1001|0|<ETX>q<STX>0210|00|597029414300|75000804|1234|271653|1000|0||0972|
000096|CR|||VI|30102015|155118|1001|0|<ETX>q
Pgina
21
Manual Integracin
Versin 2.3
POS Integrado
7.2 ltima Venta
7.2.1 Solicitud ltima Venta

<STX> 1 Indica inicio de comando Valor
Hexa 0x02
<ETX> 1 Indica Fin de comando Valor
Hexa 0x03
<LRC> 1 Byte resultado de la operacin
XOR del mensaje
Ejemplos Requerimiento:
<STX>0250|0<ETX>H
7.2.2 Respuesta ltima Venta

Hexa 0x02
Monto Cuota 9(Mximo) Valor Numrico
Nmero Operacin 6 (Mximo) Correlativo de Transaccin
del Terminal
Pgina
22
Manual Integracin
Versin 2.3
POS Integrado

Fecha Contable 6 Valor ASCII. Se utiliza si es
tarjeta Debito
Nmero de Cuenta 19 Valor ASCII. Se utiliza si es
tarjeta Debito
Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de
Tarjetas
Separador de campo 1(opcional) Valor | Hexa 0x7c
Hexa 0x03
XOR del mensaje
<ACK>
Anulacin
Solo se pueden anular las transacciones efectuadas con tarjeta Crdito.
7.3.1 Solicitud Anulacin

Hexa 0x02
del Terminal
Pgina
23
Manual Integracin
Versin 2.3
POS Integrado
Hexa 0x03
XOR del mensaje
<STX>1200|96<ETX>s
7.3.2 Respuesta Anulacin

Hexa 0x02
del Terminal
Hexa 0x03
XOR del mensaje
Ejemplos Respuesta:
<STX>1210|00|597029414300|75000804|271653|96<ETX>z
7.4 Cierre
7.4.1 Solicitud de Cierre

Hexa 0x02
Pgina
24
Manual Integracin
Versin 2.3
POS Integrado

Hexa 0x03
XOR del mensaje
<STX>0500|0<ETX>J
7.4.2 Respuesta de Cierre

Hexa 0x02
Hexa 0x03
XOR del mensaje
Ejemplo Respuesta:
<STX>0510|00|597029414300|75000804|<ETX><VT>
7.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 an se encuentran en la memoria de este.
En este caso el campo de solicitud Detalle a la Caja indica si el POS realizar slo la impresin
del detalle de ventas en el POS o enviar a la caja el detalle de ventas, transaccin por transaccin
Pgina
25
Manual Integracin
Versin 2.3
POS Integrado
Las dos opciones que maneja este comando para obtener el detalle de transacciones en memoria
del equipo son:
Valor 0: El POS imprime voucher con el detalle completo de transacciones que existen en
memoria.
Valor 1: El POS enva a la Caja el detalle de transacciones realizadas y almacenadas en la
memoria del POS. Entre cada transaccin la Caja debe enviar un ACK al POS. El POS en
la ltima trx que enva responde con el mismo formato de mensaje pero el cdigo de
autorizacin en blanco.
Detalle a la Caja Valor

Imprime POS 0
Enva Data a la Caja 1
7.5.1 Solicitud Detalle de Ventas

Hexa 0x02
Detalle a la Caja 1 Valor Numrico
Hexa 0x03
XOR del mensaje
Ejemplo Respuesta:
<STX>0260|0<ETX>K
Pgina
26
Manual Integracin
Versin 2.3
POS Integrado
6.5.2 Respuesta Detalle de Ventas

Hexa 0x02
del Terminal
Fecha Contable 6 Valor Ascii. Se utiliza si es
tarjeta Debito
Nmero de Cuenta 19 Valor ASCII. Se utiliza si es
tarjeta Debito
Abreviacin Tarjeta 2 Ver Tabla de Abreviacin de
Tarjetas
Monto Cuota 9(Mximo) Valor Numrico
Separador de campo 1(opcional) Valor | Hexa 0x7c
Pgina
27
Manual Integracin
Versin 2.3
POS Integrado
Hexa 0x03
XOR del mensaje
7.6 Totales
Esta operacin le permitir a la caja tener un resumen de totales con las transacciones que fueron
procesadas.
Adems la Caja podr determinar si existen transacciones que no fueron informadas desde el
POS, haciendo una comparacin de los Totales que tiene la Caja y el POS.
La impresin del Voucher de totales ser realizada por el POS.
Pgina
28
Manual Integracin
Versin 2.3
POS Integrado
7.6.1 Solicitud Totales:

Hexa 0x02
Hexa 0x03
XOR del mensaje
Ejemplo Requerimiento:
<STX>0700||0<ETX>y
7.6.2 Respuesta Detalle de Totales

Hexa 0x02
Nmero de TX 3 Valor Numrico
Totales 9 Valor Numrico
Hexa 0x03
XOR del mensaje
Ejemplo Respuesta:
<STX>0710|00|1|1000<ETX>I
Pgina
29
Manual Integracin
Versin 2.3
POS Integrado
7.7 Carga de Llaves
7.7.1 Solicitud Carga de Llaves

Hexa 0x02
Hexa 0x03
XOR del mensaje
<STX>0800<ETX><VT>
7.7.2 Respuesta Carga de Llaves

Hexa 0x02
Hexa 0x03
XOR del mensaje
Pgina
30
Manual Integracin
Versin 2.3
POS Integrado
Ejemplo Respuesta:
<STX>0810|00|597029414300|75000804|<ETX>
7.8 Pooling
7.8.1 Solicitud Pooling

Hexa 0x02
Hexa 0x03
XOR del mensaje
<STX>0100<ETX><STX>
7.8.2 Respuesta Pooling

<ACK> 1 Comando recibido OK
Valor Hexa 0x06
Ejemplo Respuesta:
<ACK>
Pgina
31
Manual Integracin
Versin 2.3
POS Integrado
7.9 Cambio de Modalidad a POS Normal
Esta funcin le permitir a la caja, realizar el cambio de modalidad a travs de un comando.

El POS debe estar en modo integrado y al recibir el comando quedara en modo normal.
7.9.1 Solicitud Cambio Modalidad a POS Normal:

Hexa 0x02
Hexa 0x03
XOR del mensaje
<STX>0300|<ETX>|
7.9.2 Respuesta Cambio Modalidad a POS Normal:

<ACK> 1 Comando recibido OK
Valor Hexa 0x06
Ejemplo Respuesta:
<ACK>
Pgina
32
Manual Integracin
Versin 2.3
POS Integrado
8. Voucher
Los voucher sern impresos por el POS para todos los casos.
9. Flujos de Venta y Otros
9.1 Flujo TX 3.20 con boleta, propina, empleado
9.2 Flujo TX 3.20 sin boleta, propina, empleado
Pgina
33
Manual Integracin
Versin 2.3
POS Integrado
9.3 Flujo TX 3.40 con boleta, propina, empleado
Pgina
34
Manual Integracin
Versin 2.3
POS Integrado
9.4 Flujo TX 3.40 sin boleta, propina, empleado
Pgina
35
Manual Integracin
Versin 2.3
POS Integrado
9.5 Cambio de modalidad POS Normal a POS Integrado
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.
9.6 Cambio de modalidad POS Integrado a POS Normal
Pgina
36
Manual Integracin
Versin 2.3
POS Integrado
10. Tipos de Conexin a POS
10.1 Conexin con Cable Serial

El POS utilizado para la solucin POS integrado es el Verifone Vx520. Estos cuentan con una
conexin 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.
Conexin
Corriente
RS232: Cable Serial ETH = Ethernet

POS/Caja Conexin LAN Internet
Pgina
37
Manual Integracin
Versin 2.3
POS Integrado
Todos los cables conectados deberan estar de la siguiente forma:
Pgina
38
Manual Integracin
Versin 2.3
POS Integrado
10.2 Conexin POS Integrado con cable LAN para comunicacin con
Transbank
El equipo por defecto viene configurado para recibir las IP por DHCP. Tambin est la posibilidad
de con IP fija. Para realizar el cambio a IP fija se debe realizar el siguiente procedimiento.
A. Primero debemos ingresar al men de CONFIGURACION del POS. Para esto el usuario
debe presionar a la tecla F1 o F2 para que aparezca la pantalla Transbank y las opciones
de VENTA, CIERRE, COMERCIO y CONFIGURACIN:
B. Una vez estando la siguiente pantalla se debe seleccionar opcin Func. Instalacin F1,
donde se debe ingresar el RUT y la Clave Tcnico (solicitar RUT y clave a operaciones).
C. Luego una vez seleccionado la opcin CONFIGURACION POS desplegara la siguiente

pantalla:
Pgina
39
Manual Integracin
Versin 2.3
POS Integrado
D. En la siguiente pantalla se debe seleccionar la opcin 4 (F4) Config Comunicac. Una vez
seleccionada esta opcin el men desplegado ser el siguiente, donde se debe escoger la
opcin F2 Ethernet.
E. Posterior a la seleccin del medio de conexin Ethernet se debe seleccionar la opcin F2

IP FIJA.
F. Una vez seleccionado el men 2 (F2) IP FIJA aparecer pantalla para ingresar el N de IP
de Terminal, mascara de subred, Gateway y los DNS.
G. Posterior a la configuracin de la IP fija POS quedara con la siguiente pantalla:
H. Una vez estando en esta pantalla ser necesario presionar el botn rojo del POS.
Pgina
40
Manual Integracin
Versin 2.3
POS Integrado
Para que el equipo logre comunicarse con los servidores de Transbank, es necesaria la habilitacin
de los siguientes trficos en la RED del comercio:
DESARROLLO
200.10.12.16 puerto 4100
200.10.12.216 puerto 8087
10.3 Conexin POS Integrado con cable TELEFNICO para comunicacin

con Transbank
El equipo por defecto viene configurado para discar los nmeros telefnicos del ambiente de
desarrollo de Transbank. El equipo permite agregar un cdigo PABX si la lnea telefnica usada
est conectada a una central. (Debe consultar a Transbank).
Para configurar el PABX es necesario realizar el siguiente flujo:
A. Primero debemos ingresar al men de CONFIGURACION del POS. Para esto el usuario
debe presionar a la tecla F1 o F2 para que aparezca la pantalla Transbank y las opciones
de VENTA, CIERRE, COMERCIO y CONFIGURACIN:
Pgina
41
Manual Integracin
Versin 2.3
POS Integrado
B. Una vez estando la siguiente pantalla se debe seleccionar opcin Func. Instalacin F1,
donde se debe ingresar el RUT y la Clave Tcnico (solicitar RUT y clave a operaciones).
C. Luego una vez seleccionado la opcin CONFIGURACION POS desplegara la siguiente

pantalla donde se debe presionar la tecla enter para ir a pantalla 2:
D. Una vez ingresando a la opcin Pabx se procede a ingresar N Pabx.
Pgina
42
Manual Integracin
Versin 2.3
POS Integrado
11.Tabla Abreviacin de Tarjetas
TARJETA ABREVIACION
VISA VI
MASTERCARD MC
CABAL CA
CREDENCIAL CR
AMEX AX
CERRADA CE
DINNERS DC
PRESTO TP
MAGNA MG
MAS (CENCOSUD) TM
RIPLEY RP
EXTRA EX
CMR TC
REDCOMPRA DB
Pgina
43
Pgina 44
12. Tabla de Respuestas
Aprobado 00
Rechazado 01
Host no Responde 02
Conexin Fallo 03
Transaccin ya Fue Anulada 04
No existe Transaccin para Anular 05
Tarjeta no Soportada 06
Transaccin Cancelada desde el POS 07
No puede Anular Transaccin Debito 08
Error Lectura Tarjeta 09
Monto menor al mnimo permitido 10
No existe venta 11
Transaccin No Soportada 12
Debe ejecutar cierre 13
No hay Tono 14
Archivo BITMAP.DAT no encontrado. Favor 15
cargue
Error Formato Respuesta del HOST 16
Error en los 4 ltimos dgitos. 17
Men invalido 18
ERROR_TARJ_DIST 19
Tarjeta Invalida 20
Anulacin. No Permitida 21
TIMEOUT 22
Impresora Sin Papel 24
Fecha Invalida 25
Debe Cargar Llaves 26
Error de formato Campo de Boleta MAX 6 70
Solicitando Conformar Monto 80
Solicitando Ingreso de Clave 81
Enviando transaccin al Host 82
Error Cantidad Cuotas 88
Declinada 93
Toda transaccin cuyo cdigo de respuesta, en el POS, sea distinto de 0 ser considerada como
un rechazo. Por secreto bancario el detalle de la causa del rechazo no ser entregado al comercio.
Pgina 45
13. ANEXO 1
CONFIDENCIALIDAD DE LA INFORMACIN.
De acuerdo a las normativas vigentes, las transacciones con Tarjeta de Crdito y Dbito requieren
la incorporacin de los siguientes elementos de seguridad en el sistema:
La informacin de la banda magntica leda en el punto de venta NO debe ser almacenada en
ningn sistema. Para efectos de cuadratura e identificacin de transacciones, se debe utilizar el
NMERO DE TRANSACCIN.
TRATAMIENTO DE LOS TRACKS DE LA TARJETA

La informacin grabada en el Track I y Track II ser leda slo por los dispositivos de seguridad
(POS). Estos dispositivos procedern a encriptar el contenido del Track I y Track II para que esta
informacin no quede en claro.
El algoritmo de encriptacin utilizado para los tracks I y II es DES.
TRATAMIENTO DE LA DATA SENSIBLE.

Para asegurar la confidencialidad de la informacin, los mensajes de las transacciones o al menos
los datos sensibles (adems del PIN) deben viajar encriptados en los distintos tramos de la
conexin, tanto en el requerimiento como en la respuesta. Como datos sensibles se consideran:
nmero de tarjeta, fecha expiracin, nmero de cuenta y monto de la transaccin (dato validado en
Autenticacin de Mensajes o MAC).
EL MODELO MSTER/SESIN KEY

El mtodo actual de administracin de llaves es el llamado Mster/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 enva al servidor.
La Working Key se cambia en forma peridica (al menos en cada cierre), para evitar que sea
descubierta por terceros.
Pgina 46
Este modelo de administracin de llaves es el que se usar para las llaves MAC.
Nota: esta funcionalidad no se ve impactada por la incorporacin de transacciones con Chip
EL MODELO DUKPT ENCRIPTACION DE PIN

El nuevo mtodo de administracin de llaves para PIN que usar Transbank es el denominado
Llave nica derivada por transaccin o DUKPT por sus iniciales en ingls.
Bajo este mtodo los PED son inicializados en un ambiente seguro, con datos de identificacin
propios de cada PED (Identificador de la llave de derivacin, Identificador de PED nico y un
contador de transacciones iniciado en cero), ms una llave inicial que se calcula usando los datos
propios de cada PED y la llave de derivacin base. Con esta llave inicial se genera la prxima llave
de cifrado para PIN. Este proceso se realiza con una funcin asimtrica (DUKPT del PinPad), es
decir, una funcin 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 informacin que viaja desde y hacia el Autorizador de comercio,
se introduce un cdigo de autenticacin 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 enva un cdigo de MAC para el mensaje de respuesta, el cual debe ser validado por la
caja. Si la validacin que hace la caja del cdigo de MAC es negativa debe generar una reversa. La
transaccin 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 invlido en el mensaje de requerimiento, enva un mensaje de
respuesta con cdigo de rechazo 898 (MAC invlido).
Pgina 47
MANEJO DE LLAVES MAC (MESSAGE AUTHENTICATION CODE)
Las llaves criptogrficas para la generacin 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 lnea 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 transaccin atendida por Transbank.
Por lo que la caja debe registrar esta nueva llave para su uso en la siguiente transaccin.
Las llaves se deben cambiar automticamente todos los das. Esto implica que debe existir un
procedimiento de inicializacin o cierre obligatorio en cada caja (terminal ID) que se ejecuta en
forma automtica todos los das y que como parte de este procedimiento se enva a Transbank una
transaccin 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 encriptacin 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, operacin que se realiza
previamente a la instalacin 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 TCNICO

Para acceder a los menues de perfil tcnico, deber acreditarse con el RUT y la Clave que
corresponde a este rut.
Esta clave es de generacin dinmica, con caducidad mxima en 31 das.
Pgina 48
El algoritmo y el detalle de esta funcionalidad sern entregados a demanda, por el carcter de
confidencialidad del algoritmo.
MANEJO DE CLAVE SUPERVISORA

En las versiones ms antiguas cada comercio tena una tarjeta supervisora que le permita
autenticarse para realizar cierres, anulaciones y otras operaciones. A partir del ao 2011 en
adelante, durante el proceso de auto instalacin se solicitar la digitacin 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 digitacin de
una nueva clave de comercio.
MANEJO DE CLAVE MAESTRA DE COMERCIO / ACTIVACION

La solicitud de esta clave se realiza a Transervice.
.
Pgina 49
14. Anexo 2: Detalle campos de cada transaccin
LISTADO DE
TRANSACCIONES
Abreviacin Marca Tarjeta

Nmero de Ticket/Boleta
Fecha Real Transaccion

ltimos 4 Digitos Tarjeta
Hora Real Transaccion
Parametro Impresin
Codigo Autorizacion
Solicitud/Respuesta
Numero Operacin
Nmero de Cuenta
Codigo Respuesta
Codigo Comercio
Enviar Mensajes
Detalle a la Caja
Fecha Contable
Tipo de Tarjeta
Numero de Tx
Terminal Id
Funcion
Totales
Monto
CAMPOS
Largo del Campo 4 2 12 8 6 6 9 4 6 2 6 19 2 8 6 1 1 1 3 9
Transaccin Venta
Crdito/Debito (Desde
1 Caja -> POS) Solicitud 0200 x x x
(Desde POS -> Caja) Respuesta 0210 x x x x x x x x x x x x x x
Mensajes de estatus de la
transaccin (Desde
2 Pinpad -> POS) Respuesta 0900 x
Solicitud ltima Venta

3 (Desde Caja -> POS) Solicitud 0250
Transaccin Anulacin
de Venta (Desde Caja ->
4 POS) Solicitud 1200 x
(Desde POS -> Caja) Respuesta 1210 x x x x x
Transaccion de Cierre
(Desde POS -> Caja) Respuesta 0510 x x x
6 Transaccin Detalle de Solicitud 0260 x
Pgina 50
Ventas (Desde Caja ->
POS)
Transaccin Totales
(Desde POS -> Caja) Respuesta 0710 x x
Transaccion Carga
Llaves (Desde Caja ->
8 POS) Solicitud 0800
(Desde POS -> Caja) Respuesta 0810 x x x
Pooling -Probar
comunicaciones con
Pinpad (Desde Caja ->
9 POS) Solicitud 0100
(Reponde ACK) Respuesta
Cambio de Modalidad a
POS Normal (Desde Caja
10 -> POS) Solicitud 0300
(Reponde ACK) Respuesta
Pgina 51

Manual Pos Integrado Final

Cargado por

Información del documento

Descripción original:

Derechos de autor

Formatos disponibles

Compartir este documento

Compartir o incrustar documentos

Opciones para compartir

¿Le pareció útil este documento?

¿Este contenido es inapropiado?

Copyright:

Formatos disponibles

Manual Pos Integrado Final

Cargado por

Copyright:

Formatos disponibles

MANUAL DE DESARROLLO

4.1 TRANSACCIN DE VENTA..................................................................................................................................8

6. ESPECIFICACIN DE PROTOCOLO DE COMUNICACIN CAJA POS....................................................18

6.1 ESQUEMA DE COMUNICACIN CAJA - POS.......................................................................................................18

CONSIDERACIONES GENERALES DE MENSAJERA.......................................................................................................19

7.2 LTIMA VENTA.............................................................................................................................................22

9. FLUJOS DE VENTA Y OTROS............................................................................................................... 34

9.1 FLUJO TX 3.20 CON BOLETA, PROPINA, EMPLEADO.............................................................................................34

10. TIPOS DE CONEXIN A POS.......................................................................................................... 38

10.1 CONEXIN CON CABLE SERIAL.......................................................................................................................38

11. TABLA ABREVIACIN DE TARJETAS................................................................................................ 44

12. TABLA DE RESPUESTAS.................................................................................................................. 45

13. ANEXO 1....................................................................................................................................... 47

14. Anexo 2: Detalle campos de cada transaccin.......................................................................................51

Versin Cambio Responsable Fecha

1.9 Se agregan los siguientes campos en la transaccin de Andrs Oct-2012

Las transacciones soportadas por los equipos POS de Transbank son:

La comunicacin con Transbank y la lgica del procesamiento de una transaccin financiera es

4.1 Transaccin de Venta

o Lectura de Tarjeta Cdigo 78

4.2 Transaccin ltima Venta

Al momento de ejecutar un cierre se borran todas las transacciones almacenadas en la memoria

4.3 Transaccin Anulacin Venta

La transaccin de anulacin siempre ser de responsabilidad de la caja y es quien decide cuando

Nmero de Operacin: Valor enviado al POS, impreso en el Voucher de Venta. Le indica

4.4 Transaccin de Cierre.

Para el cierre no se solicita tarjeta supervisora.

4.5 Transaccin Detalle de Ventas

Importante: Un Cierre de Terminal, vaca la memoria del POS.

4.6 Transaccin Totales

4.7 Transaccin Carga de Llaves

4.8 Transaccin de Pooling

4.9 Cambio de Modalidad a POS Normal

Este comando le permitir a la caja, realizar el cambio de modalidad a travs de un comando.

5.2 ltima Venta

El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda en Batch y

El POS enva requerimiento al Autorizador, en caso de ser aprobada, se borra Batch y se

5.5 Carga de Llaves

El POS enva requerimiento al Autorizador, en caso de ser aprobada, se guarda nueva

6. Especificacin de Protocolo de Comunicacin Caja POS

6.1 Esquema de Comunicacin Caja - POS

6.2 Flujo de la Comunicacin Caja - POS

Consideraciones Generales de Mensajera

Ejemplo: Transaccin de Venta <0x02>0200|5000|0|0<0x03>LRC, Respuesta <0x02>0210|00|0|

7.1.1 Solicitud Venta

DATO LARGO COMENTARIO

7.1.2 Mensajes Intermedios

DATO LARGO COMENTARIO

<STX> 1 Indica inicio de comando Valor Hexa 0x02

1.1.3 Respuesta Venta

<LRC> 1 Byte resultado de la operacin XOR del mensaje

7.2 ltima Venta

7.2.1 Solicitud ltima Venta

7.2.2 Respuesta ltima Venta

Separador de campo 1 Valor | Hexa 0x7c

7.3.1 Solicitud Anulacin

7.3.2 Respuesta Anulacin

7.4.1 Solicitud de Cierre

Separador de campo 1 Valor | Hexa 0x7c

7.4.2 Respuesta de Cierre

7.5 Detalle de Ventas

Detalle a la Caja Valor

7.5.1 Solicitud Detalle de Ventas