Clients

Créez et retrouvez les clients facturés par votre logiciel.

Créer ou mettre à jour un client

POST /api/v1/customers · droit customers:write

Avec externalRef, le même appel met à jour le client déjà associé à cette référence.

curl https://api.yaoka.fr/api/v1/customers \
  -H "Authorization: Bearer $YAOKA_API_KEY" \
  -H "X-Yaoka-Organization-Id: $YAOKA_ORG_ID" \
  -H "Idempotency-Key: customer-crm-4242-v1" \
  -H "Content-Type: application/json" \
  -d '{
    "externalRef": "crm_4242",
    "type": "company",
    "name": "Atelier Martin",
    "siret": "12345678901234",
    "emails": ["facturation@atelier-martin.fr"],
    "address": {"street":"8 rue Victor Hugo","postalCode":"75008","city":"Paris","country":"FR"}
  }'

Pour une entreprise française, YAOKA résout automatiquement les informations d’adressage électronique disponibles auprès de la PA.

Lister

GET /api/v1/customers?search=Martin&limit=20

La réponse contient data et nextCursor. Passez cursor=<nextCursor> pour la page suivante.

Avoirs Erreurs