⚙️ Composant Métier : Importation des Règlements Clients

29 / Oct / 2020 Capsoft

🧩 Module d’Import et Lettrage des Règlements Clients

1. 🎯  Objectif du Composant

Importer un fichier Excel contenant les règlements clients, effectuer des contrôles de cohérence, et automatiser le lettrage avec les factures correspondantes.

2. 📂 Entrée du Composant

•    Type de fichier : Excel (.xlsx)
•    Modèle requis : fichier structuré avec les colonnes suivantes :
            o    Numéro client (référence dans Oxygène)
            o    Date de règlement
            o    Montant
            o    Référence facture (liée à la gestion commerciale Oxygène)
            o    Mode de paiement
            o    Référence bancaire
            o    Événement / Salon (optionnel)

3. 🔍 Contrôles Fonctionnels
À l’import :

  •     Vérification du format du fichier
  •     Présence des colonnes obligatoires
  •     Types de données conformes (dates, montants numériques, etc.)
  •     Détection des doublons (référence bancaire déjà enregistrée)
  •     Existence du client dans la base Oxygène
  •     Référence facture valide et non lettrée
  •     Montant cohérent avec la facture
  •     Si renseigné : vérification de l’événement/salon dans le référentiel

En cas d’erreur :

  •     Génération d’un rapport d’erreurs
  •     Blocage de l’import ou traitement partiel selon gravité

4. ⚙️ Traitements Métier

Une fois les données validées :
•    Création des écritures de règlement dans Oxygène
•    Lettrage automatique :
            o    Montant = facture → lettrage direct
            o    Montant < facture → lettrage partiel
            o    Montant > facture → alerte ou proposition de lettrage multiple
•    Gestion des écarts :
            o    Tolérance paramétrable (ex. : ±1€)
            o    Écart hors tolérance → mise en attente ou rejet

5. 🧪 Cas d’usage spécifiques

a. Règlements liés à des événements ou salons
•    Les règlements collectés lors d’événements (ex : salons professionnels) sont enregistrés dans un fichier Excel par les équipes commerciales.
•    Ce fichier contient une colonne “Événement” permettant de regrouper les règlements par contexte.
•    À l’import :
               o    Le composant identifie les règlements liés à un événement spécifique
               o    Permet un suivi analytique par événement
               o    Facilite le rapprochement avec les factures émises dans le cadre de l’événement

b. Traitement groupé par événement
•    Possibilité d’importer un fichier contenant uniquement les règlements d’un salon donné
•    Génération d’un rapport spécifique à l’événement
•    Lettrage automatique des règlements avec les factures associées à l’événement

6. 📈 Suivi et Journalisation

•    Rapport d’import :
            o    Nombre de lignes traitées
            o    Nombre de règlements créés
            o    Nombre de lettrages effectués
            o    Erreurs détectées
            o    Répartition par événement/salon
•    Historique des imports consultable dans Oxygène
•    Journalisation des actions pour audit

7. 🔐 Sécurité et Accès

•    Accès au composant restreint par rôle utilisateur dans Oxygène
•    Permissions configurables pour :
             o    Import
             o    Validation
             o    Lettrage manuel