{"ramo":"moto","insurance_line":"Motorcycle","mensaje_para_el_cliente":"Para darte precios de varias aseguradoras necesito esto (mándamelo todo de una vez):\n\nLa moto:\n- Matrícula de la moto.\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 se puede deducir de ella)\n- Fecha de compra.\n- Código postal (y municipio) donde circula normalmente.\n- ¿Dónde duerme la moto? [Garaje privado (propio o alquilado, cerrado) / Garaje o aparcamiento comunitario / En la calle]\n- Kilómetros al año, aproximadamente.\n- ¿El propietario de la moto es el titular del seguro? [Sí / No, es otra persona]\n\nPropietario de la moto (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 de moto y fecha en que lo sacó. [AM / A1 / A2 / A / B (con 3 años, motos de hasta 125 cc) / Licencia de ciclomotor (LCM)]\n- ¿Dónde se sacó el carnet? [España / Otro país de la UE / Fuera de la UE]\n- ¿Qué experiencia tiene con motos? [Ninguna / Ya conduce esta moto / Ha conducido otra moto]\n- ¿Qué moto conducía? (sólo si ha conducido otra moto)\n- ¿Tiene también carnet de coche? ¿Desde cuándo? [Sí / No]\n- ¿Tiene o ha tenido un seguro de moto 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 moto 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 moto a su nombre)\n- Multas en los últimos 3 años y si ha perdido puntos en el último año (opcional).\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":"La moto","preguntas":[{"pregunta":"Matrícula de la moto.","campos":["vehicle.registration_plate"],"nota":"Con la matrícula se deduce el modelo y la fecha de matriculación si corresponde a una sola moto."},{"pregunta":"Marca, modelo y versión exacta.","campos":["vehicle.code"],"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=moto → vehicle-models → vehicle-versions y envía vehicle.code."},{"pregunta":"Fecha de primera matriculación.","campos":["vehicle.registration_date"],"soloSi":"no hay matrícula o no se puede deducir de ella"},{"pregunta":"Fecha de compra.","campos":["vehicle.purchase_date"],"nota":"No puede ser anterior a la matriculación."},{"pregunta":"Código postal (y municipio) donde circula normalmente.","campos":["vehicle.circulation_postal_code","vehicle.circulation_town_id"],"nota":"El municipio se deduce si el código postal sólo tiene uno; si no, /api/agent/catalogo?tipo=towns&codigo_postal=…"},{"pregunta":"¿Dónde duerme la moto?","campos":["vehicle.garage_type_id"],"opciones":[{"etiqueta":"Garaje privado (propio o alquilado, cerrado)","valor":"PrivateGarage"},{"etiqueta":"Garaje o aparcamiento comunitario","valor":"CommunalParking"},{"etiqueta":"En la calle","valor":"NoGarage"}]},{"pregunta":"Kilómetros al año, aproximadamente.","campos":["vehicle.kilometers_per_year"],"nota":"Número entero."},{"pregunta":"¿El propietario de la moto es el titular del seguro?","campos":["owner_same_as_holder"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No, es otra persona","valor":false}]}]},{"titulo":"Propietario de la moto","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 de moto y fecha en que lo sacó.","campos":["driver.driving_license_type","driver.driving_license_date"],"opciones":[{"etiqueta":"AM","valor":"AM"},{"etiqueta":"A1","valor":"A1"},{"etiqueta":"A2","valor":"A2"},{"etiqueta":"A","valor":"A"},{"etiqueta":"B (con 3 años, motos de hasta 125 cc)","valor":"B"},{"etiqueta":"Licencia de ciclomotor (LCM)","valor":"LCM"}],"nota":"El carnet tiene que permitir esa moto: AM y LCM hasta 50 cc; A1 hasta 125 cc y 11 kW; A2 hasta 35 kW; B hasta 125 cc y con 3 años de antigüedad. Si no, no se puede cotizar."},{"pregunta":"¿Dónde se sacó el carnet?","campos":["driver.driving_license_issuing_zone_id"],"opciones":[{"etiqueta":"España","valor":"Spain"},{"etiqueta":"Otro país de la UE","valor":"RestEU"},{"etiqueta":"Fuera de la UE","valor":"RestWorld"}]},{"pregunta":"¿Qué experiencia tiene con motos?","campos":["driver.driving_experience_id"],"opciones":[{"etiqueta":"Ninguna","valor":"NoExperience"},{"etiqueta":"Ya conduce esta moto","valor":"ThisMotorcycle"},{"etiqueta":"Ha conducido otra moto","valor":"OtherMotorcycle"}]},{"pregunta":"¿Qué moto conducía?","campos":["driver.previous_motorcycle_code"],"soloSi":"ha conducido otra moto","nota":"Búscala en /api/agent/catalogo?tipo=vehicle-brands&ramo=moto → vehicle-models → vehicle-versions y envía su código."},{"pregunta":"¿Tiene también carnet de coche? ¿Desde cuándo?","campos":["driver.has_car_license","driver.car_license_date"],"opciones":[{"etiqueta":"Sí","valor":true},{"etiqueta":"No","valor":false}],"nota":"La fecha sólo si tiene carnet de coche."},{"pregunta":"¿Tiene o ha tenido un seguro de moto 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 moto a su nombre","nota":"Compañía: código de /api/agent/catalogo?tipo=motorcycle-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 moto 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":"Multas en los últimos 3 años y si ha perdido puntos en el último año (opcional).","campos":["driver.penalties","driver.points_lost"],"nota":"Multas: \"0\" a \"5\", o \"6\" si son más de cinco."}]},{"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":"Motorcycle"},{"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":"la moto","obligatorio":"siempre","campos":[{"campo":"vehicle.code","obligatorio":"opcional","tipo":"texto","descripcion":"Versión exacta (Base7, catálogo vehicle-versions con line=Motorcycle). 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":"02360100002"},{"campo":"vehicle.registration_plate","obligatorio":"opcional","tipo":"texto","descripcion":"Matrícula española. Se valida siempre que se envía.","formato":"matrícula española","ejemplo":"5678BCD"},{"campo":"vehicle.registration_date","obligatorio":"opcional","tipo":"fecha (YYYY-MM-DD)","descripcion":"Primera matriculación. Solo se deduce de la matrícula; si no se puede, es obligatoria.","formato":"fecha YYYY-MM-DD, no futura","ejemplo":"2020-01-01"},{"campo":"vehicle.purchase_date","obligatorio":"siempre","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de compra. Ya no se deduce de la matriculación.","formato":"fecha YYYY-MM-DD, no futura e igual o posterior a la matriculación","ejemplo":"2020-02-01"},{"campo":"vehicle.circulation_postal_code","obligatorio":"siempre","tipo":"texto","descripcion":"Código postal por donde circula habitualmente. Ya no se asume el del tomador: si es el mismo, repítelo.","formato":"5 dígitos, en texto","ejemplo":"28001"},{"campo":"vehicle.circulation_town_id","obligatorio":"opcional","tipo":"número entero","descripcion":"Municipio de circulación. Solo se deduce si el código postal tiene un único municipio.","formato":"entero del catálogo towns","catalogo":"/api/agent/catalogo?tipo=towns","ejemplo":28079},{"campo":"vehicle.garage_type_id","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Dónde duerme la moto. Determina la prima.","formato":"un valor del catálogo motorcycle-garage-types","valores":["PrivateGarage","CommunalParking","NoGarage"],"catalogo":"/api/agent/catalogo?tipo=motorcycle-garage-types","ejemplo":"NoGarage"},{"campo":"vehicle.kilometers_per_year","obligatorio":"siempre","tipo":"número entero","descripcion":"Kilómetros al año.","formato":"entero > 0","ejemplo":5000}]},{"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í.","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 de moto.","formato":"un valor del catálogo motorcycle-driving-license-types","valores":["AM","A1","A2","A","B","LCM"],"catalogo":"/api/agent/catalogo?tipo=motorcycle-driving-license-types","ejemplo":"A2"},{"campo":"driver.driving_license_date","obligatorio":"siempre","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha de expedición del carnet de moto.","formato":"fecha YYYY-MM-DD, no futura","ejemplo":"2015-06-01"},{"campo":"driver.driving_license_issuing_zone_id","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Zona de expedición del carnet. Ya no se asume España.","formato":"Spain, RestEU o RestWorld","valores":["Spain","RestEU","RestWorld"],"ejemplo":"Spain"},{"campo":"driver.driving_experience_id","obligatorio":"siempre","tipo":"uno de los valores permitidos","descripcion":"Experiencia conduciendo motos.","formato":"un valor del catálogo motorcycle-driving-experience","valores":["NoExperience","ThisMotorcycle","OtherMotorcycle"],"catalogo":"/api/agent/catalogo?tipo=motorcycle-driving-experience","ejemplo":"ThisMotorcycle"},{"campo":"driver.previous_motorcycle_code","obligatorio":"segun_otras_respuestas","tipo":"texto","descripcion":"Versión de la moto anterior.","formato":"id del catálogo vehicle-versions","cuando":"con `driver.driving_experience_id: \"OtherMotorcycle\"`","catalogo":"/api/agent/catalogo?tipo=vehicle-versions","ejemplo":"02360100001"},{"campo":"driver.has_car_license","obligatorio":"opcional","tipo":"true o false","descripcion":"¿Tiene además carnet de coche? No se asume.","formato":"true o false","ejemplo":true},{"campo":"driver.car_license_date","obligatorio":"segun_otras_respuestas","tipo":"fecha (YYYY-MM-DD)","descripcion":"Fecha del carnet de coche.","formato":"fecha YYYY-MM-DD, no futura","cuando":"con `driver.has_car_license: true`","ejemplo":"2010-03-01"},{"campo":"driver.previously_insured","obligatorio":"siempre","tipo":"true o false","descripcion":"¿Tiene o ha tenido un seguro de moto a su nombre? Ya no se asume que no.","formato":"true o false","ejemplo":false},{"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 motorcycle-insurance-companies","cuando":"con `driver.previously_insured: true`","no_enviar_si":["con `driver.previously_insured: false`"],"catalogo":"/api/agent/catalogo?tipo=motorcycle-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":"opcional","tipo":"uno de los valores permitidos","descripcion":"Multas de los últimos 3 años. Hoy ninguna aseguradora de moto lo consume: se guarda con la cotización.","formato":"\"0\" a \"6\", en texto","valores":["0","1","2","3","4","5","6"],"ejemplo":"0"},{"campo":"driver.points_lost","obligatorio":"opcional","tipo":"true o false","descripcion":"¿Perdió puntos el último año? Hoy no lo consume ninguna aseguradora de moto.","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)."]}