---
title: 5.2. Upload de Arquivo
url: https://docs.vehub.com.br/API/VeFlow%20-%20Duplicata%20Escritural/5.%20Escritura%C3%A7%C3%B5es/v1/5.2.%20Criar%20Escritura%C3%A7%C3%B5es%20com%20Upload%20de%20Arquivo/
---
# 5.2. Upload de Arquivo

## 🔗 Endpoint

| Método                                          | URL |
|-------------------------------------------------|-----|
| ![POST](https://img.shields.io/badge/POST-blue) | `/public/api/v1/duplicata-escritural/escrituracoes/arquivo` |

---

## 🧾 Descrição

Realiza a escrituração em lote de duplicatas por meio do upload de um arquivo. O arquivo deve conter as duplicatas no formato esperado pelo sistema (XML), e o tipo do documento fiscal informado será aplicado a todas as duplicatas contidas no arquivo.

---

## 📤 Requisição

### 📋 Payload (multipart/form-data)

| Campo              | Tipo    | Obrigatório | Descrição |
|--------------------|---------|-------------|-----------|
| TipoDocumentoFiscal | integer | Sim        | Tipo do documento fiscal das duplicatas no arquivo (ver enumerador abaixo) |
| Arquivo            | file    | Sim         | Arquivo com as duplicatas a escriturar (XML) |

### 🔢 TipoDocumentoFiscal

| Código | Significado |
|--------|-------------|
| 1      | NF-e (Nota Fiscal Eletrônica) |
| 2      | CF-e (Cupom Fiscal Eletrônico) |

---

## 🧪 Exemplo de cURL

```bash
curl -X POST https://api.vehub.com.br/public/api/v1/duplicata-escritural/escrituracoes/arquivo \
  -H "Authorization: Bearer {seu_token}" \
  -H "GrupoEconomico: {seu_grupo_economico}" \
  -F "TipoDocumentoFiscal=1" \
  -F "Arquivo=@/caminho/para/arquivo-duplicatas.xml"
```

---

## 📥 Responses

### ✅ 200 OK

```json
{
  "mensagem": "Arquivo recebido e duplicatas escrituradas com sucesso!",
  "identificador": "5174568D-9FFE-4C10-9FC2-B0F4E7F8D1B6",
  "identificadorProcessamento": null
}
```

---

### ✅ 202 Accepted

```json
{
  "mensagem": "Arquivo recebido e será processado em breve.",
  "identificadorProcessamento": "A1B2C3D4-E5F6-7890-ABCD-EF1234567890"
}
```

---

### ❌ 400 Bad Request

```json
{
  "tipo": "https://tools.ietf.org/html/rfc9110#section-15.5.1",
  "titulo": "Atenção",
  "status": 400,
  "erros": [
    "Arquivo inválido ou formato não suportado.",
    "Campo 'TipoDocumentoFiscal' é obrigatório."
  ]
}
```

---

## 🕒 Observações

- O arquivo deve estar no formato esperado pela plataforma para o tipo de documento fiscal informado, XML.
- Quando o retorno for `202 Accepted`, o processamento do arquivo ocorrerá de forma assíncrona.
- O campo `TipoDocumentoFiscal` define o tipo de documento fiscal para **todas** as duplicatas contidas no arquivo.