> ## 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 transações (multipart)

> Envia arquivos com mapeamento opcional ou parser nativo — pela API de importação em lote da gu1 para alto volume, com exemplos para import transactions.

## Endpoint

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

Equivalente a:

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

## Visão geral

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

Sem **`mappingId`** nem **`columnMapping`**, usa parser nativo. Org com **`batchUploadEnabled`**.

Ver [Criar transações em lote](/pt/api-reference/transactions/create-batch).

## Autenticação

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

## Campos do formulário

| Campo                    | Obrigatório | Descrição                                                                                                                                                                                                    |
| ------------------------ | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `file`                   | Sim         | Um ou mais arquivos (`file` repetido)                                                                                                                                                                        |
| `mappingId`              | Não         | UUID                                                                                                                                                                                                         |
| `columnMapping`          | Não         | string JSON (só CSV)                                                                                                                                                                                         |
| `executeRules`           | Não         | `true` / `false`                                                                                                                                                                                             |
| `skipDuplicates`         | Não         | `true` / `false`                                                                                                                                                                                             |
| `validateExistingEntity` | Não         | `true` (padrão) / `false`                                                                                                                                                                                    |
| `batchErrorHandling`     | Não         | `rollback_all` (padrão se omitido), `continue_collect_errors` ou `stop_keep_success`. Com validação estrita de entidade, decide se refs inválidas abortam o lote ou são omitidas por linha (`failures.csv`). |

## Limites

|                                 | Valor                                                                                                                                           |
| ------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| **Arquivos por request**        | **Até 5** (repetir `file`)                                                                                                                      |
| **Máx. transações por arquivo** | Conforme plano — [Criar transações em lote](/pt/api-reference/transactions/create-batch#limits-by-plan); teto parser **100.000** linhas/arquivo |
| **Formatos**                    | CSV, Excel, JSON                                                                                                                                |
| **Flag org**                    | `batchUploadEnabled` ativo                                                                                                                      |

Ver também: [Importações em lote](/pt/api-reference/bulk-imports/overview).