# Criar um novo evento financeiro de contas a pagar

Endpoint: POST /v1/financeiro/contas-a-pagar
Version: v1
Security: BearerAuth

## Security:

  - `BearerAuth` (unknown)
    apiKey in header Authorization

## Request body:

  - `application/json` (unknown)
    Dados do evento financeiro a ser criado

## Request fields (application/json):

  - `condicao_pagamento` (object, required)
    Condição de pagamento do evento financeiro

  - `condicao_pagamento.parcelas` (array, required)
    Lista de parcelas da condição de pagamento

  - `condicao_pagamento.parcelas.conta_financeira` (string, required)
    ID da conta financeira associada à parcela
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `condicao_pagamento.parcelas.data_vencimento` (string, required)
    Data de vencimento da parcela
    Example: 2025-01-01

  - `condicao_pagamento.parcelas.descricao` (string, required)
    Descrição da parcela
    Example: Parcela 1

  - `condicao_pagamento.parcelas.detalhe_valor` (object, required)
    Composição do valor da parcela

  - `condicao_pagamento.parcelas.detalhe_valor.desconto` (number)
    Desconto aplicado na parcela
    Example: 0

  - `condicao_pagamento.parcelas.detalhe_valor.juros` (number)
    Juros aplicados na parcela
    Example: 0

  - `condicao_pagamento.parcelas.detalhe_valor.multa` (number)
    Multa aplicada na parcela
    Example: 0

  - `condicao_pagamento.parcelas.detalhe_valor.taxa` (number)
    Taxa aplicada na parcela
    Example: 0

  - `condicao_pagamento.parcelas.detalhe_valor.valor_bruto` (number, required)
    Valor bruto da parcela
    Example: 100

  - `condicao_pagamento.parcelas.metodo_pagamento` (string)
    Metodo de pagamento da parcela
    Enum: "BOLETO_BANCARIO", "CARTAO_CREDITO", "CARTAO_DEBITO", "DINHEIRO", "CHEQUE", "TRANSFERENCIA_BANCARIA", "OUTRO", "CARTEIRA_DIGITAL", "CASHBACK", "CREDITO_LOJA", "CREDITO_VIRTUAL", "DEPOSITO_BANCARIO", "PIX_PAGAMENTO_INSTANTANEO", "PROGRAMA_FIDELIDADE", "SEM_PAGAMENTO", "VALE_ALIMENTACAO", "VALE_COMBUSTIVEL", "VALE_PRESENTE", "VALE_REFEICAO", "PIX_COBRANCA", "DEBITO_AUTOMATICO", "CARTAO_CREDITO_VIA_LINK"

  - `condicao_pagamento.parcelas.nota` (string)
    Nota associada à parcela
    Example: Pagamento referente à fatura

  - `conta_financeira` (string, required)
    ID da conta financeira
    Example: c89475a2-bdf9-4e6b-ae5b-5a8e96cab946

  - `data_competencia` (string, required)
    Data de competência do evento financeiro
    Example: 2025-01-01

  - `descricao` (string, required)
    Descrição do evento financeiro
    Example: Conta a pagar - Fornecedor X

  - `id_fornecedor` (string, required)
    ID do fornecedor
    Example: c89475a2-bdf9-4e6b-ae5b-5a8e96cab946

  - `observacao` (string)
    Observação do evento financeiro
    Example: Observação

  - `rateio` (array, required)
    Rateio das categorias do evento financeiro

  - `rateio.id_categoria` (string, required)
    ID da categoria financeira
    Example: 937f6d29-3b2c-4eee-9778-29e54606f8b5

  - `rateio.rateio_centro_custo` (array)
    Rateio dos centros de custo associados à categoria

  - `rateio.rateio_centro_custo.id_centro_custo` (string)
    ID do centro de custo
    Example: bbe8049e-71df-4bf7-91f8-3b14ac5a6cdc

  - `rateio.rateio_centro_custo.valor` (number)
    Valor do centro de custo no rateio (obrigatório e maior que zero)
    Example: 100

  - `rateio.valor` (number, required)
    Valor da categoria no rateio
    Example: 100

  - `referencia_externa` (string)
    Referência externa do evento financeiro
    Example: 5b04139f-fcca-4c64-8d01-1dd568eb420e

  - `valor` (number, required)
    Valor do evento financeiro (deve ser maior que zero)
    Example: 100

