Comment gérer les modèles de configuration standard ?

🎯 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 :

Champs personnalisés
Transporteurs
Types d’incidents
Types de documents

🧩 Concepts clés

Modes de configuration

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

Mode	Description
Standard 🔒	La configuration provient entièrement du modèle du Logisticien. Ni le Logisticien ni le chargeur ne peuvent modifier ces éléments directement. Les modifications du modèle sont synchronisées automatiquement. Seuls certains champs spécifiques (ex. identifiants ERP) restent éditables côté chargeur.
Personnalisé 🔓	Le chargeur gère sa configuration de manière indépendante. Le modèle n’a aucun effet. Les deux parties peuvent créer, modifier ou supprimer librement.
Mixte ⚡	Indicateur visible dans la liste des chargeurs signifiant qu’une partie des catégories utilise le modèle, et d’autres non. Exemple : champs personnalisés en standard + transporteurs en personnalisé.

🧭 Propriété (Ownership)

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

Propriétaire Logisticien : seul le Logisticien 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

Action	Logisticien (sans modèle)	Chargeur	Logisticien (avec modèle actif)
Modifier	✅ Oui	❌ Non	⚠️ Via le modèle uniquement
Supprimer	✅ Oui	❌ Non	⚠️ Via le modèle uniquement

Transporteurs – résumé des règles principales

Le propriétaire (Logisticien 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 Logisticien pour ce client (soft delete).

Conservé :

Éléments créés par le chargeur ou par un autre Logisticien.

Appliqué :

Le modèle complet du Logisticien.

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 Logisticien peuvent désormais créer des éléments spécifiques à ce compte.

👩‍💻 Guide administrateur Logisticien

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 Logisticien ou demander un passage en mode personnalisé.

💡 Cas d’usage

1️⃣ Onboarding d’un nouveau client

Le Logisticien 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 Logisticien 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 Logisticien 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 Logisticien 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 Logisticien 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 Logisticien 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 Logisticien. 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

Problème	Cause	Solution
Erreur de synchronisation – Champ déjà existant	Champ avec le même ID présent côté chargeur	Renommer l’ID dans le modèle ou demander au chargeur de modifier le sien
Impossible de modifier un élément du modèle	Tentative depuis la vue client	Modifier directement depuis le modèle ou désactiver le modèle pour ce client
Bouton “Configuration standard” non visible	Fonctionnalité non activée pour votre compte Logisticien	Contacter l’équipe technique Spacefill pour activer `enable_config_template`
Services transporteurs absents	Transporteur personnalisé ou sans services prédéfinis	Ajouter manuellement les services nécessaires
Passage en mode standard supprime trop d’éléments	Éléments du Logisticien spécifiques à ce client	Vérifier avant bascule et ajouter ces éléments dans le modèle global

🧾 Historique des versions

v1.0 – Octobre 2025 : Première version de la documentation sur les modèles de configuration.