Leases

Bulk end-of-lease charge regularization

Perform bulk regularization for all charges at lease end.

This is an atomic operation that creates a review and updates all charge amounts in a single transaction. It compares provisional charges against actual expenses and settles the difference for each charge.

post/leases/{lease_id}/charges/finalize

Request

  • Base URL: https://api.faireplace.com/api
  • URL: https://api.faireplace.com/api/leases/{lease_id}/charges/finalize
  • Auth: HTTP bearer

Path parameters

lease_idstring uuid required

Lease ID

Request body

regularization_datestring date required

Date of the regularization, usually the lease end date.

statement_sent_datestring date nullable

Date the charge statement was sent to the tenant. Article 23 gives them 30 days' notice, counted from this date.

supporting_documentsobject nullable

Free-form JSON holding references to the supporting documents. The API stores it as-is and does not inspect it.

notesstring nullable

Notes about the bulk regularization.

Example request

{
  "regularization_date": "2025-12-31",
  "actual_amounts": [
    {
      "actual_amount": 150
    }
  ],
  "statement_sent_date": "2025-11-30"
}

Response

Bulk regularization performed successfully

idstring uuid required

Unique identifier of the charge

lease_idstring uuid required

Lease ID

service_place_idstring uuid nullable

Place service ID

category_idstring uuid nullable

Charge category ID

calculation_method'FORFAIT' | 'PROVISION' | 'DEPENSE_REELLE' | 'RELEVE_DIRECT' required

Charge billing mode to the tenant (provision/fixed/actual expense).

Compatibility rules:

  • CONSOMMATION_MESUREE (distribution) requires RELEVE_DIRECT or PROVISION
  • FORFAIT requires FORFAIT as calculation basis
  • DEPENSE_REELLE requires DEPENSE_REELLE or a staff basis as calculation basis
  • PROVISION can be used with all calculation bases
  • The mode must be allowed for the lease type (allow_provisional, allow_fixed)
calculation_basis'DEPENSE_REELLE' | 'FORFAIT' | 'PERSONNEL_75_POURCENT' | 'PERSONNEL_40_POURCENT' | 'PERSONNEL_100_POURCENT' required

Base de calcul d'une charge récupérable (art. 23-1).

Les trois valeurs PERSONNEL_… s'écrivent avec un underscore après PERSONNEL, exactement comme en base: c'est la même orthographe partout.

amountnumber required

Charge amount

billing_period_startstring date nullable

Billing period start date

billing_period_endstring date nullable

Billing period end date

last_regularization_datestring date nullable

Last regularization date

distribution_key_idstring uuid nullable

Distribution key ID

notesstring nullable

Notes about the charge

created_atstring date-time required

Creation date

updated_atstring date-time required

Last modification date

Example response

[
  {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "lease_id": "550e8400-e29b-41d4-a716-446655440001",
    "calculation_method": "PROVISION",
    "calculation_basis": "FORFAIT",
    "amount": 150
  }
]

Changes

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