Périmètre

API

👍

UPDATE

Orders / Opérations

• Filtrage et tri des commandes commerciales par source

Contexte :

Les acheteurs (ACCOUNT) peuvent désormais repérer et segmenter leurs commandes issues d’une Opération directement dans la liste des commandes.

Objectifs : retrouver rapidement « mes commandes de l’opération X », comparer des périodes, analyser l’impact des campagnes, et exporter facilement des vues cohérentes.

• Route concernée : GET /v1/shop/commercial-orders (ORDER-560)

Filtres & tris ajoutés

• 🧭 Filtres « source »
  • sourceTypes (multi-valeurs) : OPERATION (principal), QUOTE, ORDER, CART (cette version vise uniquement OPERATION)
    • Inclut les commandes dont order.sourceType appartient à la liste.
  • sourceIds (multi-valeurs) : identifiants d’opérations (ou autres sources)
    • Si sourceTypes contient OPERATION → ne retient que les commandes avec sourceType = OPERATION ET sourceId présent dans la liste.
    • Si sourceTypes est absent → fait correspondre tous les sourceType dont le sourceId est dans la liste.
    
    

    Les filtres existants restent disponibles et combinables : connectedUserOnly, customerAccountIds, isValidated, nbPreviewLines, locale.

• ⏱️ Tris disponibles
  • createdAt (défaut) - commandes les plus récentes d’abord (tie-breaker reference:asc)
  • validatedAt - prioriser les commandes validées récemment
  • updatedAt - utile pour le suivi opérationnel
  • sourceType - regrouper/segmenter par type de source (ex. OPERATION)
  • sourceId - ordonner par identifiant de source
  • reference - tri naturel pour l’utilisateur

• Exemples

GET /v1/shop/commercial-orders?locale=fr-FR&sourceTypes=OPERATION
Headers: dj-client: ACCOUNT, dj-store: store_fr

GET /v1/shop/commercial-orders?locale=fr-FR&sourceTypes=OPERATION&sourceIds=OP-2025-001,OP-2025-007

GET /v1/shop/commercial-orders?locale=fr-FR&sort=sourceType:asc,sourceId:asc

GET /v1/shop/commercial-orders?locale=fr-FR&isValidated=true&sort=validatedAt:desc

GET /v1/shop/commercial-orders?locale=fr-FR
-- applique createdAt:desc puis reference:asc (tie-breaker), nulls en fin