> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fintoc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Transferencias por lotes

> Carga, autoriza y ejecuta múltiples transferencias a la vez.

<Info>
  Disponible solo a través del Dashboard.
</Info>

## Resumen

Una transferencia por lotes te permite cargar, autorizar y ejecutar hasta 5000 transferencias desde un solo archivo. Úsala para nóminas, pagos a proveedores o desembolsos diarios a clientes.

### Beneficios clave

* Sube hasta **5000** transferencias en un archivo.
* Valida los datos automáticamente.
* Revisa los lotes antes de ejecutarlos.
* Requiere autenticación multifactor (MFA) antes de mover fondos.
* Da seguimiento al progreso y al resultado por lote o por transferencia individual.

***

## Cómo funciona

### 1. Crear una transferencia por lotes

1. Ve a **Transfers → Batch Transfers** en tu Dashboard de Fintoc y haz clic en **"Create"**.
2. Asigna una **descripción**, por ejemplo `Pagos de octubre`.
3. Descarga la plantilla específica por país:
   * 🇨🇱 [Plantilla Chile (CLP)](https://docs.google.com/spreadsheets/d/1Ngcl07HLR2LmQ97SERhL6qn4LddwGe1rbBE5oQpGGFA/edit?usp=sharing)
   * 🇲🇽 [Plantilla México (MXN)](https://docs.google.com/spreadsheets/d/12jCDW2K69eeZ-Rk-l6c4PQf7eVYKBID-9hBjIeoZPts/edit?usp=sharing)

### 2. Completar la plantilla

Cada fila representa una transferencia.

| Campo                         | Descripción                                                                                  | 🇨🇱 Requerido | 🇲🇽 Requerido | Notas                                                                                                                                                                                                                                                          |
| ----------------------------- | -------------------------------------------------------------------------------------------- | -------------- | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `sender_account_number`       | Número de cuenta desde donde se envía el dinero.                                             | ✅              | ✅              |                                                                                                                                                                                                                                                                |
| `counterparty_holder_id`      | Identificador fiscal del titular de la cuenta destino: 🇨🇱 RUT chileno o 🇲🇽 RFC mexicano. | ✅              | ❌              |                                                                                                                                                                                                                                                                |
| `counterparty_name`           | Nombre del titular de la cuenta destino.                                                     | ❌              | ❌              |                                                                                                                                                                                                                                                                |
| `counterparty_institution_id` | Institución de la cuenta de la contraparte.                                                  | ✅              | ❌ / ✅          | 🇲🇽 Requerido si no proporcionas una CLABE. Usa un código de 5 dígitos de [esta lista](https://www.banxico.org.mx/cep-scl/listaInstituciones.do).<br />🇨🇱 Un código como `cl_banco_bbva` de [esta lista](/es/reference/fintoc-api/chile-institution-codes). |
| `counterparty_account_number` | Número de la cuenta destino.                                                                 | ✅              | ✅              | CLABE (MX) o número de cuenta (CL)                                                                                                                                                                                                                             |
| `amount`                      | Monto a transferir a la cuenta destino.                                                      | ✅              | ✅              | CLP (entero) o MXN (decimal con `.`)                                                                                                                                                                                                                           |
| `comment`                     | Nota de texto libre adjunta a la transferencia.                                              | ❌              | ❌              | Opcional. Máx. 40 caracteres                                                                                                                                                                                                                                   |
| `reference_id`                | Referencia numérica.                                                                         | ❌              | ❌              | Opcional. Máx. 7 dígitos                                                                                                                                                                                                                                       |
| `meta/...`                    | Columnas personalizadas de metadata.                                                         | ❌              | ❌              | Se permiten hasta 50. Por ejemplo, la columna `meta/user_name` resulta en la columna personalizada `user_name`.                                                                                                                                                |

<Warning>
  En Chile, Fintoc divide cualquier fila de transferencia mayor a 7,000,000 CLP en múltiples transferencias independientes.
</Warning>

### 3. Sube tu archivo

* Fintoc admite archivos **CSV**.
* Fintoc muestra mensajes de validación cuando encuentra errores.

Si ves un error, corrige tu archivo y vuelve a subirlo.
Fintoc muestra advertencias, como filas duplicadas, pero estas no bloquean la carga.

### 4. Revisar y confirmar

Antes de crear tu lote:

* Revisa el **total de transferencias** y el **monto total transferido**
* Si es necesario, regresa y carga un nuevo archivo

Después de confirmar, tu lote aparece en **Pending Authorizations**.

### 5. Autorizar el lote

1. Ve a la pestaña **Authorizations** y selecciona tu lote para abrir sus detalles.
2. Revisa el lote una última vez.
3. Elige una acción (no se puede deshacer):
   * ✅ **Authorize** (requiere MFA)
   * ❌ **Reject**

### 6. Ejecución y seguimiento

Una vez autorizado por completo:

* El lote pasa a **`in_progress`**.
* Cada transferencia aparece individualmente en tu vista de **Transfers** como `pending` y luego `succeeded` o `failed`.
* Si algunas transferencias fallan, por ejemplo por saldo insuficiente, el lote termina como **`partially_succeeded`**.
* Los lotes **expiran automáticamente después de 2 semanas** si no se autorizan.

## Probar la integración

Confirma que el lote llega a `succeeded` o `partially_succeeded` en tu vista de **Transfers**. Si alguna fila aparece como `failed`, revisa la razón del fallo antes de reintentarla.

## Estados del lote

| Estado                  | Descripción                                             |
| ----------------------- | ------------------------------------------------------- |
| `pending_authorization` | Creado, en espera de aprobación.                        |
| `in_progress`           | Autorizado y en ejecución.                              |
| `succeeded`             | Todas las transferencias se completaron con éxito.      |
| `partially_succeeded`   | Algunas transferencias tuvieron éxito y otras fallaron. |
| `failed`                | Todas las transferencias fallaron.                      |
| `rejected`              | Rechazado por un aprobador.                             |
| `expired`               | No se autorizó dentro de 2 semanas.                     |

<br />