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.
Resumen
| # | Cambio | Archivos | Estado |
|---|---|---|---|
| 1 | Voucher: "APROBADA" una sola vez | wsserver_json.cpp | a probar |
| 2 | Ticket no fiscal: una aprobada siempre dice "APROBADA" | client.cpp | a probar |
| 3 | Errores del pinpad con descripción | wsserver_json_fiserv.cpp | visto en QA |
| 4 | Sincronización del pinpad por excepción | wsserver_json_fiserv.cpp, trx_sql.cpp, trx.h, errors.h, add_requiere_sincro_column.sql | a 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.
| Y0E | Antes | Ahora |
|---|---|---|
| 01 | ERROR EN PINPAD (01) | ERROR PINPAD (01) CANCELADO |
| 05 | ERROR EN PINPAD (05) | ERROR PINPAD (05) LECTURA TARJETA CHIP |
| 09 | ERROR EN PINPAD (09) | ERROR PINPAD (09) FORMATO DE COMANDO |
| 20 | ERROR EN PINPAD (20) | ERROR PINPAD (20) DEBE SINCRONIZAR |
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ón | Antes | Ahora |
|---|---|---|
| Compra o anulación con marca en 0 | Y00 → S00 → Y41 | Y41 directo |
| Marca en 1, o no se puede leer | Y00 → S00 → Y41 | Y00 → S00 → S01 → S02 → Y41 (S01/S02 forzados aunque el S00 diga "00") |
| El pinpad responde Y0E 16/17/18/20 al Y41 directo | Error al POS | Prende 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 POS | Prende la marca y sincroniza en la misma operación |
Qué prende y qué apaga la marca
- Prende (1): el host responde
97en una compra o anulación; el pinpad rechaza la lectura con Y0E 16 (falta definición Y00), 17 (falta POS master key), 18 (falta working key) o 20 (debe sincronizar); una lectura directa sin working keys. - Apaga (0): el S02 responde "00"; el host aprueba una operación.
Cambios por archivo
wsserver_json_fiserv.cpp- Nuevas:
_LeerRequiereSincro_Fiserv,_MarcarRequiereSincro_Fiserv,_IniciarLecturaOSincro_Fiserv,_ReintentarConSincro_Fiserv. ProcesarDecodificaEmisor_FiservyProcesarIdentificarAnulacion_Fiserv: el primer llamado pasa por_IniciarLecturaOSincro_Fiserv._EmitirY41_Fiserv: parámetrobPostSincro(contextoY41S/Y01S) y fallback sin working keys._ProcesarSincroS00_Fiserv: con la marca en 1 fuerza S01/S02 (solo en la cadena previa a la lectura; la operación SINCRO_PINPAD queda igual)._ProcesarSincroS02_Fiserv: apaga la marca después del "00"._ResponderResultadoAutorizacion_Fiserv: 97 prende, aprobada apaga.- Handler del Y0E en
ProcesarOperacion_Fiserv: 16/17/18/20 sobreY41/Y01reintenta con sincronización.
- Nuevas:
trx_sql.cpp,trx.h:GetRequiereSincroPP/SaveRequiereSincroPP; nuevo parámetro opcional al final deGetTerminalCounters. El UPDATE solo escribe si el valor cambia.errors.h:sqlwc_PP_REQSINCRO = 256.
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
| Prueba | Resultado esperado | Estado |
|---|---|---|
| Compra aprobada | Voucher y ticket con "APROBADA" una sola vez | pendiente |
| Compra denegada | Código 51, "FONDOS INSUFICIENTES", sin voucher | pendiente |
| Error de pinpad | ERROR PINPAD (NN) TEXTO | visto (05 CHIP) |
| Compra con marca en 0 | Y41 directo, sin Y00 ni S00 | pendiente |
Compra con iRequiereSincroPP=1 | Y00 → S00 → S01 → S02 → Y41 y la marca vuelve a 0 | pendiente |
Contexto Y41S | APIDRIVER lo devuelve sin quejarse | pendiente |
| Respuesta 0210 del emulador | Sin campo 52; mTerminal.cWorkingKeyNew sin cambios | pendiente |
Despliegue
- Correr
add_requiere_sincro_column.sqlen la base. - Reemplazar
UltraHost.exey reiniciar el servicio. - Ejecutar las pruebas de la tabla anterior y revisar
eee,txyrx.
Anexo: emuladores (fuera de UltraHost)
- Campo 52:
uphost_serverfirstdatatcpyuphost_servervisatcpdevolvían en la 0210 el campo 52 del request. UltraHost lo toma como working key nueva y lo graba enmTerminal.cWorkingKeyNew. Ahora los emuladores no devuelven el campo 52. - Textos de respuesta: con
RESPUESTAFIJAconfigurado, el emulador usaba siempreMENSAJE_RTA_DENEGADA, también en las aprobadas por el flip. Ajuste del ini:MENSAJE_RTA_DENEGADAcomentado yRESPUESTAFIJA=51.
UltraHost sigue aceptando el campo 52 de una 0210 sin validarlo. Queda como mejora posible.