create_balance
ChatGPTCrée une nouvelle écriture comptable, soit sur un locataire (paiement reçu, appel manuel…), soit sur un bien (charge, taxe foncière, assurance, travaux, crédit…), soit sur un profil bailleur (virement du mandataire au bailleur, type 'paiement_bailleur'). Fournir exactement UN des trois paramètres tenant_id, property_id ou profile_id. Avant d'appeler, utiliser get_balance_types pour connaître les type valides et leur domaine (locataire, bien ou profil bailleur). À utiliser pour : 'enregistre un paiement de X€', 'ajoute une charge sur le bien Y', 'note la taxe foncière', 'enregistre des travaux', 'enregistre le virement au bailleur'. Pour créer plusieurs écritures d'un coup, préférer create_balances.
create_balances
ChatGPTCrée plusieurs écritures comptables en un seul appel (bulk create de la compta) : mêmes règles que create_balance, appliquées à une liste de nouvelles écritures (chaque ligne cible un locataire, un bien ou un profil bailleur). Tout ou rien : si une seule ligne est invalide, aucune écriture n'est créée. À utiliser pour : 'enregistre ces 6 paiements', 'saisis les charges de l'année', 'importe cette liste d'écritures'.
create_edl_room
ChatGPTCrée une nouvelle pièce d'état des lieux (EDL d'entrée ou de sortie) sur un bien, avec ses éléments (sols, murs, équipements, mobilier…), leur état et d'éventuels sous-éléments. Idéal pour retranscrire un état des lieux fourni en texte libre ou en PDF : appeler cet outil une fois par pièce. État : 1=Neuf, 2=Bon état, 3=État d'usage, 4=Mauvais état. À utiliser pour : 'ajoute une pièce WC à l'état des lieux', 'crée l'état des lieux du bien depuis ce texte'.
create_folder
ChatGPTCrée un dossier pour regrouper des biens (ex: un immeuble détenu, un portefeuille par ville). Un dossier peut être rangé dans un autre dossier via parent_folder_id. Pour créer un immeuble AVEC ses appartements d'un coup, utiliser plutôt create_property avec is_immeuble=true. À utiliser pour : 'crée un dossier Immeuble rue Foch', 'regroupe mes biens de Nantes'.
create_profile
ChatGPTCrée un nouveau profil bailleur : l'entité juridique (personne physique, SCI, société) qui possède des biens en location. À utiliser pour : 'crée un profil pour ma SCI Dupont', 'ajoute un bailleur', 'crée mon profil bailleur'. Les signataires sont les personnes qui signent les baux au nom du profil.
create_property
ChatGPTCrée un bien immobilier. Trois formes : bien simple (défaut) ; colocation à baux individuels (nb_rooms = nombre de chambres → crée un dossier + une chambre par colocataire) ; immeuble entier (is_immeuble = true + liste appartements → crée un dossier + un bien par appartement). loyer_hc, charges et deposit sont requis sauf pour un immeuble (ils se donnent alors par appartement). Si des informations recommandées manquent (surface, chauffage, équipements…), l'outil renvoie une erreur listant les champs : les demander à l'utilisateur, ne pas les inventer, et ne passer allow_incomplete: true que s'il confirme vouloir créer sans. À utiliser pour : 'ajoute un T2 à Vannes', 'crée une coloc de 4 chambres', 'crée mon immeuble de 6 appartements'.
create_tenant
ChatGPTCrée un locataire (= un bail) sur un bien : occupants (et garants éventuels), dates et conditions financières. type_bail (nu, meuble, etudiant, mobilite…) est obligatoire pour un bien d'habitation. Par défaut, AUCUN contrat de bail n'est généré — passer generate_bail=true pour générer le PDF du bail (et l'envoyer selon envoi_bail). generate_initial_balance crée les appels de loyer depuis la date d'entrée ; avec generate_payments, les loyers passés sont aussi marqués payés. Si des informations recommandées manquent (dépôt de garantie, jour d'appel, date de signature, indice IRL, email des locataires), l'outil renvoie une erreur listant les champs : les demander à l'utilisateur, ne pas les inventer, et ne passer allow_incomplete: true que s'il confirme vouloir créer sans. À utiliser pour : 'ajoute un locataire dans le T2', 'crée le bail de M. Martin au 1er septembre', 'enregistre mes locataires actuels'.
delete_balance
ChatGPTSupprime une écriture comptable. Les écritures auto-générées (avec correlation_id) ne peuvent pas être supprimées. Une écriture déjà comptabilisée dans une période clôturée n'est jamais effacée : une contrepassation datée du jour est créée à la place et renvoyée dans contrepassation. À utiliser pour : 'efface ce paiement', 'supprime l'écriture du 12 mars'.
generate_avis_echeance
ChatGPTGénère un avis d'échéance (= appel de loyer : demande de paiement du loyer et des charges pour la prochaine période) pour un locataire, en PDF. À utiliser pour : 'envoie un appel de loyer à X', 'génère l'avis d'échéance', 'demande le paiement du loyer', 'préviens X que le loyer arrive'.
generate_quittances
ChatGPTGénère automatiquement toutes les quittances de loyer manquantes pour un locataire (basé sur les paiements déjà enregistrés et la période de bail) — la quittance est le justificatif de paiement du loyer et des charges que le bailleur remet gratuitement au locataire qui en fait la demande (loi du 6 juillet 1989). Retourne la liste des PDFs générés. À utiliser quand l'utilisateur demande : 'génère mes quittances', 'envoie la quittance à X', 'quittance de loyer du mois', 'créer les quittances manquantes'.
get_balance_types
ChatGPTListe tous les types d'écritures comptables disponibles dans Qalimo avec leur libellé et leur domaine : 'locataire' pour les types à utiliser avec tenant_id (paiement, appel_loyer, appel_dg…), 'bien' pour les types à utiliser avec property_id (impots_tf, assurance_pno, reparation…). Les types avec creation: false ne sont pas créables manuellement. À appeler avant create_balance pour connaître les valeurs valides du paramètre type.
get_property
ChatGPTRécupère le détail complet d'un bien immobilier locatif : adresse complète, surface, type de logement, loyer, charges, DPE, etc. Préférer cet outil à list_properties quand l'utilisateur s'intéresse à UN bien précis (fiche du logement, caractéristiques de la location).
get_tenant
ChatGPTRécupère le détail d'un locataire et de son bail : dates de début et de fin de bail, loyer, charges, dépôt de garantie (caution), occupants, garants, etc. À utiliser quand l'utilisateur s'intéresse à UN locataire ou UNE location en particulier.
get_tenant_balance
ChatGPTCalcule le solde financier d'un locataire à aujourd'hui. Retourne total_appele (loyers et charges appelés), total_paye (paiements reçus du locataire), solde (négatif = le locataire doit de l'argent, positif = en sa faveur) et depot_garantie_solde (solde du dépôt de garantie). À utiliser pour : 'combien me doit X', 'solde de mon locataire', 'a-t-il payé son loyer', 'impayés ou arriérés de loyer', 'situation comptable de X'.
list_balances
ChatGPTListe les écritures financières comptables — côté locataire (appels de loyer, paiements reçus, dépôts de garantie…) ET côté bien (charges, taxes, assurances, travaux, crédits) — triées par date décroissante. À utiliser pour : 'historique de paiement', 'écritures comptables', 'mes loyers encaissés', 'les charges de mon appartement', 'détail des dépenses', 'comptabilité de ma gestion locative'.
list_banks
ChatGPTListe les comptes bancaires connectés au bailleur, avec leur solde et dernière mise à jour. À utiliser pour : 'mes banques', 'mes comptes', 'solde de mes comptes bancaires'.
list_edl_rooms
ChatGPTListe les pièces d'état des lieux (EDL, état des lieux d'entrée ou de sortie du logement) d'un bien, avec pour chaque pièce ses éléments (bâti, équipements, mobilier), leur état et leurs sous-éléments. À utiliser AVANT de créer ou modifier une pièce, pour connaître les pièces existantes et récupérer leur id. À utiliser pour : 'les pièces de l'état des lieux du bien X', 'montre l'EDL du bien'.
list_files
ChatGPTListe les documents de gestion locative (contrats de bail, quittances de loyer, avis d'échéance, états des lieux, etc.) triés par date d'ajout décroissante. Retourne uniquement les métadonnées (nom, type, taille) — pas les blobs. À utiliser pour : 'mes documents', 'mes quittances', 'mes baux', 'documents du locataire X'.
list_folders
ChatGPTListe les dossiers de biens (immeubles, colocations, regroupements libres) avec leur hiérarchie (id_parent). Un dossier regroupe des biens et/ou d'autres dossiers. À utiliser pour : 'mes immeubles', 'mes dossiers', ou avant create_property/create_folder pour connaître les ids de dossiers existants.
list_profiles
ChatGPTListe tous les profils bailleurs accessibles. Un profil bailleur représente une entité juridique propriétaire de biens en location (personne physique, SCI, société, indivision) au sens de la gestion locative. À utiliser quand l'utilisateur demande : 'mes profils', 'mes SCI', 'mes sociétés', 'liste mes bailleurs', 'au nom de qui sont mes locations'.
list_properties
ChatGPTListe les biens immobiliers mis en location : appartements, maisons, studios, colocations, locaux commerciaux, garages/parkings. Retourne les champs essentiels (nom, adresse, loyer) — utiliser get_property pour les détails complets d'un bien. À utiliser pour : 'liste mes biens', 'mes appartements', 'mes logements en location', 'combien de biens je gère', 'mon parc locatif'.
list_tenants
ChatGPTListe les locataires actifs et passés. Un 'tenant' représente un bail signé (location nue, meublée, colocation…) sur un bien. Retourne les champs essentiels (nom, bien occupé, dates de bail). Utiliser get_tenant pour le détail. À utiliser pour : 'mes locataires', 'qui loue chez moi', 'liste des baux', 'mes locations en cours', 'contrats de location actifs'.
list_transactions
ChatGPTListe les transactions bancaires importées depuis les comptes connectés (Nordigen/Linxo), triées par date décroissante. Une transaction peut être 'liée' (rapprochée à une ou plusieurs écritures) ou 'non liée'. À utiliser pour : 'mes transactions bancaires', 'paiements reçus sur mon compte', 'transactions non rapprochées', 'rapprochement bancaire', 'mouvements bancaires'.
update_balance
ChatGPTModifie une écriture comptable existante (montant, date, commentaire). Les écritures auto-générées (avec correlation_id) ne peuvent pas être modifiées — utiliser generate_quittances pour les régénérer. Une écriture comptabilisée dans une période clôturée n'est jamais modifiée en place : une contrepassation est créée et une écriture corrigée datée du jour la remplace (toutes deux renvoyées dans la réponse ; un changement de date est alors sans effet, la correction est datée du jour). Pour modifier plusieurs écritures d'un coup, préférer update_balances.
update_balances
ChatGPTModifie plusieurs écritures comptables en un seul appel (bulk update de la compta) : mêmes règles que update_balance, appliquées à une liste d'écritures. Tout ou rien : si une seule écriture est introuvable ou non modifiable (auto-générée avec correlation_id, déjà contrepassée), aucune modification n'est appliquée. Une écriture comptabilisée dans une période clôturée est corrigée par contrepassation + écriture de remplacement datée du jour (renvoyées dans la réponse). À utiliser pour : 'corrige la date de ces paiements', 'passe ces trois loyers à 650€', 'ajoute un commentaire sur toutes ces écritures'.
update_edl_room
ChatGPTMet à jour une pièce d'état des lieux (EDL) existante. Fournir room_id (cf. list_edl_rooms). Champs modifiables dans room : nom, commentaire, is_shared et elements. ⚠️ Si elements est fourni, il REMPLACE l'intégralité des éléments de la pièce ; pour ne changer que le nom ou le commentaire, ne PAS inclure elements. État : 1=Neuf, 2=Bon état, 3=État d'usage, 4=Mauvais état. À utiliser pour : 'renomme la pièce', 'corrige l'état du sol'.
update_folder
ChatGPTModifie un dossier de biens existant (nom, adresse, date/prix d'achat, dossier parent). Fournir uniquement les champs à changer. À utiliser pour : 'renomme le dossier X', 'déplace le dossier X dans Y'.
update_profile
ChatGPTModifie un profil bailleur existant (nom, SIRET, IBAN, régime fiscal…). Fournir uniquement les champs à changer. À utiliser pour : 'change l'IBAN de ma SCI', 'corrige le SIRET du profil X'.
update_property
ChatGPTModifie un bien existant : nom, adresse, loyer, charges, dépôt de garantie, surface, date/prix d'achat… Fournir uniquement les champs à changer. Ne modifie PAS les baux en cours (utiliser update_tenant pour changer le loyer d'un bail actif). À utiliser pour : 'passe le loyer du T2 à 650€', 'corrige l'adresse du bien X'.
update_tenant
ChatGPTModifie un bail existant : dates, loyer, charges, dépôt de garantie, jour d'appel, préavis. Fournir uniquement les champs à changer. Pour un départ, passer preavis=true et fin=date de départ (crée le processus de départ). Le loyer modifié est reporté sur le bien. À utiliser pour : 'passe le loyer de M. Martin à 700€', 'M. Martin a posé son préavis pour le 31 octobre'.
