Import immobilisations MyUnisoft (format Quadra)

Ce skill convertit une liste d'immobilisations en fichier ASCII séquentiel QuadraIMMO, importable dans MyUnisoft. MyUnisoft accepte le format Quadra pour les immobilisations : menu Tenue > Flux > Imports, sélection de l'éditeur d'immobilisations Quadra, puis choix du fichier.

Quand l'utiliser

Dès qu'l'utilisateur veut intégrer / reprendre des immobilisations dans un dossier MyUnisoft à partir d'un tableau d'immobilisations, d'un état des amortissements, d'un export d'un ancien logiciel, d'un PDF, d'un Excel/CSV ou d'une saisie manuelle.

Déroulé

1. Identifier le dossier client (CRM en priorité)

Si un nom de client/société est mentionné, consulter d’abord le CRM du cabinet (si disponible) pour récupérer le nom exact du dossier. Le nom_dossier n'est utilisé que pour nommer le fichier ; il n'a pas besoin de correspondre exactement au libellé MyUnisoft (l'import se fait dans le dossier déjà ouvert).

2. Lire la source des immobilisations

La source peut être :

• un Excel/CSV (tableau des immobilisations) → utiliser le skill xlsx ou lire le CSV directement (colonnes usuelles : compte, libellé, date d'acquisition/mise en service, valeur HT, durée, mode, amortissements antérieurs, dotation, VNC) ;
• un PDF (état des immobilisations, plan d'amortissement) → skill pdf-reading ; si scanné, OCR puis relire attentivement les colonnes chiffrées (l'OCR décale souvent les colonnes et confond ,/.) ;
• une saisie manuelle dictée par l'utilisateur.

Extraire, pour chaque immobilisation : compte, libellé, dates d'acquisition et de mise en service, valeur HT, mode et durée d'amortissement, amortissements antérieurs (cumul avant l'exercice en cours), dotation de l'exercice, VNC.

Voir references/format_quadraimmo.md pour le détail de tous les champs, les règles de codage et le schéma JSON complet.

3. Construire le JSON

Rassembler les données dans un JSON selon le schéma de references/format_quadraimmo.md. Structure résumée :

{
  "nom_dossier": "SARL EXEMPLE",
  "immobilisations": [
    { "compte": "215400", "libelle": "Camion Renault Master",
      "date_acquisition": "15/03/2022", "date_mise_service": "15/03/2022",
      "valeur_ht": 25000.00, "duree_eco": 5, "type_eco": "L",
      "amort_ant_eco": 10000.00, "dotation_eco": 5000.00 } ]
}

Points à clarifier avec l'utilisateur avant de générer (sauf si déjà dans la source ou la conversation) :

• Reprise en cours d'amortissement ? S'il s'agit d'une reprise de dossier, bien distinguer les amortissements antérieurs (cumul à l'ouverture de l'exercice) de la dotation de l'exercice. Si la source ne donne que le cumul total, demander la date d'arrêté correspondante.
• Amortissement fiscal dérogatoire ? Par défaut le volet fiscal recopie le comptable (type_eco, duree_eco, taux_eco, amort_ant_eco, dotation_eco). Ne renseigner les champs *_fiscal que s'il y a un amortissement dérogatoire.
• Dossier déjà existant dans MyUnisoft ? Quasi toujours oui → ne pas générer le bloc constantes. Ne l'ajouter que si le dossier n'existe pas.

Le script calcule automatiquement, si non fournis : taux linéaire (100/durée), base d'amortissement (= valeur HT), VNC (= valeur − amort − dotation), n° d'immobilisation, état, et le volet fiscal. Ne pas inventer une donnée manquante : la déduire si c'est raisonnable, sinon demander à l'utilisateur.

4. Générer le fichier

python3 scripts/build_immo_quadra.py chemin/vers/entree.json -o "IMMO_<Dossier>.txt"

Le script :

• écrit un enregistrement de 480 caractères par immobilisation, à positions fixes (montants en centimes, dates JJMMAA, taux ×100), en latin-1, fins de ligne CRLF ;
• ajoute l'enregistrement constantes (ID, 180 car.) uniquement si le JSON contient une clé constantes ;
• exécute des contrôles de cohérence et affiche un rapport.

5. Vérifier le rapport de contrôle

Le script contrôle notamment :

• valeur HT > 0 et compte renseigné (classe 2 attendue) ;
• date de mise en service présente ;
• amort. antérieurs + dotation ≤ valeur HT (pas de sur-amortissement) ;
• cohérence VNC = valeur − amort − dotation ;
• cohérence taux linéaire / durée ;
• unicité des n° d'immobilisation.

Si une [ERREUR] ou une [ALERTE] apparaît, la signaler à l'utilisateur et vérifier l'extraction avant de présenter le fichier (souvent : virgule mal lue, colonne décalée par l'OCR, ou confusion cumul/dotation). Le fichier est tout de même généré pour inspection.

6. Présenter le livrable

Présenter le .txt avec present_files, accompagné d'un résumé court du rapport (nombre d'immobilisations, total valeur HT, statut des contrôles). Rappeler que l'import se fait dans MyUnisoft via Tenue > Flux > Imports, éditeur d'immobilisations Quadra, dans le dossier concerné.

Notes

• Plusieurs immobilisations : autant d'objets dans immobilisations.
• Véhicules : renseigner le sous-objet vehicule (immatriculation, CO2, puissance) pour les VP/VU.
• Cession : etat = "C", date_cession et prix_cession renseignés.
• Ne jamais introduire de caractères de séparation parasites dans les libellés : le script neutralise tabulations et retours, mais privilégier des libellés propres, tronqués à 30 caractères.
• En cas de doute sur une convention (fichier trimé vs complété à 480 car., encodage), valider avec un fichier test réel fourni par l'utilisateur et ajuster le script si besoin.