Images de voitures pour les sinistres et devis d’assurance

Un formulaire de devis, un contrat d'assurance et une déclaration de sinistre désignent tous le véhicule de la même manière : par son VIN, saisi par le client ou lu sur le certificat d'immatriculation. Tout ce qu'une personne voit ensuite de la voiture est du texte : une année, une marque, un modèle et éventuellement une finition. Demander « Est-ce votre véhicule ? » à côté d'une ligne de texte, c'est s'exposer à un oui pour n'importe quoi.

Une image du modèle correspondant au VIN décodé permet au client et à l’expert de vérifier d’un coup d’œil que le dossier désigne le bon type de voiture. Elle ne peut pas montrer de quelle voiture il s’agit : un rendu est une illustration studio d’une marque, d’un modèle et d’une année du catalogue, et il ne représente aucun véhicule physique précis. Ce seul fait détermine toute l’intégration décrite ci-dessous.

• Décoder à la souscription. Le parcours de devis ou le système de gestion des contrats décode le VIN une seule fois, gratuitement, et enregistre l’identifiant de véhicule du catalogue avec le contrat. Les sinistres ouverts sur ce contrat en héritent.
• Une seule vue partout. front-3-4, l’angle principal, dans un même cadre sur l’écran de devis, le poste de gestion des sinistres, le devis PDF et le portail assuré, pour que chaque écran présente le modèle de la même façon.
• Des URL signées, jamais la clé. Les navigateurs et les moteurs de rendu PDF chargent des URL sans clé générées par votre serveur.
• Des mots pour ce qu’une image ne peut pas dire. Finition, options, couleur enregistrée, dommages et kilométrage restent du texte et des photos, et l’image indique qu’elle est représentative.

GET /api/v1/vin/{vin} est gratuit et nécessite une clé avec images:read. Il renvoie les champs décodés des données vPIC de la NHTSA (année, marque, modèle, finition, série, type de carrosserie, moteur et tous les autres attributs connus de vPIC) et, lorsque le catalogue contient le véhicule, un objet vehicle avec son identifiant stable et un image_path prêt à l’emploi.

Lisez le champ trim : « Carrera, Carrera T, Carrera 4 ». Le schéma de ce VIN couvre trois finitions : même le décodage ne peut donc pas dire laquelle le contrat assure, et un rendu de la 911 2024 encore moins. Demandez au client de confirmer la finition, conservez-la sous forme de texte avec series et body_class, et laissez l’image montrer le modèle.

• Un VIN avec un chiffre de contrôle erroné est tout de même décodé, avec valid: false et le problème dans errors ; suggested_vin marque d’un ! le caractère que vPIC estime erroné, et c’est ce qu’il faut montrer à la personne qui saisit le numéro.
• Un formulaire qui ne dispose que des premiers caractères peut envoyer un VIN partiel : au moins cinq caractères, avec * pour chaque position inconnue, et un year facultatif.
• Une réponse 404 signifie que vPIC n’a aucune trace de ce motif. vPIC couvre les véhicules fabriqués pour le marché américain ; pour les autres marchés, partez donc de la marque et du modèle avec POST /api/v1/images/resolve, qui est également gratuit.

Stockez data.vehicle.id sur le contrat sous forme de simple chaîne et copiez-le dans chaque sinistre ouvert au titre de ce contrat. L’id est déterministe et permanent : le même véhicule a le même id à chaque déploiement et après chaque version du catalogue, il peut donc servir de clé étrangère, et chaque requête ultérieure indique vehicle=veh_78qtwrgh37bkr au lieu d’épeler une marque et un modèle.

Lorsque data.vehicle vaut null, la marque et le modèle décodés ne figurent pas dans le catalogue, comme pour les remorques et certains châssis utilitaires. Vous pouvez tout de même afficher les champs décodés. Affichez-les sans image, et ne mettez jamais une voiture similaire à sa place.

L’écran de devis, le poste de gestion des sinistres et le portail des contrats sont des applications web, donc votre serveur génère des URL signées avec POST /api/v1/image-urls : 1 crédit par URL au moment de sa génération, jusqu’à 50 par appel, puis chargement gratuit jusqu’à expiration. Cadrez l’image une fois et réutilisez ce format : front-3-4 dans un cadre de 640×400 avec fit: "contain", et trim avec un peu de padding pour qu’un coupé et un pick-up remplissent le cadre de la même manière. La durée de vie de chaque URL dépend de l’endroit où elle s’affiche :

• Le poste de gestion des sinistres. Générez l’URL au moment où l’écran s’affiche. La durée de vie par défaut de 1 heure couvre une session de travail, et un sinistre rouvert le lendemain obtient une nouvelle URL.
• Le devis PDF. Lorsque le PDF est généré à partir de HTML, le moteur de rendu charge l’image une seule fois et l’intègre ; la durée de vie par défaut suffit donc largement, et le service PDF ne détient jamais votre clé. format: "jpg" aplatit l’image sur fond blanc, ce qui convient à un document.
• Le portail des contrats et l’e-mail de renouvellement. Ils durent plus longtemps que toute durée de validité : générez donc l’URL avec renew: true et ttl_seconds: 604800 (7 jours). L’URL continue de fonctionner, chaque semaine supplémentaire au cours de laquelle elle est ouverte coûte 1 crédit, et renew_days: 365, la valeur maximale autorisée, couvre un contrat d’un an.

Attribuez à la clé qui génère les URL une liste d’origines autorisées dans le tableau de bord : une URL chargée depuis un autre site renvoie 403 avec origin_not_allowed, tandis que les clients de messagerie et les lecteurs PDF, qui n’envoient pas d’en-tête Referer, la chargent quand même. Révoquer la clé invalide toutes les URL qu’elle a générées.

Placez la mention là où se trouve l’image, pas seulement dans une note de bas de page : dans le texte alternatif et dans une légende sous l’image. Le rendu montre la marque, le modèle et l’année dans la teinte de votre choix, et color peut reprendre la couleur indiquée sur le contrat (un nom prédéfini ou n’importe quel code hexadécimal). Il s’agit toujours du modèle dans cette teinte, pas de la voiture du client.

• Gratuit : le décodage du VIN, resolve, les recherches dans le catalogue et chaque chargement d’une URL signée pendant sa durée de validité.
• 1 crédit : chaque image livrée sur votre serveur ou chaque URL générée, ainsi que chaque semaine supplémentaire au cours de laquelle une URL renouvelable est ouverte.
• Véhicules distincts : un tunnel de devis voit passer de nombreux véhicules différents, et chaque forfait plafonne le nombre de véhicules distincts par mois : Free 100, Pro 2 500 et Business 15 000 ; aucun plafond pour Enterprise. Un véhicule déjà servi ce mois-ci est toujours autorisé, et une requête au-delà du plafond est refusée avant toute facturation : dimensionnez donc le forfait selon les véhicules pour lesquels vous établissez des devis, pas selon les crédits.

Avec un forfait payant, la licence couvre l’intégration d’un rendu dans ce que votre produit génère pour ses utilisateurs, devis ou rapport compris, tant que le forfait est actif ; les détails figurent dans la licence.

• SDK : client.decodeVin(vin, { year? }) et client.createImageUrls(…), comme ci-dessus ; client.resolve(query) pour un véhicule sans VIN.
• MCP : decode_vin et create_car_image_urls font partie des outils de base : un assistant qui a le sinistre en contexte peut donc répondre à « Montrez-moi le modèle assuré » à partir du VIN enregistré. La configuration se trouve sur la page MCP.