Page de configuration système
Accès : Menu latéral → Administration → Paramètres → Configuration
Accès restreint
Cette page est réservée aux utilisateurs ayant le rôle Administrateur. Tout autre rôle est redirigé automatiquement.
Vue d'ensemble
La page de configuration système permet à l'administrateur de piloter le comportement global de SocFF sans redéploiement : choix de l'ERP actif, activation/désactivation des tâches automatiques (crons), et URLs des services.
Toute modification n'est effective qu'après avoir cliqué sur Sauvegarder.
Section ERP
Type ERP actif
Le sélecteur Type ERP actif (TYPE_ERP) détermine quel connecteur est utilisé pour l'intégration des factures et des bons de commande.
| Valeur | Connecteur | Port |
|---|---|---|
CEGID |
soc_ff_cegid |
10085 |
SAP |
soc_ff_sap |
10088 |
BLG |
soc_ff_blg |
variable |
Info
Ce paramètre conditionne également quels crons spécifiques sont actifs (crons BLG ou crons SAP).
Section Processus
Les trois interrupteurs de cette section permettent de suspendre immédiatement des processus critiques sans toucher aux crons individuels.
| Interrupteur | Effet |
|---|---|
| Bloquer tous les crons | Interrupteur global — suspend immédiatement tous les crons du backend. À utiliser lors d'une maintenance ou d'une intervention d'urgence. |
| Bloquer archivage emails PARC | Suspend uniquement le cron d'archivage des emails du parc, sans couper les autres processus. |
| Bloquer lecture emails factures fournisseur | Suspend la lecture de la boîte Office365 dédiée aux factures fournisseurs. Les emails restent dans la boîte et seront traités à la réactivation. |
Attention
Activer Bloquer tous les crons stoppe l'ensemble des automatismes : import ERP, OCR, EDI, etc. À n'utiliser qu'en cas de besoin explicite.
Section Crons généraux
Les crons généraux sont actifs quel que soit l'ERP sélectionné. Ils couvrent l'ensemble du pipeline SocFF : import des référentiels, OCR, EDI, et SocOrder.
Import des référentiels ERP
| Cron | Horaire | Description |
|---|---|---|
| Import fournisseurs | 18h25, puis toutes les heures | Synchronise la liste des fournisseurs depuis MSSQL ERP (SOCODICOR) vers la base MySQL locale. |
| Import clients | 18h25, puis toutes les heures | Synchronise la liste des clients depuis MSSQL ERP. |
| Import dépôts | Même horaire | Synchronise la liste des dépôts/entrepôts depuis l'ERP. |
| Import utilisateurs stock | Même horaire | Récupère les utilisateurs de l'application stock pour maintenir les droits. |
OCR et emails
| Cron | Horaire | Description |
|---|---|---|
| Import emails factures fournisseur | Toutes les 4h | Fusionne les pièces jointes PDF des emails fournisseurs reçus sur la boîte Office365, puis les injecte dans le pipeline OCR. |
| Feedback Dataleon | 21h30 (quotidien) | Envoie les corrections manuelles des factures à l'API Dataleon pour améliorer les modèles OCR. |
| Mise à jour étapes factures | Toutes les heures (6h-22h) | Recalcule l'étape de workflow de chaque facture fournisseur selon les règles métier (rapprochement BDC, validation comptable, etc.). |
EDI — Factures fournisseurs
| Cron | Description |
|---|---|
| Export EDI factures fournisseur | Génère les fichiers EDI (format CC) pour les factures validées et les dépose dans le dossier DC_DOSSIER_SORTIE_EDI_CC. |
| Intégration EDI FF dans ERP | Transmet les fichiers EDI de factures au connecteur ERP actif pour intégration dans CEGID, SAP ou BLG. |
| Récupération numéro FF ERP | Récupère depuis l'ERP le numéro d'enregistrement attribué aux factures intégrées pour le suivi. |
| Vérification erreur insertion FF ERP | Détecte les factures dont l'intégration a échoué et déclenche une alerte Slack avec le détail de l'erreur. |
EDI — Avoirs
| Cron | Description |
|---|---|
| Export EDI avoirs | Génère les fichiers EDI pour les avoirs fournisseurs (notes de crédit). |
| Intégration EDI avoirs dans ERP | Transmet les fichiers EDI d'avoirs au connecteur ERP actif. |
EDI — Bons de commande
| Cron | Description |
|---|---|
| Export EDI bons de commande | Génère les fichiers EDI (format BRC) pour les bons de commande, déposés dans DC_DOSSIER_SORTIE_EDI_BRC. |
| Intégration EDI BDC dans ERP | Transmet les fichiers EDI de bons de commande au connecteur ERP actif. |
| Récupération numéro BDC ERP | Récupère depuis l'ERP le numéro attribué aux bons de commande intégrés. |
| Vérification erreur insertion BDC ERP | Détecte les bons de commande dont l'intégration a échoué et déclenche une alerte. |
Crons CEGID spécifiques
Ces crons ne sont pertinents que lorsque TYPE_ERP = CEGID.
| Cron | Description |
|---|---|
| Vérification PRE (CEGID) | Vérifie le statut des Prises En Charge (rapprochement facture/commande) côté CEGID et met à jour les factures en base locale. |
| Vérification BDC (CEGID) | Vérifie le statut des bons de commande côté CEGID et synchronise les données. |
| Sync documents (CEGID) | Synchronise les documents traités côté CEGID (toutes les 30 min ou 5 min selon configuration) pour refléter leur statut d'intégration. |
Crons SocOrder
Ces crons pilotent le module de gestion des commandes fournisseurs (SocOrder), actif de 6h à 23h.
| Cron | Description |
|---|---|
| Rapport attente ARC (SocOrder) | Génère et envoie par email le rapport des bons de commande en attente d'Accusé de Réception Commande (ARC). |
| Calcul encours (SocOrder) | Calcule l'encours financier par fournisseur (montant des factures en cours) et met à jour les tableaux de bord. |
| Date livraison depuis ERP (SocOrder) | Récupère depuis l'ERP les dates de livraison confirmées pour les bons de commande. |
| Récupération emails commandes (SocOrder) | Récupère les emails de confirmation de commande reçus pour les associer aux bons de commande. |
| Envoi emails commandes (SocOrder) | Envoie automatiquement les emails de commande aux fournisseurs (toutes les minutes, 6h-23h). |
Sections Crons BLG et Crons SAP
Ces sections ne concernent que l'ERP correspondant (TYPE_ERP = BLG ou TYPE_ERP = SAP). Désactiver ces crons quand l'ERP correspondant n'est pas l'ERP actif n'a aucun effet pratique, mais garder l'ERP actif en cohérence avec les crons activés est recommandé.
Crons BLG
| Cron | Description |
|---|---|
| Vérification jobs BLG | Vérifie l'état des jobs d'intégration soumis à l'API BLG Cloud. Toutes les minutes (6h-23h). |
| Analyse commandes BLG | Analyse les retours BLG sur les commandes intégrées et met à jour le statut des bons de commande. |
| Clôture auto FF BLG | Clôture automatiquement les factures fournisseurs dont l'intégration BLG est confirmée. |
| Analyse avoirs BLG | Analyse les retours BLG sur les avoirs et met à jour leur statut d'intégration. |
| Analyse BDC BLG | Analyse les retours BLG sur les bons de commande et met à jour leur statut. |
Crons SAP
| Cron | Description |
|---|---|
| Vérification jobs SAP | Vérifie l'état des jobs d'intégration soumis au connecteur SAP. |
| Analyse commandes SAP | Analyse les retours SAP sur les commandes intégrées. |
| Clôture auto FF SAP | Clôture automatiquement les factures fournisseurs dont l'intégration SAP est confirmée. |
| Analyse avoirs SAP | Analyse les retours SAP sur les avoirs et met à jour leur statut. |
| Analyse BDC SAP | Analyse les retours SAP sur les bons de commande et met à jour leur statut. |
Section URLs des services
Cette section configure les adresses réseau de chaque composant de SocFF. Ces URLs sont utilisées par le backend pour communiquer avec les autres services.
| Champ | Variable | Description |
|---|---|---|
| URL API backend | HOST_WEB_API |
URL de base de l'API backend Express.js. Utilisée par le frontend et les outils CLI. Exemple : http://localhost:8081 |
| URL frontend | HOST_WEB_FRONT |
URL publique du frontend Next.js. Utilisée par le backend pour générer des liens dans les emails. Exemple : http://localhost:10021 |
| URL connecteur CEGID | HOST_API_CEGID |
URL du service NestJS soc_ff_cegid. Actif quand TYPE_ERP = CEGID. Exemple : http://localhost:10085 |
| URL connecteur BLG | HOST_API_BLG |
URL du service NestJS soc_ff_blg. Actif quand TYPE_ERP = BLG. |
| URL connecteur SAP | HOST_API_SAP |
URL du service NestJS soc_ff_sap. Actif quand TYPE_ERP = SAP. Exemple : http://localhost:10088 |
| URL API stock | APP_STOCK_HOST_WEB_API |
URL de l'API de l'application de gestion de stock complémentaire. |
| URL frontend stock | APP_STOCK_HOST_WEB_FRONT |
URL publique du frontend stock pour les liens dans les emails et notifications. |
| URL API ARC Salon 2024 | APP_ARC_SALON_2024_HOST_WEB_API |
URL de l'API de l'application ARC Salon 2024. |
| URL frontend ARC Salon 2024 | APP_ARC_SALON_2024_HOST_WEB_FRONT |
URL publique du frontend ARC Salon 2024. |
Environnement Docker
En environnement Docker, les services se parlent via l'IP de la passerelle Docker (172.17.0.1) et non localhost. Exemple : http://172.17.0.1:10085 pour le connecteur CEGID.
Bouton Sauvegarder
Le bouton Sauvegarder (en bas à droite) envoie l'ensemble de la configuration modifiée au backend via PUT /configuration/settings.
- Pendant la sauvegarde, le bouton affiche un spinner et est désactivé pour éviter les doubles soumissions.
- En cas de succès, une notification verte apparaît en haut à droite.
- En cas d'erreur réseau ou serveur, une notification rouge s'affiche avec un message d'erreur.
Warning
Les modifications ne sont pas appliquées à chaud pour les crons déjà en cours d'exécution. Le changement prend effet au prochain déclenchement planifié de chaque cron.
Boutons d'aide contextuels
Chaque paramètre dispose d'un bouton ? à sa droite. Un clic ouvre un modal explicatif indiquant le code technique du paramètre, son titre et une description détaillée de son rôle.
Cas d'usage typiques
Maintenance planifiée
- Activer Bloquer tous les crons pour suspendre tous les automatismes.
- Effectuer la maintenance (migration base, mise à jour connecteur, etc.).
- Désactiver Bloquer tous les crons puis cliquer sur Sauvegarder.
Changement d'ERP
- Changer le Type ERP actif vers le nouvel ERP.
- Vérifier et mettre à jour l'URL du connecteur correspondant.
- Activer les crons spécifiques au nouvel ERP (BLG ou SAP).
- Désactiver les crons de l'ancien ERP si nécessaire.
- Cliquer sur Sauvegarder.
Suspension temporaire de l'OCR email
Désactiver uniquement Import emails factures fournisseur et/ou Bloquer lecture emails factures fournisseur puis sauvegarder. Les emails restent dans la boîte Office365 et seront traités à la réactivation.