Gérer les modèles de configuration (Configuration Templates)

🎯 Avantages des modèles de configuration

• Centralisation : gérer toutes les configurations depuis un seul espace.

• Cohérence : assurer une uniformité des paramètres entre les chargeurs.

• Efficacité : réduire considérablement le temps de paramétrage lors de l’onboarding.

• Synchronisation automatique : toute modification du modèle est instantanément appliquée à tous les clients associés.

---

⚙️ Éléments gérés par le modèle

Le modèle de configuration prend en charge les quatre catégories suivantes :

1. Champs personnalisés

2. Transporteurs

3. Types d’incidents

4. Types de documents

---

🧩 Concepts clés

Modes de configuration

Chaque catégorie peut être dans l’un des trois états suivants :

---

🧭 Propriété (Ownership)

Chaque entité configurée possède un propriétaire :

• Propriétaire 3PL : seul le 3PL peut modifier (sauf champs ERP spécifiques).

• Propriétaire chargeur : seul le chargeur peut modifier (sauf champs TMS/WMS).

Ces règles s’appliquent même en dehors de l’usage du modèle pour garantir une séparation claire des responsabilités.

---

🔐 Permissions et droits d’édition

Champs personnalisés

Transporteurs – résumé des règles principales

• Le propriétaire (3PL ou chargeur) garde la main sur tous les champs principaux.

• Certaines clés d’intégration (ERP / TMS / WMS) peuvent être modifiées par l’autre partie selon les cas.

• Avec un modèle actif, seuls les champs ERP restent modifiables côté chargeur.

(Les matrices détaillées sont disponibles dans la documentation technique interne.)

---

🔄 Comportement de synchronisation

Synchronisation transactionnelle

Lorsqu’une modification est effectuée sur le modèle :

• La synchronisation s’applique à tous les clients liés.

• Si une erreur survient pour un client, la modification est annulée pour tous (transaction atomique).

• Un message d’erreur détaille le client et la cause (ex. champ déjà existant).

Cas d’erreur fréquents :

• Champ personnalisé avec le même ID déjà présent côté chargeur.

• Violation de contraintes en base de données.

---

🔁 Passage entre les modes

De personnalisé vers standard

Supprimé :

• Tous les éléments créés spécifiquement par le 3PL pour ce client (soft delete).

Conservé :

• Éléments créés par le chargeur ou par un autre 3PL.

Appliqué :

• Le modèle complet du 3PL.

---

De standard vers personnalisé

Conservé :

• Tous les éléments du modèle existants (l’historique est préservé).

Modifié :

• Les mises à jour futures du modèle ne seront plus synchronisées.

• Le chargeur et le 3PL peuvent désormais créer des éléments spécifiques à ce compte.

---

👩‍💻 Guide administrateur 3PL

Accéder au modèle

• Ouvrir Paramètres > Chargeurs > Modifier la configuration standard.

Gérer la synchronisation

• Dans la liste des chargeurs, les statuts Standard / Personnalisé / Mixte sont indiqués.

Modifier le modèle

• Naviguer dans chaque onglet (Champs personnalisés, Types d’incidents, Transporteurs, Documents).

• Créer, modifier ou supprimer des éléments.

• Les changements sont automatiquement synchronisés.

• Les IDs/API Keys ne sont pas modifiables après création.

Gérer la configuration client

• Accéder à Paramètres > Chargeurs > [Client] > Configuration.

• Utiliser :

  • 🔒 Revenir à la configuration standard

  • 🔓 Gérer de manière personnalisée

• Une boîte de confirmation explique toujours l’impact avant l’application.

---

👤 Guide administrateur chargeur

Consultation

• Accès via Paramètres > Configuration pour voir la configuration actuelle.

Modifications possibles (même avec modèle actif)

• Champs liés à l’ERP :

  • ext_erp_carrier_id

  • ext_erp_shipper_id

  • ext_erp_service_id

Éléments issus du modèle

• Identifiables par une icône spécifique et des boutons gris (non éditables).

• Pour toute modification, contacter le 3PL ou demander un passage en mode personnalisé.

---

💡 Cas d’usage

1️⃣ Onboarding d’un nouveau client

• Le 3PL crée le chargeur.

• Active la configuration standard par catégorie.

• Le client hérite instantanément de tous les paramètres du modèle.

➡️ Bénéfice : mise en service quasi instantanée.

---

2️⃣ Ajout global d’un champ personnalisé

• Le LSP crée un champ “Numéro de commande” dans le modèle.

• Celui-ci est immédiatement disponible pour tous les clients liés.

➡️ Bénéfice : déploiement global en une seule action.

---

3️⃣ Client avec besoins spécifiques

• Option A : rester en mode standard et créer des champs complémentaires (bénéficie toujours du modèle).

• Option B : basculer en mode personnalisé pour une autonomie totale (sans synchronisation).

---

4️⃣ Correction d’un type d’incident

• Le 3PL modifie le nom d’un type d’incident dans le modèle.

• La modification se répercute automatiquement sur tous les clients.

(Les clés techniques restent inchangées pour préserver l’historique.)

---

5️⃣ Gestion des transporteurs

• Transporteur prédéfini : ex. Chronopost – services standards déjà disponibles.

• Transporteur personnalisé : créé manuellement par le 3PL avec ses propres services.

---

❓ FAQ & Dépannage

Q : Que se passe-t-il si j’active le modèle pour un client déjà configuré ?
👉 Les éléments créés par le 3PL sont remplacés par ceux du modèle. Ceux du chargeur sont conservés. Une confirmation s’affiche avant l’application.

Q : Puis-je activer le modèle seulement pour certaines catégories ?
👉 Oui, chaque catégorie peut être activée ou non indépendamment.

Q : Le chargeur peut-il refuser le modèle ?
👉 Non. Seul le 3PL contrôle l’activation. Le chargeur garde néanmoins la main sur ses champs ERP.

Q : La suppression d’un élément du modèle supprime-t-elle les données historiques ?
👉 Non. Les éléments sont marqués comme supprimés mais les données restent visibles dans les historiques.

Q : Puis-je avoir plusieurs modèles ?
👉 Non, un seul modèle par 3PL. Pour des besoins très différents, utiliser le mode personnalisé.

Q : Comment identifier un élément provenant du modèle ?
👉 Il est affiché avec une icône spécifique et un bouton d’édition grisé.

---

🧩 Erreurs courantes

---