> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/almacenamiento-y-reenvio-supervision-de-lotes-de-red.md).

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

## 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.

{% hint style="info" %}
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.
{% endhint %}

## Configuración de Store and Forward

Configure Store and Forward en [Controlador de pagos](/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/formularios-del-cliente-de-configuracion/controlador-de-pagos.md).

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](/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/formularios-del-cliente-de-configuracion/herramientas.md) 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

<table data-header-hidden><thead><tr><th width="132" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Lanzado</td><td valign="top">Base057.01.00  ·  Base056.03.02  ·  Base055.02.10</td></tr><tr><td valign="top">Cliente</td><td valign="top">CITGO (específico de la marca)</td></tr><tr><td valign="top">Plataforma</td><td valign="top">Viper / EPS (lado del Commander, red NTS)</td></tr></tbody></table>

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.

{% hint style="info" %}
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.
{% endhint %}

#### Qué hace esta función

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

<table><thead><tr><th width="103" valign="top">Capa</th><th width="174" valign="top">Nombre</th><th valign="top">Descripción</th></tr></thead><tbody><tr><td valign="top">1</td><td valign="top">Prevención</td><td valign="top">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.</td></tr><tr><td valign="top">2</td><td valign="top">Autorreparación</td><td valign="top">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.</td></tr><tr><td valign="top">3</td><td valign="top">Escalación de alarmas</td><td valign="top">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.</td></tr></tbody></table>

#### Detalles del comportamiento

**Escritura atómica de archivos**

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

* escribir en un archivo temporal,&#x20;
* vaciar al disco,&#x20;
* renombrar al nombre de archivo final.&#x20;

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**

<table><thead><tr><th valign="top">Archivo</th><th valign="top">Reconstruido a partir de</th><th valign="top">Cuándo se activa</th></tr></thead><tbody><tr><td valign="top">BatchClose.xml</td><td valign="top">BatchConfig.xml, con recuperación alternativa a partir del nombre del directorio del lote</td><td valign="top">El archivo existe pero es ilegible</td></tr><tr><td valign="top">BatchConfig.xml</td><td valign="top">Archivos de transacciones individuales escaneados desde el disco</td><td valign="top">El archivo está ausente o está dañado</td></tr></tbody></table>

*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

<table><thead><tr><th width="186" valign="top">Atributo</th><th valign="top">Valor</th></tr></thead><tbody><tr><td valign="top">Red</td><td valign="top">NTS (solo marca CITGO)</td></tr><tr><td valign="top">Plataforma</td><td valign="top">Viper / EPS — lado de Commander</td></tr><tr><td valign="top">Tipos de transacción</td><td valign="top">Todos los tipos de transacción que usan liquidación de lotes NTS</td></tr><tr><td valign="top">Nuevo FID</td><td valign="top">ATOMICBATCHCFGWRITE (en FIDTable.xml)</td></tr><tr><td valign="top">Nueva alarma</td><td valign="top">BATCH CLOSE ERROR — CALL HELPDESK (inglés y español)</td></tr></tbody></table>

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](/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/metodos-de-pago.md) 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](/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/funciones-de-red.md) 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.**


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/cug-57.01-en/cug-57.01-es/referencia-de-usuario-de-commander-57.01/almacenamiento-y-reenvio-supervision-de-lotes-de-red.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
