UltraHost · Versión 20261117

Cambios del 17/11/2026

Textos de voucher y ticket no fiscal en operaciones aprobadas, descripción de los errores del pinpad FISERV y sincronización del pinpad por excepción.

Base: commit 67d44e1 · Build Debug Win32 UltraHost.exe 17/11/2026 15:58

4cambios funcionales
6 + 1archivos fuente + script SQL
+235 / −19líneas
−2comandos de pinpad por compra (sin sincronizar)

Resumen

#CambioArchivosEstado
1Voucher: "APROBADA" una sola vezwsserver_json.cppa probar
2Ticket no fiscal: una aprobada siempre dice "APROBADA"client.cppa probar
3Errores del pinpad con descripciónwsserver_json_fiserv.cppvisto en QA
4Sincronización del pinpad por excepciónwsserver_json_fiserv.cpp, trx_sql.cpp, trx.h, errors.h, add_requiere_sincro_column.sqla probar

1. Voucher sin "APROBADA" repetido

Problema: en una aprobada el voucher que recibe APIDRIVER mostraba "APROBADA" seguido del texto del campo 63 del autorizador. Cuando ese texto ya empezaba con "APROBADA" quedaba duplicado, y cuando el emulador mandaba un texto de denegada en una aprobada quedaba "APROBADA / DENEGADA / FONDOS INSUFICIENTES".

Cambio (wsserver_json.cpp, armado del voucher, ~línea 1671): si el campo 63 ya empieza con "APROBADA" se imprime tal cual; si no, se antepone "APROBADA" como antes. Se conservan los textos propios de FirstData, por ejemplo ,COMPRA EN PLAN Z.

if(strlen(pTrx->out_f63_mensaje) && !strnicmp(pTrx->out_f63_mensaje,"APROBADA",8))
	sp+=sprintf(sp,"%.180s\n", pTrx->out_f63_mensaje);	//ya dice APROBADA: no repetirlo
else if(strlen(pTrx->out_f63_mensaje))
	sp+=sprintf(sp,"%s\n%.180s\n", "APROBADA", pTrx->out_f63_mensaje);
else
	sp+=sprintf(sp,"APROBADA\n");

El origen del texto de denegada en aprobadas era el emulador (ver Anexo), no UltraHost. Este cambio deja el voucher robusto igual.

2. Ticket no fiscal robusto

Problema: en el ticket no fiscal (SetVoucher2Print) el resultado era directamente el texto del campo 63. En una aprobada con un texto de denegada en el 63, el ticket podía quedar como resultado "FONDOS INSUFICIENTES".

Cambio (client.cpp, ~línea 1901): si la operación está autorizada y el 63 no empieza con "APROBADA", se imprime primero "APROBADA" y después el texto del autorizador, igual que el voucher.

if(IsTrxAuthorized(&trxin) && strnicmp(trxin.out_f63_mensaje,"APROBADA",8))
	sp+=sprintf(sp,"APROBADA\n");
sp+=sprintf(sp,"%.200s\n", strlen(trxin.out_f63_mensaje)?trxin.out_f63_mensaje:"APROBADA");

Afecta también a los tickets del protocolo binario de POS en producción.

3. Errores del pinpad con descripción

Problema: un Y0E del pinpad llegaba al POS como ERROR EN PINPAD (09), sin el significado del código.

Cambio (wsserver_json_fiserv.cpp): nueva tabla _TextoErrorPinPad_Fiserv con los 37 códigos de la sección 3.3.17 del manual PP-Caja (igual en V02 y V04). El mensaje queda ERROR PINPAD (NN) TEXTO, con un máximo de 40 caracteres para entrar en cSystemErrorMsg. El código de resultado no cambia: 1000 + NN. Un código fuera de la tabla mantiene el texto anterior.

Y0EAntesAhora
01ERROR EN PINPAD (01)ERROR PINPAD (01) CANCELADO
05ERROR EN PINPAD (05)ERROR PINPAD (05) LECTURA TARJETA CHIP
09ERROR EN PINPAD (09)ERROR PINPAD (09) FORMATO DE COMANDO
20ERROR EN PINPAD (20)ERROR PINPAD (20) DEBE SINCRONIZAR

