API: gerenciar clientes

O recurso clientes permite ler e criar o cadastro de clientes da sua organização a partir do seu backend, ideal para sincronizar com o seu ERP ou CRM.

Listar clientes

curl "https://cordhq.app/api/v1/clientes?limit=50&offset=0" \
  -H "Authorization: Bearer sk_live_your_key"

Retorna { "data": [ ... ], "meta": { "limit": 50, "offset": 0, "total": 128 } }.

Criar um cliente

Faça um POST para /api/v1/clientes (exige uma chave com escopo de escrita):

curl -X POST https://cordhq.app/api/v1/clientes \
  -H "Authorization: Bearer sk_live_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "empresa": "Acme Corp",
    "contacto": "Laura Mendez",
    "email": "ap@acmecorp.com",
    "telefono": "5512345678",
    "rfc": "ACM190203XYZ",
    "terminos": "net30",
    "limite": 500000,
    "nivel": "oro",
    "descuento_pct": 10
  }'

Resposta: { "data": { "id": "..." } }.

Campos:

• empresa (obrigatório): razão social ou nome fantasia.
• rfc: se você informar um RFC válido, poderá timbrar CFDI 4.0 em nome deste cliente ao faturar o orçamento dele.
• terminos: contado (à vista) ou net<N> para N dias de prazo: net7, net15, net30, net45, net60, net90.
• limite: limite de crédito em pesos (MXN).
• nivel: estandar, plata, oro ou distribuidor (tabela de preços).
• descuento_pct: desconto automático do nível (0–100).

Os valores sempre vão em pesos (não em centavos).