Communauté gestion

Forum Discussion

Avatar de CLOCKTIME
CLOCKTIME
Icône pour le rang Première notePremière note
il y a 6 jours
Répondu

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

Bonjour,

Lors de la création d'un client 

https://app.pennylane.com/api/external/v2/company_customers

La requète renvoie ID Client . Par exemple 23456

Cet ID ne correspond pas à l'identifiant client dans sa fiche

Lors de la récupération d'un client

https://app.pennylane.com/api/external/v2/customers/{id}

Si {id}=23456 tout est OK on récupère la fiche client

Si {id}=019d15....  indiqué dans la fiche client - Marche pas

Comment récupérer la fiche client par son SIREN ou Numéro de TVA ou Identifiant client(019d15.. qui marche pas) ? https://app.pennylane.com/api/external/v2/??

 

En vous remerciant par avance

  • 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 v2utilisable dans /customers/{id}
    • 019d15… (string) = très probablement external_referencepas 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'



1 Réponse

  • 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 v2utilisable dans /customers/{id}
    • 019d15… (string) = très probablement external_referencepas 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'