# Criar uma nova cobrança

Permite criar uma nova cobrança, por meio desse endpoint, é possível informar o valor, data de vencimento, descrição da fatura e demais parâmetros que definem a cobrança. Essa funcionalidade facilita a geração automatizada de cobranças.

Endpoint: POST /v1/financeiro/eventos-financeiros/contas-a-receber/gerar-cobranca
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `conta_bancaria` (string, required)
    Identificador único para a conta bancária. A conta deve ser do tipo "COBRANCAS_CONTA_AZUL" ou, caso seja uma Conta PJ Conta Azul, do tipo "CONTA_CORRENTE"
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `descricao_fatura` (string, required)
    Descrição da fatura
    Example: Pagamento da fatura #1234

  - `id_parcela` (string, required)
    Identificador único para a parcela
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `data_vencimento` (string, required)
    Data de vencimento da cobrança
    Example: 2023-10-10

  - `tipo` (string, required)
    Tipo da cobrança
    Enum: "LINK_PAGAMENTO", "PIX_COBRANCA", "BOLETO"

  - `atributos` (object)

  - `atributos.desconto_antecipado` (object)
    Deverá ser informado apenas um dos campos: valor ou percentual

  - `atributos.desconto_antecipado.valor` (number)
    Quando informado, o campo "percentual" deve ser omitido
    Example: 10

  - `atributos.desconto_antecipado.percentual` (number)
    Quando informado, o campo "valor" deve ser omitido
    Example: 10

  - `atributos.desconto_antecipado.dias_antes_vencer` (integer)
    Dias antes do vencimento para aplicar o desconto antecipado
    Example: 10

  - `maximo_parcelas` (integer)
    Número máximo de parcelas exibido na fatura do cartão
    Example: 3

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `id` (string)
    Identificador único da cobrança
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `url` (string)
    URL da cobrança
    Example: http://www.exemplo.com.br

  - `status` (string)
    Status da cobrança
    Enum: "AGUARDANDO_CONFIRMACAO", "EM_CANCELAMENTO", "REGISTRADO", "QUITADO", "CANCELADO", "INVALIDO", "EXPIRADO", "FALHA_EMISSAO", "FALHA_CANCELAR", "REMESSA_GERADO", "REMESSA_PENDENTE", "PAGO", "EXTORNADO"

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 401:

  - `401` (unknown)
    Unauthorized

## Response 429:

  - `429` (unknown)
    Too Many Requests

## Response 500:

  - `500` (unknown)
    Internal Server Error