> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kinglog.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Leia /llms.txt antes de explorar páginas. A API HTTP usa Authorization: Bearer com o JWT da conta. A chave kl_live_ serve só ao assistente MCP e não substitui o JWT. Não invente rotas, hosts públicos, SDKs ou CLI. companyId e userId vêm da sessão. Consultas não aceitam SQL. Exclusão no assistente exige confirm=true. O webhook público é POST /webhook/leads.

# Despesa

> Lançamento comercial com responsável e ao menos um item. O valor do item vai em centavos.

Lançamento comercial com responsável e ao menos um item. O valor do item vai em centavos.

> [card] Obrigatório
>
> `responsibleId` (uuid) e `items` com `description`, `category`, `amountCents` e `date`.

## Fluxo

1. Pegue o uuid do responsável.
2. Monte `items` com descrição, categoria, centavos e data.
3. Crie a despesa.

## Enums

| Campo | Valores |
| - | - |
| `category` | FOOD, TRANSPORT, LODGING, PARKING, TOLL, TAXI, RIDEHAIL, OTHER |
| `status` | draft, submitted, approved, reimbursed, rejected |

## Operações

| Você quer | Método | Caminho |
| - | - | - |
| [Despesas](https://docs.kinglog.com.br/pages/reference/crm/crm-expenses-list.md) | `GET` | `/crmExpense/getAll/:companyId/:userId` |
| [Uma despesa](https://docs.kinglog.com.br/pages/reference/crm/crm-expenses-getOne.md) | `GET` | `/crmExpense/getOne/:companyId/:userId/:expenseId` |
| [Criar despesa](https://docs.kinglog.com.br/pages/reference/crm/crm-expenses-create.md) | `POST` | `/crmExpense/create/:companyId/:userId` |
| [Excluir despesa](https://docs.kinglog.com.br/pages/reference/crm/crm-expenses-delete.md) | `DELETE` | `/crmExpense/delete/:companyId/:userId/:expenseId` |
| [Categorias de despesa](https://docs.kinglog.com.br/pages/reference/crm/crm-expenseCategories-list.md) | `GET` | `/crmCategoryExpense/getAll/:companyId/:userId` |

## Exemplo de requisição

```json theme={null}
{
  "responsibleId": "UUID_DO_RESPONSAVEL",
  "items": [
    {
      "description": "Almoço",
      "category": "FOOD",
      "amountCents": 4500,
      "date": "2026-11-05"
    }
  ]
}
```

## Exemplo de resposta

```json theme={null}
{
  "success": true,
  "data": {
    "id": "ID_DA_DESPESA",
    "responsibleId": "UUID_DO_RESPONSAVEL",
    "status": "draft"
  },
  "code": "SUCCESS"
}
```

> [!TIP]
>
> Categorias do item: `FOOD`, `TRANSPORT`, `LODGING`, `PARKING`, `TOLL`, `TAXI`, `RIDEHAIL` ou `OTHER`.

> [!TIP]
>
> Status: `draft`, `submitted`, `approved`, `reimbursed` ou `rejected`.

## Relacionado

* [Guia: lançar uma despesa](https://docs.kinglog.com.br/pages/guides/lancar-despesa.md)
* [Conceito: despesas](https://docs.kinglog.com.br/pages/concepts/despesas.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.