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

# Importar transacciones (multipart)

> Sube archivos de transacciones con mapeo opcional o parser nativo — mediante la API de importación masiva de gu1 para alto volumen.

## Endpoint

```
POST https://api.gu1.ai/batch-import/import/transactions
```

Equivale a:

```
POST https://api.gu1.ai/transactions/batch/upload
```

## Descripción

**Content-Type:** `multipart/form-data`.

Sin **`mappingId`** ni **`columnMapping`**, se usa el parser nativo. Org con **`batchUploadEnabled`**.

Query **`validateGap=true`** solo en `/transactions/batch/upload`.

Ver [Crear transacciones batch](/es/api-reference/transactions/create-batch).

## Autenticación

```bash theme={null}
Authorization: Bearer TU_API_KEY
```

## Campos del formulario

| Campo                    | Obligatorio | Descripción                                                                                                                                                                                                |
| ------------------------ | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `file`                   | Sí          | Uno o más archivos (repetir `file`)                                                                                                                                                                        |
| `mappingId`              | No          | UUID mapeo transacciones                                                                                                                                                                                   |
| `columnMapping`          | No          | string JSON (solo CSV)                                                                                                                                                                                     |
| `executeRules`           | No          | `true` / `false`                                                                                                                                                                                           |
| `skipDuplicates`         | No          | `true` / `false`                                                                                                                                                                                           |
| `validateExistingEntity` | No          | `true` (default) / `false`                                                                                                                                                                                 |
| `batchErrorHandling`     | No          | `rollback_all` (default si se omite), `continue_collect_errors` o `stop_keep_success`. Con validación de entidad estricta, decide si refs inválidas abortan el lote o se omiten por fila (`failures.csv`). |

## Límites

|                                    | Valor                                                                                                                                                                                     |
| ---------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Archivos por request**           | **Hasta 5** (repetir campo `file`)                                                                                                                                                        |
| **Máx. transacciones por archivo** | Según plan — [Crear transacciones batch](/es/api-reference/transactions/create-batch#limits-by-plan) (Freemium **4.000** → Enterprise **100.000**); tope parser **100.000** filas/archivo |
| **Formatos**                       | CSV, Excel, JSON                                                                                                                                                                          |
| **Flag org**                       | `batchUploadEnabled` debe estar activo                                                                                                                                                    |

Mismos límites en `POST /transactions/batch/upload`.

Ver también: [Importaciones masivas](/es/api-reference/bulk-imports/overview).