Seguros
Contratación
Flujo de contratación. Lo primero que necesitamos es saber el detalle de la póliza a contratar.
GetPolicy
Pasamos el ID de la póliza que queremos contratar para recuperar su detalle que anteriormente en login indentificamos dentro del listado de polizas con el atributo idDyn
Request
GET https://apigw-dev.intermundial.com/aks/api/policies/v5/policy/{id}[?origin]
Response
La respuesta nos devolverá los detalles de la póliza y también opciones de contratación entre otros muchos otros valores necesarios.
{
...
"currency":{},
"policyNumber": "string",
"product": {
...
"productName": "string"
"idDyn": 0,
"productCountriesList": []
"priceList": {
"currency": {},
"conditionsList": [] para pintar el formulario
"priceListInfoList": [] Descripciones del seguro,
"priceListParamsList": [] parametros de precio {
ámbitos de cobertura {mundo, europa...}
duración {[1-5, 6-9... dias]}
}
"priceListPeriodList": {
"startDate": "string",
"endDate": "string",
},
},
},
},product.priceList.conditionsList[] : Parametrización de los campos del formulario que se visualizará posteriormente, por ejemplo:
...{"isBoolean": true,"condition": "requerido","field": "nombre","conditionId": 34,"conditionValueId": 73328,"conditionValue": true,"entityId": 3,"entity": "asegurado_dependiente","fieldId": 23},...
product.priceList.priceListInfoList[] : Descripciones de las coberturas del seguro.
product.priceList.priceListParamsList[] : Ámbitos de cobertura ( Destino y Duración) cada uno tiene unos posibles valores a seleccionar, cada opción seleccionada del ambito de cobertura tendrá un valor que tendremos que memorizar, su idDyn product.priceList.priceListParamsList[].priceListParamsValues[].idDyn que tendremos que utilizar en la posterior llamada a PostPricing en el orden indicado por el parámetro product.priceList.priceListParamsList[].plan.
PostPricing
Request
En esta llamada deberemos de pasar los idDyn, recogidos anteriormente. También, una vez hecha la primera llamada a pricing podremos recuperar las posibles extensiones o ampliaciones de cobertura para modificar tu póliza y así volver, si es necesario, volver a calcular los precios enviando esas ampliaciones en el atributo coverageExtensions.
POST https://apigw-dev.intermundial.com/aks/api/policies/v5/policy/{id}/pricing[?origin]
{
"coverageExtensions": ["Generic array"],
"quotePresetList": [{
"paxNum": 0,
"priceListParamsValues1": {
"idDyn": 0
},
"priceListParamsValues2": {
"idDyn": 0
}
}]
}
A continuación podemos ver un ejemplo completo de una llamada a pricing con las ampliaciones de cobertura:
{
coverageExtensions: [
{coverageExtensionsValues: [{priceListCoveragesValues: {idDyn: 177528}}]
],
effectDate: "string",
quotePresetList: [
{paxNum: 1, priceListParamsValues1: {idDyn: 28666}, priceListParamsValues2: {idDyn: 28668}}
]
unsuscribeDate: "string"
}Si quieres saber mas sobre ampliaciones de coberturas puedes ir a la sección de Ampliaciones
Response
La respuesta después de enviar las opciones de contratación de la póliza contendrá todo lo seleccionado anteriormente junto con los valores de prima del seguro en los siguientes atributos:
retailPriceAmount :Prima total
netPremiumAmount :Prima neta
PostPricingList
En caso de querer hacer una tarificación múltiple puedes utilizar esta llamada. Como se puede ver se envían varias a la vez con sus distintas opciones seleccionadas en sus priceListParamsValues y sus posibles ampliaciones de cobertura en coverageExtensions
[
{
"policyId": 0,
"coverageExtensions": [],
"quotePresetList": [
{
"paxNum": 1,
"priceListParamsValues1": {"idDyn": 0},
"priceListParamsValues2": {"idDyn": 0},
"insuredAmount": null
}
]
},
{
"policyId": 0,
"coverageExtensions": [],
"quotePresetList": [
{
"paxNum": 1,
"priceListParamsValues1": {"idDyn": 0},
"priceListParamsValues2": {"idDyn": 0},
"insuredAmount": null
}
]
}
]
POST https://apigw-dev.intermundial.com/aks/api/insurances/v5/insurance?origin={origin}
{
"unsuscribeDate": "string",
"effectDate": "string",
"policy": {
"idDyn": 0
},
"coverageExtensions": [{
"coverage": {
"idDyn": 0
},
"priceListCoverages": {
"idDyn": 0
},
"extensionType": "string",
"coverageExtensionsValues": [{
"priceListCoveragesDesc": {
"idDyn": 0
},
"priceListCoveragesValues": {
"idDyn": 0
},
"isIncluded": false,
"extensionLimit": 0,
"retailPremiumAmount": 0
}]
}],
"quotePresetList": [{
"paxNum": "string",
"basePrices": {
"idDyn": 0
},
"priceListParamsValues1": {
"idDyn": 0
},
"priceListParamsValues2": {
"idDyn": 0
},
"insuredAmount": 0,
"countryDestiny": {
"idDyn": 0,
"name": "string",
"isoCode2": "string"
},
"countryOrigin": {
"idDyn": 0,
"name": "string",
"isoCode2": "string",
"isoCode3": "string"
}
}],
"insuranceInsuredList": [{
"isMainInsured": false,
"insured": {
"name": "string",
"surname": "string",
"treatment": "string",
"documentType": "string",
"documentNumber": "string",
"birthDate": "string",
"addressInfoList": [{
"commercialCity": "string",
"commercialAddress": "string",
"commercialPostalCode": "string",
"commercialCountry": {
"idDyn": 0,
"name": "string",
"isoCode3": "string"
},
"commercialProvince": {
"idDyn": 0,
"name": "string"
}
}],
"contactInfoList": [{
"phoneNumber": "string",
"email": "string"
}]
}
}]
}
GetInsurances
Para poder conseguir el listado de pólizas contratadas podemos hacer la siguiente llamada con los siguientes filtros.
GET https://apigw.intermundial.com/aks/api/insurances/v5/insurance/?[origin]&[page]&[rows]&[sort]&[order]&[entryDate]&[type]
A continuación un ejemplo real:
GET https://apigw.intermundial.com/aks/api/insurances/v5/insurance/?origin=INT&page=1&rows=25&sort=entryDate&order=DESC&entryDate=2021-06-04,%202024-06-04&type=user