Import emprunt MyUnisoft

Ce skill convertit un tableau d'amortissement d'emprunt en ZIP d'import MyUnisoft : deux CSV liés (Emprunts_<dossier>.csv et Echéances_<dossier>.csv) au format exact attendu par l'outil, avec contrôles de cohérence comptable.

Quand l'utiliser

Dès que l'utilisateur veut intégrer un prêt / emprunt bancaire dans MyUnisoft à partir d'un tableau d'amortissement (PDF bancaire, scan, échéancier, offre de prêt).

Déroulé

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

Si un nom de client/société est mentionné, consulter d'abord le CRM CABINET (voir skill crm-cabinet-priority) pour récupérer le nom exact du dossier et, si disponible, le plan de comptes (numéros de compte capital / intérêts / assurance). Le nom_dossier doit correspondre au dossier MyUnisoft.

2. Lire le tableau d'amortissement

Le fichier source est presque toujours un PDF. Lire son contenu :

• PDF texte → extraction directe (skill pdf-reading).
• PDF scanné → OCR (skill pdf / pdf-reading), puis relire attentivement les colonnes (l'OCR confond souvent virgule/point et décale les colonnes).

Extraire, depuis l'en-tête du tableau : capital emprunté, taux nominal, durée, date de souscription/déblocage, date de 1re échéance, organisme prêteur, périodicité.

Puis, ligne par ligne dans le tableau : date, capital remboursé, intérêts, assurance de chaque échéance.

Voir references/format_myunisoft.md pour le détail des champs, les valeurs comptables usuelles et les points de vigilance (différé, assurance hors échéance, etc.).

3. Construire le JSON

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

{
  "nom_dossier": "DUPONT SARL",
  "emprunts": [ { "num": 1, "motif": "...", "compte_capital": "164110",
                  "compte_interet": "661160", "compte_assurance": "661160",
                  "montant": 30000, "date_souscription": "28/04/2016",
                  "echeance1": "15/06/2016", "type_organisme": "Organisme de crédit",
                  "organisme": "CMDP", "echeance_constante": "Oui",
                  "type_remboursement": "Mois", "taux": 1.5, "duree": 84,
                  "assurance_constante": "Oui", "assurance_mt_tx": 7.61 } ],
  "echeances": [ { "num": 1, "date": "15/06/2016", "rbt_capital": 338.94,
                   "montant_int": 20.54, "montant_ass": 7.61 } ]
}

Comptes comptables — TOUJOURS LES DEMANDER. Avant de générer le fichier, demander explicitement à l'utilisateur les trois numéros de compte à utiliser :

• compte capital (classe 16 — emprunts auprès des établissements de crédit ; souvent un sous-compte dédié par emprunt) ;
• compte intérêts (classe 66 — charges d'intérêts) ;
• compte assurance (compte de l'assurance emprunteur ; parfois regroupé avec les intérêts).

Poser la question de façon concise en proposant des valeurs usuelles à titre indicatif (164110 / 661160 / 661160), mais ne pas générer le ZIP tant que les comptes ne sont pas confirmés. Si l'utilisateur répond « les valeurs par défaut » ou équivalent, utiliser 164110 / 661160 / 661160. S'il a déjà indiqué les comptes plus tôt dans la conversation, les réutiliser sans redemander.

Si une autre donnée d'en-tête manque dans le PDF, la déduire si possible (ex. durée = nombre de lignes du tableau) ou demander à l'utilisateur plutôt que d'inventer.

4. Générer le ZIP

python3 scripts/build_zip.py chemin/vers/entree.json -o "Import_emprunt_<Dossier>.zip"

Le script :

• écrit les deux CSV au format exact MyUnisoft (séparateur ;, décimales à la virgule avec zéros de fin supprimés, dates JJ/MM/AAAA, contenu en latin-1, fins de ligne CRLF) ;
• nomme les fichiers Emprunts_<dossier>.csv et Echéances_<dossier>.csv, le « é » étant encodé en CP850 dans le ZIP (comme le modèle d'origine) ;
• 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 :

• Somme des capitaux remboursés = capital emprunté (contrôle clé) ;
• Nombre d'échéances = durée (pour un remboursement mensuel) ;
• 1re échéance = date Echeance1 déclarée ;
• échéances rattachées à un emprunt existant ; montant > 0.

Si une [ALERTE] ou une [ERREUR] apparaît, la signaler à l'utilisateur et vérifier l'extraction avant de présenter le fichier (souvent : virgule mal lue, échéance manquante, ou dernière échéance d'ajustement). Le ZIP est tout de même généré pour inspection.

6. Présenter le livrable

Présenter le .zip à l'utilisateur avec present_files, accompagné d'un résumé court du rapport de contrôle (capital, intérêts, assurance, nb d'échéances, statut). Rappeler que l'import se fait dans MyUnisoft via la fonction d'import des emprunts du dossier concerné.

Notes

• Plusieurs emprunts dans un même ZIP : ajouter d'autres objets dans emprunts (avec des num distincts) + les échéances correspondantes.
• Ne jamais introduire de ; dans un champ texte (Motif, Organisme) — le script les neutralise, mais privilégier des libellés propres.
• En cas de différé d'amortissement, les premières échéances ont rbt_capital = 0 : c'est normal, mais le contrôle de durée peut alerter → vérification manuelle.