> ## Documentation Index
> Fetch the complete documentation index at: https://docs.lexio.rent/llms.txt
> Use this file to discover all available pages before exploring further.

# Ce qui se gère dans Lexio

Principe : tout ce qui bloque une opération de l’API se lit par l’API (la cause figure dans l’erreur et la ressource est consultable). Certaines décisions restent au loueur, dans l’application Lexio.

## Décisions du loueur

| Sujet | Ce qui bloque | Lecture par l’API | Pourquoi dans Lexio |
| - | - | - | - |
| Restitution ou retenue de caution | — | lignes `DEPOSIT` de `GET /rentals/{rentalId}/payments` ; `effects.cancellation.depositsHeld` à l’annulation | décision d’argent du loueur après le retour |
| Remboursement d’un paiement Stripe | `PAYMENT_PROVIDER_MANAGED` à la suppression du paiement | `balance` de la location | se fait chez Stripe ; Lexio l’enregistre à réception de l’événement Stripe |
| Trop-perçu d’une clé partenaire | `409 OVERPAYMENT_RESOLUTION_REQUIRED` avec `resolvableByKey: false` | `balance` de la location | décision d’argent du loueur |
| Blocages de planning | `VEHICLE_UNAVAILABLE` (raison `BLOCKED`) | `GET /vehicle-blocks` | outil de planning du loueur ; supprimer un entretien (`DELETE /maintenance-records/{maintenanceRecordId}`) supprime son blocage |
| Contrôle technique | `VEHICLE_UNAVAILABLE` (raison `MAINTENANCE_OVERDUE`) | `GET /vehicles/{vehicleId}/maintenance-alerts` | suivi réglementaire, absent de `/maintenance-records` (`404`) ; l’échéance reste visible dans les alertes |
| Réinitialisation du suivi d’entretien | `MAINTENANCE_TRACKING_ALREADY_STARTED` | `maintenanceTrackingMode` du véhicule | réécrit les points de départ de toutes les échéances |
| Blocage d’un client | `409 CUSTOMER_BLOCKED` (`BOOKING_REFUSED` pour une clé partenaire) | `isBlocked` de la fiche client | décision du loueur ; son motif reste interne |
| Émission d’un avoir (fiche entreprise du loueur, avoir en brouillon…) | `409 CREDIT_NOTE_NOT_ISSUABLE` à l’annulation ou au remboursement | cause dans `detail` | facturation et informations légales du loueur |
| Lieux gérés | `422 REFERENCE_INACTIVE` sur un lieu désactivé | `GET /locations` | non bloquant : une adresse libre (`{ address }`) reste toujours possible |

## Lecture seule par l’API

Ces réglages se lisent par l’API et se modifient dans Lexio :

* les réglages tarifaires : activation des règles, week-end, courte durée ([`GET /pricing-settings`](https://docs.lexio.rent/api-reference/tarification/get-pricing-settings)) ;
* la création et la suppression des saisons : l’API règle leur `priceFactor` et le calendrier ;
* la création et la suppression des paliers de délai : l’API modifie les paliers existants.

## Calendrier des saisons

Le calendrier des saisons est un gabarit annuel, par mois et par jour, sans année : il s’applique à toutes les années. Une hausse ponctuelle ou une fête mobile (Pâques, par exemple) ne s’y représente pas. Faites-la gérer par le loueur dans Lexio, ou, avec une clé interne, ajoutez un frais libre (`charges`, type `SURCHARGE`) au devis ou à la location concernés. Ne modifiez pas le calendrier pour un cas ponctuel : il s’applique aussitôt à tous les canaux de vente du loueur.

## Langue

La documentation, les `title` et les `detail` des erreurs sont en français. Les valeurs lisibles par une machine (`code`, `errors[].code`, énumérations, `type`) ne dépendent pas de la langue ; il n’y a pas de négociation `Accept-Language`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.