> 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-en-es-419/referencia-del-usuario-de-commander-57.01/almacenamiento-y-reenvio-supervision-de-lotes-de-red.md).

# Almacenamiento y reenvío: supervisión de lotes de red

Almacenamiento y reenvío: configura y supervisa las transacciones de contingencia 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.

{% hint style="info" %}
Para VAPS CITGO, a partir de Verifone Commander Release 57.01, se implementó lo siguiente para garantizar una conciliación oportuna:

Cuando hay lotes de red abiertos con más de 72 horas de antigüedad, se muestra el mensaje «Unclosed Network Batches; Call Help Desk» en el POS.

Cuando hay lotes de red abiertos con más de 120 horas de antigüedad, se muestra el mensaje «Unclosed Network Batches; Transaction Processing Halted; Call Help Desk» en el POS y se bloquea el procesamiento de transacciones en Commander. El procesamiento se reanuda después de procesar los lotes antiguos.
{% endhint %}

## Configuración de Store and Forward

Configure Store and Forward en [Payment Controller](https://docs.verifone.com/cug-57.01-en/cug-57.01-en-es-419/referencia-del-usuario-de-commander-57.01/formularios-del-cliente-de-configuracion/controlador-de-pagos.md).

Vaya a **EPS Configuration** → **EPS Global Configuration** → **EPS** → **Misc**.

Revise estos campos:

* **Store and Forward Limit** — establece la cantidad de transacciones de respaldo permitidas.
* **Online Velocity Check Required** — aplica controles de velocidad a las transacciones en línea y sin conexión.
* **Data Storage Time (In Days)** y los campos de seguridad relacionados — muestran la configuración de retención.

Las transacciones EMV pueden permitir aprobaciones en modo de contingencia cuando el host está sin conexión.

Los parámetros del modo de contingencia son específicos del FEP.

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

## Monitoreo de Store and Forward

Use [Tools](https://docs.verifone.com/cug-57.01-en/cug-57.01-en-es-419/referencia-del-usuario-de-commander-57.01/formularios-del-cliente-de-configuracion/herramientas.md) para revisar el estado de los pagos.

Vaya a **Helpdesk Diagnostics** → **Payment Status**.

Esta vista incluye:

* Recuento de Store and Forward
* Detalles del lote actual
* Hora de la última transacción

### Monitoreo de lotes de la red

<table data-header-hidden><thead><tr><th width="132" valign="top"></th><th valign="top"></th></tr></thead><tbody><tr><td valign="top">Versiones publicadas</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 (del lado de Commander, red NTS)</td></tr></tbody></table>

Los sitios de CITGO experimentaban lotes «atascados» debido a archivos de liquidación dañados o de cero bytes. Cuando BatchClose.xml o BatchConfig.xml sufría daños, el hilo de Store-and-Forward (SAF) entraba en un bucle infinito silencioso que bloqueaba la liquidación de todas las transacciones. Los sitios podían tardar horas en descubrir el problema.

{% hint style="info" %}
Nota: La solicitud original de la función describía un monitor del envejecimiento de lotes de 72 y 120 horas, con advertencias en el POS y bloqueo de transacciones. La solución implementada adopta un enfoque diferente: previene y corrige automáticamente la causa raíz (los archivos dañados) en lugar de monitorear el envejecimiento. El concepto del monitor de envejecimiento se derivó al proyecto Verifone Commander Central Health & Alerts.
{% endhint %}

#### Qué hace esta función

Se agregaron 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. Primero, el sistema prepara el archivo en una ubicación temporal y luego lo reemplaza de una sola vez, de modo que una falla nunca deje un archivo incompleto 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 individuales de transacciones almacenados en el disco.</td></tr><tr><td valign="top">3</td><td valign="top">Escalamiento de alarmas</td><td valign="top">Si la reconstrucción automática falla por completo, se activa una nueva alarma de inmediato para notificar al personal, en lugar de que el sistema siga ejecutándose en un bucle silencioso.</td></tr></tbody></table>

#### Detalles del comportamiento

**Escrituras atómicas 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 los datos al disco,&#x20;
* cambiar el nombre por el nombre de archivo definitivo.&#x20;

Si se produce un error, la operación se reintenta hasta tres veces. Cuando se inicia Verifone Commander, se eliminan automáticamente los archivos temporales que hayan quedado de un bloqueo anterior.

Un nuevo indicador de configuración (ATOMICBATCHCFGWRITE) controla si se habilitan las escrituras atómicas para BatchConfig.xml.

**Detección de archivos de cero bytes**

Antes de leer cualquiera de los archivos, el sistema verifica si está vacío. Si lo está, se considera ilegible y se inicia el proceso de reconstrucción, en lugar de generar un error de deserialización.

**Reconstrucción automática**

<table><thead><tr><th valign="top">Archivo</th><th valign="top">Se reconstruye 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 una alternativa basada en el 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 examinados en el disco</td><td valign="top">El archivo no existe o está dañado</td></tr></tbody></table>

*Si no se pueden leer campos clave, como el número de lote o el número de secuencia, desde el archivo de configuración, el sistema los recupera individualmente del nombre del directorio del lote. Así se evitan errores de desfase de una unidad 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 en silencio; se espera que el establecimiento llame a la mesa de ayuda para realizar la recuperación manual.

Este escenario extremo requiere que varios archivos se dañen al mismo tiempo y es muy poco frecuente en condiciones normales de operación.

#### Alcance 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 transacciones</td><td valign="top">Todos los tipos de transacciones que usan la liquidación de lotes de 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. Solo se aplica cuando está instalada la red NTS.

#### **Liquidación detenida / SAF en bucle silencioso**

1. Revisa los registros de Commander para encontrar entradas WARN que mencionen un BatchClose.xml o BatchConfig.xml de cero bytes.
2. Comprueba si el nombre del directorio del lote coincide con el formato esperado de fecha y secuencia.
3. Busca la alarma BATCH CLOSE ERROR — CALL HELPDESK en la pantalla de alarmas de Commander.
4. Si no hay ninguna alarma, pero SAF parece estar en un bucle, revisa el directorio de lotes de NTS para buscar 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 ilegibles; se trata de un escenario extremo con varios errores. Se requiere intervención manual. El establecimiento debe comunicarse con la mesa de ayuda para recuperar los datos del lote.

#### **La función no se activa en un establecimiento CITGO después de la actualización**

* Confirma que la red instalada sea NTS (marca CITGO).
* Verifica que la compilación sea Base057.01.00, Base056.03.02 o Base055.02.10, o una versión posterior.
* Revisa FIDTable.xml en Commander para confirmar que esté presente la entrada ATOMICBATCHCFGWRITE.

## Funciones relacionadas

Usa [Métodos de pago](https://docs.verifone.com/cug-57.01-en/cug-57.01-en-es-419/referencia-del-usuario-de-commander-57.01/metodos-de-pago.md) cuando necesites opciones de recuperación manual.

**26 - Forzar envío** se usa para las transacciones procesadas mientras el host estaba desconectado.

Usa [Funciones de red](https://docs.verifone.com/cug-57.01-en/cug-57.01-en-es-419/referencia-del-usuario-de-commander-57.01/funciones-de-red.md) para los flujos de trabajo relacionados con el host y la red de pagos.

## Solución de problemas

**Si los recuentos de Store and Forward aumentan inesperadamente, primero verifica la conectividad del host.**

**Luego revisa la configuración de EPS y los parámetros de modo suplente del FEP.**

**Si el comportamiento varía según el tipo de tarjeta, confirma las reglas específicas del procesador con tu 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
