Périmètre
Data Hub
Data Hub - Export de commandes SFTP | Nom de fichier court
Il est désormais possible de configurer le format du nom de fichier pour les exports de commandes via SFTP.
Formats disponibles :
- Format standard (par défaut) :
- DJUST_ORDERID_SUPPLIERID_TIMESTAMP_orders.FORMAT
- Exemple : DJUST_172-189-1896838-1_FRMO_1721891899392_orders.xml
- Format simplifié (nouveau format, sur demande) :
- ORDERID.FORMAT
- Exemple : 172-189-1896838-1.xml
Le format simplifié est disponible sur demande.
Back-Office
Visualisation des restrictions de catalogues (Catalog Views) sur une page produit
Il est désormais possible via la page produit d’identifier dans quelle restriction de catalogue se trouve le produit.
API
NEW
Orders
Une évolution importante des commandes est en préparation. Elles vont apporter la possibilité de créer une commande sans panier ni devis au préalable et y ajouter un comportement similaire à celui du panier.
-
Nouvelle route de création de commande commerciale :
ORDER-108 - POST /v2/shop/commercial-orders
Cette route permet de créer une nouvelle commande commerciale avec l'ajout possible de custom fields liés. Voici le body de l'API :
"customFields": [ { "customFieldId": "string", "customFieldValue": "string" } ] "customFieldIdType": "string", // DJUST_ID or EXTERNAL_ID
-
Nouvelle route de modification de commande commerciale :
ORDER-222 - PUT /v2/shop/commercial-orders/{commercialOrderId}
Cette route permet la mise à jour d'une commande commerciale à partir de son id externe ou de se référence. Son body est similaire à celui deORDER-108, il permet l'update des CF de la commande commerciale.
-
Nouvelle route d'ajout de ligne à la commande commerciale :
ORDER-150 - PUT /v2/shop/commercial-orders/{commercialOrderId}/lines
Cette route permet d'ajouter des lignes de commande (automatiquement ventilées sur les commandes logistiques liées). Son comportement est semblable à l'ajout de lignes à un panier.
{ "lineType": "OFFER_PRICE", // OFFER_PRICE or PRODUCT_VARIANT "lineIdType": "EXTERNAL_ID", // DJUST_ID or EXTERNAL_ID "customFieldIdType": "DJUST_ID", "lines": [ { "id": "123456", // can be offer price id or variant id "quantity": 10, "updateAction": "ADD_QUANTITY", { "customFields": [ { "customFieldId": "string", "customFieldValue": "string" } ], } ] }AttentionLe path param commercialOrderId est de type unique REFERENCE. Les business ids ou les external ids ne sont pas acceptés.
-
Nouvelle route de récupération des lignes d'une commande commerciale :
ORDER-561 - GET /v1/shop/commercial-orders/{commercialOrderId}/lines
Cette route est dédiée à la récupération paginée des lignes d'une commande commerciale. Il est possible de la filtrer par ids de fournisseur, de variants ou d'offer prices.
-
Nouvelle route de suppression de commande commerciale :
ORDER-300 - DELETE /v2/shop/commercial-orders/{commercialOrderId}.InformationCette route pouvant être sensible, elle est contrainte par un droit utilisateur
CHECKOUT_ORDER_DELETE. Si l'utilisateur possède ce droit, alors il sera autorisé à supprimer une commande commerciale. L'ensemble des commandes logistiques liées doivent être en statutDRAFT_ORDER.
-
Nouvelle route de suppression de ligne d'une commande commerciale :
ORDER-350 - DELETE /v2/shop/commercial-orders/{commercialOrderId}/lines
Cette route permet la suppression d'une ou plusieurs lignes d'une commande commerciale.
"lines": [ { "offerPriceId": "string", } ]
UPDATE
Orders
Les routes suivantes de gestion des commandes commerciales évoluent pour préparer les futures évolutions de réapprovisionnement automatiques.
L'ensemble des routes évoluent avec les changements de propriétés suivantes :
Nouvelles propriétés
customerAccountSnapshot: les informations d'account sont enregistrées au niveau de la commande commerciale"customerAccountSnapshot": { "externalId": "string", "id": "string", "name": "string", "vatNumber": "string" }
customerUserSnapshot: les informations de customer user sont enregistrées au niveau de la commande commerciale"customerUserSnapshot": { "civility": "MR", "email": "string", "externalId": "string", "firstName": "string", "id": "string", "lastName": "string", "phone": "string" }
lineCount: nombre total de lignes de produits contenus dans les différentes commandes logistiques
productCount: nombre total de produits contenus dans les différentes commandes logistiques. Si une ligne contient une quantité 10, on ajoutera 10 au productCount.
custom fields: les custom fields sont désormais présents au niveau de la commande commerciale
updatedAt: date de dernier update de la commande commerciale
validatedAt: date de passage en statut CREATED de l’ensemble des commandes logistiques
InformationLe nombre de lignes n’est pas égal au nombre de produits. En effet, une ligne correspond à un prix. Sur un produit, il peut par exemple y avoir plusieurs conditionnements avec des offres/prix différents. Pour un produit on aura donc plusieurs lignes correspondantes.
Propriétés supprimées
numberOfLines: ancienne propriété non utilisée pour le nombre de lignes du commande
numberOfProducts: ancienne propriété non utilisée pour le nombre total de produits
- Routes d'administration back-office concernées :
GET /v1/logistic-orders
POST /v1/logistic-orders
GET /v1/logistic-orders/{orderLogisticId}
GET /v1/logistic-orders/{orderLogisticId}/approvals
GET /v1/logistic-orders/{orderLogisticId}/shipments
GET /v1/supplier-quotes/{supplierQuoteId}/orders- Routes front-office concernées :
ORDER-560 - GET /v1/shop/commercial-orders
GET /v1/shop/customer-accounts/orders
GET /v1/shop/customer-accounts/organisations/{organisationId}/orders
GET /v1/shop/logistic-orders
POST /v1/shop/logistic-orders
