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. En esta API de partners, la letra de control del DNI y del NIE tiene que cuadrar con el número (se rechaza con VALIDATION_INVALID_DNI); el pasaporte no se valida con letra. Formato: DNI: 8 dígitos + letra de control · NIE: X/Y/Z + 7 dígitos + letra de control · 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
holder.has_driving_license | Opcional | Sólo si el tomador NO es el conductor habitual: ¿tiene carnet de conducir? Tuio lo exige del tomador; sin respuesta, Tuio no cotiza. Formato: true o false. |
holder.driving_license_country | Opcional | Con `has_driving_license: true`: país de expedición del carnet del tomador (ISO-3). Formato: un valor 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
holder.driving_license_date | Opcional | Con `has_driving_license: true`: cuándo sacó el carnet el tomador por primera vez. Formato: fecha YYYY-MM-DD, no futura. |
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, Extramuros, Parque, Lugar, Diseminado, Ferrocarril, Cuesta, Jardines, Ramal, Puente, Autopista, Escalinata, Canada, Campo, Poblado, Partida, Prolongacion. |
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. En esta API de partners, la letra de control del DNI y del NIE tiene que cuadrar con el número (se rechaza con VALIDATION_INVALID_DNI); el pasaporte no se valida con letra. Formato: DNI: 8 dígitos + letra de control · NIE: X/Y/Z + 7 dígitos + letra de control · 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
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), el del carnet que usa hoy: si lo canjeó por uno español, ESP. Cada aseguradora lo recibe traducido a su clase (España, UE/EEE, resto); Caser, que no tiene campo para él, no cotiza con un carnet de fuera de la UE/EEE. Formato: un valor 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
driver.resides_in_spain | Opcional | Con carnet NO español: ¿vive habitualmente en España? Un carnet de fuera de la UE/EEE vale 6 meses desde que vive aquí (o desde que llegó, si no vive aquí). Formato: true o false. |
driver.resident_since | Opcional | Con carnet de fuera de la UE/EEE y `resides_in_spain: true`: desde cuándo vive en España. Con más de 6 meses a la fecha de efecto, la emisión la revisa una persona. Formato: fecha YYYY-MM-DD, no futura. |
driver.arrival_date | Opcional | Con carnet de fuera de la UE/EEE y `resides_in_spain: false`: cuándo llegó a España. Con más de 6 meses a la fecha de efecto, la emisión la revisa una persona. Formato: fecha YYYY-MM-DD, no futura. |
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_status | Opcional | ¿La póliza anterior sigue en vigor? active = sí; expired_recent = venció hace menos de 2 meses; expired_old = hace más. Sin él se trata como en vigor. Formato: active, expired_recent o expired_old. Valores: active, expired_recent, expired_old. |
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. |
driver.policyholder_relationship | Opcional | Qué es esta persona del tomador: Spouse (cónyuge), CivilPartner (pareja de hecho registrada), Partner (pareja), Parent (su padre o madre), Child (su hijo o hija), Sibling (su hermano o hermana) u Other. Si no se envía, las aseguradoras que la piden reciben «Partner» (pareja), como hasta ahora. Formato: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. Valores: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. |
driver.last_at_fault_claim_date | Opcional | Fecha del último siniestro con culpa. Tiene que cuadrar con `last_five_years_accidents`: dentro de los últimos cinco años si declaras alguno, anterior si declaras 0. Si no se envía, no se declara. Formato: fecha YYYY-MM-DD, no futura. |
driver.address.postal_code | Solo con el bloque `driver.address` | Código postal español de esta dirección. Formato: 5 dígitos, en texto. |
driver.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. Un `town_id` que no es de ese código postal se rechaza. Formato: entero del catálogo towns. |
driver.address.road_type | Opcional | Tipo de vía. Opcional: sin él, cada aseguradora usa su valor por defecto («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, Extramuros, Parque, Lugar, Diseminado, Ferrocarril, Cuesta, Jardines, Ramal, Puente, Autopista, Escalinata, Canada, Campo, Poblado, Partida, Prolongacion. |
driver.address.road_name | Solo con otro dato de la calle (`road_type`, `road_name` y `road_number` van juntos) | Nombre de la vía. No se inventa "Principal". Formato: texto. |
driver.address.road_number | Solo con otro dato de la calle (`road_type`, `road_name` y `road_number` van juntos) | 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"). |
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. En esta API de partners, la letra de control del DNI y del NIE tiene que cuadrar con el número (se rechaza con VALIDATION_INVALID_DNI); el pasaporte no se valida con letra. Formato: DNI: 8 dígitos + letra de control · NIE: X/Y/Z + 7 dígitos + letra de control · 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
owner.policyholder_relationship | Opcional | Qué es esta persona del tomador: Spouse (cónyuge), CivilPartner (pareja de hecho registrada), Partner (pareja), Parent (su padre o madre), Child (su hijo o hija), Sibling (su hermano o hermana) u Other. Si no se envía, las aseguradoras que la piden reciben «Partner» (pareja), como hasta ahora. Formato: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. Valores: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. |
owner.address.postal_code | Opcional | Código postal español de esta dirección. Formato: 5 dígitos, en texto. |
owner.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. Un `town_id` que no es de ese código postal se rechaza. Formato: entero del catálogo towns. |
owner.address.road_type | Opcional | 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, Extramuros, Parque, Lugar, Diseminado, Ferrocarril, Cuesta, Jardines, Ramal, Puente, Autopista, Escalinata, Canada, Campo, Poblado, Partida, Prolongacion. |
owner.address.road_name | Opcional | Nombre de la vía. No se inventa "Principal". Formato: texto. |
owner.address.road_number | Opcional | 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"). |
secondary_driver.document_type | Solo con el bloque `secondary_driver` | 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. |
secondary_driver.document_id | Solo con el bloque `secondary_driver` | Número del documento. Su formato debe corresponder al tipo declarado. En esta API de partners, la letra de control del DNI y del NIE tiene que cuadrar con el número (se rechaza con VALIDATION_INVALID_DNI); el pasaporte no se valida con letra. Formato: DNI: 8 dígitos + letra de control · NIE: X/Y/Z + 7 dígitos + letra de control · Pasaporte: mínimo 5 caracteres. |
secondary_driver.name | Solo con el bloque `secondary_driver` | Nombre, tal como figura en el documento. Formato: texto, solo letras. |
secondary_driver.surname | Solo con el bloque `secondary_driver` | Primer apellido. Formato: texto, solo letras. |
secondary_driver.surname2 | Solo con el bloque `secondary_driver` y `secondary_driver.document_type: "Dni"` | Segundo apellido. Obligatorio con DNI. Formato: texto, solo letras. |
secondary_driver.birth_date | Solo con el bloque `secondary_driver` | Fecha de nacimiento. Formato: fecha YYYY-MM-DD, no futura. |
secondary_driver.gender | Solo con el bloque `secondary_driver` | Sexo. No se asume "Male". Formato: Male o Female. Valores: Male, Female. |
secondary_driver.marital_status | Solo con el bloque `secondary_driver` | 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. |
secondary_driver.nationality | Solo con el bloque `secondary_driver` y `secondary_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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
secondary_driver.driving_license_type | Solo con el bloque `secondary_driver` | Tipo de carnet del conductor adicional. Formato: un valor del catálogo driving-license-types. Valores: B, C1, C. |
secondary_driver.driving_license_date | Solo con el bloque `secondary_driver` | Fecha de expedición del carnet del conductor adicional. Su antigüedad cambia el precio. Formato: fecha YYYY-MM-DD, no futura. |
secondary_driver.driving_license_country | Solo con el bloque `secondary_driver` | País de expedición del carnet del conductor adicional (ISO-3), el del carnet que usa hoy: si lo canjeó por uno español, ESP. Cada aseguradora lo recibe traducido a su clase (España, UE/EEE, resto); Caser, que no tiene campo para él, no cotiza con un carnet de fuera de la UE/EEE. Formato: un valor 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, ISL, LIE, LUX, GRC, CZE, SVK, HUN, HRV, SVN, EST, LVA, LTU, CYP, MLT, AFG, ALB, AND, AGO, AIA, ATG, SAU, ARM, ABW, AZE, BHS, BGD, BRB, BHR, BLZ, BEN, BMU, BLR, MMR, BIH, BWA, BRN, BFA, BDI, BTN, CPV, KHM, CMR, QAT, TCD, VAT, COM, PRK, CIV, CUW, DMA, ARE, ERI, SWZ, ETH, FJI, GAB, GMB, GEO, GIB, GRD, GRL, GLP, GUM, GUF, GGY, GIN, GNQ, GNB, GUY, HTI, HKG, IDN, IRQ, IRN, IMN, CXR, NFK, ALA, CYM, CCK, COK, FRO, FLK, MNP, MHL, SLB, TCA, VGB, VIR, JAM, JEY, JOR, KAZ, KEN, KGZ, KIR, KWT, LAO, LSO, LBN, LBR, LBY, MAC, MKD, MDG, MYS, MWI, MDV, MLI, MTQ, MUS, MRT, MYT, FSM, MDA, MCO, MNG, MNE, MSR, MOZ, NAM, NRU, NPL, NER, NIU, NCL, OMN, PLW, PSE, PNG, PYF, PRI, CAF, COG, COD, REU, RWA, ESH, WSM, ASM, BLM, KNA, SMR, MAF, SPM, VCT, SHN, LCA, STP, SRB, SYC, SLE, SGP, SYR, SOM, LKA, SDN, SUR, SJM, THA, TWN, TZA, TJK, TLS, TGO, TKL, TON, TTO, TUN, TKM, TUV, UGA, UZB, VUT, VNM, WLF, YEM, DJI, ZMB, ZWE. |
secondary_driver.resides_in_spain | Opcional | Con carnet NO español: ¿vive habitualmente en España? Un carnet de fuera de la UE/EEE vale 6 meses desde que vive aquí (o desde que llegó, si no vive aquí). Formato: true o false. |
secondary_driver.resident_since | Opcional | Con carnet de fuera de la UE/EEE y `resides_in_spain: true`: desde cuándo vive en España. Con más de 6 meses a la fecha de efecto, la emisión la revisa una persona. Formato: fecha YYYY-MM-DD, no futura. |
secondary_driver.arrival_date | Opcional | Con carnet de fuera de la UE/EEE y `resides_in_spain: false`: cuándo llegó a España. Con más de 6 meses a la fecha de efecto, la emisión la revisa una persona. Formato: fecha YYYY-MM-DD, no futura. |
secondary_driver.policyholder_relationship | Opcional | Qué es esta persona del tomador: Spouse (cónyuge), CivilPartner (pareja de hecho registrada), Partner (pareja), Parent (su padre o madre), Child (su hijo o hija), Sibling (su hermano o hermana) u Other. Si no se envía, las aseguradoras que la piden reciben «Other» (otra relación), como hasta ahora. Formato: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. Valores: Spouse, CivilPartner, Partner, Parent, Child, Sibling, Other. |
secondary_driver.address.postal_code | Opcional | Código postal español de esta dirección. Formato: 5 dígitos, en texto. |
secondary_driver.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. Un `town_id` que no es de ese código postal se rechaza. Formato: entero del catálogo towns. |
secondary_driver.address.road_type | Opcional | Tipo de vía. Opcional: sin él, cada aseguradora usa su valor por defecto («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, Extramuros, Parque, Lugar, Diseminado, Ferrocarril, Cuesta, Jardines, Ramal, Puente, Autopista, Escalinata, Canada, Campo, Poblado, Partida, Prolongacion. |
secondary_driver.address.road_name | Opcional | Nombre de la vía. No se inventa "Principal". Formato: texto. |
secondary_driver.address.road_number | Opcional | 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"). |
