Clientes — Referência

Clientes

Cadastro de clientes da loja para cobranças e assinaturas.

Criar cliente

Cadastra um cliente na conta logada.

POST/api/customers

Autenticação: sessão do dashboard (cookie Supabase)

Parâmetros

Campo	Tipo	Obrigatório	Descrição
`name`	string	sim	Nome
`email`	string	sim	E-mail
`document`	string	não	CPF ou CNPJ
`phone`	string	não	Telefone
`notes`	string	não	Observações
`customerCode`	string	não	Código preferido (cust_…)

Exemplo de body

{
  "name": "Maria Silva",
  "email": "maria@email.com",
  "document": "12345678909",
  "phone": "11999998888"
}

Exemplo de resposta

{
  "ok": true,
  "customer": {
    "id": "uuid",
    "customer_code": "cust_…",
    "name": "Maria Silva",
    "email": "maria@email.com",
    "document": "12345678909",
    "phone": "11999998888",
    "created_at": "…"
  }
}

Listar clientes

Lista todos os clientes da conta.

GET/api/customers

Autenticação: sessão do dashboard (cookie Supabase)

Exemplo de resposta

{ "customers": [ /* Customer[] */ ] }

Buscar cliente

Detalhe do cliente. Também: GET /api/customers/{id}/orders para pedidos.

GET/api/customers/{id}

Autenticação: sessão do dashboard (cookie Supabase)

Atualizar / remover

PATCH atualiza campos; DELETE remove o cliente.

PATCH/api/customers/{id}

Autenticação: sessão do dashboard (cookie Supabase)

DELETE /api/customers/{id} — remove o registro se não houver vínculos bloqueantes.