Périmètre

🖥️ Back-Office

📘
NEW

Rôles et groupes Djust Studio (Uniquement pour les clients concernés par Djust Studio)

Contexte

Djust Studio ne disposait d'aucun contrôle d'accès : tout opérateur ayant accès à Studio pouvait y faire toutes les actions. Les droits Studio se gèrent désormais là où sont gérés tous les autres droits de la plateforme, depuis la page Groupes & rôles du back-office.

Fonctionnement

Sept rôles Studio sont disponibles sur le client OPERATOR, regroupés dans leur propre typologie :

Accès Studio : consulter pages, médias, thème, traductions, paramètres, configuration, versions, déploiements, espaces et templates.
Gestion des contenus : créer, modifier, publier et supprimer pages, blocs globaux, SEO et médias.
Gestion des traductions.
Gestion du thème : thème et design tokens.
Gestion des versions : créer des versions de contenu, les déployer, les promouvoir vers l'environnement suivant.
Gestion des paramètres : activer ou désactiver des fonctionnalités, modifier la configuration et les intégrations, consulter les utilisateurs et leurs rôles.
Gestion des espaces : créer, dupliquer, supprimer et provisionner les espaces Studio.

Sept groupes prêts à l'emploi sont créés avec ces rôles : super administrateur, administrateur, éditeur, traducteur, designer, gestionnaire de versions et lecteur.

Aucun utilisateur n'est rattaché automatiquement à ces groupes : vous ajoutez vous-même vos opérateurs au groupe qui correspond à leur métier. Les groupes existants ne sont pas modifiés. Un changement de groupe est pris en compte au plus tard quelques minutes après, au renouvellement de la session.

📄 Documentation :

👉 Côté métier : vous donnez à chaque opérateur le niveau d'accès Studio qui correspond à son rôle, depuis la même page que les autres droits de la plateforme.

👉 Côté technique : les rôles Studio sont portés par le jeton d'accès de l'opérateur et exposés par les API de rôles et de groupes.

👍
UPDATE

Liste des devis : filtres sur les dates

Contexte

La liste des devis ne se filtrait que par recherche, statut, fournisseur, compte et utilisateur. Retrouver les devis d'une période imposait de parcourir la liste, alors que la liste des commandes propose déjà des filtres de dates.

Fonctionnement

Filtrez vos devis sur une plage « Date de création » et sur une plage « Date de modification », avec une date de début et une date de fin. Chaque borne est facultative et incluse : renseignez une seule borne pour ouvrir la plage de l'autre côté.

Ces filtres se combinent entre eux, avec les autres filtres et avec la recherche. Ils sont conservés dans l'adresse de la page, donc dans un lien partagé ou après un rechargement, et « Effacer les filtres » les retire comme les autres.

Les filtres sont disponibles dans le back-office opérateur comme dans le back-office fournisseur, où ils portent sur les seuls devis du fournisseur.

👉 Côté métier : vous isolez en quelques clics les devis créés ou modifiés sur une période, exactement comme sur la liste des commandes.

👉 Côté technique : l'API de la liste des devis accepte des bornes de date de création et de date de modification, combinables avec les critères existants.

Liste des utilisateurs clients : filtres sur les dates

Contexte

La liste des utilisateurs clients était la seule grande liste du back-office sans filtre de date : impossible d'isoler les utilisateurs arrivés ou mis à jour récemment.

Fonctionnement

Filtrez vos utilisateurs clients sur une plage « Date de création » et sur une plage « Date de modification ». Chaque borne est facultative et incluse ; une période dont le début est postérieur à la fin renvoie une liste vide, sans erreur.

Une fois appliquée, chaque plage s'affiche en étiquette au-dessus du tableau et peut être retirée individuellement. Les filtres sont conservés dans l'adresse de la page, se combinent avec le compte, le statut, « Sans compte », la recherche et le store sélectionné.

👉 Côté métier : vous retrouvez immédiatement les utilisateurs créés ou modifiés sur une période, et vous partagez cette vue par un simple lien.

👉 Côté technique : l'API de la liste des utilisateurs clients accepte des bornes de date de création et de mise à jour, avec le même format et le même fuseau que les listes des comptes clients et des devis.

