Release Notes
Start typing to search…
Back to All

Djust 3.96.0 - Semaine du 15 Dec 2025

13 days ago

Périmètre

API

📘

NEW

Payment commissions

Gestion des commissions marketplace par fournisseur

Djust PAY introduit une gestion centralisée des commissions marketplace par fournisseur, via une matrice dédiée administrée exclusivement par les opérateurs. Cette fonctionnalité permet de définir, contrôler et tracer le taux de commission (%) appliqué à chaque fournisseur, utilisé lors du calcul des splits de paiement côté marketplace, tout en garantissant qu’aucun fournisseur ne puisse modifier ou consulter son propre taux.

  • Consultation de la commission marketplace d’un fournisseur

Contexte

Les opérateurs peuvent désormais consulter la ligne de commission marketplace configurée pour un fournisseur, afin de connaître le taux appliqué lors des calculs de split en capture de paiement. Cette fonctionnalité apporte de la transparence et facilite le diagnostic des montants reversés dans un contexte marketplace, sans exposer ni modifier de données sensibles.

Nouveauté API ADM-PAY-500 - GET /v1/payments/marketplace-commissions/{supplierId}

{
  "supplierId": "SUP-AX145",
  "supplierName": "AXSUP Industries",
  "commissionRate": 3.5,
  "status": "ACTIVE",
  "createdAt": "2025-01-10T09:12:00Z",
  "updatedAt": "2025-02-14T10:45:33Z",
  "updatedBy": "OP-998877"
}

👍

UPDATE

Devis

  • Support des external IDs dans l'ajout de lignes de devis :

Afin d'améliorer la compatibilité des devis et des versions récentes de checkout, la route d'ajout de lignes au devis QUOTE-200 a été étendue.

La route QUOTE-200 - PUT /v1/shop/master-quotes/{masterQuoteId} supporte désormais un nouveau paramètre :

  • idType (optionnel) :
    • valeurs possibles : DJUST_ID (défaut), EXTERNAL_ID
    • s’applique aux variants et aux custom fields présents dans le payload
    • ne s’applique pas à la master quote, qui ne possède pas encore d’external ID

Le comportement par défaut reste inchangé :

👉 si idType n’est pas fourni, l’API continue d’interpréter les identifiants en DJUST_ID pour garantir la compatibilité existante.

  • Création d'une commande depuis un devis :

Contexte

Les customer users (ACCOUNT) peuvent désormais créer une commande à partir d’un devis auquel ils ont accès, via la route de checkout v3 ORDER-108 - POST /v2/shop/commercial-orders. L’objectif est de permettre la conversion directe d’un devis en commande, en reprenant ses lignes et conditions, tout en conservant un contrôle strict sur l’éligibilité du devis et le cycle de vie de la commande.

Fonctionnement métier

  • Nouvelle source QUOTE supportée dans ORDER-108 La création de commande supporte désormais deux types de source :
    • OPERATION (déjà existant)
    • QUOTE (nouveau)
  • Pour pouvoir être transformé en commande, le devis doit :
    • être valide (non expiré, non annulé),
    • être au statut WAITING_FOR_CUSTOMER au moment de l’appel,
    • appartenir à l’account du caller,
    • être dans le store effectif (scoping via dj-store ou store par défaut).
  • Si une de ces conditions n’est pas remplie, la création est refusée.
  • Contrairement aux opérations, seul le mode FULL est accepté.
  • La commande créée est au statut initial DRAFT_ORDER_ON_HOLD.
    • Elle est non éditable : les appels de type ORDER-150, ORDER-213, ORDER-215… sont refusés.
    • Le paiement via PAY-101 est autorisé ; en cas de succès, la commande passe en CREATED (workflow standard).