---
title: "Efetua upload de um novo lote de importação."
method: POST
path: "/v1/import_batches"
tags: ["import_batches"]
---

# Efetua upload de um novo lote de importação.

`POST /v1/import_batches`

## Request

- Base URL: `//app.vindi.com.br/api` (relative, and the document’s source URL is not known)
- URL: `//app.vindi.com.br/api/v1/import_batches`
- Auth: HTTP basic

Utilize este método para efetuar o upload de um arquivo de retorno de boleto bancário ou débito em conta.

#### Content-Type
Este é o único método da API Vindi que deve ser usado no modo [multipart](http://www.w3.org/Protocols/rfc1341/7_2_Multipart.html) com o cabeçalho `Content-Type: multipart/form-data`. Consulte a documentação da sua biblioteca REST e não se esqueça de informar o código do método de pagamento através do parâmetro `payment_method_code`. Também informe o parâmetro `payment_company_code` no caso do débito em conta.

## Request body

- object
  - `payment_method_code` string, required: Código do método de pagamento
  - `payment_company_code` string: Código da bandeira ou banco
  - `batch` string, binary, required: Arquivo a ser importado

## Response `201`

Lote de importação cadastrado com sucesso.

- ImportBatch: Utilize este método para listar os lotes de importação associados à sua conta na Vindi. Leia a documentação sobre [paginação](http://atendimento.vindi.com.br/hc/pt-br/articles/203020644#pagination) e [filtros de busca](http://atendimento.vindi.com.br/hc/pt-br/articles/204163150). #### Atributos para busca <code>id</code>, <code>payment_method_id</code>, <code>batch_file_size</code>, <code>batch_file_name</code>, <code>batch_fingerprint</code>, <code>created_at</code> e <code>updated_at</code>.
  - `id` integer, required: ID do lote de importação
  - `status` 'new' | 'processing' | 'imported' | 'rejected', required: Status do lote de importação
  - `batch_file_name` integer, required: Nome do arquivo
  - `batch_file_size` integer, required: Tamanho do arquivo em bytes
  - `batch_fingerprint` integer, required: MD5 checksum
  - `url` string, required: URL temporária para download do arquivo
  - `created_at` string, required: Data e hora do cadastro do lote de importação
  - `updated_at` string, required: Data e hora da última atualização do lote de importação
  - `payment_method` PaymentMethodSummary, required
    - `id` integer, required: ID do método de pagamento
    - `public_name` string, required: Nome público do método de pagamento
    - `name` string, required: Nome interno do método de pagamento
    - `code` string, required: Código externo para referência via API
    - `type` string, required: Tipo do método de pagamento

## Other responses

- `400`: Erro de sintaxe JSON no corpo do request.
- `422`: Parâmetros inválidos. Verificar erro na resposta.

---

[API](https://skmtc.dev/vindi/apis/api-vindi.md) - [All operations](https://skmtc.dev/vindi/apis/api-vindi/llms.txt) - [OpenAPI document](https://skmtc.dev/vindi/apis/api-vindi/revisions/3e857e1cdd03?raw)