El mensaje se arma en el handler del Y0E de ProcesarOperacion_Fiserv y sale al JSON como datosHost.mensaje_resultado desde ResponderAlCliente (wsserver_json.cpp:1064).

4. Sincronización del pinpad por excepción

Problema: antes de cada lectura de tarjeta (Y41/Y01) UltraHost mandaba siempre Y00 → S00 para verificar la sincronización, aunque la resincronización real se necesita más o menos cada 24 h. Eran 2 idas y vueltas extra WS ↔ APIDRIVER ↔ pinpad en cada compra y en cada identificación de anulación.

Cambio: se sincroniza solo cuando hace falta, igual que el POS de referencia POSDINO (pos_ppfd.cpp:4175-4230, pos_card.cpp:640-646, pos_ppfd.cpp:263-268). La marca vive por terminal en mTerminal.iRequiereSincroPP.

Flujo

SituaciónAntesAhora
Compra o anulación con marca en 0Y00 → S00 → Y41Y41 directo
Marca en 1, o no se puede leerY00 → S00 → Y41Y00 → S00 → S01 → S02 → Y41 (S01/S02 forzados aunque el S00 diga "00")
El pinpad responde Y0E 16/17/18/20 al Y41 directoError al POSPrende la marca y encadena la sincronización en la misma operación
El Y41 posterior a la sincronización también falla—Error al POS, sin loop (contexto Y41S/Y01S)
Terminal sin working keys en mTerminal"Faltan working keys" al POSPrende la marca y sincroniza en la misma operación

Qué prende y qué apaga la marca

Cambios por archivo

Script de base de datos

Correr a mano en la base de UltraHost antes de desplegar el exe. Se puede ejecutar más de una vez.

-- add_requiere_sincro_column.sql
IF COL_LENGTH('dbo.mTerminal', 'iRequiereSincroPP') IS NULL
BEGIN
	ALTER TABLE [dbo].[mTerminal] ADD [iRequiereSincroPP] [smallint] NOT NULL CONSTRAINT [DF_mTerminal_iRequiereSincroPP] DEFAULT (0)
END
GO

-- Rollback:
-- ALTER TABLE [dbo].[mTerminal] DROP CONSTRAINT [DF_mTerminal_iRequiereSincroPP];
-- ALTER TABLE [dbo].[mTerminal] DROP COLUMN [iRequiereSincroPP];

Sin la columna, UltraHost deja un warning en el log y sincroniza siempre, como antes. Desplegar el exe sin correr el script no rompe nada.

El campo 60 de la 0200 no depende del Y00 de la misma operación: la versión de app del pinpad ya no llegaba a la 0200 antes de este cambio (upinpad se rearma en cada tramo del relay). Es un hueco previo, no introducido acá.

Pruebas en QA

PruebaResultado esperadoEstado
Compra aprobadaVoucher y ticket con "APROBADA" una sola vezpendiente
Compra denegadaCódigo 51, "FONDOS INSUFICIENTES", sin voucherpendiente
Error de pinpadERROR PINPAD (NN) TEXTOvisto (05 CHIP)
Compra con marca en 0Y41 directo, sin Y00 ni S00pendiente
Compra con iRequiereSincroPP=1Y00 → S00 → S01 → S02 → Y41 y la marca vuelve a 0pendiente
Contexto Y41SAPIDRIVER lo devuelve sin quejarsependiente
Respuesta 0210 del emuladorSin campo 52; mTerminal.cWorkingKeyNew sin cambiospendiente

Despliegue

  1. Correr add_requiere_sincro_column.sql en la base.
  2. Reemplazar UltraHost.exe y reiniciar el servicio.
  3. Ejecutar las pruebas de la tabla anterior y revisar eee, tx y rx.

Anexo: emuladores (fuera de UltraHost)

UltraHost sigue aceptando el campo 52 de una 0210 sin validarlo. Queda como mejora posible.