Garu

2026-04-30

v0.4.0 — Cadastro de clientes com e-mail de cobrança próprio

customersdashboardapi

A primeira peça da capacidade de cobranças agendadas está no ar: agora você pode manter uma agenda de clientes do seu account, registrá-los antes mesmo de cobrar e configurar um e-mail de cobrança específico por cliente.

O que mudou

  • Nova página /clientes no menu lateral com lista, busca por nome / e-mail / CPF, e botão Novo cliente em destaque.
  • Cadastro explícito sem precisar criar uma cobrança — informe nome, CPF/CNPJ, e-mail e telefone.
  • Detalhe do cliente com cabeçalho, dados de contato, e novo card E-mail de cobrança.
  • E-mail de cobrança personalizado (billingEmailOverride): você pode fixar um endereço específico para esse cliente — e mesmo que ele troque de e-mail em uma cobrança futura, o seu sobrescreve. Para voltar ao padrão, basta clicar em Voltar ao padrão.

API

Endpoints novos / atualizados em /api/customers:

  • POST /api/customers registra um cliente para o seu account.
  • PATCH /api/customers/:id/billing-email-override para definir ou limpar o e-mail de cobrança específico daquele cliente para o seu account.
  • GET /api/customers/:id agora inclui billingEmail (resolvido) e hasBillingEmailOverride (boolean).

A regra de resolução do e-mail de cobrança é:

billingEmailOverride
  ?? lastUsedEmail (per-seller)
  ?? customer.email

Quem vê o quê

A nova página respeita as permissões customer:view e customer:create que já existiam — não há nada de novo pra configurar.

Próximos passos

Esse é M1 da série de cinco entregas que vão até cobranças agendadas, recorrência, portal do cliente (/minha-area) e parity no Garu app. As próximas vão atrás de uma feature flag scheduled_charges_enabled e serão liberadas gradualmente.