## Response 201:

  - `201` (unknown)
    Created

## Response 201 fields (application/json):

  - `agendado` (boolean)
    se o evento financeiro é agendado
    Example: true

  - `condicao_pagamento` (object)
    condição de pagamento do evento financeiro

  - `condicao_pagamento.parcelas` (array)
    parcelas

  - `condicao_pagamento.parcelas.agendado` (boolean)
    se a parcela é agendada
    Example: true

  - `condicao_pagamento.parcelas.composicao_valor` (object)
    composição do valor da parcela

  - `condicao_pagamento.parcelas.composicao_valor.desconto` (number)
    desconto
    Example: 100

  - `condicao_pagamento.parcelas.composicao_valor.juros` (number)
    juros
    Example: 100

  - `condicao_pagamento.parcelas.composicao_valor.multa` (number)
    multa
    Example: 100

  - `condicao_pagamento.parcelas.composicao_valor.taxa` (number)
    taxa
    Example: 100

  - `condicao_pagamento.parcelas.composicao_valor.valor_bruto` (number)
    valor bruto
    Example: 100

  - `condicao_pagamento.parcelas.composicao_valor.valor_liquido` (number)
    valor líquido
    Example: 100

  - `condicao_pagamento.parcelas.conciliado` (boolean)
    se a parcela é conciliada
    Example: true

  - `condicao_pagamento.parcelas.conta_financeira` (object)

  - `condicao_pagamento.parcelas.conta_financeira.id` (string)
    id da conta financeira
    Example: 9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39

  - `condicao_pagamento.parcelas.data_pagamento_esperado` (string)
    data de pagamento esperada da parcela
    Example: 2025-07-23

  - `condicao_pagamento.parcelas.data_vencimento` (string)
    data de vencimento da parcela
    Example: 2025-07-23

  - `condicao_pagamento.parcelas.descricao` (string)
    descrição da parcela
    Example: Descrição do evento

  - `condicao_pagamento.parcelas.evento` (object)
    evento da parcela

  - `condicao_pagamento.parcelas.evento.agendado` (boolean)
    se o evento é agendado
    Example: true

  - `condicao_pagamento.parcelas.evento.data_competencia` (string)
    data de competência do evento
    Example: 2025-07-23

  - `condicao_pagamento.parcelas.evento.id` (string)
    id do evento
    Example: 9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39

  - `condicao_pagamento.parcelas.evento.referencia` (object)
    referência do evento

  - `condicao_pagamento.parcelas.evento.referencia.id` (string)
    id da referência
    Example: 9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39

  - `condicao_pagamento.parcelas.evento.referencia.origem` (string)
    origem da referência
    Enum: "VENDA", "LANCAMENTO_FINANCEIRO", "VENDA_AGENDADA", "RENEGOCIACAO", "DAS", "FOLHA", "TRANSFERENCIA", "SALDO_CONTA_BANCARIA", "COMPRA", "COMPRA_AGENDADA", "IMPORTACAO_DOCUMENTO", "IMPOSTO_RETIDO", "NOTA_COMPRA", "ANTECIPACAO", "HONORARIOS_CONTABEIS", "SIC"

  - `condicao_pagamento.parcelas.evento.referencia.revisao` (integer)
    revisão da referência
    Example: 1

  - `condicao_pagamento.parcelas.evento.tipo` (string)
    tipo do evento
    Enum: "RECEITA", "DESPESA"

  - `condicao_pagamento.parcelas.id` (string)
    id da parcela
    Example: 9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39

  - `condicao_pagamento.parcelas.indice` (integer)
    índice da parcela
    Example: 1

  - `condicao_pagamento.parcelas.metodo_pagamento` (string)
    metodo de pagamento
    Enum: "BOLETO_BANCARIO", "CARTAO_CREDITO", "CARTAO_DEBITO", "DINHEIRO", "CHEQUE", "TRANSFERENCIA_BANCARIA", "OUTRO", "CARTEIRA_DIGITAL", "CASHBACK", "CREDITO_LOJA", "CREDITO_VIRTUAL", "DEPOSITO_BANCARIO", "PIX_PAGAMENTO_INSTANTANEO", "PROGRAMA_FIDELIDADE", "SEM_PAGAMENTO", "VALE_ALIMENTACAO", "VALE_COMBUSTIVEL", "VALE_PRESENTE", "VALE_REFEICAO", "PIX_COBRANCA", "DEBITO_AUTOMATICO", "CARTAO_CREDITO_VIA_LINK"

  - `condicao_pagamento.parcelas.nota` (string)
    nota da parcela
    Example: Nota do evento

  - `condicao_pagamento.parcelas.nsu` (string)
    nsu da parcela
    Example: 000215783210

  - `condicao_pagamento.parcelas.pago` (number)
    valor pago da parcela
    Example: 100

  - `condicao_pagamento.parcelas.pendente` (number)
    valor pendente da parcela
    Example: 100

  - `condicao_pagamento.parcelas.status` (string)
    status da parcela
    Enum: "EM_ABERTO", "RECEBIDO", "RECEBIDO_PARCIAL", "CANCELADO"

  - `condicao_pagamento.parcelas.valor_liquido` (number)
    valor líquido da parcela
    Example: 100

  - `condicao_pagamento.parcelas.versao` (integer)
    versão da parcela
    Example: 1

  - `condicao_pagamento.quantidade_parcelas` (integer)
    quantidade de parcelas
    Example: 1

  - `data_competencia` (string)
    data de competência do evento financeiro
    Example: 2025-07-23

  - `descricao` (string)
    descrição do evento financeiro
    Example: Descrição do evento

  - `id` (string)
    id do evento financeiro
    Example: 9e4bb72d-f6f6-4fbf-9ca9-5e444e0c2e39

  - `id_cliente` (string)
    id do cliente do evento financeiro caso receita
    Example: f91047eb-2cff-4546-80e3-0f2b54d2cce0

  - `id_fornecedor` (string)
    id do fornecedor do evento financeiro caso despesa
    Example: fda2f85c-ecd1-4cf1-9d0b-170c54b4cb3e

  - `id_recorrencia` (string)
    id da recorrência do evento financeiro
    Example: 35473eec-4e74-11ee-b500-9f61de8a8b8b

  - `indice_recorrencia` (integer)
    índice da recorrência do evento financeiro
    Example: 1

  - `observacao` (string)
    observação do evento financeiro
    Example: Observação do evento

  - `rateio` (array)
    rateio do evento financeiro

  - `rateio.id_categoria` (string)
    id da categoria do evento financeiro
    Example: 23545d79-3c6a-4ec3-b805-5912736a3e00

  - `rateio.rateio_centro_custo` (array)
    rateio do centro de custo do evento financeiro

  - `rateio.rateio_centro_custo.id_centro_custo` (string)
    id do centro de custo do evento financeiro
    Example: 23545d79-3c6a-4ec3-b805-5912736a3e00

  - `rateio.rateio_centro_custo.valor` (number)
    valor do evento financeiro
    Example: 100

  - `rateio.valor` (number)
    valor do evento financeiro
    Example: 100

  - `referencia` (object)
    referência do evento financeiro

  - `referencia_externa` (string)
    referência externa do evento financeiro
    Example: 5b04139f-fcca-4c64-8d01-1dd568eb420e

  - `tipo` (string)
    tipo do evento financeiro
    Enum: "RECEITA", "DESPESA"

  - `valor` (number)
    valor do evento financeiro
    Example: 100

  - `versao` (integer)
    versão do evento financeiro
    Example: 1

## Response 400:

  - `400` (unknown)
    Bad Request

## Response 400 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada

## Response 500:

  - `500` (unknown)
    Internal Server Error

## Response 500 fields (application/json):

  - `error` (string)
    Mensagem de erro
    Example: Mensagem de erro detalhada