API: Kunden verwalten

Mit der Ressource clientes (Kunden) können Sie das Kundenverzeichnis Ihrer Organisation aus Ihrem Backend lesen und erweitern – ideal für die Synchronisierung mit Ihrem ERP oder CRM.

Kunden auflisten

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

Gibt { "data": [ ... ], "meta": { "limit": 50, "offset": 0, "total": 128 } } zurück.

Kunden anlegen

Senden Sie einen POST an /api/v1/clientes (erfordert einen Schlüssel mit der Berechtigung Schreiben):

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

Antwort: { "data": { "id": "..." } }.

Felder:

• empresa (Pflichtfeld): rechtlicher Firmenname oder Handelsname.
• rfc: Wenn Sie einen gültigen RFC erfassen, können Sie bei der Abrechnung seines Angebots einen CFDI 4.0 auf den Namen dieses Kunden stempeln.
• terminos: contado (sofort fällig) oder net<N> für N Tage Zahlungsziel: net7, net15, net30, net45, net60, net90.
• limite: Kreditlimit in Pesos (MXN).
• nivel: estandar, plata, oro oder distribuidor (Preisliste).
• descuento_pct: automatischer Rabatt der Stufe (0–100).

Beträge werden immer in Pesos angegeben (nicht in Centavos).