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

# Criar CNAB

`POST /v1/remittances`

Criar CNAB.

Será feita uma solicitação de Remessa. Após a criação da Remessa, ela será processada e ao término do processamento serão emitidas notificações através dos Webhooks.

## Headers

- `User-Agent` string
- `X-Idempotency-Key` string

## Request body

- RemittanceCreateCnabObject
  - `bank_billet_account_id` integer, nullable — ID da [Carteira de Cobrança](/reference/post_v1-bank-billet-accounts).
  - `bank_billet_remittance_ids` integer[], nullable — IDs de [Registros de Remessa](/reference/get_v1-bank-billet-remittances).
  - `external_id` string, nullable — ID externo.
  - `custom_data` object, nullable — Dados customizados.
  - `tags` string[], nullable — Etiquetas.

## Response `201`

CNAB criado com custom_data e tags

- 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` — Remessa não encontrada

---

[API](https://skmtc.net/kobana/apis/cobran-as.md) · [All operations](https://skmtc.net/kobana/apis/cobran-as/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kobana/cobran-as/versions/728c362ec4d7/schema)