Lire les achats d'un client
/v1/customers/{id}/purchases
Renvoie ce qu'un client a acheté : une ligne par article, de la plus récente à la plus ancienne. Cette adresse demande la permission read_sales, distincte de read_customers : lire les coordonnées d'un client ne donne pas accès à ses achats.
Chaque ligne est un article d'un ticket. Les articles d'un même passage en caisse portent le même id_ticket et le même num_ticket : regroupez-les par id_ticket pour reconstituer un ticket. Un retour apparaît comme une ligne avec une quantité qt et un montant val négatifs. Les ventes annulées n'apparaissent pas. Une carte cadeau apparaît sans détail (type vaut carte_kdo).
Les montants sont dans la devise du compte. val est le montant TTC réellement payé pour la ligne, remise déduite : c'est lui qu'il faut additionner pour obtenir un total.
Le parcours se fait par curseur : tant que meta.has_more vaut true, rappelez avec after égal à meta.next_after. Sans since ni until, tout l'historique du client est parcouru. Une liste vide signifie que le client n'a rien acheté sur la période, ce n'est pas une erreur. Un client supprimé ou inconnu renvoie 404.
Les ventes ne se modifient pas par l'API : elles sont en lecture seule.
Paramètres
id |
Obligatoire | Identifiant du client (champ id). |
limit |
Facultatif | Nombre de lignes par page, de 1 à 100. 50 par défaut. |
after |
Facultatif | Curseur de parcours. Absent ou 0 pour la première page, puis la valeur next_after de la réponse précédente. |
since |
Facultatif | Ne renvoie que les ventes à partir de cette date, incluse. Format 2026-01-01. |
until |
Facultatif | Ne renvoie que les ventes jusqu'à cette date, incluse. Format 2026-12-31. |
Exemple d'appel
curl "https://api.wanapos.com/v1/customers/1842/purchases" \ -H "Authorization: Bearer VOTRE_CLE"
Réponse en cas de succès (statut 200)
Une page des achats du client.
| Champ | Type | Description |
|---|---|---|
data |
liste | Lignes d'articles achetés, de la plus récente à la plus ancienne. Liste vide si le client n'a rien acheté sur la période. |
data[].id |
entier | Identifiant de la ligne de vente. |
data[].date |
texte |
Date de la vente, au format AAAA-MM-JJ. |
data[].date_creation |
texte | Date et heure d'enregistrement de la vente. |
data[].id_ticket |
entier | Identifiant du ticket auquel appartient la ligne. Toutes les lignes d'un même passage en caisse portent le même. |
data[].num_ticket |
entier | Numéro du ticket, tel qu'il est imprimé. 0 s'il est inconnu. |
data[].id_shop |
entier |
Identifiant du magasin où la vente a eu lieu (voir GET /v1/me). |
data[].id_point_caisse |
entier | Identifiant du point de caisse. |
data[].type |
texte |
Nature de la ligne : product pour un article, carte_kdo pour une carte cadeau. |
data[].id_product |
entier | Identifiant du produit. 0 pour une carte cadeau. |
data[].id_variante_product |
entier | Identifiant de la variante vendue. 0 pour une carte cadeau. |
data[].designation |
texte | Désignation de l'article au moment de la vente. « Carte cadeau » pour une carte cadeau, sans autre détail. |
data[].variante |
texte | Nom de la variante (taille, couleur…). Chaîne vide si le produit n'a pas de variante. |
data[].qt |
entier | Quantité. Négative pour un retour. |
data[].pv_initial |
nombre | Prix de vente unitaire TTC avant remise. |
data[].remise_pc |
nombre | Remise appliquée, en pourcentage. |
data[].remise_mt |
nombre | Montant de la remise, TTC. |
data[].val |
nombre | Montant TTC de la ligne, remise déduite. Négatif pour un retour. |
data[].val_ht |
nombre | Montant hors taxes de la ligne. |
data[].tva_mt |
nombre | Montant de TVA de la ligne. |
data[].id_promotion |
entier | Identifiant de la promotion appliquée. 0 si aucune. |
data[].promotion |
texte | Nom de la promotion appliquée. Chaîne vide si aucune, ou si la promotion n'existe plus. |
data[].remarque |
texte | Remarque saisie sur la ligne. Chaîne vide si aucune. |
meta |
objet | |
meta.request_id |
texte | Identifiant de l'appel. |
meta.count |
entier | Nombre de lignes dans cette page. |
meta.has_more |
booléen |
true s'il reste une page à lire. |
meta.next_after |
entier |
Valeur à passer dans after pour la page suivante. 0 quand le parcours est terminé. |
{
"data": [
{
"id": 58214,
"date": "2026-10-02",
"date_creation": "2026-10-02T16:05:12+02:00",
"id_ticket": 9041,
"num_ticket": 3187,
"id_shop": 1,
"id_point_caisse": 1,
"type": "product",
"id_product": 412,
"id_variante_product": 1630,
"designation": "Pull col rond",
"variante": "M / Bleu",
"qt": 1,
"pv_initial": 59.9,
"remise_pc": 10,
"remise_mt": 5.99,
"val": 53.91,
"val_ht": 44.93,
"tva_mt": 8.98,
"id_promotion": 0,
"promotion": "",
"remarque": ""
},
{
"id": 58213,
"date": "2026-10-02",
"date_creation": "2026-10-02T16:05:12+02:00",
"id_ticket": 9041,
"num_ticket": 3187,
"id_shop": 1,
"id_point_caisse": 1,
"type": "product",
"id_product": 77,
"id_variante_product": 205,
"designation": "Écharpe laine",
"variante": "",
"qt": 1,
"pv_initial": 24,
"remise_pc": 0,
"remise_mt": 0,
"val": 24,
"val_ht": 20,
"tva_mt": 4,
"id_promotion": 0,
"promotion": "",
"remarque": ""
}
],
"meta": {
"request_id": "3f9a1c0b7d2e4a61",
"count": 2,
"has_more": false,
"next_after": 0
}
}
Erreurs possibles
-
404
L'élément demandé n'existe pas sur ce compte. Code :
resource_not_found. -
401
Clé absente, inconnue ou révoquée. Codes :
missing_key,invalid_key. -
403
Appel refusé pour ce compte ou cette clé. Codes :
api_not_activated,account_not_eligible,access_blocked,missing_scope. -
422
Un paramètre est absent, inconnu ou invalide. Code :
invalid_parameter. Le champfieldnomme le paramètre. -
429
Quota dépassé. Codes :
rate_limited,daily_quota_exceeded,too_many_failed_attempts. L'en-têteRetry-Afterindique combien de secondes attendre.
Une question ? contact@wanapos.com
