> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.simplificagestao.com.br/llms.txt.
> For full documentation content, see https://docs.simplificagestao.com.br/llms-full.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.simplificagestao.com.br/_mcp/server.

# Financeiro · despesas

> Criar, ajustar e cancelar despesas avulsas, recorrentes e parceladas.

# Financeiro · despesas

As rotas abaixo complementam a leitura do financeiro e permitem operar contas a pagar pela API privada.

## Despesas avulsas

* `POST /simplificav2/despesa`
* `PUT /simplificav2/despesa/{id}`

Use essas rotas para despesas únicas.

Regras principais:

* informe conta bancária, categoria, tipo de pagamento, nome, valor, data de emissão e data de vencimento;
* `pagar_despesa` aceita `S` ou `N`;
* quando `pagar_despesa = "S"`, a API exige `data_pagamento`;
* no `PUT`, somente os campos enviados são alterados;
* quando a despesa ainda estiver em aberto, o valor líquido continua precisando ser maior que zero.

## Despesas recorrentes

* `POST /simplificav2/despesa_recorrente`
* `PUT /simplificav2/despesa_recorrente/{id}`
* `POST /simplificav2/despesa_recorrente/{id}/cancelar`

Use essas rotas para séries periódicas de despesa.

Regras principais:

* `frequencia` aceita `SEMANAL`, `QUINZENAL`, `MENSAL`, `SEMESTRAL` ou `ANUAL`;
* todo ajuste exige `motivo`;
* `aplicar_em` aceita `FUTURAS` ou `PROXIMAS`;
* a data de início e a frequência não são alteradas pelo ajuste;
* o cancelamento também exige `motivo`.

## Despesas parceladas

* `POST /simplificav2/despesa_parcelada`
* `PUT /simplificav2/despesa_parcelada/{id}`
* `POST /simplificav2/despesa_parcelada/{id}/cancelar`

Use essas rotas para parcelamentos.

Regras principais:

* informe valor total, quantidade de parcelas, frequência e data de início;
* no `PUT`, somente os campos enviados são alterados;
* todo ajuste exige `motivo`;
* a frequência não é alterada por esta rota;
* o cancelamento também exige `motivo`.

## Resposta padrão

```json
{
  "status": "sucesso",
  "mensagem": "Operação concluída com sucesso.",
  "data": {
    "id": 123
  }
}
```