Vendas (regime competência)

Vendas com data de competência no período, paginadas, da mais recente para a mais antiga.

• Não existe campo quitada. status e recebimento_status saem crus e podem discordar entre si e da dívida. “Quanto falta receber” é divida_em_aberto, que vem null em venda cancelada.
• Não existe taxa em R$. A taxa sai em % (na venda ou em cada perna); o valor já vem descontado em valor_liquido.
• formas_pagamento é uma foto da venda e não acompanha as baixas.
• Profissionais saem só como id: o nome está em /v1/scheduling/professionals.
• search (paciente, número da venda ou procedimento) e os dados do paciente exigem sensitive:read.
• Só lançamentos com ao menos um item vendido, como a aba Vendas de /incomes.

GET /v1/financial/sales

Vendas (regime competência)

cURL

curl --request GET \
  --url https://api.controleclinic.com.br/v1/financial/sales \
  --header 'X-API-Key: <api-key>'

200

{
  "data": [
    {
      "id": "<string>",
      "numero_venda": 123,
      "data_competencia": "<string>",
      "valor_bruto": 123,
      "desconto": 123,
      "valor_liquido": 123,
      "forma_pagamento": "<string>",
      "taxa_percentual": 123,
      "bandeira": "<string>",
      "parcelas": 123,
      "profissional_venda_id": "<string>",
      "conta_id": "<string>",
      "centro_custo_id": "<string>",
      "status": "<string>",
      "recebimento_status": "<string>",
      "cancelada": true,
      "divida_em_aberto": 123,
      "formas_pagamento": [
        {
          "forma": "<string>",
          "valor": 123,
          "parcelas": 123,
          "taxa_percentual": 123,
          "bandeira": "<string>",
          "conta_id": "<string>"
        }
      ],
      "itens": [
        {
          "procedure_id": "<string>",
          "procedimento": "<string>",
          "categoria": "<string>",
          "quantidade": 123,
          "valor_cobrado": 123,
          "desconto": 123,
          "vendido": true,
          "profissional_execucao_id": "<string>"
        }
      ],
      "patient_id": "<string>",
      "paciente_nome": "<string>",
      "paciente_cpf": "<string>",
      "descricao": "<string>"
    }
  ],
  "count": 123,
  "page": 123,
  "limit": 123,
  "regime": "competencia",
  "periodo": {
    "from": "<string>",
    "to": "<string>"
  }
}

Autorizações

X-API-Key · string · header · obrigatório

Token de API no formato cc_live_<64 chars hex>. Obtido em Minha Clínica → Integrações.

Parâmetros de consulta

from · string · obrigatório

Data AAAA-MM-DD

Exemplo:

"2026-10-01"

to · string · obrigatório

Data AAAA-MM-DD

Exemplo:

"2026-10-01"

status · enum<string> · padrão: all

Opções disponíveis: all, em_aberto, recebido

include_cancelled · enum<string> · padrão: false

Opções disponíveis: true, false

search · string

Só com o escopo sensitive:read

Maximum string length: 200

page · integer · padrão: 1

Intervalo obrigatório: 1 <= x <= 1000000

limit · integer · padrão: 50

Intervalo obrigatório: 1 <= x <= 100

Resposta

200

application/json

Vendas

data · object[] · obrigatório

Show child attributes

count · number · obrigatório

page · number · obrigatório

limit · number · obrigatório

regime · enum<string> · obrigatório

Opções disponíveis: competencia

periodo · object · obrigatório

Show child attributes