---
title: "Criar CNABs em Lote"
method: POST
path: "/v1/remittances/bulk"
tags: ["CNAB (Remessa)"]
---

# Criar CNABs em Lote

`POST /v1/remittances/bulk`

## Request

- Base URL: `https://api-sandbox.kobana.com.br`
- URL: `https://api-sandbox.kobana.com.br/v1/remittances/bulk`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/kobana/apis/cobran-as/docs/v1/remittances/bulk/post.ts> (a function with typed inputs; its response is checked against the schema)

Criar CNABs em Lote.

Serão feitas solicitações de Remessa de acordo com IDs das ocorrências. Será criada uma solicitação de Remessa para cada carteira associada às ocorrências. Após a criação das Remessas, elas serão processadas e ao término do processamento serão emitidas notificações através dos Webhooks.

## Headers

- `User-Agent` string

## Request body

- object
  - `bank_billet_remittance_ids` integer[], nullable: IDs de [Registros de Remessa](/reference/get_v1-bank-billet-remittances).

## Response `201`

CNABs criadas

- RemittanceObject[]
  - `id` integer: ID do CNAB
  - `content` string, nullable: Conteúdo da remessa
  - `filename` string, nullable: Nome do arquivo
  - `status` 'unprocessed' | 'processed' | 'send': Situação do arquivo: * `unprocessed` Pendente * `processed` Processado * `send` Enviada para o banco (Somente quando contratado envio automático)
  - `processed_at` string, date-time, nullable: Data de Processamento.
  - `created_at` string, date-time, nullable: Data e hora de criação.
  - `updated_at` string, date-time, nullable: Data e hora da última atualização.
  - `url` string, nullable: URL do arquivo de remessa.
  - `created_via_api` boolean, nullable: Enviado pela API
  - `bank_billet_account_id` integer, nullable: ID da [Carteira de Cobrança](/reference/post_v1-bank-billet-accounts).
  - `remittance_number` integer, nullable: Número da remessa
  - `sent_via_integration` string, date-time, nullable: Data e hora de envio automático para o banco.
  - `bank_billet_ids` integer[], nullable: IDs de boletos.
  - `bank_billet_remittances` BankBilletRemittanceObject[], nullable: Registros de Remessa.
    - `id` integer: ID do Registro de Remessa
    - `our_code` string, nullable, required: Código de operação de registro. Consulte os possíveis valores [para cada banco](/reference/bancos-suportados).
    - `occurrence` string, nullable: Ocorrência.
    - `remittance_id` integer, nullable, required: ID da Remessa.
    - `bank_billet_id` integer, nullable, required: ID do Boleto.
    - `bank_billet_account_id` integer, nullable, required: ID da Carteira.
    - `processed_at` string, date-time, nullable: Data de Processamento.
    - `occurrence_detail` string, nullable: Descrição do evento na Remessa.
    - `created_at` string, date-time, nullable: Data e hora de criação do registro
    - `updated_at` string, date-time, nullable: Data e hora da última atualização do registro
  - `external_id` string, nullable: ID externo.
  - `custom_data` object, nullable: Dados customizados.
  - `tags` string[], nullable: Etiquetas.
  - `tag_list` string, nullable: Lista de etiquetas separadas por vírgula.

## Other responses

- `401`: Falha de autenticação. Token inválido
- `403`: Falha de permissão. Você não tem o Scope obrigatório para essa chamada.
- `404`: Ocorrência não encontrada

---

[API](https://skmtc.dev/kobana/apis/cobran-as.md) - [All operations](https://skmtc.dev/kobana/apis/cobran-as/llms.txt) - [OpenAPI document](https://skmtc.dev/kobana/apis/cobran-as/revisions/728c362ec4d7?raw)