openapi: 3.0.3 info: title: 'ERSM Documentación API.' description: '' version: 1.0.0 servers: - url: 'https://api.ersm.net' paths: /ersmtarificador/polizas/tarificar: post: summary: 'Nuevo proyecto.' operationId: nuevoProyecto description: "Crea un nuevo proyecto de seguros y obtiene cotizaciones de cada compañía asignada.\n\nNota: Esta operación puede tardar más de un minuto en completarse!\n\nLas cotizaciones obtenidas las encontrarás en los campos mainQuotes y addonQuotes dependiendo de si se trata\nde un producto principal o de un add-on. Mira el campo errors para cotizaciones fallidas.\n\nAdicionalmente, obtendrás una lista de ofertas preconfiguradas que representan una combinación de una\ncotización de producto principal y, opcionalmente, algunas cotizaciones de add-on compatibles.\n\nCuando sea necesario, recibirás más información sobre el estado en el campo messages de cada resultado." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: { } tags: - 'Tarificador ERSM' /ersmtarificador/polizas/recuperar: get: summary: Recuperar. operationId: recuperar description: 'Recupera un proyecto de seguro con sus cotizaciones.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/polizas/modificar: patch: summary: Modificar. operationId: modificar description: "Modifica un proyecto de seguro cotizado.\n\nPuede enviar una solicitud con los datos del seguro anterior modificando solo las propiedades de los\ndatos del seguro modificables. El resto de las propiedades se ignorarán.\n\nNota: Revise la operación Enumerar los roles de los participantes del seguro de cada línea de seguro\npara determinar qué campos de rol de persona son obligatorios y modificables.\n\nEsto le permite continuar con el proceso de solicitud de seguro para obtener una póliza de seguro del proveedor." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: { } tags: - 'Tarificador ERSM' /ersmtarificador/polizas/presupuesto: post: summary: 'Report o Presupuesto.' operationId: reportOPresupuesto description: "Crea un REPORT o Presupuesto sobre un proyecto de seguro.\n\nSe debe proporcionar el ID general del proyecto del seguro y los ID's de las Ofertas \"offers\" que se\nquieran incluir en el presupuesto" parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: { } tags: - 'Tarificador ERSM' /ersmtarificador/polizas/recupera-oferta: get: summary: 'Recupera oferta.' operationId: recuperaOferta description: 'Recupera una oferta de seguro con sus opciones de producto.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/polizas/recupera-oferta-garantias: get: summary: 'Recupera garantías.' operationId: recuperaGarantas description: "Recuperar las garantías de una oferta de seguro.\n\nPara facilitar la comparación de ofertas, el conjunto de garantias que se devuelve es el mismo para todas las\nofertas (en cada ramo de seguro).\nSi la oferta realmente proporciona estas coberturas se determina mediante los campos \"included\" y \"text\"." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/polizas/pre-emitir: post: summary: 'Pre emitir solicitud de póliza.' operationId: preEmitirSolicitudDePliza description: "Crea una nueva oferta de seguro pre-emitiendo y empaquetando una cotización principal y, opcionalmente, algunas\ncotizaciones complementarias compatibles de un seguro existente.\n\nEsta operación es obligatoria para las ofertas cuyas cotizaciones tienen la acción \"ReRate\" como\nobligatoria entre sus \"actions\". Una vez reevaluadas, no debería ser necesario volver a evaluar las\ncotizaciones nuevas a menos que se apliquen otras restricciones (como que la oferta haya vencido).\n\nTambién es necesario reevaluar una oferta si desea modificar alguna opción específica del producto,\nla frecuencia de pago o la fecha de vigencia." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: { } tags: - 'Tarificador ERSM' /ersmtarificador/polizas/solicitud: post: summary: 'Envío de solicitud de póliza.' operationId: envoDeSolicitudDePliza description: "La presentación de una solicitud de póliza de seguro representa la intención de formalizar una cotización\nen una póliza de seguro.\n\nMediante esta operación se pueden formalizar las cotizaciones incluidas en una oferta de seguro en pólizas\nde seguro. La solicitud del producto principal se presentará en primer lugar y, si se acepta, las solicitudes\nde los complementos se presentarán a continuación." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: { } tags: - 'Tarificador ERSM' /ersmtarificador/listados/aseguradoras: get: summary: Aseguradoras operationId: aseguradoras description: 'Lista de las compañías aseguradoras totales con las que trabaja el tarificador.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/listados/tipos-de-seguros: get: summary: 'Listado de Tipos de Seguros' operationId: listadoDeTiposDeSeguros description: 'Listado de líneas de seguro que tiene asignadas a su usuario.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/listados/proyectos: get: summary: 'Listado de Proyectos / Pólizas' operationId: listadoDeProyectosPlizas description: '' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/listados/productos: get: summary: 'Listado de Productos' operationId: listadoDeProductos description: 'Listado de los productos actualmente asignados' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/idiomas: get: summary: 'Idiomas de Contacto' operationId: idiomasDeContacto description: 'Lista de idiomas que pueden ser utilizados para contactar con una persona.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/estado-inactividad: get: summary: 'Estados de Inactividad' operationId: estadosDeInactividad description: 'Lista de estados de inactividad según el INE' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/ocupaciones: get: summary: Ocupaciones operationId: ocupaciones description: 'Lista de la Clasificación Nacional de Ocupaciones 2011 (CNO-11)' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/estado-laboral: get: summary: 'Estado Laboral' operationId: estadoLaboral description: 'Lista de los estados laborales según se establece en ILOSTAT.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/generos: get: summary: Género operationId: gnero description: 'Lista de géneros' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/tipos-de-documentos: get: summary: 'Tipos de Documentos' operationId: tiposDeDocumentos description: 'Lista de los tipos de identificación para personas físicas y jurídicas.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/persona/estado-civil: get: summary: 'Estado Civil' operationId: estadoCivil description: 'Lista de los diferentes tipos de estados civiles.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/lugar/paises: get: summary: Países operationId: pases description: 'Listado de Países gestionados por el tarificador' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/lugar/provincias: get: summary: Provincias operationId: provincias description: 'Listado de Provincias' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/lugar/poblaciones: get: summary: Poblaciones operationId: poblaciones description: 'Listado de poblaciones de la Provincia proporcionada' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: false content: application/json: schema: type: object properties: provincia_id: type: string description: 'ID de la Provincia obtenida en el metodo opcional ID del tipo de motor/combustible obtenido en el método Motores.' example: Gasoline nullable: false minCV: type: integer description: 'opcional Mínimo valor de la Potencia del vehículo en CV.' example: null nullable: false maxCV: type: integer description: 'opcional Máximo valor de la Potencia del vehículo en CV.' example: null nullable: false minCC: type: integer description: 'opcional Mínimo valor de los Centímetros Cúbicos (CC) del vehículo.' example: null nullable: false maxCC: type: integer description: 'opcional Máximo valor de los Centímetros Cúbicos (CC) del vehículo.' example: null nullable: false required: - marca_id - modelo_id /ersmtarificador/catalogos/autos/zonas-expedicion-licencia: get: summary: 'Expedición Licencia' operationId: expedicinLicencia description: 'Lista de Zonas/Países convalidados para la expedición de la licencia de conducción' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/autos/licencias: get: summary: Licencias operationId: licencias description: 'Lista de tipos de licencia de conducción' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/autos/motores: get: summary: 'Motores / Combustibles' operationId: motoresCombustibles description: 'Lista de tipos de combustibles' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/autos/aparcamientos: get: summary: Aparcamientos operationId: aparcamientos description: 'Lista de tipos de aparcamientos' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/autos/aseguradoras: get: summary: 'Listado de Compañías Aseguradoras' operationId: listadoDeCompaasAseguradoras description: 'Lista las Compañías Aseguradoras del grupo Automóviles relacionadas con su usuario.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/autos/fecha_matricula: get: summary: 'Fecha de Matrícula' operationId: fechaDeMatrcula description: 'Devuelve la fecha de la matrícula proporcionada' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: false content: application/json: schema: type: object properties: matricula: type: string description: 'Matrícula del vehículo.' example: 8765KJC nullable: false /ersmtarificador/catalogos/autos/complementos: get: summary: Complementos operationId: complementos description: 'Lista de complementos del vehículo' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: false content: application/json: schema: type: object properties: base7: type: string description: 'Código BaseSIETE de Centro Zaragoza del vehículo para obtener sus complementos.' example: '20490020008' nullable: false /ersmtarificador/catalogos/autos/listado-productos: get: summary: 'Listado de Productos' operationId: listadoDeProductos description: 'Lista de los diferentes productos por compañía aseguradora disponibles' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/marcas: get: summary: Marcas operationId: marcas description: 'Lista de Marcas' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/modelos: get: summary: Modelos operationId: modelos description: 'Lista de modelos de la marca proporcionada' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: true content: application/json: schema: type: object properties: marca_id: type: integer description: 'ID de la marca obtenida en el método Marcas.' example: 1944 nullable: false required: - marca_id /ersmtarificador/catalogos/motos/versiones: get: summary: Versiones operationId: versiones description: "Lista de versiones de vehículos de la marca y modelos proporcionados.\nSe pueden utilizar los filtros opcionales para acotar la lista de resultados." parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: true content: application/json: schema: type: object properties: marca_id: type: integer description: 'ID de la marca obtenida en el método Marcas.' example: 1944 nullable: false modelo_id: type: integer description: 'ID del modelo obtenido en el método Modelos.' example: 14220 nullable: false combustible: type: string description: 'ID del tipo de motor/combustible obtenido en el método Motores.' example: Gasoline nullable: false minCV: type: integer description: 'Mínimo valor de la Potencia del vehículo en CV.' example: null nullable: false maxCV: type: integer description: 'Máximo valor de la Potencia del vehículo en CV.' example: null nullable: false minCC: type: integer description: 'Mínimo valor de los Centímetros Cúbicos (CC) del vehículo.' example: null nullable: false maxCC: type: integer description: 'Máximo valor de los Centímetros Cúbicos (CC) del vehículo.' example: null nullable: false required: - marca_id - modelo_id /ersmtarificador/catalogos/motos/zonas-expedicion-licencia: get: summary: 'Expedición Licencia' operationId: expedicinLicencia description: 'Lista de Zonas/Países convalidados para la expedición de la licencia de conducción' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/licencias: get: summary: Licencias operationId: licencias description: 'Lista de tipos de licencia de conducción' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/experiencia: get: summary: Experiencia operationId: experiencia description: 'Lista de experiencia de conducción' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/motores: get: summary: 'Motores / Combustibles' operationId: motoresCombustibles description: 'Lista de tipos de combustibles' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/aparcamientos: get: summary: Aparcamientos operationId: aparcamientos description: 'Lista de tipos de aparcamientos' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/aseguradoras: get: summary: 'Listado de Compañías Aseguradoras' operationId: listadoDeCompaasAseguradoras description: 'Lista las Compañías Aseguradoras del grupo Automóviles relacionadas con su usuario.' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' /ersmtarificador/catalogos/motos/fecha_matricula: get: summary: 'Fecha de Matrícula' operationId: fechaDeMatrcula description: 'Devuelve la fecha de la matrícula proporcionada' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' requestBody: required: false content: application/json: schema: type: object properties: matricula: type: string description: 'Matrícula del vehículo.' example: 8765KJC nullable: false /ersmtarificador/catalogos/motos/listado-productos: get: summary: '' operationId: getErsmtarificadorCatalogosMotosListadoProductos description: '' parameters: - in: header name: Accept-Version description: '' example: '1.0' schema: type: string responses: 401: description: '' content: application/json: schema: type: object example: error: 'Unauthenticated: Your token is invalid.' properties: error: type: string example: 'Unauthenticated: Your token is invalid.' tags: - 'Tarificador ERSM' tags: - name: 'Tarificador ERSM' description: " Tarificador Genérico de ERSM Insurance Brokers con el que se puede:\n Crear proyectos de tarificación\n Recuperar un proyecto\n Modificar el proyecto\n Emitir la póliza del proyecto" components: securitySchemes: default: type: http scheme: bearer description: "Si quieres realizar alguna prueba, puedes hacerlo generando un token de acceso con la url proporcionada por email,\nusando el usuario y contraseña asignado." security: - default: []