Almacenamiento y reenvío - Supervisión de lotes de red

Almacene y reenvíe. Configure y supervise transacciones de respaldo sin conexión.

Descripción general

Store and Forward administra las transacciones de respaldo cuando el host de pagos no está disponible.

Úselo con su configuración de EPS y FEP.

El comportamiento del host puede variar según el procesador.

Para VAPS CITGO, a partir de Verifone Commander Release 57.01, con el fin de garantizar una conciliación oportuna, se ha implementado lo siguiente:

Cuando hay lotes de red abiertos con más de 72 horas, se muestra en el POS el mensaje "Lotes de red sin cerrar; llame al Help Desk"

Cuando hay lotes de red abiertos con más de 120 horas, se muestra en el POS el mensaje "Lotes de red sin cerrar; procesamiento de transacciones detenido; llame al Help Desk" y el procesamiento de transacciones se bloquea en el Commander. El procesamiento de transacciones se reanuda después de que se procesan los lotes antiguos.

Configuración de Store and Forward

Configure Store and Forward en Controlador de pagos.

Vaya a Configuración de EPS → Configuración global de EPS → EPS → Varios.

Revise estos campos:

• Límite de Store and Forward — establece el número de transacciones de respaldo permitidas.
• Se requiere verificación de velocidad en línea — aplica verificaciones de velocidad a las transacciones en línea y fuera de línea.
• Tiempo de almacenamiento de datos (en días) y los campos de seguridad relacionados — muestran la configuración de retención.

Las transacciones EMV pueden permitir aprobaciones de respaldo cuando el host está fuera de línea.

Los parámetros de respaldo son específicos de FEP.

Consulte la documentación de su FEP antes de cambiar los valores de respaldo EMV.

Monitoreo de Store and Forward

Use Herramientas para revisar el estado del pago.

Vaya a Diagnósticos del Help Desk → Estado del pago.

Esta vista incluye:

• Cantidad de Store and Forward
• Detalles del lote actual
• Momento de la última transacción

Monitoreo de lotes de red

Lanzado	Base057.01.00 · Base056.03.02 · Base055.02.10
Cliente	CITGO (específico de la marca)
Plataforma	Viper / EPS (lado del Commander, red NTS)

Los sitios CITGO estaban experimentando lotes "atascados" causados por archivos de liquidación dañados o de tamaño cero. Cuando BatchClose.xml o BatchConfig.xml se dañaba, el subproceso Store-and-Forward (SAF) entraba en un bucle infinito silencioso, bloqueando toda la liquidación de transacciones. Los sitios no descubrían el problema durante horas.

Nota: La solicitud de función original describía un monitor de antigüedad de lotes de 72 horas y 120 horas con advertencias en el POS y bloqueo del procesamiento de transacciones. La solución implementada adopta un enfoque diferente: previene y se autorrepara de la causa raíz (archivos dañados) en lugar de monitorear la antigüedad. El concepto del monitor de antigüedad se redirigió al proyecto C-Site Health & Alerts.

Qué hace esta función

Se añadieron tres capas de protección al proceso de liquidación de lotes de la red NTS:

Capa	Nombre	Descripción
1	Prevención	Los archivos de liquidación se escriben de forma atómica. El sistema prepara primero el archivo en una ubicación temporal y luego lo reemplaza de una sola vez, de modo que un fallo nunca pueda dejar un archivo a medio escribir o vacío.
2	Autorreparación	Si se detecta un archivo dañado al iniciar o durante la liquidación, el sistema lo reconstruye automáticamente a partir de los registros de transacciones individuales almacenados en el disco.
3	Escalación de alarmas	Si la reconstrucción automática falla por completo, se activa de inmediato una nueva alarma para que el personal sea notificado en lugar de que el sistema se quede en un bucle silencioso.

Detalles del comportamiento

Escritura atómica de archivos

Tanto BatchClose.xml como BatchConfig.xml se escriben mediante un proceso seguro de tres pasos:

• escribir en un archivo temporal,
• vaciar al disco,
• renombrar al nombre de archivo final.

