Modification
L'avenant polyvalent — corriger le souscripteur, modifier des véhicules, en ajouter ou en retirer, en une seule cotation.
| Code | MODIFICATION |
| Incidence | déduite du contenu : INCREASE, DECREASE ou NEUTRAL |
| Payant | oui (un lien n'est émis que si le montant est positif) |
| Différé | non |
| Statut requis | ACTIVE ou SUSPENDED |
| Actif | non au moment de la rédaction |
À quoi il sert
Regrouper dans un seul acte des changements de plusieurs natures : données du souscripteur, données d'un ou plusieurs véhicules, ajout de véhicules (au prorata), retrait de véhicules (ristourne). Le serveur calcule chaque composante, réédite les attestations touchées et produit un montant net.
Corps de cotation
{
"endorsementId": "<id du type MODIFICATION>",
"selectedReason": "Correction d'une erreur de saisie",
"effectiveDate": "2026-12-01 00:00:00",
"subscriberInfo": { "mobilePhone": "+2250700000099", "address": "Marcory, Abidjan" },
"vehiclesInfo": [
{ "vehicleId": "9e7258b6-…", "registrationNumber": "2547 ZR 64", "numberOfSeats": 7 }
],
"vehicleIds": ["a1b2c3d4-…"],
"removedVehicleIds": ["ffee1122-…"]
}Au moins un des cinq blocs est requis.
| Champ | Description |
|---|---|
selectedReason | Libellé du motif (GET /provider/reasons/type/MODIFICATION) |
effectiveDate | Date d'effet des changements (défaut : maintenant) |
subscriberId | Remplacer le souscripteur par un souscripteur existant |
subscriberInfo | Corriger les données du souscripteur actuel. Champs admis : civility, lastName, firstNames, birthDate, birthPlace, nationality, nationalIdNumber, drivingLicenseNumber, drivingLicenseDate, companyName, legalForm, rccmNumber, taxNumber, legalRepresentative, address, postalCode, landlinePhone, mobilePhone, phone, email |
vehiclesInfo[] | Liste de { vehicleId, …champs modifiés } pour des véhicules déjà au contrat |
vehicleIds[] | Véhicules à ajouter (identifiants existants), au prorata de la période restante |
removedVehicleIds[] | Véhicules à retirer, avec ristourne au prorata |
Champs modifiables d'un véhicule (vehiclesInfo)
| Groupe | Champs | Effet |
|---|---|---|
| Identifiants | registrationNumber, chassisNumber | Appliqués tels quels ; réédition de l'attestation |
| Référentiels | brandId, modelId, vehicleGenderId, energyId, usageId, zoneId, circulationCityId, vehicleCategoryId, vehicleTypeId | Résolus par identifiant ; marque, modèle et genre rééditent l'attestation |
| Caractéristiques | modelText, horsepower, engineDisplacementCc, numberOfSeats, emptyWeightTons, payloadTons, grossVehicleWeightTons, firstRegistrationDate, manufactureYear, newValue, marketValue, hasGps, hasTrailer, hasRoadTractor | numberOfSeats ne peut qu'augmenter et entraîne un complément de prime |
Réponse
ActionResponse : EndorsementPaymentLink si le montant net est positif ; sinon l'avenant est
appliqué (ristourne ou neutre). payload contient le plan complet (addedVehicleIds,
removedVehicleIds, vehicleUpdates, subscriberInfo…), vehicleChanges le détail par véhicule
avec le mode retenu (INCORPORATION_VEHICULES, RETRAIT_VEHICULES, CHANGEMENT_IMMATRICULATION,
MODIFICATION_PLACES, MODIFICATION_SIMPLE), changes le changement de souscripteur.
Règles et erreurs
detail | Cause |
|---|---|
| « Au moins un changement est requis : subscriberInfo, vehiclesInfo, subscriberId, vehicleIds ou removedVehicleIds » | Corps vide |
| « Champ du souscripteur non modifiable : X » | Clé hors liste dans subscriberInfo |
| « vehiclesInfo doit être une liste de {vehicleId, champs modifiés} » / « vehicleId requis pour chaque entrée » | Structure invalide |
| « Le véhicule X ne peut pas être à la fois modifié et ajouté ou retiré » | Même identifiant dans deux blocs |
| « Le véhicule X est déjà rattaché au contrat » | vehicleIds contient un véhicule déjà présent |
| « Le véhicule X est absent du contrat » | removedVehicleIds ou vehiclesInfo cite un véhicule étranger |
| « Impossible de retirer tous les véhicules : utiliser la résiliation » | removedVehicleIds vide le contrat |
| « Le nouveau numéro d'immatriculation est identique à l'actuel » | Pas de changement |
| « Le nombre de places du véhicule … ne peut pas être réduit (a → b) » | Diminution de places interdite |