> 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.md).

# Sincronizar tokens usando archivos por lotes

Thales **TIG** permite al **emisor** sincronizar tokens que no fueron creados a través de la plataforma TIG. Esto es útil cuando la tokenización para comercio electrónico se habilitó antes de que el emisor se conectara a TIG.

Este servicio no requiere nuevas API en el backend del emisor. Utiliza campañas de sincronización con el **TSP** para recuperar datos de tokens existentes. Solo se admiten Mastercard y Visa.

Para iniciar una campaña, el emisor carga un archivo por lotes de entrada (con los datos de las tarjetas a sincronizar) al Servicio de Tokenización mediante una conexión SFTP dedicada.

Después de completar el procesamiento, TIG genera un archivo de resultados de salida en formato JSON.

El emisor puede entonces descargar los resultados. TIG genera un archivo de salida por cada archivo de entrada.

Esto se ilustra, a alto nivel, en la imagen a continuación:

<figure><img src="/files/cf9e9eb8f13d9a4df86df9b2dc8b617221d28512" alt=""><figcaption><p>Flujo de sincronización de tokens a alto nivel usando archivos por lotes.</p></figcaption></figure>

{% hint style="info" %}
Para ayuda creando y administrando una cuenta SFTP con Thales, contacte a su **equipo de entrega de Thales**.
{% endhint %}

### Convención de nombres de archivos por lotes <a href="#batch-file-naming-convention" id="batch-file-naming-convention"></a>

Use este formato para los nombres de archivos por lotes de entrada:

`"BatchId"-"SeqNumber"-"UNIX_UTC_Timestamp".json`

Use este formato para los nombres de archivos por lotes de salida:

`"BatchId"-"SeqNumber"-"UNIX_UTC_Timestamp"_OUT.json`

Donde:

| NOMBRE               | DESCRIPCIÓN                                                                     |
| -------------------- | ------------------------------------------------------------------------------- |
| BatchId              | El identificador único del archivo por lotes.                                   |
| SeqNumber            | Se usa cuando el lote contiene muchos registros y se divide en varios archivos. |
| UNIX\_UTC\_Timestamp | Una marca de tiempo Epoch UNIX en segundos.                                     |

Ejemplo:

* BatchId = 87889898
* SeqNumber = 001
* Archivo de entrada: 87889898-001-1563188489.json
* Archivo de salida: 87889898-001-1563188615\_OUT.json

### Operaciones admitidas <a href="#operations-supported" id="operations-supported"></a>

Solo hay un tipo de operación admitido por el archivo por lotes:

* VIRTUAL\_CARD\_REGISTRATION

#### Registro de tarjeta virtual <a href="#virtual-card-registration" id="virtual-card-registration"></a>

Esta operación consulta al TSP por cada tarjeta en el archivo por lotes. Luego recupera los datos que TIG necesita para gestionar esos tokens.

No puede gestionar tokens creados fuera de TIG a través de TIG hasta que los sincronice.

#### Datos del token incluidos <a href="#token-data-included" id="token-data-included"></a>

Los datos del token registrados en TIG dependen de lo que proporcione el TSP. En la mayoría de los casos, TIG sincroniza:

* ID del token
* ID del solicitante de token (TRID)
* ID de referencia del PAN
* Sufijo del PAN del token
* Estado del token
* Tipo de token
* Hora de aprovisionamiento del token (si está disponible)
* Hora del último cambio de estado del token (si está disponible)
* Nombre del solicitante de token (si está disponible)
* ID del dispositivo (si está disponible)
* Nombre del dispositivo (si está disponible)

{% hint style="info" %}
La sincronización de tokens **no** significa que TIG actúa como una bóveda de tokens.

El rol de bóveda de tokens permanece con el TSP de la red de pagos.
{% endhint %}


---

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