Incorporation de véhicules
Ajouter un ou plusieurs véhicules à une flotte assurée, au prorata de la période restante.
| Code | INCORPORATION_VEHICULES |
| Incidence | INCREASE : prime au prorata, par véhicule |
| Payant | non dans la version actuelle : l'avenant est appliqué dès la cotation, la prime calculée est portée sur l'avenant |
| Différé | non |
| Statut requis | ACTIVE |
| Actif | non au moment de la rédaction ; l'ajout de véhicules passe par l'avenant Modification (vehicleIds) |
À quoi il sert
Rattacher de nouveaux véhicules à un contrat flotte en cours, à partir d'une date d'incorporation, jusqu'à l'échéance du contrat.
Corps de cotation
{
"endorsementId": "<id du type INCORPORATION_VEHICULES>",
"periodStart": "2026-12-01 00:00:00",
"vehicleIds": ["a1b2c3d4-…", "b2c3d4e5-…"]
}| Champ | Obligatoire | Description |
|---|---|---|
periodStart | oui | Date d'incorporation, avant l'échéance du contrat |
vehicleIds | oui | Véhicules existants à ajouter (POST /provider/vehicles) |
Comportement
Le serveur vérifie que chaque véhicule n'est pas déjà couvert ailleurs sur la période, calcule la
prime de chaque véhicule au prorata (periodStart → échéance), puis applique l'incorporation : les
véhicules deviennent actifs au contrat, les attestations sont produites. vehiclesAdded est renseigné.
Règles et erreurs
detail / exception | Cause |
|---|---|
| « La date d'incorporation est postérieure à la date d'expiration du contrat. » | periodStart après l'échéance |
VEHICLE_NOT_FOUND « Véhicule introuvable: X » | Identifiant inconnu |
VEHICLE_ALREADY_INSURED | Véhicule couvert par un autre contrat sur la période |
INVALID_DURATION_CONFIGURATION « durationId required » | Contrat sans durée |