Release 20261003 — APIDRIVER + UltraHost

Resumen — qué incluye este release

Qué cambió respecto de la versión anterior

Cada fila mapea el cambio con la acción requerida al actualizar. «Ninguna (código)» = ya viene en el binario, no hay que hacer nada.

UltraHost vs build anterior (p. ej. UH230508)

APIDRIVER vs 20231017

Actualizar UltraHost (soporte técnico)

Pasos

1. Parar el servicio / proceso UltraHost.
2. Backup: base de datos + UltraHost.ini + UltraHost.exe actual.
3. SQL (requerido). Correr en la base qa_ajustes_fiserv.sql (idempotente). Agrega columnas que el build nuevo consulta al arrancar — si faltan, UltraHost corta en la carga de tablas maestras y no levanta. Si la base no tiene la columna de protocolo de pinpad, correr también add_protocolo_pinpad_column.sql.
4. .ini (requerido). En UltraHost.ini, sección [PINPAD]: MODELO=FISERV, ENCRIPTA (0 ó 2), WK_ORIGEN (HOST / INYECTADA). En [HOST]: verificar puertos (PORTBINARY_POS_PINPAD_EMV=20004, etc.) y MAXFAILOVER_RESTART=2 en producción. Ver la tabla completa en «UltraHost — configuración (.ini)».
5. Reemplazar UltraHost.exe por el del release.
6. Arrancar y verificar en UltraHost.log que cargó las tablas maestras sin error. Si corta ahí → falta una columna SQL (volver al paso 3).
7. (V02/V04) Si se usa V04 en algún terminal, setear mTerminal.cProtocoloPinPad='V04' y reiniciar. Ver «Soporte V02 / V04».

Actualizar APIDRIVER (soporte técnico)

Pasos

1. Parar APIDRIVER.
2. Backup: jar actual + el .properties externo si ya existía + r.bat.
3. .properties (requerido). Crear / actualizar el archivo externo (ej. c:/Work/APIDRIVER/apidriver.properties) con la config completa (puerto, COM, URLs, timeouts). Ver la tabla «APIDRIVER — configuración». Recordar: spring.config.location reemplaza al embebido, así que el externo debe tener todo.
4. Reemplazar el jar por APIDRIVER-20261003.jar.
5. Arranque (requerido). Actualizar r.bat a la línea con -Dspring.config.location=file:c:/.../apidriver.properties antes del -jar (barras normales en la URI).
6. Arrancar y verificar: Tomcat started on port(s): 50001 y Started ApidriverpinpadApplication.

Inicio rápido (prueba E2E)

Topología de una prueba típica: Caja/POS → APIDRIVER (serie → pinpad) ↔ UltraHost (ISO 8583) → autorizador FISERV.

1) UltraHost (gateway)

cd C:\Work\AI\FISERV\ULTRAHOST
UltraHost.exe -d        REM consola, modo debug

Usa UltraHost.ini del mismo directorio. Verificá en el log UltraHost.log que arrancó y que las listas de base cargaron.

2) APIDRIVER (relay del pinpad)

cd C:\Work\AI\FISERV\APIDRIVER
r.bat
REM equivale a:
java -Dspring.config.location=file:c:/Work/APIDRIVER/apidriver.properties -jar target/APIDRIVER-20261003.jar

Al arrancar debe loguear Tomcat started on port(s): 50001 y Started ApidriverpinpadApplication.

Puertos y topología

Checklist de prueba E2E

• ☐ UltraHost arrancó sin errores de carga de base (revisar UltraHost.log).
• ☐ El procesador FISERV está habilitado y alcanzable en mProcesador (si no → error 263 al operar).
• ☐ El terminal de prueba existe en mTerminal y resuelve a un POS/sucursal válido.
• ☐ APIDRIVER levanta en 50001 y abre el COMx del pinpad.
• ☐ Sincronización de pinpad OK (si aplica) — el pinpad acepta las working keys.
• ☐ Operación de prueba (compra) → revisar código de respuesta y el dump ISO (x25.bin).

Errores comunes y qué significan

APIDRIVER 20261003 — cambios

Correcciones HIGH

Configuración externalizada

APIDRIVER ahora lee su configuración de un archivo externo (apidriver.properties) en vez del embebido en el jar. Criterio: externo siempre, interno nada.

• Otros cambios recogidos desde 2022: manejo de ACK del pinpad y ajustes de modelo de host.

APIDRIVER — cómo correrlo

java -Dspring.config.location=file:c:/Work/APIDRIVER/apidriver.properties -jar target/APIDRIVER-20261003.jar

spring.config.location reemplaza la ubicación por defecto (no la suma): el application.properties embebido deja de leerse, así que el externo tiene que estar completo.

APIDRIVER — configuración (apidriver.properties)

UltraHost (FISERV) — cambios

• Selección de protocolo PP-Caja V02/V04 por terminal (ver sección siguiente).
• Sincronización de pinpad modelo FISERV: flujo Y00 → S00 → S01 → S02, con manejo de working keys.
• Corrección de sincro con WK inyectadas: se resuelve el terminal antes de leer las working keys (antes daba error 264).
• Reconciliación del bitmap de sincro (SINCROPP) para que el conform no falle.
• Build dual VS2012 / VS2026 (toolset v145); ejecutable x86 self-contained.
• Assets de despliegue QA: ajustes SQL + plantilla de .ini + runbook (RUNBOOK_QA.md).

Soporte V02 / V04 (por terminal)

UltraHost ahora soporta simultáneamente las versiones V02 y V04 del protocolo PP-Caja, elegidas por terminal. Esto permite tener terminales viejos y nuevos conviviendo contra el mismo gateway.

La columna se agrega con add_protocolo_pinpad_column.sql. Para testers: para probar V04 en un terminal, poner cProtocoloPinPad = 'V04' en su fila de mTerminal y reiniciar UltraHost (las listas se cargan al arranque).

-- Ejemplo: pasar un terminal a V04
UPDATE dbo.mTerminal SET cProtocoloPinPad = 'V04' WHERE cNro = '<terminal>';
-- Volver a V02 (o default): poner 'V02' o NULL

UltraHost — configuración (UltraHost.ini)

Sección [PINPAD] (clave para FISERV)

Otras claves relevantes

UltraHost — ajustes SQL de base

Para una base que venía de una versión anterior, el build actual consulta columnas nuevas al arrancar. Si faltan, UltraHost no arranca (corta en la carga de tablas maestras). Están consolidados en qa_ajustes_fiserv.sql (idempotente):

Guía completa de despliegue y prueba: RUNBOOK_QA.md (en el repo de UltraHost).

Caveats conocidos

• APIDRIVER — serie: esta configuración usa 7E1 @ 115200. Verificar contra producción (posible 8N1 @ 19200) antes de desplegar.
• APIDRIVER — jar: el artefacto del release es target/APIDRIVER-20261003.jar. Si se recompila, mantener la versión fechada.
• UltraHost — sincro de WK: si el pinpad rechaza las working keys (error 266), es provisión del pinpad (su SAM / Master Key), no software.
• UltraHost — watchdog: dejar MAXFAILOVER_RESTART=2 en producción.
• UltraHost — ejecutable: el .exe no se distribuye en el release; se genera/despliega internamente.