Périmètre

🖥️ Back-Office

👍
UPDATE

Colonne SHIPPING de la vue Order lines

Contexte

Avec le module shipping V1, les frais de port des commandes issues du checkout direct sont résolus au niveau de la commande logistique (via la matrice de frais), et non plus ligne par ligne. La vue "Order lines" du back-office affichait pourtant une colonne SHIPPING à 0 € sur chaque ligne, ce qui laissait penser à une absence de frais de port alors que ceux-ci existent bien au niveau de la commande logistique.

Fonctionnement

Lorsque le shipping par ligne n'est plus applicable — commande issue du checkout direct avec module shipping actif — la colonne SHIPPING n'est plus affichée dans la vue "Order lines". Le montant de référence reste celui porté par la commande logistique.

Les autres cas conservent leur affichage actuel :

commande issue d'une quote : le shipping saisi par ligne reste affiché ;
commande sans module shipping actif : comportement inchangé.

👉 Côté métier : la vue "Order lines" ne présente plus de montant de frais de port trompeur ; l'opérateur lit le franco et les frais de port au bon niveau, celui de la commande logistique.

👉 Côté technique : l'affichage de la colonne SHIPPING est désormais conditionné à la présence effective d'un shipping par ligne.

🛠️ API

📘
NEW

Base de calcul du franco de port (HT / TTC)

Contexte

Le franco de port du module shipping V1 est comparé au montant TTC de la commande logistique. De nombreux acheteurs B2B raisonnent en HT et attendent que leur seuil de franco s'applique sur le total hors taxes. Un paramètre de configuration au niveau du tenant permet désormais de choisir la base de comparaison.

Fonctionnement

Un nouveau setting OMS francoTaxBasis définit la base de calcul du franco de port :

TTC : le seuil de franco est comparé au total TTC de la commande logistique ;
HT : le seuil de franco est comparé au total HT de la commande logistique.

La valeur par défaut est TTC : le comportement des tenants existants reste strictement identique, aucune action n'est requise. La modification du setting est réservée au rôle DJUST_ADMIN, comme pour l'activation du module shipping.

Le changement de base de calcul est signalé sur les paniers en cours au moment du switch, via un avertissement dédié (référence complète : Error / Warning codes).

À noter : ce setting porte uniquement sur la base de comparaison du franco. Le prix des frais de port issus de la matrice reste exprimé en TTC.

Impact API

GET /v1/settings/oms — le champ francoTaxBasis est retourné dans les settings.

PATCH /v1/settings/oms — le champ francoTaxBasis est accepté en entrée. Valeurs autorisées : HT, TTC. Une valeur hors énumération est rejetée en 400, un appel par un rôle non autorisé en 403.

📄 Documentation :

👉 Côté métier : chaque marchand peut aligner son seuil de franco de port sur sa logique commerciale, HT ou TTC, sans développement spécifique.

👉 Côté technique : nouveau champ francoTaxBasis en lecture et en écriture sur les settings OMS, avec défaut TTC garantissant la rétrocompatibilité.

👍
UPDATE

Exposition du shipping par ligne de commande

Contexte

Le champ de frais de port porté par les lignes de commande (OrderLine.shippingPrice et taxes associées) n'a plus de sens fonctionnel pour les commandes issues du checkout direct lorsque le module shipping est actif : les frais sont alors résolus au niveau de la commande logistique. Il reste en revanche indispensable pour les commandes issues d'une quote, où le shipping est saisi par ligne.

Fonctionnement

Le shipping par ligne n'est plus exposé pour les commandes sans origine quote lorsque le module shipping est actif. La source de vérité pour ces commandes est le shipping résolu au niveau de la commande logistique.

Les commandes issues d'une quote continuent d'exposer le shipping par ligne, et les commandes des tenants sans module shipping actif conservent le comportement existant.

Impact API

Endpoints de récupération d'une commande exposant OrderLine — ORDER-501 (shop) et ADM-ORDER-501 (admin) : les champs de shipping par ligne ne sont plus renseignés pour les commandes concernées.

Les intégrations qui lisent le shipping au niveau de la ligne pour des commandes issues du checkout direct doivent se baser sur le shipping de la commande logistique.

📄 Documentation : Start From A Source Operation Or Quote

👉 Côté métier : les montants de frais de port restitués par l'API correspondent au niveau où ils sont réellement calculés, sans valeur nulle ambiguë.

👉 Côté technique : point de vigilance pour les intégrateurs — le shipping par ligne n'est plus disponible pour les commandes directes avec module shipping actif.