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

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

> **Disponible solo vía Dashboard**

## Visión general

Las Batch Transfers están diseñadas para equipos que necesitan realizar **transferencias repetitivas o de alto volumen** de forma eficiente, manteniendo visibilidad y control total. Esta funcionalidad es ideal para nóminas, pagos a proveedores o desembolsos diarios a clientes.

### Beneficios clave

* Sube hasta **5000** transferencias en un solo archivo.
* Valida los datos automáticamente.
* Revisa los lotes antes de ejecutarlos.
* Requiere autorización MFA antes de mover fondos.
* Realiza seguimiento del progreso y resultados por lote o por transferencia individual.

***

## Cómo funciona

### 1. Crear una Batch Transfer

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 del 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 enviará el dinero.    | ✅              | ✅              |                                                                                                                                                                                          |
| `counterparty_holder_id`      | 🇨🇱 RUT o 🇲🇽 RFC del titular de la cuenta destino. | ✅              | :x:            |                                                                                                                                                                                          |
| `counterparty_name`           | Nombre del titular de la cuenta destino               | ❌              | ❌              |                                                                                                                                                                                          |
| `counterparty_institution_id` | La institución de la cuenta de la contraparte.        | ✅              | ❌ / ✅          | 🇲🇽 Requerido si no es CLABE. 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. |
| `counterparty_account_number` | Número de cuenta destino.                             | ✅              | ✅              | CLABE (MX) o número de cuenta (CL)                                                                                                                                                       |
| `amount`                      | Monto de la transferencia                             | ✅              | ✅              | CLP (entero) o MXN (decimal con `.`)                                                                                                                                                     |
| `comment`                     | Descripción                                           | ❌              | ❌              | Opcional. Máximo 40 caracteres                                                                                                                                                           |
| `reference_id`                | Referencia numérica                                   | ⛔              | ❌              | Opcional. Máximo 7 dígitos                                                                                                                                                               |
| `meta/...`                    | Columnas de metadata personalizadas.                  | ❌              | ❌              | Hasta 50 permitidas. Por ejemplo: la columna `meta/user_name` resultará en la columna personalizada `user_name`                                                                          |

> ⚠️ En **Chile**, Fintoc dividirá automáticamente las filas de transferencias con monto superior a 7.000.000 CLP en múltiples transferencias.
>
> Estas transacciones actuarán como nuevas transferencias independientes.

### 3. Sube tu archivo

* Formatos soportados: **CSV**
* Verás mensajes de validación si se detectan errores.

Si ves un error, corrige tu archivo y vuelve a subirlo.
Las advertencias (por ejemplo, filas duplicadas) se mostrarán, pero no bloquearán la subida.

### 4. Revisar y confirmar

Antes de crear tu lote:

* Revisa el **número total de transferencias** y el **monto total a transferir**.
* Si es necesario, vuelve atrás y sube un nuevo archivo.

Después de confirmar, tu lote aparecerá 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`, luego `succeeded` o `failed`.
* Si algunas transferencias fallan (por ejemplo, saldo insuficiente), el lote terminará como **`partially_succeeded`**.
* Los lotes **expiran automáticamente después de 2 semanas** si no se autorizan.

## Estados del lote

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

<br />