Esta operación se reintenta hasta tres veces en caso de fallo. Cualquier archivo temporal residual de un fallo anterior se elimina automáticamente cuando se inicia Verifone Commander.

Un nuevo indicador de configuración (ATOMICBATCHCFGWRITE) controla si la escritura atómica está habilitada para BatchConfig.xml.

Detección de archivos de cero bytes

Antes de leer cualquiera de los archivos, el sistema comprueba si el archivo está vacío. Un archivo vacío se trata como ilegible y activa el proceso de reconstrucción en lugar de provocar un error de deserialización.

Reconstrucción automática

Archivo	Reconstruido a partir de	Cuándo se activa
BatchClose.xml	BatchConfig.xml, con recuperación alternativa a partir del nombre del directorio del lote	El archivo existe pero es ilegible
BatchConfig.xml	Archivos de transacciones individuales escaneados desde el disco	El archivo está ausente o está dañado

Si campos clave como el número de lote o el número de secuencia no se pueden leer de la configuración, el sistema los recupera individualmente del nombre del directorio del lote, evitando errores de desplazamiento de uno en los totales de liquidación.

Alarma BATCH CLOSE ERROR — CALL HELPDESK

Si la reconstrucción falla por completo, el sistema activa la alarma: “BATCH CLOSE ERROR — CALL HELPDESK”. Esta alarma aparece en la pantalla de alarmas de Commander y también está disponible en español. La liquidación no continúa silenciosamente; se espera que el sitio llame al Help Desk para la recuperación manual.

Este escenario extremo requiere que varios archivos se dañen simultáneamente y es muy raro en condiciones normales de operación.

Ámbito y aplicabilidad

Atributo	Valor
Red	NTS (solo marca CITGO)
Plataforma	Viper / EPS — lado de Commander
Tipos de transacción	Todos los tipos de transacción que usan liquidación de lotes NTS
Nuevo FID	ATOMICBATCHCFGWRITE (en FIDTable.xml)
Nueva alarma	BATCH CLOSE ERROR — CALL HELPDESK (inglés y español)

Esta función no está activa para marcas que no sean CITGO. Se aplica solo cuando la red NTS está instalada.

Liquidación atascada / SAF en bucle silencioso

1. Revise los registros de Commander en busca de entradas WARN que mencionen BatchClose.xml o BatchConfig.xml de cero bytes.
2. Compruebe si el nombre del directorio del lote coincide con el formato de fecha y secuencia esperado.
3. Busque la alarma BATCH CLOSE ERROR — CALL HELPDESK en la pantalla de alarmas de Commander.
4. Si no hay ninguna alarma presente pero SAF parece estar en bucle, revise el directorio de lotes NTS en busca de archivos temporales que puedan indicar una escritura interrumpida.

La alarma se activa, pero la liquidación no se recupera

Esto significa que BatchClose.xml, BatchConfig.xml, y los archivos de transacciones individuales son todos ilegibles — un escenario extremo de fallos múltiples. Se requiere intervención manual. El sitio debe contactar al Help Desk para recuperar los datos del lote.

La función no está activa en un sitio CITGO después de la actualización

• Confirme que la red instalada sea NTS (marca CITGO).
• Verifique que la compilación sea Base057.01.00, Base056.03.02 o Base055.02.10, o posterior.
• Compruebe en Commander que FIDTable.xml contenga la entrada ATOMICBATCHCFGWRITE.

Funciones relacionadas

Use Métodos de pago cuando necesite opciones de recuperación manual.

26 - Forzar registro se usa para transacciones procesadas mientras el host estaba fuera de línea.

Use Funciones de red para flujos de trabajo relacionados con el host y la red de pagos.

Solución de problemas

Si los conteos de Store and Forward aumentan inesperadamente, verifique primero la conectividad con el host.

Luego revise la configuración de EPS y los parámetros de respaldo de FEP.

Si el comportamiento difiere según el tipo de tarjeta, confirme las reglas específicas del procesador con su proveedor de FEP.