Liste des offres : colonne et filtre « Visibilité »

Contexte

Dans la liste des offres, le statut de l'offre et sa visibilité sur le site étaient affichés dans la même colonne alors qu'il s'agit de deux informations distinctes : une offre active peut être hors ligne. Il n'était par ailleurs pas possible de filtrer sur la visibilité.

Fonctionnement

La colonne « Statut » ne porte plus que le statut de l'offre (« Actif », « Inactif »). Une colonne « Visibilité » la suit et indique « En ligne » ou « Hors ligne » pour le store consulté, selon la dernière indexation du catalogue.

Un filtre « Visibilité » vient compléter le panneau des filtres, avec les valeurs « En ligne » et « Hors ligne ». Il se combine avec la recherche et tous les filtres existants, et s'affiche dans les filtres actifs.

📄 Documentation : Offers 1

👉 Côté métier : vous repérez d'un coup d'œil les offres actives mais invisibles sur le site, et vous les isolez en un clic.

👉 Côté technique : l'API de la liste des offres accepte un filtre de visibilité appliqué avant la pagination, combinable avec tous les critères existants.

Rôle de modification des champs personnalisés disponible sur tous les environnements

Contexte

Le rôle autorisant la modification des champs personnalisés d'une commande passée par un autre utilisateur du même compte client n'apparaissait pas dans la page Groupes & rôles, et ne pouvait donc pas être attribué.

Fonctionnement

Ce rôle existe désormais sur tous les environnements, avec son libellé et sa typologie « Commandes », sur le client ACCOUNT. Il est visible et cochable dans la page Groupes & rôles.

Aucun droit nouveau n'est accordé : le rôle n'est attribué à aucun groupe, c'est à l'administrateur de l'activer sur les groupes de son choix. Les attributions déjà en place sont conservées.

👉 Côté métier : ce droit est visible et activable depuis la page Groupes & rôles, sans intervention de nos équipes.

👉 Côté technique : le rôle est présent dans le catalogue de rôles avec sa typologie et ses libellés en français et en anglais.

Opérations : filtre propriétaire et ajout de comptes

Contexte

Sur la liste des opérations, le propriétaire n'était disponible qu'en colonne, sans filtre associé. Dans la fenêtre d'ajout de comptes, les comptes déjà associés à l'opération se présentaient comme des résultats sélectionnables, et les résultats de recherche n'étaient pas paginés.

Fonctionnement

Le panneau des filtres de la liste des opérations accepte désormais un filtre sur le propriétaire, avec le même comportement que les filtres existants : étiquette de filtre actif, « Effacer les filtres » et conservation dans l'adresse de la page.

Dans la fenêtre d'ajout de comptes, chaque compte déjà associé à l'opération est signalé « Déjà ajouté » sur sa ligne et n'est plus sélectionnable. Les résultats de recherche sont paginés.

👉 Côté métier : vous retrouvez les opérations d'un propriétaire en un filtre, et vous ajoutez des comptes sans risque de doublon, même sur un grand nombre de résultats.

👉 Côté technique : la liste des opérations accepte un critère de propriétaire et la recherche de comptes associés est paginée.

🔗 Data Hub

👍
UPDATE

Réactiver une connexion ne réactive plus ses imports et exports

Contexte

Réactiver une connexion réactivait automatiquement tous les imports et exports qu'elle porte, y compris ceux qui avaient été désactivés volontairement. Une simple remise en service de la connexion pouvait ainsi relancer des traitements que vous aviez arrêtés.

Fonctionnement

Désactiver une connexion ne change pas : la connexion et l'ensemble de ses imports et exports passent inactifs et aucune planification ne se déclenche.

Réactiver une connexion ne réactive plus que la connexion. L'état actif ou inactif de chacun de ses imports et exports est conservé : ceux qui étaient désactivés le restent, et c'est à vous de réactiver ceux que vous voulez. Un import réactivé pendant que la connexion était inactive reprend sa planification dès que la connexion redevient active.

La modification d'une connexion reste sans effet sur l'état de ses imports et exports.

📄 Documentation :

👉 Côté métier : vous remettez une connexion en service sans relancer par accident des traitements volontairement arrêtés.

