Synchroniser la flotte
Dites à Qasqad qui conduit quel véhicule, et depuis quand.
Une affectation dit qu'un conducteur a eu un véhicule pendant une période. Elle est identifiée par le triplet plaque + e-mail du conducteur + date de début. Toutes passent par POST /api/fleet.
{
"vehicleAssignments": [
{
"licencePlate": "AB-123-CD",
"startDate": "2025-02-17T00:00:00+01:00",
"driverEmail": "conducteur@entreprise.fr"
}
]
}Les règles
Créer ou mettre à jour
Un triplet inconnu crée une affectation ; un triplet déjà envoyé met la ligne à jour avec les autres champs.
Rien n'est supprimé
Une affectation absente de votre envoi reste en place. Vous pouvez n'envoyer que les changements.
Tout ou rien
Si une ligne est invalide, le lot entier est refusé et la première erreur rencontrée est renvoyée.
Plaques SIV
AB-123-CD, en majuscules, avec les tirets. Les plaques FNI et étrangères ne sont pas acceptées.
Clore, rouvrir
| Vous envoyez | Effet |
|---|---|
"endDate": "2025-03-17T00:00:00+01:00" | l'affectation est close à cette date |
"endDate": null | l'affectation est rouverte |
pas de clé endDate | la fin déjà enregistrée ne bouge pas |
Les dates sont des instants
Une date en Z est en UTC : 2025-02-17T00:00:00Z commence à 1 h du matin à Paris. Pour une affectation qui commence à minuit heure française, envoyez le décalage : 2025-02-17T00:00:00+01:00, et +02:00 l'été.
C'est la date de l'infraction qui désigne le conducteur. Une heure d'écart sur un changement de véhicule, et un FPS dressé à 0 h 30 part au conducteur précédent.
Sociétés d'un groupe
Si votre organisation regroupe plusieurs sociétés, companySiret dit laquelle détient le véhicule :
companySiret | Effet |
|---|---|
| un SIRET de votre groupe | le véhicule est rattaché à cette société |
"" ou null | le véhicule revient à l'organisation |
| absent | la société déjà enregistrée ne change pas |
Un SIRET qui n'appartient pas à votre organisation fait refuser le lot (statut 499).
Champs libres
driverName, driverFirstName, driverReference (votre matricule), deux e-mails en copie (additionalEmail1, additionalEmail2) et sept champs libres extraField1 à extraField7, repris dans vos exports. Tout champ inconnu fait refuser la requête. Le détail est dans la référence.