{"openapi":"3.1.0","info":{"title":"Importar Fácil API","version":"1.0.0","description":"Calcula el coste de importar a España un coche comprado en otro país de la Unión Europea, consulta su valor oficial en las tablas del BOE, explica los trámites y permite pedir presupuestos a importadores. Las cifras son estimaciones orientativas.","termsOfService":"https://importarfacil.es/legal/aviso-legal/"},"servers":[{"url":"https://importarfacil.es"}],"externalDocs":{"description":"Metodología y fuentes","url":"https://importarfacil.es/metodologia/"},"paths":{"/api/calcular":{"get":{"operationId":"calcular_coste_importacion","summary":"Calcular el coste de importar un coche a España","description":"Calcula cuánto cuesta en total comprar un coche de segunda mano o nuevo en otro país de la Unión Europea (Alemania, Francia, Bélgica, Países Bajos, Italia, Austria u otro) y matricularlo en España: impuesto de matriculación (IEDMT) por comunidad autónoma, IVA o ITP cuando corresponden, transporte, ITV de importación, tasa de la DGT, placas e impuesto de circulación. Devuelve el total, un rango y el desglose por concepto. Los impuestos se calculan con código, con los valores oficiales del BOE y los porcentajes de depreciación de Hacienda. Úsala cuando el usuario pregunte cuánto cuesta importar un coche concreto o si le compensa. Solo es obligatorio el precio; con fecha de primera matriculación, CO₂ (WLTP), marca y modelo el resultado es más preciso. Si falta el CO₂ de un coche de combustión, el total queda incompleto y lo indica. No cubre importaciones desde fuera de la UE ni motos.","x-openai-isConsequential":false,"parameters":[{"name":"precio_eur","in":"query","required":true,"description":"Precio del anuncio en euros, con el IVA del país de origen incluido.","schema":{"type":"number","exclusiveMinimum":0}},{"name":"pais_origen","in":"query","required":false,"description":"País donde se compra: código ISO de dos letras (DE, FR, BE, NL, IT, AT…) o nombre. Por defecto, Alemania.","schema":{"type":"string"}},{"name":"comunidad_autonoma","in":"query","required":false,"description":"Comunidad autónoma donde se matriculará. Valores: Andalucía, Aragón, Asturias, Illes Balears, Canarias, Cantabria, Castilla y León, Castilla-La Mancha, Cataluña, Comunidad Valenciana, Extremadura, Galicia, Comunidad de Madrid, Región de Murcia, Navarra, País Vasco, La Rioja, Ceuta, Melilla. Por defecto, Comunidad de Madrid.","schema":{"type":"string"}},{"name":"vendedor","in":"query","required":false,"description":"Quién vende el coche. Por defecto, profesional.","schema":{"type":"string","enum":["profesional","particular"]}},{"name":"primera_matriculacion","in":"query","required":false,"description":"Fecha de primera matriculación en formato AAAA-MM (o solo el año).","schema":{"type":"string","pattern":"^\\d{4}(-\\d{2})?"}},{"name":"kilometros","in":"query","required":false,"description":"Kilómetros del coche.","schema":{"type":"number","minimum":0}},{"name":"co2_g_km","in":"query","required":false,"description":"Emisiones de CO₂ en g/km (WLTP, ciclo combinado). Para un eléctrico, 0.","schema":{"type":"number","minimum":0}},{"name":"marca","in":"query","required":false,"description":"Marca del coche, p. ej. \"BMW\".","schema":{"type":"string"}},{"name":"modelo","in":"query","required":false,"description":"Modelo y versión tal como aparecen en el anuncio, p. ej. \"320d Touring M Sport\".","schema":{"type":"string"}},{"name":"combustible","in":"query","required":false,"description":"Combustible.","schema":{"type":"string","enum":["gasoline","diesel","hybrid","phev","electric","lpg"]}},{"name":"potencia_kw","in":"query","required":false,"description":"Potencia en kW. Ayuda a elegir la versión correcta.","schema":{"type":"number","minimum":0}},{"name":"potencia_cv","in":"query","required":false,"description":"Potencia en CV, si no se conoce en kW.","schema":{"type":"number","minimum":0}},{"name":"valor_boe_eur","in":"query","required":false,"description":"Valor de nuevo de la versión según las tablas del BOE, si ya se obtuvo con buscar_valor_boe. Si se indica, no se busca por marca y modelo.","schema":{"type":"number","minimum":0}},{"name":"iva_deducible","in":"query","required":false,"description":"Solo para coches nuevos a efectos fiscales (6 meses o menos, o 6.000 km o menos): si el vendedor descuenta el IVA de su país. Por defecto, sí.","schema":{"type":"boolean"}},{"name":"ex_alquiler","in":"query","required":false,"description":"Si el coche procede de una flota de alquiler o autoescuela (reduce la base del impuesto un 30 %). Por defecto, no.","schema":{"type":"boolean"}},{"name":"transporte","in":"query","required":false,"description":"Cómo llega a España. Por defecto, camión.","schema":{"type":"string","enum":["camion","conduciendo","ninguno"]}},{"name":"coste_transporte_eur","in":"query","required":false,"description":"Coste del transporte si el usuario ya tiene un presupuesto.","schema":{"type":"number","minimum":0}},{"name":"tiene_coc","in":"query","required":false,"description":"Si el coche tiene certificado de conformidad europeo (COC). Por defecto, sí.","schema":{"type":"boolean"}},{"name":"incluir_gestoria","in":"query","required":false,"description":"Si se añade el coste de una gestoría para los trámites. Por defecto, no.","schema":{"type":"boolean"}}],"responses":{"200":{"description":"Resultado.","content":{"application/json":{"schema":{"type":"object","properties":{"completo":{"type":"boolean","description":"false si falta algún dato imprescindible (normalmente el CO₂) y el total no incluye el impuesto de matriculación."},"total_eur":{"type":"number"},"total_min_eur":{"type":"number"},"total_max_eur":{"type":"number"},"precio_coche_eur":{"type":"number"},"impuestos_y_gastos_eur":{"type":"number"},"impuestos_eur":{"type":"number"},"gastos_eur":{"type":"number"},"es_nuevo_a_efectos_fiscales":{"type":"boolean"},"base_imponible_eur":{"type":["number","null"]},"origen_base_imponible":{"type":"string"},"depreciacion_pct":{"type":["number","null"]},"comunidad_autonoma":{"type":"string"},"desglose":{"type":"array","items":{"type":"object","properties":{"concepto":{"type":"string"},"importe_eur":{"type":"number"},"min_eur":{"type":"number"},"max_eur":{"type":"number"},"tipo":{"type":"string","enum":["impuesto","gasto"]},"nota":{"type":["string","null"]}},"required":["concepto","importe_eur","tipo"]}},"version_boe":{"anyOf":[{"type":"null"},{"type":"object","properties":{"marca":{"type":"string"},"version":{"type":"string"},"valor_nuevo_eur":{"type":"number"},"periodo":{"type":"string"},"combustible":{"type":"string"},"potencia_cv":{"type":["number","null"]}}}]},"alternativas_boe":{"type":"array","items":{"type":"object","properties":{"marca":{"type":"string"},"version":{"type":"string"},"valor_nuevo_eur":{"type":"number"},"periodo":{"type":"string"},"combustible":{"type":"string"},"potencia_cv":{"type":["number","null"]}}}},"supuestos":{"type":"array","items":{"type":"string"},"description":"Valores por defecto aplicados porque el usuario no los indicó."},"avisos":{"type":"array","items":{"type":"string"}},"notas":{"type":"array","items":{"type":"string"}},"enlace_calculo":{"type":"string","description":"Enlace a la calculadora web con estos mismos datos, editable."},"enlace_presupuesto":{"type":"string"},"fuentes":{"type":"array","items":{"type":"string"}},"aviso_legal":{"type":"string"}},"required":["completo","total_eur","total_min_eur","total_max_eur","desglose","enlace_calculo","aviso_legal"]}}}},"400":{"description":"Faltan datos o no son válidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/boe":{"get":{"operationId":"buscar_valor_boe","summary":"Buscar el valor oficial de un coche en las tablas del BOE","description":"Busca una marca y un modelo en las tablas de precios medios de venta que publica Hacienda en el BOE cada año y devuelve las versiones que coinciden, con su valor de nuevo, años de comercialización, combustible y potencia. Ese valor, depreciado por antigüedad, es la base del impuesto de matriculación de un coche usado. Úsala cuando haya varias versiones posibles de un modelo y haga falta que el usuario confirme la suya, o cuando pregunte por el valor fiscal de un coche. Las tablas solo incluyen turismos y todoterrenos.","x-openai-isConsequential":false,"parameters":[{"name":"marca","in":"query","required":true,"description":"Marca del coche, p. ej. \"BMW\".","schema":{"type":"string"}},{"name":"modelo","in":"query","required":true,"description":"Modelo y versión tal como aparecen en el anuncio, p. ej. \"320d Touring M Sport\".","schema":{"type":"string"}},{"name":"anio","in":"query","required":false,"description":"Año de primera matriculación, para descartar versiones de otros años.","schema":{"type":"number","minimum":1980,"maximum":2100}},{"name":"combustible","in":"query","required":false,"description":"Combustible.","schema":{"type":"string","enum":["gasoline","diesel","hybrid","phev","electric","lpg"]}},{"name":"potencia_kw","in":"query","required":false,"description":"Potencia en kW. Ayuda a elegir la versión correcta.","schema":{"type":"number","minimum":0}},{"name":"potencia_cv","in":"query","required":false,"description":"Potencia en CV, si no se conoce en kW.","schema":{"type":"number","minimum":0}}],"responses":{"200":{"description":"Resultado.","content":{"application/json":{"schema":{"type":"object","properties":{"encontrado":{"type":"boolean"},"coincidencia_fiable":{"type":"boolean"},"tabla":{"type":"string"},"versiones":{"type":"array","items":{"type":"object","properties":{"marca":{"type":"string"},"version":{"type":"string"},"valor_nuevo_eur":{"type":"number"},"periodo":{"type":"string"},"combustible":{"type":"string"},"potencia_cv":{"type":["number","null"]}}}},"mensaje":{"type":"string"}},"required":["encontrado","versiones","mensaje"]}}}},"400":{"description":"Faltan datos o no son válidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/tramites":{"get":{"operationId":"explicar_tramites","summary":"Explicar los trámites para importar un coche a España","description":"Devuelve la lista ordenada de pasos para comprar un coche en otro país de la Unión Europea y matricularlo en España (documentación, transporte, ITV de importación, modelo 576, IVA o ITP si corresponden, impuesto de circulación y DGT), adaptada al país, al tipo de vendedor y a si el coche tiene certificado de conformidad, con un enlace a la guía de cada paso. Úsala cuando el usuario pregunte qué tiene que hacer, qué documentos necesita o cuánto se tarda. Es información general, no asesoramiento fiscal ni legal.","x-openai-isConsequential":false,"parameters":[{"name":"pais_origen","in":"query","required":false,"description":"País donde se compra: código ISO de dos letras o nombre. Por defecto, Alemania.","schema":{"type":"string"}},{"name":"vendedor","in":"query","required":false,"description":"Quién vende el coche. Por defecto, profesional.","schema":{"type":"string","enum":["profesional","particular"]}},{"name":"es_nuevo_a_efectos_fiscales","in":"query","required":false,"description":"Si el coche tiene 6 meses o menos, o 6.000 km o menos. Por defecto, no.","schema":{"type":"boolean"}},{"name":"tiene_coc","in":"query","required":false,"description":"Si el coche tiene certificado de conformidad europeo (COC). Por defecto, sí.","schema":{"type":"boolean"}},{"name":"transporte","in":"query","required":false,"description":"Cómo llega a España. Por defecto, camión.","schema":{"type":"string","enum":["camion","conduciendo"]}}],"responses":{"200":{"description":"Resultado.","content":{"application/json":{"schema":{"type":"object","properties":{"pasos":{"type":"array","items":{"type":"object","properties":{"orden":{"type":"number"},"paso":{"type":"string"},"detalle":{"type":"string"},"enlace":{"type":"string"}},"required":["orden","paso","detalle"]}},"plazo_habitual":{"type":"string"},"alternativa":{"type":"string"},"guia_completa":{"type":"string"},"aviso_legal":{"type":"string"}},"required":["pasos"]}}}},"400":{"description":"Faltan datos o no son válidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}},"/api/solicitud":{"post":{"operationId":"solicitar_presupuestos","summary":"Pedir presupuestos a importadores de coches","description":"Envía a Importar Fácil una solicitud de presupuesto en nombre del usuario. Importar Fácil la revisa y la comparte con un máximo de tres empresas importadoras, que contactan con el usuario por correo o teléfono. Es gratis y sin compromiso para el usuario. Esta herramienta envía datos personales a un tercero: úsala solo si el usuario ha pedido expresamente recibir presupuestos, ha facilitado él mismo su nombre y su correo, y ha confirmado en la conversación que acepta que sus datos se compartan con esos importadores. No inventes ni deduzcas datos de contacto y no la llames sin esa confirmación.","x-openai-isConsequential":true,"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"consentimiento":{"type":"boolean","description":"true solo si el usuario ha confirmado en esta conversación que acepta compartir sus datos con un máximo de tres importadores, según la política de privacidad de Importar Fácil."},"nombre":{"type":"string","description":"Nombre del usuario.","maxLength":100},"email":{"type":"string","description":"Correo electrónico del usuario.","format":"email","maxLength":200},"telefono":{"type":"string","description":"Teléfono, si el usuario quiere que le llamen.","maxLength":40},"comunidad_autonoma":{"type":"string","description":"Comunidad autónoma donde se matriculará el coche. Valores: Andalucía, Aragón, Asturias, Illes Balears, Canarias, Cantabria, Castilla y León, Castilla-La Mancha, Cataluña, Comunidad Valenciana, Extremadura, Galicia, Comunidad de Madrid, Región de Murcia, Navarra, País Vasco, La Rioja, Ceuta, Melilla."},"coche":{"type":"string","description":"Coche que busca o que ha encontrado: marca, modelo, año y lo que sea relevante.","maxLength":300},"url_anuncio":{"type":"string","description":"Enlace al anuncio, si ya ha elegido un coche.","maxLength":500},"presupuesto_eur":{"type":"number","description":"Presupuesto total aproximado en euros.","minimum":0},"plazo":{"type":"string","description":"Cuándo quiere comprar, p. ej. \"este mes\" o \"en tres meses\".","maxLength":60},"servicio":{"type":"string","description":"Qué necesita del importador. Por defecto, todo el proceso.","enum":["Todo el proceso","Solo transporte","Solo trámites y matriculación","Búsqueda del coche"]},"mensaje":{"type":"string","description":"Cualquier otro detalle que el usuario quiera comunicar.","maxLength":1500},"resumen_calculo":{"type":"string","description":"Resumen breve del cálculo de costes ya hecho, si lo hay.","maxLength":600}},"required":["consentimiento","nombre","email","comunidad_autonoma","coche"],"additionalProperties":false}}}},"responses":{"200":{"description":"Resultado.","content":{"application/json":{"schema":{"type":"object","properties":{"enviada":{"type":"boolean"},"mensaje":{"type":"string"},"datos_enviados":{"type":"object"},"privacidad":{"type":"string"}},"required":["enviada","mensaje"]}}}},"400":{"description":"Faltan datos o no son válidos.","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"string"}}}}}}}}}}}