Périmètre

BackOffice Djust

Améliorations graphiques et optimisations de design

Dans la continuité de la refonte globale du Back Office de Djust, un redesign des pages suivantes a été apporté afin de simplifier l'expérience utilisateur.

• Page de Types de documents : Settings > Document Types.
• Page de gestion des Utilisateurs du backoffice : Settings > Internal Users.
• Page de gestion des Attributs produits : Settings > Product Attributes.

API

👍

UPDATE

Orders

• Filtrage des commandes à l'utilisateur connecté :

Afin de pouvoir récupérer l’ensemble des commandes d’un customer user sur tous ses comptes (via customerAccountIds) un nouveau filtre est ajouté sur la route de récupération de commandes ORDER-550.

Ainsi, la route ORDER-550 - POST /v1/shop/logistic-orders (et la route historique dépréciée GET /v1/shop/logistic-orders) évoluera comme ceci avec l’ajout de l’attribut suivant :

connectedUserOnly : booléen optionnel pour préciser si oui ou non la réponse doit être filtrée sur le customer user connecté.

Si le param connectedUserOnly est à true, alors les commandes remontées seront celles du customer user de l’ensemble des accounts précisés dans la liste d’ids customerAccountIds.

• Récupération des commandes commerciales par référence :

La route de récupération de commandes commerciales fonctionne avec l’attribut idType servant à distinguer si l'id est de type business_id ou cart_id.

L’id de base pour une commande est la référence. Ainsi, la valeur REFERENCE a été ajoutée à la liste des valeurs possibles d’idType sur la route ORDER-500 - GET /v1/shop/commercial-orders/{orderCommercialId} afin de pouvoir récupérer une commande depuis une référence.

Jobs

• Data Hub - Paramètre cronExpression désormais optionnel

Jusqu’à présent, le paramètre cronExpression était requis dans le payload de création ou de mise à jour d’un job, via les endpoints :

POST /v2/mapper/job
PUT /v1/mapper/job/{jobId}

Cela impliquait qu’un job devait toujours être déclenché selon une planification.

Dans certains cas d’usage, il est nécessaire de créer un job sans planification automatique, qui ne sera déclenché que manuellement (via un appel explicite à l’exécution du job).

Nouveauté

Le champ cronExpression devient optionnel dans ces endpoints

Comportement attendu

Exemples

Avec cronExpression (job planifié automatiquement)

{
	"clientConfigurationId": "string",
	"cronExpression": "0 0 \* \* \* ?",
	"jobName": "attribute-import-job",
	...
}

Sans cronExpression (job déclenchable uniquement manuellement)

{
	"clientConfigurationId": "string",
	"jobName": "attribute-import-job",
	...
}

• Data Hub - Amélioration de la route GET /v2/mapper/job/generic-job-types?flux=import

Cette route permet d’obtenir la liste des types de jobs disponibles pour un flux d’import ou d’export, des connexions client disponibles (FTP, Connecteur API ou Mirakl) et des formats de fichiers acceptés (JSON, CSV, XML). Elle a été enrichie afin de mieux refléter les différentes configurations possibles.

Ce qui change

Nouveau format de réponse

[
	{
		"name": "SUPPLIER",
		"flux": "IMPORT",
		"trigger": "SCHEDULED",
		"availableConfigurations": [
			{
				"clientType": "SFTP_CLIENT",
				"acceptedFormats": [
					"CSV"
				]
			},
			{
				"clientType": "API_NO_AUTH_CLIENT",
					"acceptedFormats": [
					"JSON"
				]
			},
			{
				"clientType": "API_OAUTH2_CLIENT",
					"acceptedFormats": [
						"JSON"
					]
			},
			{
				"clientType": "MIRAKL_CLIENT",
					"acceptedFormats": [
						"EMPTY"
					]
			}
		]
	},
]