API création client / Récupération client

Bonjoue CLOCKTIME​ 

Dans l’API external v2, l’endpoint GET /api/external/v2/customers/{id} attend l’**id numérique** du client (ex : 42). Dans la réponse, vous avez aussi un champ external_reference (string) qui est “la référence externe unique assignée à ce client” (par vous à la création, ou par Pennylane). 

Donc :

• 23456 (numérique) = id API v2 → utilisable dans /customers/{id}
• 019d15… (string) = très probablement external_reference → pas utilisable directement dans /customers/{id} 

Comment récupérer une fiche client par SIREN (reg_no) ou par “l’identifiant fiche” (external_reference)

Vous devez passer par le listing GET /api/external/v2/customers + filtre, puis récupérer l’id numérique retourné.

1) Par SIREN (champ reg_no)

Le filtre reg_no est supporté sur /customers. 

Exemple (schéma) :

curl --request GET \ --url 'https://app.pennylane.com/api/external/v2/customers?filter=[{"field":"reg_no","operator":"eq","value":"123456789"}]' \ --header 'accept: application/json'

Ensuite, prenez l’id (numérique) dans la réponse, puis :

• GET /api/external/v2/customers/{id} 

2) Par identifiant “019d15…” (champ external_reference)

Le filtre external_reference est supporté sur /customers. 

Exemple :

curl --request GET \ --url 'https://app.pennylane.com/api/external/v2/customers?filter=[{"field":"external_reference","operator":"eq","value":"019d15..."}]' \ --header 'accept: application/json'