Cotizar con un agente de IA
Si eres un asistente de IA que ayuda a una persona a contratar un seguro de hogar, coche o moto en España: aquí tienes todo lo que necesitas para cotizarle en Seguro Match preguntándole todos los datos de una sola vez, sin recorrer el formulario pantalla a pantalla.
Qué preguntar al cliente, en un solo mensaje
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.
Cada pregunta dice cuándo hacerla («sólo si…»), qué respuestas caben y, entre corchetes, qué valor se envía por cada una. Pídelo todo en un mensaje; lo que no aplique, el cliente lo salta.
Seguro de hogar
Formulario con todo en una página: /cotizar?tipo=hogar&modo=formulario · En JSON: /api/agent/requisitos?ramo=hogar
- La vivienda
- Dirección de la vivienda que se asegura: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número. 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-typesCampos:
risk.address.postal_coderisk.address.road_typerisk.address.road_namerisk.address.road_numberrisk.address.town_id - ¿Qué relación tiene con la vivienda? Respuestas: Es el propietario y la usa él (como vivienda habitual o como segunda residencia) [Owner] · Es el propietario y la tiene alquilada a otra persona [Rental] · Es inquilino [Tenant]. risk.owner_is_holder se envía siempre true (también si es inquilino). Si el titular del seguro no es ni el propietario ni el inquilino, no se puede cotizar por aquí.Campos:
risk.userisk.owner_is_holder - ¿Es su vivienda habitual o una segunda residencia? Respuestas: Vivienda habitual [MainResidence] · Segunda residencia [SecondHome].Campos:
risk.occupancy - Tipo de vivienda. Respuestas: Piso en planta intermedia [MiddleFloor] · Ático o último piso [TopFloor] · Bajo o planta baja [GroundFloor] · Casa o chalet independiente [DetachedHouse] · Adosado [TerracedHouse].Campos:
risk.dwelling_type - ¿Dónde está? Respuestas: En el casco urbano [CityCentre] · En una urbanización [ResidentialDevelopment] · Aislada o en zona despoblada [Depopulated].Campos:
risk.location - Metros cuadrados, número de habitaciones y año de construcción.Campos:
risk.area_m2risk.roomsrisk.year_built - ¿En qué año se hizo la última reforma? ¿O no se ha reformado nunca? Año, o null si no se ha reformado. No puede ser anterior al año de construcción.Campos:
risk.last_reform_year - ¿De qué está construida? Respuestas: Ladrillo, hormigón o piedra (nada combustible) [NonCombustible] · Alguna parte de madera (menos del 25 %) [LessThan25Combustible] · Mucha madera (más del 25 %) [MoreThan25Combustible].Campos:
risk.materials - Calidad de la construcción. Respuestas: Básica [Basic] · Normal [Normal] · Alta [High] · De lujo [Luxury].Campos:
risk.build_quality - ¿Tiene alarma? Respuestas: No [NoAlarm] · Sí, conectada a una central [ConnectedAlarm] · Sí, sin conexión a central [NonConnectedAlarm].Campos:
risk.alarm - ¿Tiene puerta blindada o acorazada? ¿Rejas o protección en las ventanas? (opcional: sólo suma descuento) Respuestas: Sí [true] · No [false].Campos:
risk.security_main_doorrisk.security_windows - ¿Cuánto quiere asegurar? Continente (la casa: paredes, suelos, instalaciones) y contenido (muebles, electrodomésticos, ropa…), en euros. Si es propietario, el continente tiene que ser mayor que 0. Un inquilino puede poner 0 de continente.Campos:
risk.buildings_limitrisk.contents_limit - Si hay un siniestro, ¿cómo prefiere que se le indemnice? Respuestas: Valor de reposición: se asegura el valor total de lo que tiene [ReplacementValue] · Primer riesgo: sólo hasta una cantidad fija, más barato [FirstRisk].Campos:
risk.settlement_type
- Dirección de la vivienda que se asegura: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número. 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-typesCampos:
- Titular del seguro
- Nombre y apellidos del titular. El segundo apellido es opcional.Campos:
holder.nameholder.surnameholder.surname2 - Tipo y número de documento del titular. Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
holder.document_typeholder.document_id - Nacionalidad del titular. Sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
holder.nationality - Fecha de nacimiento del titular.Campos:
holder.birth_date - Sexo del titular. Respuestas: Hombre [Male] · Mujer [Female].Campos:
holder.gender - Estado civil del titular. Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
holder.marital_status - Situación laboral del titular. Respuestas: Trabaja por cuenta ajena [Employee] · Autónomo/a [SelfEmployed] · Funcionario/a [CivilServant] · Jubilado/a [Retired] · Estudiante [Student] · En paro [Unemployed] · Labores del hogar [HomeWorker].Campos:
holder.employment_status - Profesión del titular (si no trabaja ahora, la última que tuvo). Se envía el código de 4 dígitos: búscalo en /api/agent/catalogo?tipo=economic-occupationsCampos:
holder.economic_occupation - Móvil y correo electrónico del titular. Móvil español (empieza por 6 o 7). Al correo le llegan los precios y el enlace para contratar.Campos:
holder.phoneholder.email - ¿El titular vive en la vivienda que se asegura? Respuestas: Sí [true] · No [false]. Si vive en ella, se envía true y no hace falta su dirección.Campos:
holder.address_same_as_risk - Dirección del titular: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número. Sólo si el titular NO vive en la vivienda que se asegura. 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-typesCampos:
holder.address.postal_codeholder.address.road_typeholder.address.road_nameholder.address.road_numberholder.address.town_id
- Nombre y apellidos del titular. El segundo apellido es opcional.Campos:
- Cuándo empieza
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
effective_date
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
Seguro de coche
Formulario con todo en una página: /cotizar?tipo=auto&modo=formulario · En JSON: /api/agent/requisitos?ramo=coche
- El coche
- Matrícula del coche. Con la matrícula se deducen marca, modelo, versión y fecha de matriculación si corresponde a un solo coche.Campos:
vehicle.registration_plate - 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. Búscala en /api/agent/catalogo?tipo=vehicle-brands&ramo=coche → vehicle-models → vehicle-versions y envía vehicle.version_id.Campos:
vehicle.version_idvehicle.brand_idvehicle.model_id - Fecha de primera matriculación. Sólo si no hay matrícula o no identifica un solo coche.Campos:
vehicle.registration_date - ¿Cómo tiene el coche? Respuestas: Ya lo tiene (no lo acaba de comprar) [already_owned] · Lo acaba de comprar nuevo [new] · Lo acaba de comprar de segunda mano o km 0, en un concesionario [used_dealer] · Lo acaba de comprar de segunda mano, a un particular [used_private] · Aún no lo ha comprado [planned].Campos:
vehicle.purchase_type - Fecha de compra. Sólo si ya lo ha comprado (no se envía si aún no lo ha comprado). No puede ser anterior a la matriculación. Si lo acaba de comprar, es la fecha de hoy.Campos:
vehicle.purchase_date - Uso del coche. Respuestas: Particular [Private] · Profesional (para trabajar) [Professional] · Servicio público (taxi, VTC…) [PublicService].Campos:
vehicle.use - Kilómetros al año, aproximadamente. Respuestas: Hasta 5.000 [UpTo5000km] · Hasta 10.000 [UpTo10000km] · Hasta 15.000 [UpTo15000km] · Hasta 20.000 [UpTo20000km] · Hasta 25.000 [UpTo25000km] · Hasta 30.000 [UpTo30000km] · Más de 30.000 [MoreThan30000km].Campos:
vehicle.annual_km - ¿Dónde duerme el coche? Respuestas: Garaje privado (propio o alquilado, cerrado) [PrivateGarage] · Garaje o aparcamiento comunitario [CommunalParking] · En la calle [NoGarage].Campos:
vehicle.parking_type - ¿El propietario del coche es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
owner_same_as_holder
- Matrícula del coche. Con la matrícula se deducen marca, modelo, versión y fecha de matriculación si corresponde a un solo coche.Campos:
- Propietario del coche — sólo si el propietario NO es el titular del seguro
- Nombre y apellidos del propietario. Con DNI el segundo apellido es obligatorio.Campos:
owner.nameowner.surnameowner.surname2 - Tipo y número de documento del propietario. Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
owner.document_typeowner.document_id - Nacionalidad del propietario. Sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
owner.nationality - Fecha de nacimiento del propietario.Campos:
owner.birth_date - Sexo del propietario. Respuestas: Hombre [Male] · Mujer [Female].Campos:
owner.gender - Estado civil del propietario. Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
owner.marital_status
- Nombre y apellidos del propietario. Con DNI el segundo apellido es obligatorio.Campos:
- Conductor habitual
- ¿El conductor habitual es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
driver.same_as_holder - 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). Con DNI el segundo apellido es obligatorio.Campos:
driver.namedriver.surnamedriver.surname2 - Tipo y número de documento del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
driver.document_typedriver.document_id - 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). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
driver.nationality - 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).Campos:
driver.birth_date - Sexo del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: Hombre [Male] · Mujer [Female].Campos:
driver.gender - Estado civil del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
driver.marital_status - Tipo de carnet del conductor, fecha en que lo sacó y si lo sacó en España. Respuestas: B (turismo) [B] · C1 [C1] · C [C]. País: se envía "ESP". Con un carnet de fuera de España no se puede cotizar por aquí.Campos:
driver.driving_license_typedriver.driving_license_datedriver.driving_license_country - ¿Tiene o ha tenido un seguro de coche a su nombre? Respuestas: Sí [true] · No [false].Campos:
driver.previously_insured - 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. Compañía: código de /api/agent/catalogo?tipo=car-insurance-companies. Si es el mismo vehículo, repite su matrícula.Campos:
driver.previous_company_codedriver.previous_policy_numberdriver.previous_plate - 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. 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.Campos:
driver.total_years_insureddriver.years_in_previous_companydriver.years_without_accidentsdriver.last_five_years_accidents - ¿Cuántas multas de tráfico ha tenido en los últimos 3 años? Respuestas: Ninguna [0] · 1 [1] · 2 [2] · 3 [3] · 4 [4] · 5 [5] · Más de 5 [6].Campos:
driver.penalties - Esa multa, ¿fue sólo de aparcamiento? Sólo si ha tenido exactamente una multa. Respuestas: Sí [true] · No [false].Campos:
driver.parking_fine_only - ¿Ha perdido puntos del carnet en el último año? Respuestas: Sí [true] · No [false].Campos:
driver.points_lost
- ¿El conductor habitual es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
- Titular del seguro
- Nombre y apellidos del titular. Con DNI el segundo apellido es obligatorio.Campos:
holder.nameholder.surnameholder.surname2 - Tipo y número de documento del titular. Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
holder.document_typeholder.document_id - Nacionalidad del titular. Sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
holder.nationality - Fecha de nacimiento del titular.Campos:
holder.birth_date - Sexo del titular. Respuestas: Hombre [Male] · Mujer [Female].Campos:
holder.gender - Estado civil del titular. Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
holder.marital_status - Situación laboral del titular. Respuestas: Trabaja por cuenta ajena [Employee] · Autónomo/a [SelfEmployed] · Funcionario/a [CivilServant] · Jubilado/a [Retired] · Estudiante [Student] · En paro [Unemployed] · Labores del hogar [HomeWorker].Campos:
holder.employment_status - Profesión del titular. Sólo si trabaja (por cuenta ajena, autónomo o funcionario). Se envía el código de 4 dígitos: búscalo en /api/agent/catalogo?tipo=economic-occupationsCampos:
holder.economic_occupation - Móvil y correo electrónico del titular. Móvil español (empieza por 6 o 7). Al correo le llegan los precios y el enlace para contratar.Campos:
holder.phoneholder.email - Dirección del titular: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número. 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-typesCampos:
holder.address.postal_codeholder.address.road_typeholder.address.road_nameholder.address.road_numberholder.address.town_id
- Nombre y apellidos del titular. Con DNI el segundo apellido es obligatorio.Campos:
- Cuándo empieza
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
effective_date
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
Seguro de moto
Formulario con todo en una página: /cotizar?tipo=moto&modo=formulario · En JSON: /api/agent/requisitos?ramo=moto
- La moto
- Matrícula de la moto. Con la matrícula se deduce el modelo y la fecha de matriculación si corresponde a una sola moto.Campos:
vehicle.registration_plate - 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. Búscala en /api/agent/catalogo?tipo=vehicle-brands&ramo=moto → vehicle-models → vehicle-versions y envía vehicle.code.Campos:
vehicle.code - Fecha de primera matriculación. Sólo si no hay matrícula o no se puede deducir de ella.Campos:
vehicle.registration_date - Fecha de compra. No puede ser anterior a la matriculación.Campos:
vehicle.purchase_date - Código postal (y municipio) donde circula normalmente. El municipio se deduce si el código postal sólo tiene uno; si no, /api/agent/catalogo?tipo=towns&codigo_postal=…Campos:
vehicle.circulation_postal_codevehicle.circulation_town_id - ¿Dónde duerme la moto? Respuestas: Garaje privado (propio o alquilado, cerrado) [PrivateGarage] · Garaje o aparcamiento comunitario [CommunalParking] · En la calle [NoGarage].Campos:
vehicle.garage_type_id - Kilómetros al año, aproximadamente. Número entero.Campos:
vehicle.kilometers_per_year - ¿El propietario de la moto es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
owner_same_as_holder
- Matrícula de la moto. Con la matrícula se deduce el modelo y la fecha de matriculación si corresponde a una sola moto.Campos:
- Propietario de la moto — sólo si el propietario NO es el titular del seguro
- Nombre y apellidos del propietario. Con DNI el segundo apellido es obligatorio.Campos:
owner.nameowner.surnameowner.surname2 - Tipo y número de documento del propietario. Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
owner.document_typeowner.document_id - Nacionalidad del propietario. Sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
owner.nationality - Fecha de nacimiento del propietario.Campos:
owner.birth_date - Sexo del propietario. Respuestas: Hombre [Male] · Mujer [Female].Campos:
owner.gender - Estado civil del propietario. Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
owner.marital_status
- Nombre y apellidos del propietario. Con DNI el segundo apellido es obligatorio.Campos:
- Conductor habitual
- ¿El conductor habitual es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
driver.same_as_holder - 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). Con DNI el segundo apellido es obligatorio.Campos:
driver.namedriver.surnamedriver.surname2 - Tipo y número de documento del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
driver.document_typedriver.document_id - 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). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
driver.nationality - 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).Campos:
driver.birth_date - Sexo del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: Hombre [Male] · Mujer [Female].Campos:
driver.gender - Estado civil del conductor habitual. Sólo si el conductor habitual NO es el titular (si lo es, no se envían sus datos). Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
driver.marital_status - Tipo de carnet de moto y fecha en que lo sacó. Respuestas: AM [AM] · A1 [A1] · A2 [A2] · A [A] · B (con 3 años, motos de hasta 125 cc) [B] · Licencia de ciclomotor (LCM) [LCM]. 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.Campos:
driver.driving_license_typedriver.driving_license_date - ¿Dónde se sacó el carnet? Respuestas: España [Spain] · Otro país de la UE [RestEU] · Fuera de la UE [RestWorld].Campos:
driver.driving_license_issuing_zone_id - ¿Qué experiencia tiene con motos? Respuestas: Ninguna [NoExperience] · Ya conduce esta moto [ThisMotorcycle] · Ha conducido otra moto [OtherMotorcycle].Campos:
driver.driving_experience_id - ¿Qué moto conducía? Sólo si ha conducido otra moto. Búscala en /api/agent/catalogo?tipo=vehicle-brands&ramo=moto → vehicle-models → vehicle-versions y envía su código.Campos:
driver.previous_motorcycle_code - ¿Tiene también carnet de coche? ¿Desde cuándo? Respuestas: Sí [true] · No [false]. La fecha sólo si tiene carnet de coche.Campos:
driver.has_car_licensedriver.car_license_date - ¿Tiene o ha tenido un seguro de moto a su nombre? Respuestas: Sí [true] · No [false].Campos:
driver.previously_insured - 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. Compañía: código de /api/agent/catalogo?tipo=motorcycle-insurance-companies. Si es el mismo vehículo, repite su matrícula.Campos:
driver.previous_company_codedriver.previous_policy_numberdriver.previous_plate - 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. 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.Campos:
driver.total_years_insureddriver.years_in_previous_companydriver.years_without_accidentsdriver.last_five_years_accidents - Multas en los últimos 3 años y si ha perdido puntos en el último año (opcional). Multas: "0" a "5", o "6" si son más de cinco.Campos:
driver.penaltiesdriver.points_lost
- ¿El conductor habitual es el titular del seguro? Respuestas: Sí [true] · No, es otra persona [false].Campos:
- Titular del seguro
- Nombre y apellidos del titular. Con DNI el segundo apellido es obligatorio.Campos:
holder.nameholder.surnameholder.surname2 - Tipo y número de documento del titular. Respuestas: DNI [Dni] · NIE [Nie] · Pasaporte [Passport]. DNI: 8 números y letra. NIE: X, Y o Z + 7 números + letra. No se cotiza a empresas (CIF).Campos:
holder.document_typeholder.document_id - Nacionalidad del titular. Sólo si el documento es NIE o pasaporte (con DNI es española y no se pregunta). Código de país de 3 letras (FRA, ROU, MAR…). Catálogo: /api/agent/catalogo?tipo=nationalitiesCampos:
holder.nationality - Fecha de nacimiento del titular.Campos:
holder.birth_date - Sexo del titular. Respuestas: Hombre [Male] · Mujer [Female].Campos:
holder.gender - Estado civil del titular. Respuestas: Soltero/a [Single] · Casado/a [Married] · Pareja de hecho [UnmarriedPartner] · Divorciado/a [Divorced] · Viudo/a [Widowed].Campos:
holder.marital_status - Situación laboral del titular. Respuestas: Trabaja por cuenta ajena [Employee] · Autónomo/a [SelfEmployed] · Funcionario/a [CivilServant] · Jubilado/a [Retired] · Estudiante [Student] · En paro [Unemployed] · Labores del hogar [HomeWorker].Campos:
holder.employment_status - Profesión del titular. Sólo si trabaja (por cuenta ajena, autónomo o funcionario). Se envía el código de 4 dígitos: búscalo en /api/agent/catalogo?tipo=economic-occupationsCampos:
holder.economic_occupation - Móvil y correo electrónico del titular. Móvil español (empieza por 6 o 7). Al correo le llegan los precios y el enlace para contratar.Campos:
holder.phoneholder.email - Dirección del titular: código postal, tipo de vía (calle, avenida, plaza…), nombre de la vía y número. 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-typesCampos:
holder.address.postal_codeholder.address.road_typeholder.address.road_nameholder.address.road_numberholder.address.town_id
- Nombre y apellidos del titular. Con DNI el segundo apellido es obligatorio.Campos:
- Cuándo empieza
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
effective_date
- ¿Desde qué fecha quiere el seguro? Hoy o una fecha futura.Campos:
Tres formas de cotizar
1. Formulario en una sola página (si manejas un navegador). Abre /cotizar?tipo=auto&modo=formulario (o tipo=hogar, tipo=moto): todas las preguntas aparecen juntas. Rellénalas con lo que te diga la persona y deja que ella pulse «Comparar precios».
2. API sin registro. Consulta los datos necesarios en GET /api/agent/requisitos?ramo=coche, los valores válidos en GET /api/agent/catalogo?tipo=… y cotiza con POST /api/agent/cotizaciones. Si falta o sobra algo, recibes todos los errores a la vez. Descripción completa: /api/agent/openapi.json.
3. Servidor MCP en https://seguromatch.com/api/agent/mcp (Streamable HTTP, sin login), con las herramientas seguromatch_requisitos, seguromatch_catalogo y seguromatch_cotizar_hogar / _coche / _moto.
Reglas
- Pregunta a la persona todos los datos de una vez. No inventes ni supongas ninguno.
- Antes de enviar sus datos, dile que los compartes con Seguro Match para calcular su seguro. Detalle en la política de privacidad.
- Tú no contratas. La persona recibe en su correo los precios y un enlace para revisarlos y contratar; confirma la compra en seguromatch.com con un código que le llega por SMS.
- Hay límites de uso por origen y diarios. Si los alcanzas, la respuesta lo dice y trae
Retry-After.
Datos para cotizar Hogar
En JSON: /api/agent/requisitos?ramo=hogar · Formulario: una sola página
| Campo | ¿Obligatorio? | Qué es y formato |
|---|---|---|
insurance_line | Sí | Ramo a cotizar. Formato: Home, Car o Motorcycle. Valores: Home, Car, Motorcycle, TermLife, Burial. |
effective_date | Sí | 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). |
client_reference | Opcional | Tu referencia interna. Se devuelve en la respuesta y en los webhooks. No es una clave de idempotencia. Formato: texto de hasta 100 caracteres. |
holder.document_type | Sí | 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. |
holder.document_id | Sí | 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. |
holder.name | Sí | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
holder.surname | Sí | Primer apellido. Formato: texto, solo letras. |
holder.surname2 | Opcional | Segundo apellido. EXCEPCIÓN documentada: en Hogar, con DNI y sin segundo apellido, se duplica el primero. Formato: texto, solo letras. |
holder.birth_date | Sí | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
holder.gender | Sí | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
holder.marital_status | Sí | 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. |
holder.nationality | Solo con `holder.document_type` = Nie o Passport | 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. 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. |
holder.employment_status | Sí | Situación laboral. No se asume "Employee". Formato: un valor del catálogo employment-statuses. Valores: Employee, SelfEmployed, CivilServant, Retired, Student, Unemployed, HomeWorker. |
holder.economic_occupation | Sí | Profesión, código CNO-11 de 4 dígitos. No se asume 2612. En Hogar es obligatoria siempre: para una persona inactiva, la última profesión ejercida. Formato: 4 dígitos, en texto, del catálogo economic-occupations. |
holder.phone | Sí | Móvil español del tomador. Formato: 9 dígitos empezando por 6 o 7; se admiten +34 y 0034. |
holder.email | Sí | 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. |
holder.address_same_as_risk | Opcional | true = el tomador vive en la vivienda asegurada: se usa la dirección de `risk.address`. Ya no se copia en silencio. Si lo mandas a true, no envíes `holder.address`. Formato: true o false. |
holder.address.postal_code | Sí | Código postal español. Formato: 5 dígitos, en texto. |
holder.address.town_id | Opcional | 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. |
holder.address.road_type | Sí | 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. |
holder.address.road_name | Sí | Nombre de la vía. No se inventa "Principal". Formato: texto. |
holder.address.road_number | Sí | 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"). |
risk.area_m2 | Sí | Superficie construida en m². No se asume 80. Formato: número entre 10 y 2000. |
risk.year_built | Sí | Año de construcción. No se asume 2000. Formato: año completo, no futuro. |
risk.last_reform_year | Sí | Año de la última reforma, o null para declarar que NO se ha reformado. Omitirlo ya no significa "no reformada". Formato: año entre 1900 y el actual, o null. |
risk.rooms | Sí | Número de habitaciones. No se asume 3. Formato: entero entre 1 y 50. |
risk.use | Sí | Régimen: propietario que la habita, propietario que la alquila, o inquilino. No se asume "Owner". Formato: Owner, Rental o Tenant. Valores: Owner, Rental, Tenant. |
risk.occupancy | Sí | Vivienda habitual o segunda residencia. No se asume "MainResidence". Formato: un valor del catálogo home-occupancies. Valores: MainResidence, SecondHome. |
risk.dwelling_type | Sí | Tipo de vivienda. No se asume "MiddleFloor". Formato: un valor del catálogo home-property-types. Valores: MiddleFloor, TopFloor, GroundFloor, DetachedHouse, TerracedHouse. |
risk.location | Sí | Ubicación. No se asume "CityCentre". Formato: un valor del catálogo home-locations. Valores: CityCentre, ResidentialDevelopment, Depopulated. |
risk.materials | Sí | Materiales de construcción. No se asume "NonCombustible". Formato: un valor del catálogo home-build-materials. Valores: NonCombustible, LessThan25Combustible, MoreThan25Combustible. |
risk.build_quality | Sí | Calidad de construcción. No se asume "Normal". Formato: un valor del catálogo home-build-qualities. Valores: Basic, Normal, High, Luxury. |
risk.alarm | Sí | Alarma. Declara NoAlarm explícitamente si no hay. Formato: un valor del catálogo home-alarm-types. Valores: NoAlarm, ConnectedAlarm, NonConnectedAlarm. |
risk.owner_is_holder | Sí | ¿El tomador ocupa el papel de propietario en la póliza? Ya no se asume: hay que mandarlo. Con false (un propietario distinto del tomador) el caso NO se puede cotizar por esta API. Inquilinos (`use: "Tenant"`) incluidos: mandan true, porque aquí «propietario» es el papel en la póliza, no la propiedad del inmueble. La plataforma declara al tomador en ese papel en los tres regímenes, igual que la web, y el casero de un inquilino no se envía a ninguna aseguradora. Formato: true, también con use "Tenant" (false se rechaza como caso no soportado). |
risk.buildings_limit | Sí | Capital de continente en euros. No se asume 125.000. Propietario y arrendador: mayor que 0. Un inquilino puede declarar 0. Formato: número ≥ 0. |
risk.contents_limit | Sí | Capital de contenido en euros. No se asume 20.000. 0 es un valor válido y se respeta. Formato: número ≥ 0. |
risk.settlement_type | Sí | Tipo de indemnización. No se asume "ReplacementValue". Formato: un valor del catálogo home-settlement-types. Valores: ReplacementValue, FirstRisk. |
risk.security_main_door | Opcional | Puerta principal blindada o acorazada. Si no se envía, no se declara la medida (sin descuento). Formato: true o false. |
risk.security_windows | Opcional | Rejas o protección en ventanas. Si no se envía, no se declara la medida (sin descuento). Formato: true o false. |
risk.cadastral_reference | Opcional | Referencia catastral. Identifica el inmueble; no mueve la prima. Formato: texto de 14 a 20 caracteres. |
risk.address.postal_code | Sí | Código postal español. Formato: 5 dígitos, en texto. |
risk.address.town_id | Opcional | 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. |
risk.address.road_type | Sí | 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. |
risk.address.road_name | Sí | Nombre de la vía. No se inventa "Principal". Formato: texto. |
risk.address.road_number | Sí | 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"). |
Datos para cotizar Coche
En JSON: /api/agent/requisitos?ramo=coche · Formulario: una sola página
| Campo | ¿Obligatorio? | Qué es y formato |
|---|---|---|
insurance_line | Sí | Ramo a cotizar. Formato: Home, Car o Motorcycle. Valores: Home, Car, Motorcycle, TermLife, Burial. |
effective_date | Sí | 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). |
client_reference | Opcional | Tu referencia interna. Se devuelve en la respuesta y en los webhooks. No es una clave de idempotencia. Formato: texto de hasta 100 caracteres. |
owner_same_as_holder | Sí | ¿El propietario del vehículo es el tomador? Ya no se asume que sí. Con false hay que enviar `owner`. Formato: true o false. |
holder.document_type | Sí | 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. |
holder.document_id | Sí | 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. |
holder.name | Sí | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
holder.surname | Sí | Primer apellido. Formato: texto, solo letras. |
holder.surname2 | Solo con `holder.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
holder.birth_date | Sí | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
holder.gender | Sí | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
holder.marital_status | Sí | 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. |
holder.nationality | Solo con `holder.document_type` = Nie o Passport | 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. 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. |
holder.employment_status | Sí | Situación laboral. No se asume "Employee". Formato: un valor del catálogo employment-statuses. Valores: Employee, SelfEmployed, CivilServant, Retired, Student, Unemployed, HomeWorker. |
holder.economic_occupation | Solo con `holder.employment_status` en activo (Employee, SelfEmployed o CivilServant) | 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. |
holder.phone | Sí | Móvil español del tomador. Formato: 9 dígitos empezando por 6 o 7; se admiten +34 y 0034. |
holder.email | Sí | 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. |
holder.address.postal_code | Sí | Código postal español. Formato: 5 dígitos, en texto. |
holder.address.town_id | Opcional | 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. |
holder.address.road_type | Sí | 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. |
holder.address.road_name | Sí | Nombre de la vía. No se inventa "Principal". Formato: texto. |
holder.address.road_number | Sí | 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"). |
vehicle.registration_plate | Opcional | 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). |
vehicle.brand_id | Opcional | Marca (catálogo vehicle-brands). Formato: id del catálogo. |
vehicle.model_id | Opcional | Modelo (catálogo vehicle-models). Formato: id del catálogo. |
vehicle.version_id | Opcional | 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. |
vehicle.brand_name | Opcional | Nombre de la marca (solo informativo). Formato: texto. |
vehicle.model_name | Opcional | Nombre del modelo (solo informativo). Formato: texto. |
vehicle.version_name | Opcional | Nombre de la versión (solo informativo). Formato: texto. |
vehicle.registration_date | Opcional | 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. |
vehicle.purchase_type | Sí | 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. |
vehicle.purchase_date | Solo salvo con `vehicle.purchase_type: "planned"` | 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. |
vehicle.use | Sí | 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. |
vehicle.annual_km | Sí | Kilómetros anuales. No se asume "UpTo15000km". Formato: un valor del catálogo annual-km-options. Valores: UpTo5000km, UpTo10000km, UpTo15000km, UpTo20000km, UpTo25000km, UpTo30000km, MoreThan30000km. |
vehicle.parking_type | Sí | 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. |
vehicle.fuel_type | Opcional | 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. |
vehicle.retail_price | Opcional | Precio de venta al público, en euros. Formato: número > 0. |
driver.same_as_holder | Sí | ¿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. |
driver.document_type | Solo con `driver.same_as_holder: false` | 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. |
driver.document_id | Solo con `driver.same_as_holder: false` | 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. |
driver.name | Solo con `driver.same_as_holder: false` | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
driver.surname | Solo con `driver.same_as_holder: false` | Primer apellido. Formato: texto, solo letras. |
driver.surname2 | Solo con `driver.same_as_holder: false` y `driver.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
driver.birth_date | Solo con `driver.same_as_holder: false` | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
driver.gender | Solo con `driver.same_as_holder: false` | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
driver.marital_status | Solo con `driver.same_as_holder: false` | 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. |
driver.nationality | Solo con `driver.same_as_holder: false` y `driver.document_type` = Nie o Passport | 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. 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. |
driver.driving_license_type | Sí | Tipo de carnet. No se asume "B". Formato: un valor del catálogo driving-license-types. Valores: B, C1, C. |
driver.driving_license_date | Sí | Fecha de expedición del carnet. Ya no se asume "hace 5 años". Formato: fecha YYYY-MM-DD, no futura. |
driver.driving_license_country | Sí | 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. |
driver.previously_insured | Sí | ¿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. |
driver.previous_company_code | Solo con `driver.previously_insured: true` | Aseguradora anterior. Los códigos de coche y de moto son catálogos distintos. Formato: código del catálogo car-insurance-companies. |
driver.previous_policy_number | Solo con `driver.previously_insured: true` | Número de la póliza anterior. Formato: texto de al menos 5 caracteres. |
driver.previous_plate | Solo con `driver.previously_insured: true` | 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. |
driver.total_years_insured | Solo con `driver.previously_insured: true` | Años totales asegurado. Con `previously_insured: false` no se envía, o se envía 0. Formato: entero ≥ 0. |
driver.years_in_previous_company | Solo con `driver.previously_insured: true` | 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. |
driver.years_without_accidents | Solo con `driver.previously_insured: true` | Años sin siniestros con culpa. Con `previously_insured: false` no se envía, o se envía 0. Formato: entero ≥ 0. |
driver.last_five_years_accidents | Solo con `driver.previously_insured: true` | 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. |
driver.penalties | Sí | 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. |
driver.parking_fine_only | Solo con `driver.penalties: "1"` | Con UNA sola multa: ¿fue solo de aparcamiento? Una aseguradora lo distingue. Formato: true o false. |
driver.points_lost | Sí | ¿Perdió puntos del carnet el último año? Es una declaración del conductor: ya no se omite. Formato: true o false. |
owner.document_type | Solo con `owner_same_as_holder: false` | 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. |
owner.document_id | Solo con `owner_same_as_holder: false` | 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. |
owner.name | Solo con `owner_same_as_holder: false` | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
owner.surname | Solo con `owner_same_as_holder: false` | Primer apellido. Formato: texto, solo letras. |
owner.surname2 | Solo con `owner_same_as_holder: false` y `owner.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
owner.birth_date | Solo con `owner_same_as_holder: false` | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
owner.gender | Solo con `owner_same_as_holder: false` | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
owner.marital_status | Solo con `owner_same_as_holder: false` | 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. |
owner.nationality | Solo con `owner_same_as_holder: false` y `owner.document_type` = Nie o Passport | 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. 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. |
Datos para cotizar Moto
En JSON: /api/agent/requisitos?ramo=moto · Formulario: una sola página
| Campo | ¿Obligatorio? | Qué es y formato |
|---|---|---|
insurance_line | Sí | Ramo a cotizar. Formato: Home, Car o Motorcycle. Valores: Home, Car, Motorcycle, TermLife, Burial. |
effective_date | Sí | 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). |
client_reference | Opcional | Tu referencia interna. Se devuelve en la respuesta y en los webhooks. No es una clave de idempotencia. Formato: texto de hasta 100 caracteres. |
owner_same_as_holder | Sí | ¿El propietario del vehículo es el tomador? Ya no se asume que sí. Con false hay que enviar `owner`. Formato: true o false. |
holder.document_type | Sí | 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. |
holder.document_id | Sí | 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. |
holder.name | Sí | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
holder.surname | Sí | Primer apellido. Formato: texto, solo letras. |
holder.surname2 | Solo con `holder.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
holder.birth_date | Sí | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
holder.gender | Sí | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
holder.marital_status | Sí | 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. |
holder.nationality | Solo con `holder.document_type` = Nie o Passport | 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. 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. |
holder.employment_status | Sí | Situación laboral. No se asume "Employee". Formato: un valor del catálogo employment-statuses. Valores: Employee, SelfEmployed, CivilServant, Retired, Student, Unemployed, HomeWorker. |
holder.economic_occupation | Solo con `holder.employment_status` en activo (Employee, SelfEmployed o CivilServant) | 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. |
holder.phone | Sí | Móvil español del tomador. Formato: 9 dígitos empezando por 6 o 7; se admiten +34 y 0034. |
holder.email | Sí | 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. |
holder.address.postal_code | Sí | Código postal español. Formato: 5 dígitos, en texto. |
holder.address.town_id | Opcional | 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. |
holder.address.road_type | Sí | 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. |
holder.address.road_name | Sí | Nombre de la vía. No se inventa "Principal". Formato: texto. |
holder.address.road_number | Sí | 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"). |
vehicle.code | Opcional | 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. |
vehicle.registration_plate | Opcional | Matrícula española. Se valida siempre que se envía. Formato: matrícula española. |
vehicle.registration_date | Opcional | Primera matriculación. Solo se deduce de la matrícula; si no se puede, es obligatoria. Formato: fecha YYYY-MM-DD, no futura. |
vehicle.purchase_date | Sí | 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. |
vehicle.circulation_postal_code | Sí | 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. |
vehicle.circulation_town_id | Opcional | Municipio de circulación. Solo se deduce si el código postal tiene un único municipio. Formato: entero del catálogo towns. |
vehicle.garage_type_id | Sí | Dónde duerme la moto. Determina la prima. Formato: un valor del catálogo motorcycle-garage-types. Valores: PrivateGarage, CommunalParking, NoGarage. |
vehicle.kilometers_per_year | Sí | Kilómetros al año. Formato: entero > 0. |
driver.same_as_holder | Sí | ¿El conductor habitual es el tomador? Ya no se asume que sí. Formato: true o false. |
driver.document_type | Solo con `driver.same_as_holder: false` | 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. |
driver.document_id | Solo con `driver.same_as_holder: false` | 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. |
driver.name | Solo con `driver.same_as_holder: false` | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
driver.surname | Solo con `driver.same_as_holder: false` | Primer apellido. Formato: texto, solo letras. |
driver.surname2 | Solo con `driver.same_as_holder: false` y `driver.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
driver.birth_date | Solo con `driver.same_as_holder: false` | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
driver.gender | Solo con `driver.same_as_holder: false` | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
driver.marital_status | Solo con `driver.same_as_holder: false` | 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. |
driver.nationality | Solo con `driver.same_as_holder: false` y `driver.document_type` = Nie o Passport | 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. 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. |
driver.driving_license_type | Sí | Tipo de carnet de moto. Formato: un valor del catálogo motorcycle-driving-license-types. Valores: AM, A1, A2, A, B, LCM. |
driver.driving_license_date | Sí | Fecha de expedición del carnet de moto. Formato: fecha YYYY-MM-DD, no futura. |
driver.driving_license_issuing_zone_id | Sí | Zona de expedición del carnet. Ya no se asume España. Formato: Spain, RestEU o RestWorld. Valores: Spain, RestEU, RestWorld. |
driver.driving_experience_id | Sí | Experiencia conduciendo motos. Formato: un valor del catálogo motorcycle-driving-experience. Valores: NoExperience, ThisMotorcycle, OtherMotorcycle. |
driver.previous_motorcycle_code | Solo con `driver.driving_experience_id: "OtherMotorcycle"` | Versión de la moto anterior. Formato: id del catálogo vehicle-versions. |
driver.has_car_license | Opcional | ¿Tiene además carnet de coche? No se asume. Formato: true o false. |
driver.car_license_date | Solo con `driver.has_car_license: true` | Fecha del carnet de coche. Formato: fecha YYYY-MM-DD, no futura. |
driver.previously_insured | Sí | ¿Tiene o ha tenido un seguro de moto a su nombre? Ya no se asume que no. Formato: true o false. |
driver.previous_company_code | Solo con `driver.previously_insured: true` | Aseguradora anterior. Los códigos de coche y de moto son catálogos distintos. Formato: código del catálogo motorcycle-insurance-companies. |
driver.previous_policy_number | Solo con `driver.previously_insured: true` | Número de la póliza anterior. Formato: texto de al menos 5 caracteres. |
driver.previous_plate | Solo con `driver.previously_insured: true` | 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. |
driver.total_years_insured | Solo con `driver.previously_insured: true` | Años totales asegurado. Con `previously_insured: false` no se envía, o se envía 0. Formato: entero ≥ 0. |
driver.years_in_previous_company | Solo con `driver.previously_insured: true` | 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. |
driver.years_without_accidents | Solo con `driver.previously_insured: true` | Años sin siniestros con culpa. Con `previously_insured: false` no se envía, o se envía 0. Formato: entero ≥ 0. |
driver.last_five_years_accidents | Solo con `driver.previously_insured: true` | 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. |
driver.penalties | Opcional | 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. |
driver.points_lost | Opcional | ¿Perdió puntos el último año? Hoy no lo consume ninguna aseguradora de moto. Formato: true o false. |
owner.document_type | Solo con `owner_same_as_holder: false` | 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. |
owner.document_id | Solo con `owner_same_as_holder: false` | 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. |
owner.name | Solo con `owner_same_as_holder: false` | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
owner.surname | Solo con `owner_same_as_holder: false` | Primer apellido. Formato: texto, solo letras. |
owner.surname2 | Solo con `owner_same_as_holder: false` y `owner.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
owner.birth_date | Solo con `owner_same_as_holder: false` | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
owner.gender | Solo con `owner_same_as_holder: false` | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
owner.marital_status | Solo con `owner_same_as_holder: false` | 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. |
owner.nationality | Solo con `owner_same_as_holder: false` y `owner.document_type` = Nie o Passport | 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. 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. |