Clients

Lire les achats d'un client

GET /v1/customers/{id}/purchases
vpn_key Permission read_sales Compte comme une lecture

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 champ field nomme le paramètre.
  • 429 Quota dépassé. Codes : rate_limited, daily_quota_exceeded, too_many_failed_attempts. L'en-tête Retry-After indique combien de secondes attendre.

Voir toutes les erreurs

Une question ? contact@wanapos.com