API : gérer les clients

La ressource clientes (clients) vous permet de lire et de créer l’annuaire clients de votre organisation depuis votre backend, idéal pour la synchronisation avec votre ERP ou votre CRM.

Lister les clients

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

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

Créer un client

Envoyez un POST à /api/v1/clientes (nécessite une clé avec une portée en écriture) :

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
  }'

Réponse : { "data": { "id": "..." } }.

Champs :

• empresa (obligatoire) : raison sociale ou nom commercial.
• rfc : si vous saisissez un RFC valide, vous pourrez timbrer un CFDI 4.0 au nom de ce client lors de la facturation de son devis.
• terminos : contado (paiement à réception) ou net<N> pour N jours de crédit : net7, net15, net30, net45, net60, net90.
• limite : plafond de crédit en pesos (MXN).
• nivel : estandar, plata, oro ou distribuidor (grille tarifaire).
• descuento_pct : remise automatique du niveau (0–100).

Les montants sont toujours exprimés en pesos (et non en centimes).