Passer au contenu principal
POST
Créer une option

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

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.

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

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

Corps

application/json
name
string
requis

Nom affiché au client.

Required string length: 1 - 100
kind
enum<string>
requis

STANDARD : option vendue à la quantité. ADDITIONAL_DRIVER : conducteur additionnel, réservable par une clé interne seulement. YOUNG_DRIVER : supplément jeune conducteur, appliqué par Lexio d’après l’âge des conducteurs, jamais demandé directement. Une seule option de chacun de ces deux derniers types par organisation.

Options disponibles:
STANDARD,
ADDITIONAL_DRIVER,
YOUNG_DRIVER
group
enum<string>
requis

Rubrique d’affichage de l’option.

Options disponibles:
COMFORT,
PROTECTION,
ACCESSORIES,
DELIVERY,
SERVICES,
OTHER
price
object
requis

Prix HT de l’option et son plafond.

description
string | null

Description libre ; null si absente.

Maximum string length: 500
maxQuantity
integer

Exemplaires au plus par location, pour une option STANDARD. Une option conducteur vaut toujours 1 ici et ne le fixe pas (400 not_applicable) : le conducteur additionnel se réserve jusqu’à 4 fois, borne lue dans choices.options[].maxBookableQuantity du devis.

Plage requise: 1 <= x <= 100
stockCount
integer

Exemplaires louables en même temps, toutes locations confondues ; ignoré pour une option conducteur. Le reste disponible sur une période se lit dans maxBookableQuantity du devis.

Plage requise: 1 <= x <= 1000
availableMonths
integer[]

Mois où l’option se vend (1 = janvier), chacun une fois : elle est proposée si la location touche l’un d’eux ; [] : toute l’année.

Maximum array length: 12
Plage requise: 1 <= x <= 12
youngDriverAgeThreshold
integer | null

Âge au départ en dessous duquel le supplément s’applique à un conducteur. Requis pour une option YOUNG_DRIVER (sinon 400 required) ; null pour les autres types, qui le refusent (400 not_applicable).

Plage requise: 16 <= x <= 99
isActive
boolean

false : option retirée de la vente.

displayOrder
integer

Rang d’affichage ; ordre de la liste.

Plage requise: 0 <= x <= 2147483647

Réponse

Créer une option

data
object
requis
Exemple: