> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/classic-tokenization/es/casos-de-uso/sincronizar-tokens-usando-archivos-por-lotes/estructura-del-archivo-de-salida-por-lotes.md).

# Estructura del archivo de salida por lotes

## Estructura del archivo de lote de salida <a href="#batch-file-output-structure" id="batch-file-output-structure"></a>

El archivo de salida tiene una estructura similar al archivo de lote de entrada.

La estructura del archivo de salida es la siguiente:

| NOMBRE              | TIPO   | TAMAÑO | M/O/C | DESCRIPCIÓN                                                                                                                                                       |
| ------------------- | ------ | ------ | ----- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| encabezado          | Objeto | -      | M     | Resumen de los resultados de sincronización de tokens.                                                                                                            |
| resultadosRegistros | Matriz | -      | C     | <p>Una matriz de registros.<br>Cada registro contiene el resultado de la operación. Este campo puede no estar presente si ocurre un error a nivel de archivo.</p> |

### Encabezado <a href="#header" id="header"></a>

El encabezado tiene la siguiente estructura:

| NOMBRE       | TIPO   | TAMAÑO | M/O/C | DESCRIPCIÓN                                                                                                                                                                                       |
| ------------ | ------ | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| batchId      | Cadena | 48     | M     | Identificador del encabezado del lote del archivo de entrada.                                                                                                                                     |
| seqNumber    | Cadena | 48     | M     | Número de secuencia del encabezado del lote del archivo de entrada.                                                                                                                               |
| issuerId     | Cadena | 48     | M     | Identificador del emisor del encabezado del lote del archivo de entrada.                                                                                                                          |
| operation    | Cadena | 48     | M     | Operación del encabezado del lote del archivo de entrada.                                                                                                                                         |
| totalRecords | Entero | N/A    | M     | Número total de registros incluidos en el informe.                                                                                                                                                |
| errorCode    | Cadena | 3      | C     | Presente sólo cuando ocurre un error a nivel de archivo. Ver [Códigos de error](/classic-tokenization/es/casos-de-uso/sincronizar-tokens-usando-archivos-por-lotes/tabla-de-codigos-de-error.md). |

### Resultados por registro <a href="#records-result" id="records-result"></a>

Cada registro tiene la siguiente estructura:

| NOMBRE                        | TIPO   | TAMAÑO | M/O/C | DESCRIPCIÓN                                           |
| ----------------------------- | ------ | ------ | ----- | ----------------------------------------------------- |
| rowId                         | Entero | -      | M     | Valor proporcionado en el archivo de lote de entrada. |
| virtualCardRegistrationResult | Objeto | -      | M     |                                                       |

#### Resultado del registro de la tarjeta virtual <a href="#virtual-card-registration-result" id="virtual-card-registration-result"></a>

| NOMBRE    | TIPO             | TAMAÑO | M/O/C | DESCRIPCIÓN                                                                                                                                                                                |
| --------- | ---------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| status    | Cadena           | 2      | M     | <p>- OK (El registro del lote se completa correctamente.)<br>- KO (El registro del lote falla.)</p>                                                                                        |
| card      | Tarjeta (Objeto) | N/A    | M     | Objeto que contiene los datos de identificación de la tarjeta y el resultado.                                                                                                              |
| errorCode | Cadena           | 3      | C     | Código de error devuelto cuando `status` es `KO`. Ver [Códigos de error](/classic-tokenization/es/casos-de-uso/sincronizar-tokens-usando-archivos-por-lotes/tabla-de-codigos-de-error.md). |

**Tarjeta**

| NOMBRE         | TIPO              | TAMAÑO | M/O/C | DESCRIPCIÓN                                                                                                                                                                                |
| -------------- | ----------------- | ------ | ----- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| id             | Cadena            | 1...48 | M     | Identificador único asignado por el Emisor.                                                                                                                                                |
| status         | Cadena            | 2      | M     | <p>- OK (El registro de la tarjeta se completa correctamente.)<br>- KO (El registro de la tarjeta falla.)</p>                                                                              |
| virtualCardIds | Matriz de Cadenas | N/A    | O     | Lista de IDs de tarjetas virtuales que TIG registra para la tarjeta.                                                                                                                       |
| errorCode      | Cadena            | 3      | C     | Código de error devuelto cuando `status` es `KO`. Ver [Códigos de error](/classic-tokenization/es/casos-de-uso/sincronizar-tokens-usando-archivos-por-lotes/tabla-de-codigos-de-error.md). |

### Ejemplo de archivo de lote <a href="#batch-file-example" id="batch-file-example"></a>

<br>

```json
{"header":
    {
        "batchId":"0000000000001111111111FF",
        "seqNumber":"001",
        "operation":"VIRTUAL_CARD_REGISTRATION",
        "issuerId":"BANK_PQRST",
        "totalRecords":1
    },
    "recordsResults":
        [
            {"rowId":0,
                "virtualCardRegistrationResult":{
                    "card": {
                                "id":"cms_f71b83a3-75da-4056-82a6-2d6128555463",
                                "status":"OK",
                                "virtualCardIds":["c05f9cf0-40f9-11ee-a782-af4a746b","c05f75e1-40f9-11ee-9761-af4a746b"],
                            }
            }
        ]
}
```


---

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

```
GET https://docs.payments.thalescloud.io/classic-tokenization/es/casos-de-uso/sincronizar-tokens-usando-archivos-por-lotes/estructura-del-archivo-de-salida-por-lotes.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
