Passer au contenu principal
POST
Retour du véhicule

Autorisations

Authorization
string
header
requis

Clé API lck_… créée dans Lexio (Paramètres → Développeur), envoyée en Authorization: Bearer. Voir Authentification.

En-têtes

Idempotency-Key
string
requis

Clé unique de l’opération, réutilisée à chaque nouvel essai : un rejeu avec la même clé et le même corps renvoie la réponse initiale sans rien réécrire. Voir Idempotence. Facultative avec ?dryRun=true sur les opérations qui l’acceptent.

Required string length: 1 - 255
Pattern: ^[\x20-\x7E]+$
Exemple:

"8b3e1d2c-4a5f-4c6b-9e7d-1f2a3b4c5d6e"

Paramètres de chemin

rentalId
string<uuid>
requis

Identifiant de la location.

Exemple:

"9c2d7e4a-5b1f-4d3c-8a6e-0f1b2c3d4e5f"

Paramètres de requête

dryRun
enum<string>

true : aperçu. Mêmes contrôles, même calcul (frais, dépassement, facture) et même réponse que le retour réel, puis rien n’est écrit.

Options disponibles:
true,
false

Corps

application/json
inspection
object
requis
signature
string

Exactement un de signature et signatureWaived.

Maximum string length: 500000
Pattern: ^data:image\/png;base64,[A-Za-z0-9+/]+={0,2}$
signatureWaived
object

Retour sans le client (boîte à clés…), à la place de signature.

actualEndAt
string

Instant RFC 3339 AVEC décalage (sans → 400 offset_required). Défaut : maintenant. Borné à [actualStartAt ; maintenant + 5 min], sinon 400 out_of_range.

Exemple:

"2026-11-10T10:00:00+01:00"

charges
object[]

Frais constatés au retour, appliqués dans l’ordre de la requête.

Maximum array length: 50
payments
object[]

Encaissements (PAYMENT, scope payments.write) et remboursements (REFUND, scope payments.refund) du retour, rattachés à son état des lieux. paidAt omis = actualEndAt. Contrôlés sur le total après frais et dépassement : Σ PAYMENT au-delà du reste dû (prélèvements SEPA en cours déduits) → 422 PAYMENT_EXCEEDS_DUE ; Σ REFUND au-delà du trop-perçu → 422 REFUND_EXCEEDS_PAID. DEPOSIT ou STRIPE → 400 not_applicable : un encaissement Stripe passe par POST /rentals/{rentalId}/payments, un remboursement Stripe se fait chez Stripe et Lexio l’enregistre à réception de l’événement Stripe, sauf saisie manuelle préalable par l’équipe du loueur.

Maximum array length: 20

Encaissement.

expectedTotalTTC
number

Ancrage facultatif sur le total TTC après frais et dépassement (celui de l’aperçu dryRun). Écart d’une unité mineure → 409 PRICE_CHANGED.

Réponse

Retour du véhicule

data
object
requis

Location, dans la même représentation pour la lecture, la liste et chaque écriture. Montants dans currency, voir Montants et TVA.

Exemple:
effects
object
requis