👉 Côté technique : le changement de statut d'une connexion ne propage plus son état à ses traitements planifiés ; seule la désactivation reste propagée.

🛠️ API

📘
NEW

Indicateurs de la liste des comptes clients

🚧 API uniquement pour le moment. L'interface Back-Office associée arrivera dans une prochaine version.

Contexte

Connaître ce que rapporte un portefeuille de comptes clients imposait jusqu'ici un export en tableur. Ces indicateurs sont désormais calculés par la plateforme et exposés par l'API.

Fonctionnement

Trois indicateurs sont restitués sur l'ensemble des comptes clients d'un environnement, tous stores confondus :

Volume d'affaires : le montant des commandes logistiques validées sur la période, à partir de l'acceptation fournisseur. Les commandes refusées ou annulées en sont exclues, de même que les lignes refusées, annulées ou supprimées. Le prix remisé est retenu quand l'offre en porte un.
Panier moyen : le montant courant des commandes logistiques validées sur la période, quel que soit leur statut, divisé par le nombre de commandes commerciales dont au moins une commande logistique a été validée sur la période.
Répartition des comptes par statut : le nombre de comptes clients ayant chacun des quatre statuts, et leur total. Ce comptage porte sur le statut courant et ne dépend d'aucune période.

Deux montants sont toujours restitués : les produits hors taxes hors frais de livraison, et le total payé TTC frais de livraison inclus. Les montants sont restitués par devise, jamais additionnés ni convertis.

La date qui rattache une commande à la période est la date de validation de la commande logistique. Les deux bornes sont incluses. Sans période demandée, les indicateurs portent sur toute l'activité depuis la création de l'environnement, sans durée maximale. Les bornes sont interprétées en temps universel (UTC).

Les indicateurs ne tiennent pas compte des filtres ni de la recherche de la liste, et ne sont soumis à aucun droit dédié : qui accède aux comptes clients accède aux indicateurs.

👉 Côté métier : le volume d'affaires, le panier moyen et la répartition des comptes par statut sont disponibles sans export en tableur.

👉 Côté technique : les indicateurs sont exposés par l'API de statistiques, avec une période optionnelle et une ventilation par devise.

Indicateurs de la liste des commandes

🚧 API uniquement pour le moment. L'interface Back-Office associée arrivera dans une prochaine version.

Contexte

La liste des commandes permettait de retrouver une commande, pas de mesurer le flux : quel montant a été commandé sur une période, et où en sont ces commandes.

Fonctionnement

Trois indicateurs sont restitués, sur le périmètre d'un store et de tous ses storeviews :

Montant commandé : le montant des commandes logistiques validées sur la période, à partir du statut « Commande provisoire à valider » et quel que soit leur statut ensuite, commandes refusées et annulées comprises. Une « Commande provisoire » n'est jamais comptée. À la différence du volume d'affaires de la liste des comptes clients, qui ne compte qu'à partir de l'acceptation fournisseur, il lui est toujours supérieur ou égal sur un même périmètre.
Panier moyen : même calcul que sur la liste des comptes clients, restreint au store.
Commandes par étape : parmi les commandes validées sur la période, leur nombre dans chacune des quatre étapes, selon leur statut courant : à valider, en cours, terminées, sans suite. Chaque commande appartient à une seule étape, et le nombre total de commandes passées est restitué avec. Une commande commerciale passée chez trois fournisseurs compte pour trois commandes.

La période des montants et celle du comptage par étape sont indépendantes l'une de l'autre. Comme pour la liste des comptes clients, deux montants sont restitués par devise, les bornes sont incluses, et l'absence de période couvre toute l'activité du store. Les filtres et la recherche de la liste ne s'appliquent pas, et aucun droit dédié n'est requis.

👉 Côté métier : le montant commandé, le panier moyen et l'avancement des commandes sont disponibles store par store, sans export en tableur.

👉 Côté technique : les indicateurs sont exposés par l'API de statistiques, avec une période par indicateur et une ventilation par devise.

Indicateurs restreints au périmètre d'un fournisseur

🚧 API uniquement pour le moment. L'interface Back-Office associée arrivera dans une prochaine version.

