Imágenes de coches para siniestros y presupuestos de seguros

Un formulario de cotización, un registro de póliza y una primera notificación de siniestro identifican el vehículo de la misma forma: por su VIN, escrito por un cliente o leído de un documento de matriculación. Todo lo que una persona ve después sobre el coche es texto: un año, una marca, un modelo y quizá una versión. Preguntar "¿es este su vehículo?" junto a una línea de texto invita a responder que sí a cualquier cosa.

Una imagen del modelo al que corresponde el VIN permite al cliente y al perito comprobar de un vistazo que el registro identifica el tipo de coche correcto. No puede mostrar qué coche concreto: un render es una ilustración de estudio de una marca, modelo y año del catálogo, y no representa ningún vehículo físico específico. Ese hecho condiciona toda la integración que sigue.

• Decodifique al dar de alta. El flujo de cotización o el sistema de pólizas decodifica el VIN una sola vez, sin coste, y guarda el id de vehículo del catálogo junto con la póliza. Los siniestros abiertos sobre esa póliza lo heredan.
• Una sola vista en todas partes. front-3-4, el ángulo principal, en un mismo recuadro en la pantalla de cotización, el panel de siniestros, el PDF de la cotización y el portal de pólizas, para que todas las pantallas muestren el modelo de la misma forma.
• URL firmadas, nunca la clave. Los navegadores y los generadores de PDF cargan URL sin clave que genera su servidor.
• Palabras para lo que una imagen no puede decir. La versión, el equipamiento opcional, el color registrado, los daños y el kilometraje se quedan en texto y fotos, y la imagen indica que es representativa.

GET /api/v1/vin/{vin} no cuesta nada y requiere una clave con images:read. Responde con los campos decodificados de los datos vPIC de la NHTSA (año, marca, modelo, acabado, serie, tipo de carrocería, motor y cualquier otro atributo que conozca vPIC) y, cuando el catálogo tiene el vehículo, un objeto vehicle con su id estable y un image_path listo para usar.

Lea el trim: "Carrera, Carrera T, Carrera 4". El patrón de este VIN abarca tres versiones, así que ni siquiera la decodificación puede decir cuál asegura la póliza, y mucho menos un render del 911 de 2024. Pida al cliente que confirme la versión, guárdela como texto junto con series y body_class, y deje que la imagen muestre el modelo.

• Un VIN con un dígito de control incorrecto se decodifica igualmente, con valid: false y el problema en errors; suggested_vin marca con ! el carácter que vPIC considera erróneo, que es lo que debe mostrarse a la persona que lo escribe.
• Un formulario que solo tiene los primeros caracteres puede enviar un VIN parcial: al menos cinco caracteres, con * en cada posición desconocida y un year opcional.
• Un 404 significa que vPIC no tiene registro del patrón. vPIC cubre vehículos fabricados para el mercado estadounidense, así que, para otros mercados, parta de la marca y el modelo con POST /api/v1/images/resolve, que también es gratuito.

Guarde data.vehicle.id en la póliza como una cadena simple y cópielo en cada siniestro abierto contra ella. El id es determinista y permanente: el mismo vehículo tiene el mismo id en cada despliegue y tras cada versión del catálogo, por lo que es seguro como clave foránea, y cada solicitud posterior indica vehicle=veh_78qtwrgh37bkr en lugar de escribir una marca y un modelo.

Cuando data.vehicle es null, la marca y el modelo decodificados no están en el catálogo, como ocurre con los remolques y algunos chasis comerciales. Puede seguir mostrando los campos decodificados. Muéstrelos sin imagen y nunca ponga un coche similar en su lugar.

La pantalla de cotización, el panel de siniestros y el portal de pólizas son aplicaciones de navegador, así que su servidor emite URL firmadas con POST /api/v1/image-urls: 1 crédito por URL cuando se emite, hasta 50 por llamada, y gratis de cargar hasta que caduca. Encuadre la imagen una vez y reutilice la forma: front-3-4 en un recuadro de 640×400 con fit: "contain", y trim con un poco de padding para que un cupé y una pickup llenen el recuadro de la misma manera. Cuánto debe durar cada URL depende de dónde se muestre:

• El panel de siniestros. Emita la URL cuando se dibuje la pantalla. La vigencia predeterminada de 1 hora cubre una sesión de trabajo, y un siniestro que se reabra mañana recibe una URL nueva.
• El PDF de la cotización. Cuando el PDF se genera a partir de HTML, el renderizador carga la imagen una vez y la incrusta, así que la vigencia predeterminada es más que suficiente, y el servicio de PDF nunca tiene acceso a su clave. format: "jpg" aplana la imagen sobre fondo blanco, que es lo que necesita un documento.
• El portal de pólizas y el email de renovación. Estos duran más que cualquier vida útil, así que genere la URL con renew: true y ttl_seconds: 604800 (7 días). La URL sigue funcionando, cada semana adicional en la que se abre cuesta 1 crédito, y renew_days: 365, el máximo permitido, cubre una póliza de un año.

Asigne a la clave que emite las URL una lista de orígenes permitidos en el panel: una URL cargada desde otro sitio responde 403 con origin_not_allowed, mientras que los clientes de correo y los visores de PDF, que no envían Referer, la siguen cargando. Revocar la clave invalida todas las URL que emitió.

Coloque la etiqueta donde está la imagen, no solo en una nota al pie: en el texto alternativo y en un pie de foto bajo la imagen. El render muestra la marca, el modelo y el año en la pintura que usted elija, y color puede seguir el color que figura en la póliza (un nombre predefinido o cualquier hex). Sigue siendo el modelo en esa pintura, no el coche del cliente.

• Gratis: la decodificación de VIN, resolve, las consultas al catálogo y cada carga de una URL firmada dentro de su duración.
• 1 crédito: cada imagen entregada a su servidor o cada URL emitida, y cada semana adicional en que se abre una URL renovable.
• Vehículos distintos: un embudo de cotización ve muchos vehículos diferentes, y cada plan limita los vehículos distintos al mes: Free 100, Pro 2500 y Business 15.000; Enterprise: sin límite. Un vehículo ya servido este mes siempre está permitido, y una solicitud que supere el límite se rechaza antes de cobrar nada, así que elija el plan según los vehículos que cotiza, no según los créditos.

En un plan de pago, la licencia cubre un render dentro de lo que su producto genera para sus usuarios, incluidas cotizaciones o informes, mientras el plan esté activo; los detalles están en la licencia.

• SDK: client.decodeVin(vin, { year? }) y client.createImageUrls(…), como arriba; client.resolve(query) para un vehículo sin VIN.
• MCP: decode_vin y create_car_image_urls forman parte del conjunto de herramientas principal, así que un asistente con el siniestro en contexto puede responder a "muéstrame el modelo asegurado" a partir del VIN registrado. La configuración está en la página de MCP.