over 1 year ago

Djust 3.46.0 / 3.47.0 - Semaine du 06 Jan 2025

Périmètre

Back Office

Orders

Un nouveau bouton pour forcer le déclenchement d'un export d'une commande a été ajouté. Il permet ainsi d'exécuter un nouvel export manuellement.

⚠️
Attention
Deux conditions doivent être remplies pour effectuer un export manuel d’une commande :

Un job d’export de commande doit avoir été créé.

Le statut de la commande doit figurer parmi les statuts autorisés pour l’export définis dans le job d’export.

Data Hub

Amélioration de la page des jobs d’export dans le Back Office

La page des jobs d’export a été enrichie avec de nouvelles informations pour une meilleure lisibilité et gestion :

Nom du job : Chaque job est désormais identifié par un nom spécifique.
Date de mise à jour : Une colonne indique la dernière mise à jour de chaque job.
Statut : Le statut actuel (Active/Inactive) est désormais affiché.

Amélioration du téléchargement des rapports d’intégration dans le Back Office

Les problèmes de téléchargement des rapports volumineux (+20 000 lignes) ont été résolus

Configuration des jobs d’export de commande par Connecteur API

Désormais, via le Back-Office, il est possible de configurer les jobs d’export sur une API

Nouvelle fonctionnalité : Téléchargement du rapport d’erreur pour les imports échoués

Désormais, lorsque qu’un job d’import passe au statut JOB_FAILED, il est possible de télécharger un rapport indiquant la raison précise de l’échec. Cette fonctionnalité vous permet d’identifier et de corriger rapidement les problèmes rencontrés.

Exports de commandes XML

L’Id DJUST de la commande est désormais renseigné dans la balise id dans le fichier XML lors d’un export de commande

Indexation / Search

Les visuels sont désormais gérés lors de l'indexation partielle. À chaque changement de visuel sur la plateforme Djust, l'indexation et la page de votre catalogue seront mises à jour automatiquement.

Connecteur Punchout cXML

Transcodage des catégories de classification

Lors de la génération du fichier cXML retour pour la solution d'eProcurement, certains clients ont besoin d’avoir la classification rattachée aux différents produits afin de gagner en lisibilité et pouvoir faire des statistiques.

Or la classification du client n’est pas celle du système eCommerce sur lequel est fait le panier.

Une transcodification des classifications du système eCommerce (Djust) vers le système du client est ainsi désormais assurée.

⚠️
Attention
La configuration de cette table de transcodification doit être effectuée par le CSM référent Djust.

API

🚀
NEW

Buying policies

Ajout de la possibilité de mettre à jour les validateurs d'une commande via la route d'administration :

PUT /v1/buying-policies/{id}/approvers

La liste des validateurs est passée en paramètre dans le body :

{
    "approverIds" : ["0000002771", "0000004197"]
}

⚠️
Attention
Le mode par défaut est du REPLACE, c’est à dire que si l’on envoie un seul approver et qu’il en existait 3, ils seront remplacés intégralement par le nouvel approver donné.

👍
UPDATE

emails

Les routes d'administration des configurations des emails évolue pour prendre en compte l'email du sender ainsi que son nom :

PUT /v1/settings/mailer

PATCH /v1/settings/mailer

Les bodies sont complétés avec les attributs sender et senderName :

{
  "apiKey": "string",
  "configuration": {
    "provider": "SMTP",
    "apiKey": "string"
  },
  "sender": "string",
  "senderName": "string"
}

Order incidents

Le paramètre ids de la route GET /v1/shop/incidents ORDER-559 est désormais optionnel.
La route de récupération des incidents pour un ou plusieurs acompte(s) évolue pour être simplifiée et plus générique à l'utilisation. Elle permet ainsi de récupérer les incidents de plusieurs accounts en un seul appel grâce au nouvel paramètre d'appel customerAccountIds.
GET /v1/shop/customer-accounts/{customerAccountId}/incidents ACCOUNT-551 devient
GET /v1/shop/incidents/{incidentId} ORDER-503

over 1 year ago

Djust 3.45.0 - Semaine du 17 déc 2024

Périmètre

API

👍
UPDATE

Order incidents :
Les routes front de récupération des incidents ORDER-559 et ORDER-557 sont modifiées pour faciliter son utilisation :

📘
Modifications ORDER-559 / ORDER-557
GET /v1/shop/logistic-orders/{logisticOrderId}/lines/{lineId}/incidents
GET /v1/shop/logistic-orders/{logisticOrderId}/lines/{lineId}/incidents
sont remplacées par l’unique route :
GET /v1/shop/incidents

L’objectif initial était de remonter les incidents liés à une ligne ou une commande. La simplification du path doit permettre d’avoir désormais un usage multiple.

Récupérer les incidents sur une (ou plusieurs) ligne(s) de commande
Récupérer les incidents sur une (ou plusieurs) commande(s)

De nouveaux request params sont ajoutés pour répondre aux différents use cases (à la ligne et à l’order) :

linkedType: ORDER ou ORDERLINES (obligatoire)
ids: identifiants des entités liées séparés par des virgules (optionnel)
status: Statut de l'incident OPEN, ON_GOING ou CLOSED (optionnel)

Le body de la réponse ne change pas.

📘
Exemple de request
GET /v1/shop/incidents?linkedType=ORDER&ids=123,456&status=OPEN

La route front de récupération des incidents ORDER-503 est modifiée pour faciliter son utilisation :

📘
Modification ORDER-503
GET /v1/shop/logistic-orders/{logisticOrderId}/incidents/{incidentId}
est remplacée par :
GET /v1/shop/incidents/{incidentId}

Le fonctionnement et le retour d'API ne changent pas. Il s'agit ici principalement d'une simplification de la route d'appel.

over 1 year ago

Djust 3.44.0 - Semaine du 10 déc 2024

Périmètre

API

👍
UPDATE

Catalog Views :
- Les routes de gestion des catalog views en tant qu’opérateur évoluent avec le support des external ids :
  POST /v1/catalog-views/{id}/accounts
  GET /v1/catalog-views/{id}
  DELETE /v1/catalog-views/{id}/accounts
  PATCH /v1/catalog-views
  DELETE /v1/catalog-views
  GET /v1/catalog-views/{id}/accounts
  DELETE /v1/catalog-views/{id}/products
  GET /v1/catalog-views/{id}/products
  POST /v1/catalog-views/{id}/products
  Le paramètre idType est utilisable désormais avec la valeur EXTERNAL_ID.\
Order documents :
- Les routes opérateur de gestion de documents à l’order n’acceptaient que les id Djust ou externes. Afin de faciliter leur utilisation, le type REFERENCE est désormais accepté dans le paramètre orderLogisticIdType sur les routes suivantes :
  POST /v1/documents
  GET /v1/documents\
Orders :
- La route de récupération des commandes en tant qu’opérateur évolue avec l’ajout d’un filtre sur les custom fields à l’offre :
  POST /v1/logistic-orders
  Le body est étendu avec le nouveau paramètre suivant qui permet de filtrer les résultats sur les valeurs de custom fields à l’offre :
```
"offerCustomFieldValueCriteria": [
  {
    "customFieldId": "string",
    "value": "string"
  }
],
```