tenants

Crée un bail sur un bien, avec ses occupants.

Pensé pour la retranscription d'un bail existant : pas de génération de PDF ni d'envoi en signature (flux applicatifs). Le modèle de bail est déduit du bien et de lease_type, sauf lease_template_id explicite. generate_initial_balance reconstruit les appels depuis le début du bail.

post/api/v1/tenants

Request

  • Base URL: https://api.qalimo.fr
  • URL: https://api.qalimo.fr/api/v1/tenants
  • Auth: HTTP bearer

Request body

property_idinteger required

Bien loué (accessible en écriture).

start_datestring date required

Date de début du bail.

rent_excluding_chargesnumber required

Loyer hors charges, hors complément.

chargesnumber required

Charges.

lease_type'lcd' | 'nu' | 'meuble' | 'commercial' | 'garage' | 'habitation' | 'mobilite' | 'professionnel' | 'etudiant' | 'commercial_derogatoire' | 'sous-location' | 'civil' | 'civil_habitation' | 'stockage' | 'parking'

Type de bail. Requis pour un bien d'habitation ; déduit pour un bien commercial ou garage.

lease_template_idinteger

Modèle de bail précis (sinon déduit du type et du bien).

end_datestring date

Date de fin du bail. Requise si contract_duration_months est absent, et toujours pour un bail mobilité ou de location courte durée.

contract_duration_monthsinteger

Durée du contrat en mois.

depositnumber

Dépôt de garantie (défaut : 0).

payment_dayinteger

Jour du mois auquel le loyer est dû (défaut : 1).

payment_recurrence_monthsinteger

Périodicité de l'échéance en mois (défaut : 1).

payment_periods_from_start_dateboolean

Vrai si les périodes trimestrielles, semestrielles ou annuelles sont calées sur le mois de début du bail plutôt que sur l'année civile (sans effet en mensuel). Défaut : false.

signature_datestring date

Date de signature du bail.

allow_non_compliantboolean

Retranscription d'un bail existant non conforme aux plafonds légaux (dépôt, durées) : désactive ces contrôles.

generate_initial_balanceboolean

Génère les appels de loyer depuis le début du bail (reconstruction d'historique).

generate_paymentsboolean

Avec generate_initial_balance : marque aussi les paiements correspondants.

Response

Created

idinteger required

Identifiant du bail.

namestring required

Libellé du bail.

occupantsstring required

Nom d'affichage des occupants.

property_idinteger required

Identifiant du bien loué.

start_datestring date required

Date de début du bail.

end_datestring date nullable

Date de fin du bail (null si non renseignée).

rent_excluding_chargesnumber nullable

Loyer hors charges, complément de loyer inclus.

status'active' | 'candidate' | 'archived' | 'archived_candidate' required

État du bail (actif, candidat, archivé, candidat archivé).

chargesnumber nullable

Charges.

additional_rentnumber nullable

Complément de loyer, déjà inclus dans rent_excluding_charges.

depositnumber nullable

Montant du dépôt de garantie.

payment_dayinteger nullable

Jour du mois auquel le loyer est dû.

payment_recurrence_monthsinteger nullable

Périodicité de l'échéance en mois (1 = mensuelle, 3 = trimestrielle…).

payment_periods_from_start_dateboolean

Vrai si les périodes trimestrielles, semestrielles ou annuelles sont calées sur le mois de début du bail plutôt que sur l'année civile (sans effet en mensuel).

payment_type'prelevement' | 'virement' | 'espece' | 'cheque' | 'null' nullable

Mode de paiement du loyer.

signature_datestring date nullable

Date de signature du bail.

contract_duration_monthsinteger nullable

Durée du contrat en mois.

lease_type'lcd' | 'nu' | 'meuble' | 'commercial' | 'garage' | 'habitation' | 'mobilite' | 'professionnel' | 'etudiant' | 'commercial_derogatoire' | 'sous-location' | 'civil' | 'civil_habitation' | 'stockage' | 'parking' | 'null' nullable

Type de bail.

charge_type'provision' | 'forfait' | 'null' nullable

Mode de facturation des charges.

vat_enabledboolean

Vrai si le loyer est soumis à TVA.

caf_amountnumber nullable

Montant de l'aide CAF versée directement.

last_rent_revision_datestring date nullable

Date de la dernière révision de loyer.

notice_givenboolean nullable

Vrai si le locataire a posé son préavis.

Changes

No recorded changes to this operation across all 1 revision of this API.