API de Financeiro

Razão financeiro — entradas e saídas

3 endpoints · base https://api.comando.one/v1 · autenticação por chave cmd_live_…

GET/finance/ledger

Razão financeiro

Retorna entradas e saídas consolidadas: recebimentos de clientes, pagamentos a fornecedores e despesas.

finance:read

Parâmetros, corpo, resposta e exemplo

Parâmetros

`page`(query)	integer	Número da página (default: 1)
`per_page`(query)	integer	Itens por página (default: 20, máx: 100)
`start_date`(query)	string (date)	Data inicial (YYYY-MM-DD)
`end_date`(query)	string (date)	Data final (YYYY-MM-DD)
`direction`(query)	"all" \| "entrada" \| "saida"

Resposta 200 — Listagem paginada

`origin_id`	string (uuid)
`origin`	"payment" \| "supplier_payment" \| "expense" \| "financial_movement"
`direction`	"entrada" \| "saida"
`entry_date`	string (date)
`amount`	number
`signed_amount`	number
`counterparty_name`	string \| null
`description`	string \| null
`document_numbers`	string \| null
`bank_account_name`	string \| null
`payment_method_name`	string \| null
`created_at`	string (date-time)

Exemplo

curl -X GET "https://api.comando.one/v1/finance/ledger" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE"

POST/finance/movements

Lançar movimentação manual

finance:write

Parâmetros, corpo, resposta e exemplo

Corpo (JSON)

`nature_id`obrigatório	string (uuid)	Natureza financeira (financial_movement_natures)
`direction`obrigatório	"entrada" \| "saida"
`amount`obrigatório	number
`movement_date`obrigatório	string (date)
`description`obrigatório	string
`counterparty_name`	string
`bank_account_id`	string (uuid)
`payment_method_id`	string (uuid)
`notes`	string
`status`	"realizado" \| "previsto" \| "cancelado"

Resposta 201 — Movimentação criada

`id`	string (uuid)
`nature_id`	string (uuid)
`direction`	"entrada" \| "saida"
`amount`	number
`movement_date`	string (date)
`description`	string
`counterparty_name`	string \| null
`bank_account_id`	string \| null (uuid)
`payment_method_id`	string \| null (uuid)
`notes`	string \| null
`status`	"realizado" \| "previsto" \| "cancelado"
`source_type`	"manual" \| "reconciliation" \| "rule"
`created_at`	string (date-time)
`updated_at`	string (date-time)

Exemplo

curl -X POST "https://api.comando.one/v1/finance/movements" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"nature_id":"<string (uuid)>","direction":"<\"entrada\" | \"saida\">","amount":"<number>","movement_date":"<string (date)>","description":"<string>"}'

DELETE/finance/movements/{id}

Excluir movimentação manual

finance:delete

Parâmetros, corpo, resposta e exemplo

Parâmetros

idobrigatório(path) string (uuid)

Resposta 204 — Excluída

Sem corpo.

Exemplo

curl -X DELETE "https://api.comando.one/v1/finance/movements/{id}" \
  -H "Authorization: Bearer cmd_live_SUA_CHAVE"

Início rápido, autenticação, SDK, servidor MCP e o playground para testar sem escrever código estão na documentação completa. A especificação em OpenAPI está em api.comando.one/openapi.json.

Outros recursos da API

Clientes (16)Contratos (13)Faturas (12)Webhooks (12)Serviços (9)Split de Pagamentos (9)Catálogos (7)Propostas (6)

Ou deixe a IA usar a API por você

O servidor MCP expõe estes mesmos recursos ao ChatGPT, Claude ou Gemini — com OAuth, sem chave de API.

Conectar um assistente