{"ramo":"coche","insurance_line":"Car","mensaje_para_el_cliente":"Para darte precios de varias aseguradoras necesito esto (mándamelo todo de una vez):\n\nEl coche:\n- Matrícula del coche.\n- Marca, modelo y versión exacta. (sólo si aún no tiene matrícula, o la respuesta dice que la matrícula corresponde a varias versiones)\n- Fecha de primera matriculación. (sólo si no hay matrícula o no identifica un solo coche)\n- ¿Cómo tiene el coche? [Ya lo tiene (no lo acaba de comprar) / Lo acaba de comprar nuevo / Lo acaba de comprar de segunda mano o km 0, en un concesionario / Lo acaba de comprar de segunda mano, a un particular / Aún no lo ha comprado]\n- Fecha de compra. (sólo si ya lo ha comprado (no se envía si aún no lo ha comprado))\n- Uso del coche. [Particular / Profesional (para trabajar) / Servicio público (taxi, VTC…)]\n- Kilómetros al año, aproximadamente. [Hasta 5.000 / Hasta 10.000 / Hasta 15.000 / Hasta 20.000 / Hasta 25.000 / Hasta 30.000 / Más de 30.000]\n- ¿Dónde duerme el coche? [Garaje privado (propio o alquilado, cerrado) / Garaje o aparcamiento comunitario / En la calle]\n- ¿El propietario del coche es el titular del seguro? [Sí / No, es otra persona]\n\nPropietario del coche (sólo si el propietario NO es el titular del seguro):\n- Nombre y apellidos del propietario.\n- Tipo y número de documento del propietario. [DNI / NIE / Pasaporte]\n- Nacionalidad del propietario. (sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta))\n- Fecha de nacimiento del propietario.\n- Sexo del propietario. [Hombre / Mujer]\n- Estado civil del propietario. [Soltero/a / Casado/a / Pareja de hecho / Divorciado/a / Viudo/a]\n\nConductor habitual:\n- ¿El conductor habitual es el titular del seguro? [Sí / No, es otra persona]\n- Nombre y apellidos del conductor habitual. (sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos))\n- Tipo y número de documento del conductor habitual. [DNI / NIE / Pasaporte] (sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos))\n- Nacionalidad del conductor habitual. (sólo si el conductor NO es el titular y el documento es NIE o pasaporte (con DNI es española y no se pregunta))\n- Fecha de nacimiento del conductor habitual. (sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos))\n- Sexo del conductor habitual. [Hombre / Mujer] (sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos))\n- Estado civil del conductor habitual. [Soltero/a / Casado/a / Pareja de hecho / Divorciado/a / Viudo/a] (sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos))\n- Tipo de carnet del conductor, fecha en que lo sacó y si lo sacó en España. [B (turismo) / C1 / C]\n- ¿Tiene o ha tenido un seguro de coche a su nombre? [Sí / No]\n- Compañía, número de póliza y matrícula del vehículo asegurado en esa póliza. (sólo si tiene o ha tenido un seguro de coche a su nombre)\n- Años asegurado en total, años con esa compañía, años sin partes y partes en los últimos 5 años. (sólo si tiene o ha tenido un seguro de coche a su nombre)\n- ¿Cuántas multas de tráfico ha tenido en los últimos 3 años? [Ninguna / 1 / 2 / 3 / 4 / 5 / Más de 5]\n- Esa multa, ¿fue sólo de aparcamiento? [Sí / No] (sólo si ha tenido exactamente una multa)\n- ¿Ha perdido puntos del carnet en el último año? [Sí / No]\n\nTitular del seguro:\n- Nombre y apellidos del titular.\n- Tipo y número de documento del titular. [DNI / NIE / Pasaporte]\n- Nacionalidad del titular. (sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta))\n- Fecha de nacimiento del titular.\n- Sexo del titular. [Hombre / Mujer]\n- Estado civil del titular. [Soltero/a / Casado/a / Pareja de hecho / Divorciado/a / Viudo/a]\n- Situación laboral del titular. [Trabaja por cuenta ajena / Autónomo/a / Funcionario/a / Jubilado/a / Estudiante / En paro / Labores del hogar]\n- Profesión del titular. (sólo si trabaja (por cuenta ajena, autónomo o funcionario))\n- Móvil y correo electrónico del titular.\n- Dirección del titular: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número.\n\nCuándo empieza:\n- ¿Desde qué fecha quiere el seguro?","guia_de_preguntas":[{"titulo":"El coche","preguntas":[{"pregunta":"Matrícula del coche.","campos":["vehicle.registration_plate"],"nota":"Con la matrícula se deducen marca, modelo, versión y fecha de matriculación si corresponde a un solo coche."},{"pregunta":"Marca, modelo y versión exacta.","campos":["vehicle.version_id","vehicle.brand_id","vehicle.model_id"],"soloSi":"aún no tiene matrícula, o la respuesta dice que la matrícula corresponde a varias versiones","nota":"Búscala en /api/agent/catalogo?tipo=vehicle-brands&ramo=coche → vehicle-models → vehicle-versions y envía vehicle.version_id."},{"pregunta":"Fecha de primera matriculación.","campos":["vehicle.registration_date"],"soloSi":"no hay matrícula o no identifica un solo coche"},{"pregunta":"¿Cómo tiene el coche?","campos":["vehicle.purchase_type"],"opciones":[{"etiqueta":"Ya lo tiene (no lo acaba de comprar)","valor":"already_owned"},{"etiqueta":"Lo acaba de comprar nuevo","valor":"new"},{"etiqueta":"Lo acaba de comprar de segunda mano o km 0, en un concesionario","valor":"used_dealer"},{"etiqueta":"Lo acaba de comprar de segunda mano, a un particular","valor":"used_private"},{"etiqueta":"Aún no lo ha comprado","valor":"planned"}]},{"pregunta":"Fecha de compra.","campos":["vehicle.purchase_date"],"soloSi":"ya lo ha comprado (no se envía si aún no lo ha comprado)","nota":"No puede ser anterior a la matriculación. Si lo acaba de comprar, es la fecha de hoy."},{"pregunta":"Uso del coche.","campos":["vehicle.use"],"opciones":[{"etiqueta":"Particular","valor":"Private"},{"etiqueta":"Profesional (para trabajar)","valor":"Professional"},{"etiqueta":"Servicio público (taxi, VTC…)","valor":"PublicService"}]},{"pregunta":"Kilómetros al año, aproximadamente.","campos":["vehicle.annual_km"],"opciones":[{"etiqueta":"Hasta 5.000","valor":"UpTo5000km"},{"etiqueta":"Hasta 10.000","valor":"UpTo10000km"},{"etiqueta":"Hasta 15.000","valor":"UpTo15000km"},{"etiqueta":"Hasta 20.000","valor":"UpTo20000km"},{"etiqueta":"Hasta 25.000","valor":"UpTo25000km"},{"etiqueta":"Hasta 30.000","valor":"UpTo30000km"},{"etiqueta":"Más de 30.000","valor":"MoreThan30000km"}]},{"pregunta":"¿Dónde duerme el coche?","campos":["vehicle.parking_type"],"opciones":[{"etiqueta":"Garaje privado (propio o alquilado, cerrado)","valor":"PrivateGarage"},{"etiqueta":"Garaje o aparcamiento comunitario","valor":"CommunalParking"},{"etiqueta":"En la calle","valor":"NoGarage"}]},{"pregunta":"¿El propietario del coche es el titular del seguro?","campos":["owner_same_as_holder"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No, es otra persona","valor":false}]}]},{"titulo":"Propietario del coche","soloSi":"el propietario NO es el titular del seguro","preguntas":[{"pregunta":"Nombre y apellidos del propietario.","campos":["owner.name","owner.surname","owner.surname2"],"nota":"Con DNI el segundo apellido es obligatorio."},{"pregunta":"Tipo y número de documento del propietario.","campos":["owner.document_type","owner.document_id"],"opciones":[{"etiqueta":"DNI","valor":"Dni"},{"etiqueta":"NIE","valor":"Nie"},{"etiqueta":"Pasaporte","valor":"Passport"}],"nota":"DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF)."},{"pregunta":"Nacionalidad del propietario.","campos":["owner.nationality"],"soloSi":"el documento es NIE o pasaporte (con DNI es española y no se pregunta)","nota":"Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalities"},{"pregunta":"Fecha de nacimiento del propietario.","campos":["owner.birth_date"]},{"pregunta":"Sexo del propietario.","campos":["owner.gender"],"opciones":[{"etiqueta":"Hombre","valor":"Male"},{"etiqueta":"Mujer","valor":"Female"}]},{"pregunta":"Estado civil del propietario.","campos":["owner.marital_status"],"opciones":[{"etiqueta":"Soltero/a","valor":"Single"},{"etiqueta":"Casado/a","valor":"Married"},{"etiqueta":"Pareja de hecho","valor":"UnmarriedPartner"},{"etiqueta":"Divorciado/a","valor":"Divorced"},{"etiqueta":"Viudo/a","valor":"Widowed"}]}]},{"titulo":"Conductor habitual","preguntas":[{"pregunta":"¿El conductor habitual es el titular del seguro?","campos":["driver.same_as_holder"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No, es otra persona","valor":false}]},{"pregunta":"Nombre y apellidos del conductor habitual.","campos":["driver.name","driver.surname","driver.surname2"],"nota":"Con DNI el segundo apellido es obligatorio.","soloSi":"el conductor habitual NO es el titular (si lo es, no se envían sus datos)"},{"pregunta":"Tipo y número de documento del conductor habitual.","campos":["driver.document_type","driver.document_id"],"opciones":[{"etiqueta":"DNI","valor":"Dni"},{"etiqueta":"NIE","valor":"Nie"},{"etiqueta":"Pasaporte","valor":"Passport"}],"nota":"DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).","soloSi":"el conductor habitual NO es el titular (si lo es, no se envían sus datos)"},{"pregunta":"Nacionalidad del conductor habitual.","campos":["driver.nationality"],"soloSi":"el conductor NO es el titular y el documento es NIE o pasaporte (con DNI es española y no se pregunta)","nota":"Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalities"},{"pregunta":"Fecha de nacimiento del conductor habitual.","campos":["driver.birth_date"],"soloSi":"el conductor habitual NO es el titular (si lo es, no se envían sus datos)"},{"pregunta":"Sexo del conductor habitual.","campos":["driver.gender"],"opciones":[{"etiqueta":"Hombre","valor":"Male"},{"etiqueta":"Mujer","valor":"Female"}],"soloSi":"el conductor habitual NO es el titular (si lo es, no se envían sus datos)"},{"pregunta":"Estado civil del conductor habitual.","campos":["driver.marital_status"],"opciones":[{"etiqueta":"Soltero/a","valor":"Single"},{"etiqueta":"Casado/a","valor":"Married"},{"etiqueta":"Pareja de hecho","valor":"UnmarriedPartner"},{"etiqueta":"Divorciado/a","valor":"Divorced"},{"etiqueta":"Viudo/a","valor":"Widowed"}],"soloSi":"el conductor habitual NO es el titular (si lo es, no se envían sus datos)"},{"pregunta":"Tipo de carnet del conductor, fecha en que lo sacó y si lo sacó en España.","campos":["driver.driving_license_type","driver.driving_license_date","driver.driving_license_country"],"opciones":[{"etiqueta":"B (turismo)","valor":"B"},{"etiqueta":"C1","valor":"C1"},{"etiqueta":"C","valor":"C"}],"nota":"País: se envía \"ESP\". Con un carnet de fuera de España no se puede cotizar por aquí."},{"pregunta":"¿Tiene o ha tenido un seguro de coche a su nombre?","campos":["driver.previously_insured"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No","valor":false}]},{"pregunta":"Compañía, número de póliza y matrícula del vehículo asegurado en esa póliza.","campos":["driver.previous_company_code","driver.previous_policy_number","driver.previous_plate"],"soloSi":"tiene o ha tenido un seguro de coche a su nombre","nota":"Compañía: código de /api/agent/catalogo?tipo=car-insurance-companies. Si es el mismo vehículo, repite su matrícula."},{"pregunta":"Años asegurado en total, años con esa compañía, años sin partes y partes en los últimos 5 años.","campos":["driver.total_years_insured","driver.years_in_previous_company","driver.years_without_accidents","driver.last_five_years_accidents"],"soloSi":"tiene o ha tenido un seguro de coche a su nombre","nota":"Años con la compañía y años sin partes no pueden superar los años en total. Si los años sin partes son menos de 5 y menos que los años en total, ha tenido al menos 1 parte en los últimos 5 años."},{"pregunta":"¿Cuántas multas de tráfico ha tenido en los últimos 3 años?","campos":["driver.penalties"],"opciones":[{"etiqueta":"Ninguna","valor":"0"},{"etiqueta":"1","valor":"1"},{"etiqueta":"2","valor":"2"},{"etiqueta":"3","valor":"3"},{"etiqueta":"4","valor":"4"},{"etiqueta":"5","valor":"5"},{"etiqueta":"Más de 5","valor":"6"}]},{"pregunta":"Esa multa, ¿fue sólo de aparcamiento?","campos":["driver.parking_fine_only"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No","valor":false}],"soloSi":"ha tenido exactamente una multa"},{"pregunta":"¿Ha perdido puntos del carnet en el último año?","campos":["driver.points_lost"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No","valor":false}]}]},{"titulo":"Titular del seguro","preguntas":[{"pregunta":"Nombre y apellidos del titular.","campos":["holder.name","holder.surname","holder.surname2"],"nota":"Con DNI el segundo apellido es obligatorio."},{"pregunta":"Tipo y número de documento del titular.","campos":["holder.document_type","holder.document_id"],"opciones":[{"etiqueta":"DNI","valor":"Dni"},{"etiqueta":"NIE","valor":"Nie"},{"etiqueta":"Pasaporte","valor":"Passport"}],"nota":"DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF)."},{"pregunta":"Nacionalidad del titular.","campos":["holder.nationality"],"soloSi":"el documento es NIE o pasaporte (con DNI es española y no se pregunta)","nota":"Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalities"},{"pregunta":"Fecha de nacimiento del titular.","campos":["holder.birth_date"]},{"pregunta":"Sexo del titular.","campos":["holder.gender"],"opciones":[{"etiqueta":"Hombre","valor":"Male"},{"etiqueta":"Mujer","valor":"Female"}]},{"pregunta":"Estado civil del titular.","campos":["holder.marital_status"],"opciones":[{"etiqueta":"Soltero/a","valor":"Single"},{"etiqueta":"Casado/a","valor":"Married"},{"etiqueta":"Pareja de hecho","valor":"UnmarriedPartner"},{"etiqueta":"Divorciado/a","valor":"Divorced"},{"etiqueta":"Viudo/a","valor":"Widowed"}]},{"pregunta":"Situación laboral del titular.","campos":["holder.employment_status"],"opciones":[{"etiqueta":"Trabaja por cuenta ajena","valor":"Employee"},{"etiqueta":"Autónomo/a","valor":"SelfEmployed"},{"etiqueta":"Funcionario/a","valor":"CivilServant"},{"etiqueta":"Jubilado/a","valor":"Retired"},{"etiqueta":"Estudiante","valor":"Student"},{"etiqueta":"En paro","valor":"Unemployed"},{"etiqueta":"Labores del hogar","valor":"HomeWorker"}]},{"pregunta":"Profesión del titular.","campos":["holder.economic_occupation"],"soloSi":"trabaja (por cuenta ajena, autónomo o funcionario)","nota":"Se envía el código de 4 dígitos: búscalo en /api/agent/catalogo?tipo=economic-occupations"},{"pregunta":"Móvil y correo electrónico del titular.","campos":["holder.phone","holder.email"],"nota":"Móvil español (empieza por 6 o 7). Al correo le llegan los precios y el enlace para contratar."},{"pregunta":"Dirección del titular: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número.","campos":["holder.address.postal_code","holder.address.road_type","holder.address.road_name","holder.address.road_number","holder.address.town_id"],"nota":"El municipio se deduce del código postal si sólo tiene uno; si tiene varios, pregunta cuál y usa /api/agent/catalogo?tipo=towns&codigo_postal=… Tipos de vía: /api/agent/catalogo?tipo=road-types"}]},{"titulo":"Cuándo empieza","preguntas":[{"pregunta":"¿Desde qué fecha quiere el seguro?","campos":["effective_date"],"nota":"Hoy o una fecha futura."}]}],"como_usarlo":["Pregunta al cliente TODOS los datos de una vez, en un solo mensaje, en vez de uno a uno: usa `mensaje_para_el_cliente`.","Aquí no hay valores por defecto: si el cliente no sabe un dato, pregúntale o dile que lo necesitas. No lo inventes ni lo supongas.","Los campos \"segun_otras_respuestas\" sólo se piden si se cumple su condición (\"cuando\").","Nunca inventes ni supongas un dato: si el cliente no lo sabe, pregúntale o déjalo sin enviar y la respuesta te dirá qué falta.","Envía el JSON con `insurance_line` a POST /api/agent/cotizaciones. Si falta o está mal algo, recibirás TODOS los errores juntos.","Tú no contratas: los precios y el enlace para contratar llegan al correo del cliente, que confirma la compra en seguromatch.com con un código por SMS.","Antes de enviar los datos, informa al cliente de que los compartes con SeguroMatch para calcular su seguro: https://seguromatch.com/legal/politica-privacidad"],"bloques":[{"bloque":"(raíz)","que_es":"el cuerpo de la petición","obligatorio":"siempre","campos":[{"campo":"insurance_line","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Ramo a cotizar.","formato":"Home, Car o Motorcycle","valores":["Home","Car","Motorcycle","TermLife","Burial"],"ejemplo":"Car"},{"campo":"effective_date","obligatorio":"siempre","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de inicio del seguro. Obligatoria: ya no se pone \"hoy\", y una fecha pasada se rechaza en vez de corregirse.","formato":"fecha YYYY-MM-DD, hoy o posterior (día natural de España)","ejemplo":"2030-01-01"},{"campo":"client_reference","obligatorio":"opcional","tipo":"texto","descripcion":"Tu referencia interna. Se devuelve en la respuesta y en los webhooks. No es una clave de idempotencia.","formato":"texto de hasta 100 caracteres","ejemplo":"EXP-2026-0042"},{"campo":"owner_same_as_holder","obligatorio":"siempre","tipo":"true o false","descripcion":"¿El propietario del vehículo es el tomador? Ya no se asume que sí. Con false hay que enviar `owner`.","formato":"true o false","ejemplo":true}]},{"bloque":"holder","que_es":"el tomador","obligatorio":"siempre","campos":[{"campo":"holder.document_type","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Tipo de documento de identidad. No se asume DNI.","formato":"Dni, Nie o Passport (empresas con Cif no se cotizan por esta API)","valores":["Dni","Nie","Passport"],"catalogo":"/api/agent/catalogo?tipo=document-types","ejemplo":"Dni"},{"campo":"holder.document_id","obligatorio":"siempre","tipo":"texto","descripcion":"Número del documento. Su formato debe corresponder al tipo declarado.","formato":"DNI: 8 dígitos + letra · NIE: X/Y/Z + 7 dígitos + letra · Pasaporte: mínimo 5 caracteres","ejemplo":"12345678Z"},{"campo":"holder.name","obligatorio":"siempre","tipo":"texto","descripcion":"Nombre, tal como figura en el documento.","formato":"texto, solo letras","ejemplo":"Juan"},{"campo":"holder.surname","obligatorio":"siempre","tipo":"texto","descripcion":"Primer apellido.","formato":"texto, solo letras","ejemplo":"García"},{"campo":"holder.surname2","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Segundo apellido. Obligatorio con DNI.","formato":"texto, solo letras","cuando":"con `holder.document_type: \"Dni\"`","ejemplo":"López"},{"campo":"holder.birth_date","obligatorio":"siempre","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de nacimiento.","formato":"fecha YYYY-MM-DD, no futura","ejemplo":"1985-03-15"},{"campo":"holder.gender","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Sexo. No se asume \"Male\".","formato":"Male o Female","valores":["Male","Female"],"catalogo":"/api/agent/catalogo?tipo=genders","ejemplo":"Female"},{"campo":"holder.marital_status","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Estado civil. Determina la prima en varias aseguradoras; no se asume \"Single\".","formato":"un valor del catálogo marital-statuses","valores":["Single","Married","UnmarriedPartner","Divorced","Widowed"],"catalogo":"/api/agent/catalogo?tipo=marital-statuses","ejemplo":"Married"},{"campo":"holder.nationality","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Nacionalidad ISO-3. Obligatoria con NIE o pasaporte. Con DNI es española por definición: si la mandas, tiene que ser ESP.","formato":"código ISO-3 del catálogo nationalities","cuando":"con `holder.document_type` = Nie o Passport","valores":["ESP","GBR","FRA","DEU","ITA","PRT","ROU","MAR","COL","ECU","ARG","VEN","PER","BOL","BRA","CHN","PAK","UKR","RUS","POL","BGR","NLD","BEL","SWE","NOR","DNK","FIN","IRL","CHE","AUT","USA","CAN","MEX","CHL","URY","PRY","CUB","DOM","HND","SLV","GTM","NIC","PAN","CRI","DZA","SEN","NGA","GHA","PHL","IND","JPN","KOR","AUS","NZL","TUR","ISR","EGY","ZAF"],"catalogo":"/api/agent/catalogo?tipo=nationalities","ejemplo":"ESP"},{"campo":"holder.employment_status","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Situación laboral. No se asume \"Employee\".","formato":"un valor del catálogo employment-statuses","valores":["Employee","SelfEmployed","CivilServant","Retired","Student","Unemployed","HomeWorker"],"catalogo":"/api/agent/catalogo?tipo=employment-statuses","ejemplo":"Employee"},{"campo":"holder.economic_occupation","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Profesión, código CNO-11 de 4 dígitos. No se asume 2612. Obligatoria para personas en activo; un jubilado, estudiante o parado no la envía.","formato":"4 dígitos, en texto, del catálogo economic-occupations","cuando":"con `holder.employment_status` en activo (Employee, SelfEmployed o CivilServant)","catalogo":"/api/agent/catalogo?tipo=economic-occupations","ejemplo":"2611"},{"campo":"holder.phone","obligatorio":"siempre","tipo":"texto","descripcion":"Móvil español del tomador.","formato":"9 dígitos empezando por 6 o 7; se admiten +34 y 0034","ejemplo":"+34644182739"},{"campo":"holder.email","obligatorio":"siempre","tipo":"texto","descripcion":"Correo del tomador. Es el destino de la documentación de la póliza: ahora se valida su formato.","formato":"dirección de correo válida","ejemplo":"cliente@example.com"}]},{"bloque":"holder.address","que_es":"la dirección del tomador","obligatorio":"siempre","campos":[{"campo":"holder.address.postal_code","obligatorio":"siempre","tipo":"texto","descripcion":"Código postal español.","formato":"5 dígitos, en texto","ejemplo":"28001"},{"campo":"holder.address.town_id","obligatorio":"opcional","tipo":"número entero","descripcion":"Municipio (catálogo towns). Solo se deduce del código postal si este tiene UN único municipio; si tiene varios, es obligatorio.","formato":"entero del catálogo towns","catalogo":"/api/agent/catalogo?tipo=towns","ejemplo":28079},{"campo":"holder.address.road_type","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Tipo de vía. Un valor no reconocido ya no se convierte en \"Calle\".","formato":"un valor del catálogo road-types","valores":["Acequia","Atajo","Autovia","Avenida","Barriada","Barrio","Calle","Callejon","Camino","Carretera","Comarcal","Conjunto","Glorieta","GranVia","Grupo","Kilometro","Nacional","Pasaje","Paseo","Pasillo","Paso","Plaza","Poligono","Rambla","Riera","Ronda","Sendero","Torrente","Travesera","Travesia","Urbanizacion","Via","Vial"],"catalogo":"/api/agent/catalogo?tipo=road-types","ejemplo":"Calle"},{"campo":"holder.address.road_name","obligatorio":"siempre","tipo":"texto","descripcion":"Nombre de la vía. No se inventa \"Principal\".","formato":"texto","ejemplo":"Gran Vía"},{"campo":"holder.address.road_number","obligatorio":"siempre","tipo":"texto","descripcion":"Número de la vía, en texto. Usa \"S/N\" si la vía no tiene número. No se inventa \"1\".","formato":"texto (p. ej. \"12\", \"12B\", \"S/N\")","ejemplo":"12"}]},{"bloque":"vehicle","que_es":"el vehículo","obligatorio":"siempre","campos":[{"campo":"vehicle.registration_plate","obligatorio":"opcional","tipo":"texto","descripcion":"Matrícula española. Identifica el vehículo solo si corresponde a UNA versión; si tiene varias, envía `version_id`.","formato":"matrícula española (p. ej. 1234BCD)","ejemplo":"1234BCD"},{"campo":"vehicle.brand_id","obligatorio":"opcional","tipo":"texto","descripcion":"Marca (catálogo vehicle-brands).","formato":"id del catálogo","catalogo":"/api/agent/catalogo?tipo=vehicle-brands","ejemplo":"00016"},{"campo":"vehicle.model_id","obligatorio":"opcional","tipo":"texto","descripcion":"Modelo (catálogo vehicle-models).","formato":"id del catálogo","catalogo":"/api/agent/catalogo?tipo=vehicle-models","ejemplo":"0001600012"},{"campo":"vehicle.version_id","obligatorio":"opcional","tipo":"texto","descripcion":"Versión exacta (Base7). Obligatoria si no hay matrícula o si la matrícula tiene varias versiones.","formato":"id del catálogo vehicle-versions","catalogo":"/api/agent/catalogo?tipo=vehicle-versions","ejemplo":"06310010019"},{"campo":"vehicle.brand_name","obligatorio":"opcional","tipo":"texto","descripcion":"Nombre de la marca (solo informativo).","formato":"texto","ejemplo":"SEAT"},{"campo":"vehicle.model_name","obligatorio":"opcional","tipo":"texto","descripcion":"Nombre del modelo (solo informativo).","formato":"texto","ejemplo":"LEON"},{"campo":"vehicle.version_name","obligatorio":"opcional","tipo":"texto","descripcion":"Nombre de la versión (solo informativo).","formato":"texto","ejemplo":"1.5 TSI 130 CV"},{"campo":"vehicle.registration_date","obligatorio":"opcional","tipo":"fecha (YYYY-MM-DD)","descripcion":"Primera matriculación. Solo se deduce de la matrícula si esta identifica un único vehículo; si no, es obligatoria.","formato":"fecha YYYY-MM-DD, no futura","ejemplo":"2019-06-01"},{"campo":"vehicle.purchase_type","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Cómo se adquirió. Ya no se deduce de las fechas: algunas aseguradoras tarifican distinto según el caso.","formato":"already_owned, new, used_dealer, used_private o planned","valores":["already_owned","new","used_dealer","used_private","planned"],"ejemplo":"already_owned"},{"campo":"vehicle.purchase_date","obligatorio":"segun_otras_respuestas","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de compra. Ya no se deduce de la matriculación. No se envía con purchase_type \"planned\".","formato":"fecha YYYY-MM-DD, no futura e igual o posterior a la matriculación","cuando":"salvo con `vehicle.purchase_type: \"planned\"`","no_enviar_si":["con `vehicle.purchase_type: \"planned\"` (aún no comprado)"],"ejemplo":"2019-06-15"},{"campo":"vehicle.use","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Uso del vehículo. No se asume \"Private\": declara el uso real.","formato":"un valor del catálogo car-use-types","valores":["Private","Professional","PublicService"],"catalogo":"/api/agent/catalogo?tipo=car-use-types","ejemplo":"Private"},{"campo":"vehicle.annual_km","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Kilómetros anuales. No se asume \"UpTo15000km\".","formato":"un valor del catálogo annual-km-options","valores":["UpTo5000km","UpTo10000km","UpTo15000km","UpTo20000km","UpTo25000km","UpTo30000km","MoreThan30000km"],"catalogo":"/api/agent/catalogo?tipo=annual-km-options","ejemplo":"UpTo10000km"},{"campo":"vehicle.parking_type","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Dónde duerme el coche. Determina la prima; no se asume \"NoGarage\".","formato":"un valor del catálogo car-parking-types","valores":["PrivateGarage","CommunalParking","NoGarage"],"catalogo":"/api/agent/catalogo?tipo=car-parking-types","ejemplo":"NoGarage"},{"campo":"vehicle.fuel_type","obligatorio":"opcional","tipo":"uno de los valores permitidos","descripcion":"Combustible. Se toma del catálogo cuando el vehículo queda identificado.","formato":"un valor del catálogo fuel-types","valores":["Gasoline","Diesel","Electric","Hybrid","PlugInHybrid","Lpg","Cng"],"catalogo":"/api/agent/catalogo?tipo=fuel-types","ejemplo":"Gasoline"},{"campo":"vehicle.retail_price","obligatorio":"opcional","tipo":"número","descripcion":"Precio de venta al público, en euros.","formato":"número > 0","ejemplo":24500}]},{"bloque":"driver","que_es":"el conductor habitual","obligatorio":"siempre","campos":[{"campo":"driver.same_as_holder","obligatorio":"siempre","tipo":"true o false","descripcion":"¿El conductor habitual es el tomador? Ya no se asume que sí. Con false, envía su identidad en este mismo bloque.","formato":"true o false","ejemplo":true},{"campo":"driver.document_type","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Tipo de documento de identidad. No se asume DNI.","formato":"Dni, Nie o Passport (empresas con Cif no se cotizan por esta API)","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"valores":["Dni","Nie","Passport"],"catalogo":"/api/agent/catalogo?tipo=document-types","ejemplo":"Dni"},{"campo":"driver.document_id","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Número del documento. Su formato debe corresponder al tipo declarado.","formato":"DNI: 8 dígitos + letra · NIE: X/Y/Z + 7 dígitos + letra · Pasaporte: mínimo 5 caracteres","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"ejemplo":"12345678Z"},{"campo":"driver.name","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Nombre, tal como figura en el documento.","formato":"texto, solo letras","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"ejemplo":"Juan"},{"campo":"driver.surname","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Primer apellido.","formato":"texto, solo letras","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"ejemplo":"García"},{"campo":"driver.surname2","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Segundo apellido. Obligatorio con DNI.","formato":"texto, solo letras","cuando":"con `driver.same_as_holder: false` y `driver.document_type: \"Dni\"`","no_enviar_si":["con `driver.same_as_holder: true`"],"ejemplo":"López"},{"campo":"driver.birth_date","obligatorio":"segun_otras_respuestas","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de nacimiento.","formato":"fecha YYYY-MM-DD, no futura","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"ejemplo":"1985-03-15"},{"campo":"driver.gender","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Sexo. No se asume \"Male\".","formato":"Male o Female","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"valores":["Male","Female"],"catalogo":"/api/agent/catalogo?tipo=genders","ejemplo":"Female"},{"campo":"driver.marital_status","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Estado civil. Determina la prima en varias aseguradoras; no se asume \"Single\".","formato":"un valor del catálogo marital-statuses","cuando":"con `driver.same_as_holder: false`","no_enviar_si":["con `driver.same_as_holder: true`"],"valores":["Single","Married","UnmarriedPartner","Divorced","Widowed"],"catalogo":"/api/agent/catalogo?tipo=marital-statuses","ejemplo":"Married"},{"campo":"driver.nationality","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Nacionalidad ISO-3. Obligatoria con NIE o pasaporte. Con DNI es española por definición: si la mandas, tiene que ser ESP.","formato":"código ISO-3 del catálogo nationalities","cuando":"con `driver.same_as_holder: false` y `driver.document_type` = Nie o Passport","no_enviar_si":["con `driver.same_as_holder: true`"],"valores":["ESP","GBR","FRA","DEU","ITA","PRT","ROU","MAR","COL","ECU","ARG","VEN","PER","BOL","BRA","CHN","PAK","UKR","RUS","POL","BGR","NLD","BEL","SWE","NOR","DNK","FIN","IRL","CHE","AUT","USA","CAN","MEX","CHL","URY","PRY","CUB","DOM","HND","SLV","GTM","NIC","PAN","CRI","DZA","SEN","NGA","GHA","PHL","IND","JPN","KOR","AUS","NZL","TUR","ISR","EGY","ZAF"],"catalogo":"/api/agent/catalogo?tipo=nationalities","ejemplo":"ESP"},{"campo":"driver.driving_license_type","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Tipo de carnet. No se asume \"B\".","formato":"un valor del catálogo driving-license-types","valores":["B","C1","C"],"catalogo":"/api/agent/catalogo?tipo=driving-license-types","ejemplo":"B"},{"campo":"driver.driving_license_date","obligatorio":"siempre","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de expedición del carnet. Ya no se asume \"hace 5 años\".","formato":"fecha YYYY-MM-DD, no futura","ejemplo":"2008-04-20"},{"campo":"driver.driving_license_country","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"País de expedición del carnet (ISO-3). Hoy solo se cotizan carnets españoles: cualquier otro se rechaza como caso no soportado, en vez de declararse español.","formato":"ESP","valores":["ESP","GBR","FRA","DEU","ITA","PRT","ROU","MAR","COL","ECU","ARG","VEN","PER","BOL","BRA","CHN","PAK","UKR","RUS","POL","BGR","NLD","BEL","SWE","NOR","DNK","FIN","IRL","CHE","AUT","USA","CAN","MEX","CHL","URY","PRY","CUB","DOM","HND","SLV","GTM","NIC","PAN","CRI","DZA","SEN","NGA","GHA","PHL","IND","JPN","KOR","AUS","NZL","TUR","ISR","EGY","ZAF"],"catalogo":"/api/agent/catalogo?tipo=nationalities","ejemplo":"ESP"},{"campo":"driver.previously_insured","obligatorio":"siempre","tipo":"true o false","descripcion":"¿Tiene o ha tenido un seguro de coche a su nombre? Ya no se asume que no. Con true, el historial completo es obligatorio; con false no se envía y se declara 0 años.","formato":"true o false","ejemplo":true},{"campo":"driver.previous_company_code","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Aseguradora anterior. Los códigos de coche y de moto son catálogos distintos.","formato":"código del catálogo car-insurance-companies","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"catalogo":"/api/agent/catalogo?tipo=car-insurance-companies","ejemplo":"C0109"},{"campo":"driver.previous_policy_number","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Número de la póliza anterior.","formato":"texto de al menos 5 caracteres","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":"POL-123456"},{"campo":"driver.previous_plate","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Matrícula del vehículo de la póliza anterior. Ya no se asume que es el mismo vehículo: si lo es, repite su matrícula.","formato":"matrícula española","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":"1234BCD"},{"campo":"driver.total_years_insured","obligatorio":"segun_otras_respuestas","tipo":"número entero","descripcion":"Años totales asegurado. Con `previously_insured: false` no se envía, o se envía 0.","formato":"entero ≥ 0","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":5},{"campo":"driver.years_in_previous_company","obligatorio":"segun_otras_respuestas","tipo":"número entero","descripcion":"Años en la aseguradora anterior. No puede superar total_years_insured. Con `previously_insured: false` no se envía, o se envía 0.","formato":"entero ≥ 0","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":5},{"campo":"driver.years_without_accidents","obligatorio":"segun_otras_respuestas","tipo":"número entero","descripcion":"Años sin siniestros con culpa. Con `previously_insured: false` no se envía, o se envía 0.","formato":"entero ≥ 0","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":5},{"campo":"driver.last_five_years_accidents","obligatorio":"segun_otras_respuestas","tipo":"número entero","descripcion":"Siniestros con culpa en los últimos 5 años. Con `previously_insured: false` no se envía, o se envía 0.","formato":"entero ≥ 0","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"ejemplo":5},{"campo":"driver.penalties","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Multas de tráfico de los últimos 3 años, en texto. \"6\" = más de cinco. Ya no se declara \"ninguna\" en tu nombre.","formato":"\"0\" a \"6\", en texto","valores":["0","1","2","3","4","5","6"],"ejemplo":"0"},{"campo":"driver.parking_fine_only","obligatorio":"segun_otras_respuestas","tipo":"true o false","descripcion":"Con UNA sola multa: ¿fue solo de aparcamiento? Una aseguradora lo distingue.","formato":"true o false","cuando":"con `driver.penalties: \"1\"`","ejemplo":false},{"campo":"driver.points_lost","obligatorio":"siempre","tipo":"true o false","descripcion":"¿Perdió puntos del carnet el último año? Es una declaración del conductor: ya no se omite.","formato":"true o false","ejemplo":false}]},{"bloque":"owner","que_es":"el propietario","obligatorio":"segun_otras_respuestas","cuando":"con `owner_same_as_holder: false`","campos":[{"campo":"owner.document_type","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Tipo de documento de identidad. No se asume DNI.","formato":"Dni, Nie o Passport (empresas con Cif no se cotizan por esta API)","cuando":"con `owner_same_as_holder: false`","valores":["Dni","Nie","Passport"],"catalogo":"/api/agent/catalogo?tipo=document-types","ejemplo":"Dni"},{"campo":"owner.document_id","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Número del documento. Su formato debe corresponder al tipo declarado.","formato":"DNI: 8 dígitos + letra · NIE: X/Y/Z + 7 dígitos + letra · Pasaporte: mínimo 5 caracteres","cuando":"con `owner_same_as_holder: false`","ejemplo":"12345678Z"},{"campo":"owner.name","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Nombre, tal como figura en el documento.","formato":"texto, solo letras","cuando":"con `owner_same_as_holder: false`","ejemplo":"Juan"},{"campo":"owner.surname","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Primer apellido.","formato":"texto, solo letras","cuando":"con `owner_same_as_holder: false`","ejemplo":"García"},{"campo":"owner.surname2","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Segundo apellido. Obligatorio con DNI.","formato":"texto, solo letras","cuando":"con `owner_same_as_holder: false` y `owner.document_type: \"Dni\"`","ejemplo":"López"},{"campo":"owner.birth_date","obligatorio":"segun_otras_respuestas","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de nacimiento.","formato":"fecha YYYY-MM-DD, no futura","cuando":"con `owner_same_as_holder: false`","ejemplo":"1985-03-15"},{"campo":"owner.gender","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Sexo. No se asume \"Male\".","formato":"Male o Female","cuando":"con `owner_same_as_holder: false`","valores":["Male","Female"],"catalogo":"/api/agent/catalogo?tipo=genders","ejemplo":"Female"},{"campo":"owner.marital_status","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Estado civil. Determina la prima en varias aseguradoras; no se asume \"Single\".","formato":"un valor del catálogo marital-statuses","cuando":"con `owner_same_as_holder: false`","valores":["Single","Married","UnmarriedPartner","Divorced","Widowed"],"catalogo":"/api/agent/catalogo?tipo=marital-statuses","ejemplo":"Married"},{"campo":"owner.nationality","obligatorio":"segun_otras_respuestas","tipo":"uno de los valores permitidos","descripcion":"Nacionalidad ISO-3. Obligatoria con NIE o pasaporte. Con DNI es española por definición: si la mandas, tiene que ser ESP.","formato":"código ISO-3 del catálogo nationalities","cuando":"con `owner_same_as_holder: false` y `owner.document_type` = Nie o Passport","valores":["ESP","GBR","FRA","DEU","ITA","PRT","ROU","MAR","COL","ECU","ARG","VEN","PER","BOL","BRA","CHN","PAK","UKR","RUS","POL","BGR","NLD","BEL","SWE","NOR","DNK","FIN","IRL","CHE","AUT","USA","CAN","MEX","CHL","URY","PRY","CUB","DOM","HND","SLV","GTM","NIC","PAN","CRI","DZA","SEN","NGA","GHA","PHL","IND","JPN","KOR","AUS","NZL","TUR","ISR","EGY","ZAF"],"catalogo":"/api/agent/catalogo?tipo=nationalities","ejemplo":"ESP"}]}],"excepciones_aceptadas":["Hogar: con DNI y sin `holder.surname2` se duplica el primer apellido (decisión de negocio). En Coche y Moto, `surname2` es obligatorio con DNI.","Un conductor o propietario distinto del tomador hereda la dirección del tomador: es dirección de contacto, no el lugar del riesgo. Por eso `driver` y `owner` no admiten dirección.","`town_id` se deduce del código postal SOLO si ese código postal tiene un único municipio.","Marca, modelo, versión, combustible y fecha de matriculación se deducen de la matrícula SOLO si identifica un único vehículo.","Con DNI la nacionalidad es española por definición. Enviar otra es un error de contradicción.","Hogar: las medidas de seguridad opcionales (`security_main_door`, `security_windows`) que no se envían no se declaran, y por tanto no dan descuento.","Con `previously_insured: false` no se envía historial y se declaran 0 años asegurado, que es la definición de no haber estado asegurado."],"casos_no_soportados":["Tomador, conductor o propietario empresa (`document_type: \"Cif\"`).","Hogar con propietario distinto del tomador (`risk.owner_is_holder: false`). Un inquilino no es este caso: manda `true`.","Coche con carnet expedido fuera de España (`driver.driving_license_country` distinto de ESP)."]}