Generar e imprimir recibos
Toda operación financiera procesada por Get Central puede dar lugar a la generación de uno o más recibos, dependiendo del tipo de operación, la configuración del terminal y las reglas de certificación. El manejo de recibos es administrado en gran medida por el propio TPVPC y está sujeto a estrictas restricciones técnicas y regulatorias.
Esta guía se aplica a Slim Pack.
Get Central soporta dos modelos de manejo de recibos:
- Generación e impresión automática de recibos, gestionada íntegramente por el TPVPC
- Manejo manual de recibos, leyendo campos relacionados con recibos en la respuesta XML
Requisitos
Antes de trabajar con recibos, asegúrate de que:
- Una transacción se haya completado y haya devuelto una respuesta XML final
- La máquina host tenga una impresora predeterminada configurada correctamente
- El tipo de impresora (impresora de tickets o A4) coincida con la certificación del terminal
El diseño, el contenido y el comportamiento de impresión del recibo son controlados por el TPVPC. La aplicación cliente no puede alterar los formatos de los recibos certificados.
Proceso de generación de recibos
El manejo de recibos depende del modo de funcionamiento y de la configuración del terminal.
Paso 1: Generación automática de recibos (controlada por el TPVPC)
En el modelo Slim Pack, los recibos son generados e impresos automáticamente por el TPVPC tras una operación exitosa (PAGO, DEVOLUCION, CONFIRMACION, etc.).
Características principales:
- La aplicación no llama a una función de generación de recibos
- El contenido del recibo se deriva del resultado de la transacción
- La impresión se envía a la impresora predeterminada del sistema
- La aplicación no puede suprimir, personalizar ni reformatear el recibo
Dependiendo de la operación y la configuración, el TPVPC puede imprimir:
- Recibo del cliente
- Recibo del comercio
- Ambos recibos
Paso 2: Datos del recibo en la respuesta XML
Incluso cuando la impresión es automática, la respuesta XML devuelta por Get Central puede incluir elementos relacionados con el recibo que se pueden utilizar para:
- Visualización en pantalla
- Almacenamiento para fines de auditoría
- Lógica de reimpresión (si lo soporta el entorno)
Los elementos comunes relacionados con recibos incluyen:
| Elemento de Datos | Etiqueta XML | Descripción |
|---|---|---|
| Líneas del recibo | <linea> | Líneas formateadas individuales del recibo |
| Recibo solo para el cliente | <ReciboSoloCliente> | Indica flujo de recibo solo para el cliente |
| Número de tarjeta enmascarado | <tarjetaClienteRecibo> | PAN enmascarado adecuado para impresión |
| Identificador del terminal | <terminal> | Terminal que procesó la operación |
| Fecha y hora | <fechaOperacion> | Timestamp de la operación |
La presencia de etiquetas relacionadas con recibos depende del tipo de operación y del comportamiento del terminal.
Paso 3: Construcción manual de recibos (uso limitado)
La construcción manual de recibos no es el modelo principal en las integraciones Slim Pack. Solo puede considerarse cuando:
- El entorno de integración desactiva explícitamente la impresión automática, o
- El recibo es necesario para fines distintos de la impresión (visualización en pantalla, almacenamiento para archivo)
En este caso, tu aplicación debe extraer de la respuesta XML los campos seguros para recibos.
Como mínimo, un recibo debe incluir:
| Campo Requerido | Etiqueta XML |
|---|---|
| Resultado de autorización | <resultado> |
| Código de respuesta | <codigoRespuesta> |
| Importe | <importe> |
| Moneda | <moneda> |
| Fecha y hora | <fechaOperacion> |
| Tarjeta enmascarada | <tarjetaClienteRecibo> |
| Terminal | <terminal> |
Regla de seguridad: El PAN completo, el CVV, el PIN o los datos criptográficos nunca deben imprimirse ni almacenarse. Solo pueden utilizarse los valores enmascarados devueltos por el TPVPC.
Paso 4: Cumplimiento y retención
Independientemente de la estrategia de recibos:
- Los recibos solo deben emitirse una vez que una transacción haya sido AUTORIZADA
- Los recibos almacenados deben coincidir con el resultado final de la transacción
- Las políticas de retención deben seguir las normativas fiscales y contables locales