Contexte

Les indicateurs des listes de comptes clients et de commandes sont conçus pour l'opérateur et portent sur l'ensemble de son activité. Un fournisseur ne doit voir que la sienne.

Fonctionnement

Les mêmes indicateurs sont restitués sur le seul périmètre du fournisseur, avec des règles de calcul identiques :

Commandes : uniquement les commandes qui lui sont adressées, pour le montant commandé, le panier moyen et la répartition par étape. Une commande commerciale répartie entre plusieurs fournisseurs ne compte que pour sa part.
Comptes clients : la répartition par statut porte sur les seuls comptes clients liés au fournisseur. Un fournisseur lié à aucun compte client n'obtient pas d'indicateurs de comptes.
Montants des comptes clients : les commandes passées chez le fournisseur sont toutes comptées, y compris celles d'un compte client qui ne lui est pas lié. Son volume d'affaires et son panier moyen reflètent donc l'intégralité de ses ventes.

La restriction est appliquée côté serveur : un fournisseur ne peut obtenir aucun chiffre portant sur une commande ou un compte client hors de son périmètre, y compris par un appel direct à l'API. Les indicateurs de l'opérateur ne changent pas.

👉 Côté métier : chaque fournisseur suit son activité et son portefeuille sans jamais voir les chiffres des autres.

👉 Côté technique : le périmètre du fournisseur est déterminé côté serveur à partir de son identité, et l'accès aux statistiques est ouvert aux rôles fournisseur.

👍
UPDATE

Synchronisation des commandes commerciales : champs personnalisés de ligne conservés

Contexte

En mode standard, hors Real-Time Pricing, la synchronisation d'une commande commerciale réécrivait sur chaque ligne ses propres champs personnalisés, à l'identique. Cette réécriture sans effet utile allongeait le temps de réponse et faisait remonter des avertissements sur des champs personnalisés désactivés.

Fonctionnement

En mode standard, les champs personnalisés de ligne ne sont plus réécrits pendant la synchronisation : leurs valeurs sont conservées telles quelles. Un champ personnalisé désactivé présent sur une ligne ne produit donc plus d'avertissement.

Seul le cas d'un champ personnalisé de ligne actif et obligatoire, absent ou vide, continue de remonter un avertissement non bloquant F-W-025 : la ligne est synchronisée normalement.

Le mode Real-Time Pricing est inchangé : les champs personnalisés de ligne y restent repris de la réponse du système de pricing.

Impact API

PUT /v1/shop/commercial-orders/{orderCommercialReference}/sync (operationId : ORDER-223)

La documentation de cette route décrit désormais le mode standard en premier, puis les différences du mode Real-Time Pricing dans une section dédiée, et précise pour chaque donnée réécrite sa source (offre, produit, variant, etc.).

Référence complète des codes : Error / Warning codes

📄 Documentation :

👉 Côté métier : la synchronisation d'une commande commerciale est plus rapide et ne remonte plus d'avertissement sur des champs personnalisés désactivés.

👉 Côté technique : plus d'écriture des champs personnalisés de ligne en mode standard, F-W-025 conservé pour un champ obligatoire absent, mode Real-Time Pricing inchangé.

Liste des fournisseurs : filtre par statut

🚧 API uniquement pour le moment. L'interface Back-Office associée arrivera dans une prochaine version.

Contexte

L'API de la liste des fournisseurs ne se filtrait que par recherche, date de création et date de modification. Le statut du fournisseur, pourtant affiché sur chaque ligne, n'était pas exploitable comme critère.

Fonctionnement

La liste des fournisseurs accepte un filtre par statut : « Actif », « Inactif » et « Suspendu ». Plusieurs statuts peuvent être demandés dans un même appel, et le filtre se combine avec la recherche et les filtres de dates existants.

Sans filtre de statut, la liste renvoie exactement le même résultat qu'auparavant.

👉 Côté métier : ce filtre prépare l'affichage des statistiques de la liste des fournisseurs dans le back-office.

👉 Côté technique : les intégrations peuvent récupérer les fournisseurs d'un ou plusieurs statuts en un seul appel, sans parcourir la liste complète.