Integration Avant2 API Copyright Codeoscopic S.A.

www.codeoscopic.com soporte@avant2.es Integration Avant2 API Copyright Codeoscopic S.A. Este documento es propiedad y copyright de Codeoscopic SA, y su contenido es confidencial. Este documento no puede ser difundido a terceros sin el previo permiso escrito de Codeoscopic SA. Codeoscopic SA no podrá ser considerada responsable de eventuales errores u omisiones en la edición del documento. www.codeoscopic.com Confidencial

de 168 HISTORIAL DE VERISONES Versión Fecha Modificación V 2.1 17/05/2012 V 2.6 15/04/2013 Método getversions: Se añade el parámetro category V 2.6 10/05/2013 Nuevo método getquotationresults V 2.15 02/09/2013 Método searchquotations: Se añaden los parámetros fromissuedate y toissuedate, que permiten buscar proyectos por su fecha de emisión. V 2.25 02/06/2014 Método carquoterequest: Se añade el campo companyresultid a la respuesta, donde se informa del número de presupuesto de la compañía. V 2.41 15/11/2016 Nuevos métodos: getinsurancetypes, getproducts, getpaymenttypes, getinstallments, getpersondescriptors, preparequote, quote, preissue, issue, getissuanceresult, getproductcompanytuningsdefaultvalues, getproductcompanytuningsvalues, getjobs y getproductlist. Página 2

de 168 ÍNDICE DE CONTENIDO 1 Objetivo... 11 2 Servicio Web... 12 3 Autenticación... 13 4 Métodos Expuestos... 14 4.1 echodummy... 14 4.2 PrepareCarQuote (Obsoleto)... 14 4.3 CarQuote (Obsoleto)... 21 4.4 getenginetypes... 30 4.5 getbrands... 31 4.6 getmodels... 32 4.7 getversions... 33 4.8 getmatchingversions... 34 4.9 getvehicleaccessoriesbyversionid... 36 4.10 getvehicleaccessoriesbyversionbase7code... 38 4.11 gettownsfrompostalcode... 39 4.12 getregistrationdatebyplate... 40 4.13 exportpoliciesdata... 41 4.14 getpolicydocument... 42 4.15 getinsurancetypes... 44 4.16 getproducts... 45 4.17 getpaymenttypes... 46 4.18 getinstallments... 47 4.19 getpersondescriptors... 49 4.20 searchquotations... 50 4.21 getquotationresults... 53 4.22 preparequote... 55 4.23 quote... 62 4.24 preissue... 70 4.25 issue... 79 Página 3

de 168 4.26 getissuanceresult... 90 4.27 getproductcompanytuningsdefaultvalues... 91 4.28 getproductcompanytuningsvalues... 93 4.29 getjobs... 94 4.30 getproductlist... 95 5 Tipos de Datos... 97 5.1 PrepareCarQuoteRequestType... 97 5.2 PrepareCarQuoteResponse... 97 5.3 CarQuoteRequestType... 97 5.4 CarQuoteResponse... 98 5.5 GetEngineTypesResponse... 98 5.6 GetBrandsRequest... 98 5.7 GetBrandsResponse... 98 5.8 GetModelsRequest... 99 5.9 GetModelsResponse... 99 5.10 GetVersionsRequest... 99 5.11 GetVersionsResponse... 99 5.12 GetMatchingVersionsRequest... 99 5.13 GetMatchingVersionsResponse... 101 5.14 GetVehicleAccessoriesByVersionIdRequest... 101 5.15 GetVehicleAccessoriesByVersionIdResponse... 101 5.16 GetVehicleAccessoriesByBase7CodeRequest... 101 5.17 GetVehicleAccessoriesByVersionIdResponse... 101 5.18 GetTownsFromPostalCodeRequest... 102 5.19 GetTownsFromPostalCodeResponse... 102 5.20 GetRegistrationDateByPlateRequest... 102 5.21 GetRegistrationDateByPlateResponse... 102 5.22 ExportPoliciesDataRequest... 102 5.23 ExportPoliciesDataResponse... 103 5.24 GetPolicyDocumentRequest... 103 5.25 GetPolicyDocumentResponse... 103 5.26 GetInsuranceTypesResponse... 103 Página 4

de 168 5.27 GetProductsRequest... 103 5.28 GetProductsResponse... 103 5.29 GetPaymentTypesRequest... 104 5.30 GetPaymentTypesResponse... 104 5.31 GetInstallmentsRequest... 104 5.32 GetInstallmentsResponse... 104 5.33 GetPersonDescriptorsRequest... 104 5.34 GetPersonDescriptorsResponse... 105 5.35 PersonDescriptor... 105 5.36 PersonFieldList... 105 5.37 PersonField... 105 5.38 SearchQuotationsRequest... 105 5.39 SearchQuotationsResponse... 105 5.40 GetQuotationResultsRequest... 106 5.41 GetQuotationResultsResponse... 106 5.42 Car... 106 5.43 ProductCommercialApiList... 107 5.44 ProductCommercialApiSupport... 107 5.45 ProductCompanyList... 107 5.46 ProductCompany... 107 5.47 PaymentTypesApiList... 107 5.48 InstallmentsApiList... 107 5.49 PersonsDescriptorsApiList... 108 5.50 PersonDescriptor... 108 5.51 Base7Version... 109 5.52 Person... 109 5.53 PersonDriver... 110 5.54 ComplementaryData... 111 5.55 Accessories... 111 5.56 Accessory... 112 5.57 NonBase7Accessories... 112 5.58 NonBase7Accessory... 112 Página 5

de 168 5.59 UserIdentification... 112 5.60 QuotationResults... 112 5.61 QuotationCompanyResultsList... 113 5.62 QuotationCompanyResults... 113 5.63 QuotationTaskState... 114 5.64 QuotationResultPriceList... 114 5.65 QuotationResultPrice... 114 5.66 TuningsList... 114 5.67 ProductCopmanyTuning... 114 5.68 TuningValuesList... 114 5.69 TuningValue... 115 5.70 ProductCompanyTuningWarningsList... 115 5.71 ProductCompanyTuningWarnings... 115 5.72 WarningsList... 115 5.73 Modality... 115 5.74 ProductModality... 116 5.75 EngineTypesList... 116 5.76 EngineType... 116 5.77 VehicleBrandList... 116 5.78 VehicleBrand... 116 5.79 VehicleModelsList... 116 5.80 VehicleModel... 116 5.81 VehicleVersionsList... 117 5.82 VehicleVersion... 117 5.83 VehicleAccessoriesList... 117 5.84 VehicleAccessory... 118 5.85 TownsList... 118 5.86 Town... 118 5.87 BankData... 118 5.88 PostalAddress... 118 5.89 IssuedProductsList... 119 5.90 IssuedProduct... 119 Página 6

de 168 5.91 DocumentsList... 119 5.92 Document... 119 5.93 QuotationSearchFilter... 120 5.94 QuotationSearchResultsList... 121 5.95 QuotationSummary... 121 5.96 PersonSummary... 121 5.97 RiskSummary... 122 5.98 CarSummary... 122 5.99 HomeSummary... 123 5.100 LastPolicySummary... 124 5.101 SinistersHistorySummary... 124 5.102 IssuanceSummariesList... 124 5.103 IssuanceSummary... 124 5.104 PrepareQuoteRequest... 125 5.105 AutosRisk... 125 5.106 HomeRisk... 126 5.107 AddressPostalCodeAndTown... 128 5.108 PrepareQuoteResponse... 128 5.109 QuoteRequest... 128 5.110 QuoteResponse... 129 5.111 PreissueRequest... 129 5.112 PreissuanceProduct... 129 5.113 PreissuanceAutosRisk... 129 5.114 TuningList... 130 5.115 ProductTuning... 131 5.116 PreissuanceHomeRisk... 131 5.117 PreissueResponse... 131 5.118 PreissuanceResult... 131 5.119 ProductResult... 132 5.120 ProductCompany... 132 5.121 ComplementaryProductResultList... 132 5.122 ResultPrice... 132 Página 7

de 168 5.123 ConditionList... 132 5.124 Modality... 133 5.125 Installment... 133 5.126 PaymentType... 133 5.127 IssueRequest... 133 5.128 IssuanceAutosRisk... 134 5.129 IssuanceHomeRisk... 134 5.130 JewelList... 135 5.131 Jewel... 135 5.132 SpecialValueObjectList... 135 5.133 SpecialValueObject... 135 5.134 DangerousDogList... 135 5.135 DangerousDog... 135 5.136 IssueResponse... 136 5.137 IssuanceError... 136 5.138 IssuanceResult... 136 5.139 IssuanceProductResult... 136 5.140 IssuanceComplementaryProductResultList... 137 5.141 GetIssuanceResultRequest... 137 5.142 GetIssuanceResultResponse... 137 5.143 GetProductCompanyTuningsDefaultValuesRequest... 137 5.144 GetProductCompanyTuningsDefaultValuesResponse... 137 5.145 GetProductCompanyTuningsValuesRequest... 137 5.146 GetProductCompanyTuningsValuesResponse... 137 5.147 ProductCompanyTuningValues... 138 5.148 FieldTuningValues... 138 5.149 FieldTuningOption... 138 5.150 getjobsrequest... 139 5.151 getjobsresponse... 139 5.152 JobsList... 139 5.153 Job... 139 5.154 getproductlistrequest... 139 Página 8

de 168 5.155 getproductlistresponse... 139 5.156 ProductListItemList... 140 5.157 ProductListItem... 140 6 Tipos de datos JSON (descuentos y coberturas)... 141 6.1 Tipos de datos simples... 141 6.2 Fechas... 141 6.3 Tipos de datos complejos... 141 1. País... 141 2. Código postal... 142 3. Población... 142 4. Tipo de vía... 142 5. Dirección postal... 143 6. Plus Ultra Autos: Opciones / Packs de vehículos... 143 7. Mutua Madrileña Autos: Opciones / Packs Base7... 144 8. Mutua Madrileña Autos: Accesorios no Base7... 144 9. Liberty Autos: Desglose de vehículos asegurados en Liberty... 145 10. Reale Hogar: Desglose de asegurados... 145 11. Reale Hogar: Desglose de vehículos... 146 12. Reale Hogar: Desglose de animales... 146 13. Nationale Hogar: Desglose de obras de arte... 147 14. Nationale Hogar: Desglose de obras de arte frágiles... 148 15. Nationale Hogar: Desglose de vehículos... 148 16. Nationale Hogar: Desglose de equipamiento profesional... 149 17. Helvetia Hogar H15: Desglose de construcciones anexas... 149 18. Helvetia Hogar H15: Desglose de animales de compañía... 150 19. Helvetia Hogar H15: Desglose de vehículos... 150 20. Fidelidade Hogar: Desglose de vehículos... 151 21. Mapfre Hogar: Desglose de animales de compañía... 151 22. Liberty Hogar: Desglose de vehículos... 152 23. Liberty Hogar: Desglose de otras medidas de seguridad... 152 7 Tablas maestras... 154 7.1 Género... 154 Página 9

de 168 7.2 TipoGaraje... 154 7.3 TipoCombustible... 154 7.4 KilometrosAnuales... 155 7.5 AñosSinAccidentes... 155 7.6 AntiguedadCompañiaActual... 156 7.7 Siniestros2ultimosAños... 156 7.8 TipoIdentificación... 157 7.9 CompañiasDGS... 157 7.10 Estado de la cotización... 160 7.11 EstadoCivil... 160 7.12 ZonaExpedición... 162 7.13 TipoAccesorioNoBase7... 162 7.14 CategoriaVehiculo... 162 7.15 Modalidad de Producto... 163 7.16 Pais... 163 7.17 Idioma... 163 7.18 TipoDeVia... 164 7.19 HomeSituation... 165 7.20 HomeType... 165 7.21 HomeHousingUse... 166 7.22 HomeHousingRegime... 166 7.23 HomeBuildQuality... 166 7.24 HomeMaterial... 167 7.25 HomeAlarm... 167 7.26 HomeContractingPattern... 167 7.27 DogGender... 167 7.28 IssuanceState... 168 Página 10

de 168 1 OBJETIVO Implementar un servicio que permita realizar tarificaciones completas o parciales contra la plataforma Avant. Los usuarios de este servicio (agentes, corredores, etc.) podrán integrarse con la plataforma Avant, pudiendo completar el proceso de tarificación y emisión desde el portal web con los datos suministrados por este medio. Página 11

de 168 2 SERVICIO WEB Los servicios estarán expuestos a través de un wsdl, en el cual se define la interface, documentación y sintaxis esperada. Para comunicar con el sistema, será necesario invocar a los métodos del servicio a través de una petición SOAP 1.2 (document literal), según la estructura xml indicada por el documento wsdl. La url del wsdl se encuentra en: http://mt.avant2.es/avant/wsdl/2_41 Se ha implementando también una versión para SOAP 1.1, cuyo wsdl se encuentra en la url http://mt.avant2.es/avant/wsdl11/2_41 Página 12

de 168 3 AUTENTICACIÓN La autenticación en los servicios web se llevará a cabo mediante una nombre de usuario y un apikey que serán proporcionados por Codeoscopic para aquellos clientes que deseen integrarse con Avant a través de su api. Las estructuras de datos que esperan recibir los diferentes métodos incluirán el elemento authentication, que a su vez incluirá los elementos user y key. Aquí se puede ver un ejemplo de la llamada a uno de los métodos: <xs:carquoterequest> <xs1:authentication>  <xs1:user>codeoscopic</xs1:user> <xs1:key>926e27eecdbc7a1884290188ba99bddd</xs1:key> </xs1:authentication> </xs:carquoterequest> Página 13

de 168 4 MÉTODOS EXPUESTOS 4.1 ECHODUMMY Este método es muy sencillo y sirve para que los diferentes integradores puedan comprobar que acceden sin problemas a los servicios web, Recibe como parámetro una cadena de texto y deveulve otra cade de texto que contiene SUCCESS seguido de la misma cadena que se le ha enviado. 4.2 PREPARECARQUOTE (OBSOLETO) Este método ha sido sustituido por el método preparequote. Se ofrece por compatibilidad con versiones anteriores. Pero se encuentra actualmente en desuso y podría no estar soportado en futuras versiones, por lo que no se recomienda su uso. Este método recibe como parámetro de entrada una estructura con los datos necesarios para realizar una tarificación en Avant, y si la información aportada es correcta, devuelve una url en la que se podrá abrir el frontend de Avant con el tren de cotización cargado con los datos enviados. Entre los datos que recibe debe encontrarse el alias del usuario con el que se quiere realizar la cotización, y puede indicarse también el alias de la organización a la que pertenece dicho usuario. De esta forma el frontend de Avant se abrirá con este usuario autenticado en el sistema. La ejecución de este método es muy sencilla en si misma. Extrae el alias del usuario y de la organización de los datos que recibe y busca en la base de datos de Avant si existe un usuario con esos datos. Si no lo encuentra, o encuentra más de uno, devuelve un error, indicando que hay algún problema con el usuario indicado. Si lo encuentra, genera un token único para la petición y devuelve una url formada por la url de avant, seguida del path de integración (/integration) y el parámetro token, con el token generado: http://mt.avant2.es/avant/integration?token=9a5f3eac-bf3d-4fd0-becd-96e585795851 Al acceder a esta url se marca el token como consumido, de forma que la url dejará de ser válida, y se muestra el tren de cotización de Avant, con los datos que se le habían pasado al servicio web cargados. Página 14

de 168 Datos de entrada: PrepareCarQuoteRequestType preparecarquoterequest Datos necesarios para cargar la cotización en el frontend de Avant Datos de salida: PrepareCarQuoteResponse preparecarquoteresponse Respuesta del servicio con la url del frontend de Avant si todo ha ido bien. Ejemplo de mensaje SOAP 1.2 que se debe enviar, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <soap:header/> <soap:body> <xs:preparecarquoterequest>  <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs1:risk xsi:type="xs:car">  <xs:base7> Página 15

de 168 level-->  <xs:brand>?</xs:brand> <xs:model>?</xs:model> <xs:enginetype>?</xs:enginetype> <xs:version>?</xs:version> <xs:displacement>?</xs:displacement> <xs:power>?</xs:power> <xs:releasemarketdate>?</xs:releasemarketdate> <xs:doorsnumber>?</xs:doorsnumber> <xs:exworkprice>?</xs:exworkprice>  <xs:base7code>?</xs:base7code>  <xs:avantversioncode>?</xs:avantversioncode> </xs:base7> <xs:plate>?</xs:plate> <xs:matriculationdate>?</xs:matriculationdate> <xs:purchasedate>?</xs:purchasedate> <xs:postalcode>?</xs:postalcode> <xs:town>?</xs:town> <xs:trailer>?</xs:trailer> <xs:garagetype>?</xs:garagetype> <xs:yearkilometers>?</xs:yearkilometers> <xs:habitualdriver>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> Página 16

de 168 </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> <xs:permissiondate>?</xs:permissiondate> <xs:expeditionzone>?</xs:expeditionzone> <xs:maritalstatus>?</xs:maritalstatus> </xs:habitualdriver> <xs:occasionaldriver>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> Página 17

de 168 <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> <xs:permissiondate>?</xs:permissiondate> <xs:expeditionzone>?</xs:expeditionzone> <xs:maritalstatus>?</xs:maritalstatus> </xs:occasionaldriver> <xs:owner>  <xs1:identificationtype >?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> Página 18

de 168 <xs1:nationality>?</xs1:nationality> </xs:owner> </xs1:risk> <xs1:holder>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> </xs1:holder> <xs:complementarydata> <xs:efectdate>?</xs:efectdate> <xs:previousplate>?</xs:previousplate> <xs:previouspolicy>?</xs:previouspolicy> <xs:previouscompany>?</xs:previouscompany> Página 19

de 168 <xs:yearsinpreviouscompany>?</xs:yearsinpreviouscompany> <xs:yearswithoutaccident>?</xs:yearswithoutaccident > <xs:lasttwoyearsaccidents>?</xs:lasttwoyearsaccidents > <xs:referenceprice>?</xs:referenceprice > </xs:complementarydata> <xs:accessories>  <xs:accessory>   <xs:name>?</xs:name> <xs:value>?</xs:value>  <xs:code>?</xs:code> </xs:accessory> </xs:accessories> <xs:nonbase7accessories>  <xs:accessoryo>  <xs:name>?</xs:name> <xs:value>?</xs:value> <xs:code>?</xs:code> </xs:accessory> </xs:nonbase7accesories> <xs1:alias> <xs1:useralias>?</xs1:useralias> <xs1:organizationalias>?</xs1:organizationalias> </xs1:alias> <xs:tunings>  <xs1:productcompanytuning> <xs1:productcompany>?</xs1:productcompany> <xs1:tuningvalues>  <xs1:tuningvalue> <xs1:field>?</xs1:field> <xs1:value>?</xs1:value> </xs1:tuningvalue> </xs1:tuningvalues> </xs1:productcompanytuning> </xs:tunings> <xs:bankdata> <xs1:entity>?</xs1:entity> <xs1:office>?</xs1:office> <xs1:controldigits>?</xs1:controldigits> <xs1:accountnumber>?</xs1:accountnumber> Página 20

de 168 </xs:bankdata> </xs:preparecarquoterequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:preparecarquoteresponse xmlns:ns4="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <ns3:code>?</ns3:code>   <ns3:url>?</ns3:url>  <ns3:error>?</ns3:error> </ns3:preparecarquoteresponse> </env:body> </env:envelope> 4.3 CARQUOTE (OBSOLETO) Este método ha sido sustituido por el método preparequote. Se ofrece por compatibilidad con versiones anteriores. Pero se encuentra actualmente en desuso y podría no estar soportado en futuras versiones, por lo que no se recomienda su uso. Este método recibe como parámetro de entrada una estructura con los datos necesarios para realizar una tarificación en Avant, y si la información aportada es correcta, lanza el proceso de cotización y devuelve una estructura con los precios obtenidos. El proceso es muy similar al de preparecarquote, primero se obtiene los alias del usuario y la organización y se validan sus credenciales. Tras esta validación, se crea el dto de la Quotation y esta se introduce en el bus de cotización de Avant. Una vez que se ha introducido la cotización en el bus de Avant, el proceso se queda esperando a que las diferentes compañías de las que se intenta obtener precios devuelvan sus resultados, durante un periodo de tiempo determinado. Si en ese periodo no se han obtenido precios de las compañías, el servicio devolverá un error. Con los precios obtenidos de las diferentes compañías se monta la estructura de datos que se devuelve. Dado que la cotización con las diferentes compañías se está llevando a cabo en este instante, este método puede tardar en ejecutarse, por lo que es recomendable incrementar el timeout del servicio en la llamada. Página 21

de 168 Datos de entrada: CarQuoteRequestType carquoterequest Datos necesarios para realizar la cotización en Avant. Datos de salida: CarQuoteResponse carquoteresponse Respuesta con el número de cotización en Avant y los precios para las diferentes compañías Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"> <soap:header/> <soap:body> <xs:carquoterequest>  <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> Página 22

de 168 level--> <xs1:risk xsi:type="xs:car">  <xs:base7>  <xs:brand>?</xs:brand> <xs:model>?</xs:model> <xs:enginetype>?</xs:enginetype> <xs:version>?</xs:version> <xs:displacement>?</xs:displacement> <xs:power>?</xs:power> <xs:releasemarketdate>?</xs:releasemarketdate> <xs:doorsnumber>?</xs:doorsnumber> <xs:exworkprice>?</xs:exworkprice>  <xs:base7code>?</xs:base7code>  <xs:avantversioncode>?</xs:avantversioncode> </xs:base7> <xs:plate>?</xs:plate> <xs:matriculationdate>?</xs:matriculationdate> <xs:purchasedate>?</xs:purchasedate> <xs:postalcode>?</xs:postalcode> <xs:town>?</xs:town> <xs:trailer>?</xs:trailer> <xs:garagetype>?</xs:garagetype> <xs:yearkilometers>?</xs:yearkilometers> <xs:habitualdriver>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> Página 23

de 168 <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> <xs:permissiondate>?</xs:permissiondate> <xs:expeditionzone>?</xs:expeditionzone> <xs:maritalstatus>?</xs:maritalstatus> </xs:habitualdriver> <xs:occasionaldriver>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> Página 24

de 168 <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> <xs:permissiondate>?</xs:permissiondate> <xs:expeditionzone>?</xs:expeditionzone> <xs:maritalstatus>?</xs:maritalstatus> </xs:occasionaldriver> <xs:owner>  <xs1: identificationtype >?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> Página 25

de 168 </xs:owner> </xs1:risk> <xs1:holder>  <xs1:identificationtype>?</xs1:identificationtype> <xs1:identification>?</xs1:identification> <xs1:name>?</xs1:name> <xs1:firstsurname>?</xs1:firstsurname> <xs1:secondsurname>?</xs1:secondsurname> <xs1:birthdate>?</xs1:birthdate> <xs1:gender>?</xs1:gender> <xs1:postaladdress> <xs1:postalcode>?</xs1:postalcode> <xs1:town>?</xs1:town> <xs1:streettype>?</xs1:streettype> <xs1:streetname>?</xs1:streetname> <xs1:number>?</xs1:number> <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> </xs1:holder> <xs:complementarydata> <xs:efectdate>?</xs:efectdate> <xs:previousplate>?</xs:previousplate> <xs:previouspolicy>?</xs:previouspolicy> <xs:previouscompany>?</xs:previouscompany> <xs:yearsinpreviouscompany>?</xs:yearsinpreviouscompany> <xs:yearswithoutaccident>?</xs:yearswithoutaccident > Página 26

de 168 <xs:lasttwoyearsaccidents>?</xs:lasttwoyearsaccidents > <xs:referenceprice>?</xs:referenceprice > </xs:complementarydata> <xs:accessories>  <xs:accessory>   <xs:name>?</xs:name> <xs:value>?</xs:value>  <xs:code>?</xs:code> </xs:accessory> </xs:accessories> <xs:nonbase7accessories>  <xs:accessoryo>  <xs:name>?</xs:name> <xs:value>?</xs:value> <xs:code>?</xs:code> </xs:accessory> </xs:nonbase7accesories> <xs1:alias> <xs1:useralias>?</xs1:useralias> <xs1:organizationalias>?</xs1:organizationalias> </xs1:alias> <xs:tunings>  <xs1:productcompanytuning> <xs1:productcompany>?</xs1:productcompany> <xs1:tuningvalues>  <xs1:tuningvalue> <xs1:field>?</xs1:field> <xs1:value>?</xs1:value> </xs1:tuningvalue> </xs1:tuningvalues> </xs1:productcompanytuning> </xs:tunings> </xs:carquoterequest> </soap:body> </soap:envelope> Página 27

de 168 Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:carquoteresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:results>  <ns4:quotationid>?</ns4:quotationid> <ns4:quotationurl>?</ns4:quotationurl> <ns4:mainproductsresults>  <ns4:resultslist>  <ns4:companyname>?</ns4:companyname> <ns4:produccompanyid>?</ns4:produccompanyid> <ns4:productcompanyname>?</ns4:productcompanyname> <ns4:companyresultid>?</ns4:companyresultid> <ns4:state>  <ns4:id>?</ns4:id> <ns4:description>?</ns4:description> </ns4:state> <ns4:prices>  <ns4:pricelist>  <ns4:companypriceid>?</ns4:companypriceid > <ns4:modality>  <ns4:id>?</ns4:id> <ns4:name>?</ns4:name> <ns4:rating>?</ns4:rating> <ns4:deductible>?</ns4:deductible> </ns4:modality> <ns4:firstbill>?</ns4:firstbill> </ns4:pricelist> Página 28

de 168 order--> order--> </ns4:prices> </ns4:resultslist> </ns4:mainproductsresults> <ns4:complementaryproductsresults>  <ns4:resultslist>  <ns4:companyname>?</ns4:companyname> <ns4:produccompanyid>?</ns4:produccompanyid> <ns4:productcompanyname>?</ns4:productcompanyname> <ns4:state>  <ns4:pricelist>  <ns4:id>?</ns4:id> <ns4:name>?</ns4:name> <ns4:rating>?</ns4:rating> <ns4:deductible>?</ns4:deductible> </ns4:modality> <ns4:firstbill>?</ns4:firstbill> </ns4:pricelist> </ns4:prices> </ns4:resultslist> </ns4:complementaryproductsresults> <ns4:tuningdatawarings>  <ns4:productcompanywarings> <ns4:productcompanyid>?</productcompanyid> <ns4:productcompanyname>?</productcompanyname> <ns4:warnings>  <ns4:warning>?</ns4:warning> </ns4:warnings> </ns4:productcompanywarings> </ns4:tuningdatawarings> </ns3:results> </ns3:carquoteresponse> </env:body> </env:envelope> Página 29

de 168 4.4 GETENGINETYPES Este método recupera los tipos de motores, en cuanto a combustible se refiere, que se utilizan en Avant. Datos de entrada: GetEngineTypesRequest getenginetypesrequest Datos de autenticación para poder obtener los tipos de motor. Datos de salida: GetEngineTypesResponse getenginetypesresponse Lista de tipos de motor que se utilizan en Avant Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getenginetypesrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> </xs:getenginetypesrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getenginetypesresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:enginetypes>  <ns3:enginetype> <ns3:code>?</ns3:code> Página 30

de 168 <ns3:value>?</ns3:value> </ns3:enginetype> </ns3:enginetypes> </ns3:getenginetypesresponse> </env:body> </env:envelope> 4.5 GETBRANDS Este método recupera las marcas con las de vehículos para la categoría indicada. Datos de entrada: GetBrandsRequest getbrandsrequest Estructura de datos necesaria para obtener las marcas. Datos de salida: GetBrandsResponse getbrandsresponse Lista de marcas de vechículos. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getbrandsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:category>?</xs:category> </xs:getbrandsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getbrandsresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error> Página 31

de 168  <ns3:brands>  <ns3:brand> <ns3:code>?</ns3:code> <ns3:name>?</ns3:name> </ns3:brand> </ns3:brands> </ns3:getbrandsresponse> </env:body> </env:envelope> 4.6 GETMODELS Este método recupera los modelos de vehículos para la marca y la categoría indicada. Datos de entrada: GetModelsRequest getmodelsrequest Estructura de datos necesaria para obtener los modelos. Datos de salida: GetModelsResponse getmodelsresponse Lista de modelos de vechículos. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getmodelsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:category>?</xs:category> <xs:brand>?</xs:brand> </xs:getmodelsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> Página 32

de 168 <ns3:getbrandsresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:models>  <ns3:model> <ns3:code>?</ns3:code> <ns3:name>?</ns3:name> </ns3:model> </ns3:models> </ns3:getmodelsresponse> </env:body> </env:envelope> 4.7 GETVERSIONS Este método recupera las diferentes versiones que existen de un modelo de vehículo, filtrando por el tipo de combustible. Datos de entrada: GetVersionsRequest getversionsrequest Estructura de datos necesaria para obtener las versiones de un modelo de vehículo. Datos de salida: GetVersionsResponse getversionsresponse Lista de versiones del modelo de vehículo. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getversionsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:model>?</xs:model> <xs:enginetype>?</xs:enginetype> <xs:category>?</xs:category> Página 33

de 168 </xs:getversionsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getversionsresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:versions>  <ns3:version> <ns3:code>?</ns3:code> <ns3:base7code>?</ns3:base7code> <ns3:name>?</ns3:name> <ns3:description>?</ns3:description> <ns3:displacement>?</ns3:displacement> <ns3:enginepower>?</ns3:enginepower> <ns3:doorsnumber>?</ns3:doorsnumber> <ns3:releasemarketdate>?</ns3:releasemarketdate> <ns3:exworkprice>?</ns3:exworkprice> <ns3:price>?</ns3:price> </ns3:version> </ns3:versions> </ns3:getversionsresponse> </env:body> </env:envelope> 4.8 GETMATCHINGVERSIONS Este método busca la lista de versiones de vehículos que coinciden con los datos aportados en forma de literales para marca, modelo, versión, potencia, etc Datos de entrada: GetMatchingVersionsRequest getmatchingversionsrequest Estructura de datos necesaria para buscar las versiones del vehículo. Datos de salida: GetMatchingVersionsResponse getmatchingversionsresponse Lista de versiones del vehículo que coinciden. Página 34

de 168 Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getmatchingversionsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:brand>?</xs:brand> <xs:model>?</xs:model> <xs:modelsearchmode>?</xs:modelsearchmode> <xs:version>?</xs:version> <xs:versionsearchmode>?</xs:versionsearchmode> <xs:description>?</xs:description> <xs:descriptionsearchmode>?</xs:descriptionsearchmode> <xs:enginetype>?</xs:enginetype> <xs:displacementmin>?</xs:displacementmin> <xs:displacementmax>?</xs:displacementmax> <xs:powermin>?</xs:powermin> <xs:powermax>?</xs:powermax> <xs:doorsnumbermin>?</xs:doorsnumbermin> <xs:doorsnumbermax>?</xs:doorsnumbermax> <xs:releasemarketdatemin>?</xs:releasemarketdatemin> <xs:releasemarketdatemax>?</xs:releasemarketdatemax> <xs:exworkspricemin>?</xs:exworkspricemin> <xs:exworkspricemax>?</xs:exworkspricemax> <xs:pricingmin>?</xs:pricingmin> <xs:pricingmax>?</xs:pricingmax> </xs:getmatchingversionsrequest> </soap:body> Página 35

de 168 </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getmatchingversionsresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:versions>  <ns3:version> <ns3:code>?</ns3:code> <ns3:name>?</ns3:name> <ns3:description>?</ns3:description> <ns3:displacement>?</ns3:displacement> <ns3:enginepower>?</ns3:enginepower> <ns3:doorsnumber>?</ns3:doorsnumber> <ns3:releasemarketdate>?</ns3:releasemarketdate> <ns3:exworkprice>?</ns3:exworkprice> <ns3:price>?</ns3:price> </ns3:version> </ns3:versions> </ns3:getversionsresponse> </env:body> </env:envelope> 4.9 GETVEHICLEACCESSORIESBYVERSIONID Este método recupera la lista de accesorios disponibles para el identificador de la versión indicado. Si se indica la fecha de matriculación del vehículo, mostrará sólo aquellos accesorios que estuviesen vigentes en el momento de la matriculación. Datos de entrada: GetVehicleAccessoriesByVersionIdRequest getvehicleaccessoriesbyversionidrequest Estructura de datos necesaria para obtener los accesorios del vehículo. Datos de salida: GetVehicleAccessoriesByVersionIdResponse getvehicleaccessoriesbyversionidresponse Lista de accesorios del vehículo. Página 36

de 168 Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getvehicleaccessoriesbyversionidrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:versionid>?</xs:versionid> <xs:matriculationdate>?</xs:matriculationdate> </xs: getvehicleaccessoriesbyversionidrequest > </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getvehicleaccessoriesbyversionidresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:accessories>  <ns3:accessory> <ns3:code>?</ns3:code> <ns3:optionpackcode>?</ns3:optionpackcode> <ns3:description>?</ns3:description> <ns3:ispack>?</ns3:ispack> <ns3:startdate>?</ns3:startdate> <ns3:enddate>?</ns3:enddate> <ns3:exworkprice>?</ns3:exworkprice> <ns3:retailprice>?</ns3:retailprice> <ns3:currency>?</ns3:currency> </ns3:accessory> </ns3:accessories> </ns3:getvehicleaccessoriesbyversionidresponse> </env:body> </env:envelope> Página 37

de 168 4.10 GETVEHICLEACCESSORIESBYVERSIONBASE7CODE Este método recupera la lista de accesorios disponibles para la versión indicada, a partir de su código base7. Si se indica la fecha de matriculación del vehículo, mostrará sólo aquellos accesorios que estuviesen vigentes en el momento de la matriculación. Datos de entrada: GetVehicleAccessoriesByVersionBase7CodeRequest getvehicleaccessoriesbyversionbase7coderequest Estructura de datos necesaria para obtener los accesorios del vehículo. Datos de salida: GetVehicleAccessoriesByVersionBase7CodeResponse getvehicleaccessoriesbyversionbase7coderesponse Lista de accesorios del vehículo. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getvehicleaccessoriesbyversionbase7coderequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:base7code>?</xs:base7code> <xs:matriculationdate>?</xs:matriculationdate> </xs:getvehicleaccessoriesbyversionbase7coderequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getvehicleaccessoriesbyversionbase7coderesponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   Página 38

de 168 <ns3:error>?</ns3:error>  <ns3:accessories>  <ns3:accessory> <ns3:code>?</ns3:code> <ns3:optionpackcode>?</ns3:optionpackcode> <ns3:description>?</ns3:description> <ns3:ispack>?</ns3:ispack> <ns3:startdate>?</ns3:startdate> <ns3:enddate>?</ns3:enddate> <ns3:exworkprice>?</ns3:exworkprice> <ns3:retailprice>?</ns3:retailprice> <ns3:currency>?</ns3:currency> </ns3:accessory> </ns3:accessories> </ns3:getvehicleaccessoriesbyversionbase7coderesponse> </env:body> </env:envelope> 4.11 GETTOWNSFROMPOSTALCODE Este método recupera la lista de poblaciones que poseen el código postal indicado. Datos de entrada: GetTownsFromPsotalCodeRequest gettownsfrompsotalcoderequest Estructura de datos necesaria para obtener la lista de poblaciones. Datos de salida: GetTownsFromPsotalCodeResponse gettownsfrompsotalcoderesponse Lista de poblaciones que poseen el código postal. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:gettownsfrompostalcoderequest> <xs:authentication>  <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <xs:postalcode>?</xs:postalcode> <xs:country>?</xs:country> </xs:gettownsfrompostalcoderequest> </soap:body> </soap:envelope> Página 39

de 168 Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:gettownsfrompostalcoderesponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:code>?</ns3:code>   <ns3:error>?</ns3:error>  <ns3:towns>  <ns3:town> <ns3:code>?</ns3:code> <ns3:name>?</ns3:name> </ns3:town> </ns3:towns> </ns3:gettownsfrompostalcoderesponse> </env:body> </env:envelope> 4.12 GETREGISTRATIONDATEBYPLATE Este método recupera la fecha en la que se registró un vehículo en base a su matrícula. Datos de entrada: GetRegistrationDateByPlateRequest getregistrationdatebyplaterequest Estructura de datos necesaria para obtener la fecha de registro del vehículo. Datos de salida: GetRegistrationDateByPlateResponse getregistrationdatebyplateresponse Fecha de registro del vehículo. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getregistrationdatebyplaterequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> Página 40

de 168 <xs:plate>?</xs:plate> </xs:getregistrationdatebyplaterequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns3:getregistrationdatebyplateresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns3:registrationdate>?</ns3:registrationdate> </ns3:getregistrationdatebyplateresponse> </env:body> </env:envelope> 4.13 EXPORTPOLICIESDATA Este método permite exportar los datos de las pólizas emitidas en el formato que la organización del usuario tenga definido. Datos de entrada: ExportPoliciesDataRequest exportpoliciesdatarequest Estructura de datos necesaria para obtener las pólizas que se desea exportar. Datos de salida: ExportPoliciesDataResponse exportpoliciesdataresponse Datos de las pólizas obtenidas en formato base64. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:exportpoliciesdatarequest> <xs:authentication>  <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <xs:organizationid>?</xs:organizationid> <xs:fromdate>?</xs:fromdate> <xs:todate>?</xs:todate> Página 41

de 168 <xs:includechildorganizations>?</xs:includechildorganizations> <xs:productid>?</xs:productid> <xs:companies>  <xs:company>?</xs:company> </xs:companies> <xs:quotationid>?</xs:quotationid> </xs:exportpoliciesdatarequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns2:exportpoliciesdataresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns2:code>?</ns2:code>   <ns2:error>?</ns2:error>  <ns2:data>?</ns2:data> </ns2:exportpoliciesdataresponse > </env:body> </env:envelope> 4.14 GETPOLICYDOCUMENT Este método permite obtener los documentos emitidos en la contratación de los productos seleccionados para un presupuesto. Estos documentos se obtienen en base64. Datos de entrada: GetPolicyDocumentRequest getpolicydocumentrequest Estructura de datos necesaria para obtener los documentos. Datos de salida: GetPolicyDocumentResponse getpolicydocumentresponse Estructura de datos que contiene los documentos emitidos. Página 42

de 168 Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getpolicydocumentrequest> <xs:authentication>  <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication>   <xs:quotationid>?</xs:quotationid>  <xs:policynumber>?</xs:policynumber> </xs:getpolicydocumentrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns2:getpolicydocumentresponse xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns2:code>?</ns2:code>   <ns2:error>?</ns2:error>  <ns2:issuedproducts></ns2:issuedproducts>  <ns2:issuedproduct> <ns2:companyname>?</ns2:companyname> <ns2:productcompanyid>?</ns2:productcompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:complementary>?</ns2:complementary> <ns2:policynumber>?</ns2:policynumber> <ns2:documents>  <ns2:document> <ns2:documentname>?</ns2:documentname> <ns2:documenttype>?</ns2:documenttype> <ns2:documentcontent>?</ns2:documentcontent> </ns2:document> </ns2:documents> Página 43

de 168 </ns2:issuedproduct> </ns2:exportpoliciesdataresponse > </env:body> </env:envelope> 4.15 GETINSURANCETYPES Este método permite recuperar los ramos de seguros que se permiten tarificar a través del API de Avant2. Datos de entrada: GetInsuranceTypesRequest getinsurancetypesrequest Estructura de datos necesaria para obtener los ramos de seguros soportados por API. Datos de salida: GetInsuranceTypesResponse getinsurancetypesresponse Estructura que contiene los ramos de seguros soportados por API. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getinsurancetypesrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> </xs:getinsurancetypesrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns4:getinsurancetypesresponse xmlns:ns4="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns5="http://www.codeoscopic.com/avant/2016/car/xmlschema" Página 44

de 168 xmlns:ns6="http://www.codeoscopic.com/avant/2016/home/xmlschema" xmlns:ns7="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns4:code>?</ns4:code>  <ns4:error>?</ns4:error> <ns4:products>  <ns4:product> <ns4:code>?</ns4:code> <ns4:name>?</ns4:name> </ns4:product> </ns4:products> </ns4:getinsurancetypesresponse> </env:body> </env:envelope> 4.16 GETPRODUCTS Este método permite recuperar la lista de productos de las compañías del ramo introducido como parámetro y que se encuentre soportado por el API. Datos de entrada: GetProductsRequest getproductsrequest Estructura de datos necesaria para obtener los productos de las compañías de los ramos de seguros soportados por API. Datos de salida: GetProductsResponse getproductsresponse Estructura que contiene los productos de las compañías de los ramos de seguros soportados por API. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getproductsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:productcommercialid>?</xs:productcommercialid> </xs:getproductsrequest> </soap:body> Página 45

de 168 </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns4:getproductsresponse xmlns:ns4="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns5="http://www.codeoscopic.com/avant/2016/car/xmlschema" xmlns:ns6="http://www.codeoscopic.com/avant/2016/home/xmlschema" xmlns:ns7="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns4:code>?</ns4:code>  <ns4:error>?</ns4:error> <ns4:products>  <ns4:product> <ns4:id>?</ns4:id> <ns4:description>?</ns4:description> </ns4:product> </ns4:products> </ns4:getproductsresponse> </env:body> </env:envelope> 4.17 GETPAYMENTTYPES Este método permite recuperar las formas de pago permitidas para un producto concreto. Datos de entrada: GetPaymentTypesRequest getpaymenttypesrequest Estructura de datos necesaria para obtener las formas de pago permitidas para un producto de una compañía, introducido como parámetro. Datos de salida: GetPaymentTypesResponse getpaymenttypesresponse Estructura de datos que contiene los datos de las formas de pago del producto. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: Página 46

de 168 <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getpaymenttypesrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:productid>?</xs:productid> </xs:getpaymenttypesrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns4:getpaymenttypesresponse xmlns:ns4="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns5="http://www.codeoscopic.com/avant/2016/car/xmlschema" xmlns:ns6="http://www.codeoscopic.com/avant/2016/home/xmlschema" xmlns:ns7="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns4:code>?</ns4:code>  <ns4:error>?</ns4:error> <ns4:types> <ns4:type> <ns4:id>?</ns4:id> <ns4:name>?</ns4:name> </ns4:type> </ns4:types> </ns4:getpaymenttypesresponse> </env:body> </env:envelope> 4.18 GETINSTALLMENTS Este método permite recuperar los fraccionamientos de pago permitidos para un producto concreto. Datos de entrada: Página 47

de 168 GetInstallmentsRequest getinstallmentsrequest Estructura de datos necesaria para obtener los datos de los fraccionamientos de los recibos para el producto de una compañía. Datos de salida: GetInstallmentsResponse getinstallmentsresponse Estructura de datos que contiene los fraccionamientos permitidos para los recibos del producto. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:xs1="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getinstallmentsrequest> <xs1:authentication>  <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:productid>?</xs:productid> </xs:getinstallmentsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns4:getinstallmentsresponse xmlns:ns4="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns5="http://www.codeoscopic.com/avant/2016/car/xmlschema" xmlns:ns6="http://www.codeoscopic.com/avant/2016/home/xmlschema" xmlns:ns7="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns4:code>?</ns4:code>  <ns4:error>?</ns4:error> <ns4:types>  <ns4:type> <ns4:id>?</ns4:id> <ns4:name>?</ns4:name> <ns4:installments>?</ns4:installments> </ns4:type> Página 48

de 168 </ns4:types> </ns4:getinstallmentsresponse> </env:body> </env:envelope> 4.19 GETPERSONDESCRIPTORS Este método permite recuperar los datos necesarios de cada una de las figuras intervinientes en la póliza en las fases de cotización, preemisión y emisión. Se pueden obtener los datos tanto para un ramo en general como para el producto de una compañía en concreto. En fase de cotización, todos los productos del mismo ramo requieren los mismos datos. Pero, en fase de preemisión y emisión, los datos requeridos pueden variar dependiendo de la compañía del producto. Datos de entrada: GetPersonDescriptorsRequest getpersondescriptorsrequest Estructura de datos necesaria para obtener los datos necesarios de cada una de las figuras en una fase determinada. Esta estructura contiene los campos de identificador del tipo de seguro o producto y la fase necesarios para obtener la información de las figuras. Datos de salida: GetPersonDescriptorsResponse getpersondescriptorsresponse Estructura de datos que contiene los datos de cada de una de las figuras para la fase especificada. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ws2="http://www.codeoscopic.com/avant/2016/ws/xmlschema"> <soap:header/> <soap:body> <ws2:getpersondescriptorsrequest> <ws:authentication>  <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication>  <ws2:insurancetypeid>?</ws2:insurancetypeid> <ws2:productid>?</ws2:productid> <ws2:stage>?</ws2:stage> </ws2:getpersondescriptorsrequest> </soap:body> </soap:envelope> Página 49

de 168 Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws2="http://www.codeoscopic.com/avant/2016/ws/xmlschema"> <soap:header/> <soap:body> <ws2:getpersondescriptors2request> <ws2:code>?</ws2:code>  <ws2:error>?</ws2:error>  <ws2:persondescriptor> <ws2:role>?</ws2:role> <ws2:required>?</ws2:required> <ws2:overwritable>?</ws2:overwritable> <ws2:corporateallowed>?</ws2:corporateallowed> <ws2:fields>  <ws2:field>  <ws2:name>?</ws2:name> <ws2:required>?</ws2:required> </ws2:field> </ws2:fields> </ws2:persondescriptor> </ws2:getpersondescriptors2request> </soap:body> </soap:envelope> 4.20 SEARCHQUOTATIONS Este método permite recuperar los datos de las cotizaciones realizadas en función de unos parámetros de búsqueda. Permite recuperar los datos en modo simple o extendido. El modo simple recupera sólo los datos básicos de las cotizaciones, mientras que el modo extendido recuperar todos los datos de las cotizaciones, pero el tiempo necesario para recuperar estos datos es mucho mayor, por lo que debe utilizarse para búsquedas más acotadas. Datos de entrada: SearchQuotationsRequest searchquotationsrequest Página 50

de 168 Estructura de datos necesaria para obtener los datos de las cotizaciones. Esta estructura contiene los campos por los que se puede filtrar la búsqueda, y el indicador del modo en el que se quieren recuperar los datos. Datos de salida: SearchQuotationsResponse searchquotationsresponse Estructura de datos que contiene los datos de las pólizas. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:searchquotationsrequest> <xs:authentication>  <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <xs:filter>  <xs:quotationid>?</xs:quotationid> <xs:fromdate>?</xs:fromdate> <xs:todate>?</xs:todate> <xs:productid>?</xs:productid> <xs:holderidentification>?</xs:holderidentification> <xs:holdername>?</xs:holdername> <xs:holderfirstsurname>?</xs:holderfirstsurname> <xs:holdersecondsurname>?</xs:holdersecondsurname> <xs:organizationid>?</xs:organizationid> <xs:includesuborganizations>?</xs:includesuborganizations> <xs:useralias>?</xs:useralias> <xs:stateid>?</xs:stateid> <xs:issuancecompany>?</xs:issuancecompany> <xs:policynumber>?</xs:policynumber> Página 51

de 168 <xs:plate>?</xs:plate> <xs:postalcode>?</xs:postalcode> <xs:fromissuedate>?</xs:fromissuedate> <xs:toissuedate>?</xs:toissuedate> </xs:filter> <xs:extended>?</xs:extended> </xs:searchquotationsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns2:searchquotationsresponse xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns2:code>?</ns2:code>   <ns2:error>?</ns2:error>  <ns2:quotations>  <ns2:quotation> <ns2:quotationid>?</ns2:quotationid> <ns2:quotationurl>?</ns2:quotationurl> <ns2:creationdate>?</ns2:creationdate> <ns2:effectdate>?</ns2:efectdate> <ns2:product>?</ns2:product> <ns2:state>?</ns2:state> <ns2:issuedcompanyname>?</ns2:issuedcompanyname> <ns2:organization>?</ns2:organization> <ns2:user>?</ns2:user> <ns2:holder>?</ns2:holder> <ns2:risksummary>?</ns2:risksummary> <ns2:risk>?</ns2:risk> <ns2:issuances>?</ns2:issuances> </ns2:quotation> </ns2:quotations> Página 52

de 168 </ns2:searchquotationsresponse> </env:body> </env:envelope> 4.21 GETQUOTATIONRESULTS Este método permite obtener los precios devueltos por las compañías para un presupuesto. Datos de entrada: GetQuotationResultsRequest getquotationresultsrequest Estructura de datos necesaria para obtener los resultados de la tarificación. Datos de salida: GetQuotationResultsResponse getquotationresultsresponse Estructura de datos que contiene los precios devueltos por las compañías. Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xs="http://www.codeoscopic.com/avant/2011/ws/xmlschema"> <soap:header/> <soap:body> <xs:getquotationresultsrequest> <xs:authentication>  <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <xs:quotationid>?</xs:quotationid> </xs:getquotationresultsrequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> <ns2:getquotationresultsresponse xmlns:ns2="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ns3="http://www.codeoscopic.com/avant/2011/car/xmlschema" xmlns:ns4="http://www.codeoscopic.com/avant/2011/xmlschema"> <ns2:code>?</ns2:code>   Página 53

de 168 order--> order--> order--> order--> <ns2:error>?</ns2:error>  <ns2:results>  <ns2:quotationid>?</ns2:quotationid> <ns2:quotationurl>?</ns2:quotationurl> <ns2:mainproductsresults>  <ns2:resultslist>  <ns2:companyname>?</ns2:companyname> <ns2:produccompanyid>?</ns2:produccompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:state>  <ns2:pricelist>  <ns2:resultslist>  <ns2:companyname>?</ns2:companyname> <ns2:produccompanyid>?</ns2:produccompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:state> <!--You may enter the following 2 items in any <ns2:id>?</ns2:id> <ns2:description>?</ns2:description> </ns2:state> Página 54

de 168 order--> <ns2:prices>  <ns2:pricelist>  <ns2:id>?</ns2:id> <ns2:name>?</ns2:name> <ns2:rating>?</ns2:rating> <ns2:deductible>?</ns2:deductible> </ns2:modality> <ns2:firstbill>?</ns2:firstbill> </ns2:pricelist> </ns2:prices> </ns2:resultslist> </ns2:complementaryproductsresults> <ns2:tuningdatawarings>  <ns2:productcompanywarings> <ns2:productcompanyid>?</ns2:productcompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:warnings>  <ns2:warning>?</ns2:warning> </ns2:warnings> </ns2:productcompanywarings> </ns2:tuningdatawarings> </ns2:results> </ns2:getquotationresultsresponse> </env:body> </env:envelope> 4.22 PREPAREQUOTE Este método recibe como parámetro de entrada una estructura con los datos necesarios para realizar una tarificación en Avant, y si la información aportada es correcta, devuelve una url en la que se podrá abrir el frontend de Avant con el tren de cotización cargado con los datos enviados. Entre los datos que recibe debe encontrarse el alias del usuario con el que se quiere realizar la cotización, y puede indicarse también el alias de la organización a la que pertenece dicho usuario. De esta forma el frontend de Avant se abrirá con este usuario autenticado en el sistema. La ejecución de este método es muy sencilla en si misma. Extrae el alias del usuario y de la organización de los datos que recibe y busca en la base de datos de Avant si existe un Página 55

de 168 usuario con esos datos. Si no lo encuentra, o encuentra más de uno, devuelve un error, indicando que hay algún problema con el usuario indicado. Si lo encuentra, genera un token único para la petición y devuelve una url formada por la url de avant, seguida del path de integración (/integration) y el parámetro token, con el token generado: http://mt.avant2.es/avant/integration?token=9a5f3eac-bf3d-4fd0-becd-96e585795851 Al acceder a esta url se marca el token como consumido, de forma que la url dejará de ser válida, y se muestra el tren de cotización de Avant, con los datos que se le habían pasado al servicio web cargados. El tipo de riesgo dependerá del ramo que estemos preemitiendo. Los posibles tipos de riesgo son: Ramo Namespace Tipo de dato Autos Hogar http://www.codeoscopic.com/avant/2016/car/x MLSchema http://www.codeoscopic.com/avant/2016/hom e/xmlschema AutosRisk HomeRisk Datos de entrada: PrepareQuoteRequest preparequoterequest Datos necesarios para cargar la cotización en el frontend de Avant Página 56

de 168 Datos de salida: PrepareQuoteResponse preparequoteresponse Respuesta del servicio con la url del frontend de Avant si todo ha ido bien. Ejemplo de mensaje SOAP 1.2 que se debe enviar, con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:ws="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ws2="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:car="http://www.codeoscopic.com/avant/2016/car/xmlschema"> <soap:header/> <soap:body> <ws2:preparequoterequest> <ws:authentication>  <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication> <ws2:effectdate>?</ws2:effectdate> <ws2:risk xsi:type="car:autosrisk"> <ws2:tunings>  <ws2:tuning> <ws2:productid>?</ws2:productid> <ws2:tuningjson>?</ws2:tuningjson> </ws2:tuning> </ws2:tunings> <car:base7>  <car:base7code>?</car:base7code> <car:avantversioncode>?</car:avantversioncode> </car:base7> <car:plate>?</car:plate> <car:matriculationdate>?</car:matriculationdate> <car:purchasedate>?</car:purchasedate> <ws2:postalcode>?</ws2:postalcode> <ws2:townid>?</ws2:townid> <car:trailer>?</car:trailer> <car:garagetype>?</car:garagetype> <car:yearkilometers>?</car:yearkilometers> <car:habitualdriver> <ws:identificationtype>?</ws:identificationtype> <ws:identification>?</ws:identification> <ws:name>?</ws:name> <ws:firstsurname>?</ws:firstsurname> Página 57

de 168 <ws:secondsurname>?</ws:secondsurname> <ws:birthdate>?</ws:birthdate> <ws:gender>?</ws:gender> <ws:postaladdress> <ws:postalcode>?</ws:postalcode> <ws:town>?</ws:town> <ws:streettype>?</ws:streettype> <ws:streetname>?</ws:streetname> <ws:number>?</ws:number> <ws:rest>?</ws:rest> <ws:country>?</ws:country> </ws:postaladdress> <ws:mainphone>?</ws:mainphone> <ws:otherphone>?</ws:otherphone> <ws:email>?</ws:email> <ws:contactlanguage>?</ws:contactlanguage> <ws:personpermissiondate>?</ws:personpermissiondate> <ws:personexpeditionzone>?</ws:personexpeditionzone> <ws:personmaritalstatus>?</ws:personmaritalstatus> <ws:nationality>?</ws:nationality> </car:habitualdriver> <car:owner> <ws:identificationtype>?</ws:identificationtype> <ws:identification>?</ws:identification> <ws:name>?</ws:name> <ws:firstsurname>?</ws:firstsurname> <ws:secondsurname>?</ws:secondsurname> <ws:birthdate>?</ws:birthdate> <ws:gender>?</ws:gender> <ws:postaladdress> <ws:postalcode>?</ws:postalcode> <ws:town>?</ws:town> <ws:streettype>?</ws:streettype> <ws:streetname>?</ws:streetname> <ws:number>?</ws:number> <ws:rest>?</ws:rest> <ws:country>?</ws:country> Página 58

de 168 </ws:postaladdress> <ws:mainphone>?</ws:mainphone> <ws:otherphone>?</ws:otherphone> <ws:email>?</ws:email> <ws:contactlanguage>?</ws:contactlanguage> <ws:personpermissiondate>?</ws:personpermissiondate> <ws:personexpeditionzone>?</ws:personexpeditionzone> <ws:personmaritalstatus>?</ws:personmaritalstatus> <ws:nationality>?</ws:nationality> </car:owner> <car:occasionaldriver> <ws:identificationtype>?</ws:identificationtype> <ws:identification>?</ws:identification> <ws:name>?</ws:name> <ws:firstsurname>?</ws:firstsurname> <ws:secondsurname>?</ws:secondsurname> <ws:birthdate>?</ws:birthdate> <ws:gender>?</ws:gender> <ws:postaladdress> <ws:postalcode>?</ws:postalcode> <ws:town>?</ws:town> <ws:streettype>?</ws:streettype> <ws:streetname>?</ws:streetname> <ws:number>?</ws:number> <ws:rest>?</ws:rest> <ws:country>?</ws:country> </ws:postaladdress> <ws:mainphone>?</ws:mainphone> <ws:otherphone>?</ws:otherphone> <ws:email>?</ws:email> <ws:contactlanguage>?</ws:contactlanguage> <ws:personpermissiondate>?</ws:personpermissiondate> <ws:personexpeditionzone>?</ws:personexpeditionzone> Página 59

de 168 <ws:personmaritalstatus>?</ws:personmaritalstatus> <ws:nationality>?</ws:nationality> </car:occasionaldriver> <car:previousplate>?</car:previousplate> <car:previouspolicy>?</car:previouspolicy> <car:previouscompany>?</car:previouscompany> <car:previouscompanydgs>?</car:previouscompanydgs> <car:yearsinpreviouscompany>?</car:yearsinpreviouscompany> <car:yearswithoutaccident>?</car:yearswithoutaccident> <car:lasttwoyearsaccidents>?</car:lasttwoyearsaccidents> <car:referenceprice>?</car:referenceprice> <car:totalyearsinsured>?</car:totalyearsinsured> <car:yearsinpreviouscompanynum>?</car:yearsinpreviouscompanynum> <car:yearswithoutaccidentsnum>?</car:yearswithoutaccidentsnum> <car:lastfiveyearsaccidents>?</car:lastfiveyearsaccidents> <car:accessories>  <car:accessory>  <car:name>?</car:name> <car:value>?</car:value> <car:code>?</car:code> </car:accessory> </car:accessories> <car:nonbase7accessories>  <car:accessory>  <car:name>?</car:name> <car:value>?</car:value> <car:type>?</car:type> </car:accessory> </car:nonbase7accessories> </ws2:risk> <ws2:holder> <ws:identificationtype>?</ws:identificationtype> <ws:identification>?</ws:identification> <ws:name>?</ws:name> <ws:firstsurname>?</ws:firstsurname> <ws:secondsurname>?</ws:secondsurname> Página 60

de 168 <ws:birthdate>?</ws:birthdate> <ws:gender>?</ws:gender> <ws:postaladdress> <ws:postalcode>?</ws:postalcode> <ws:town>?</ws:town> <ws:streettype>?</ws:streettype> <ws:streetname>?</ws:streetname> <ws:number>?</ws:number> <ws:rest>?</ws:rest> <ws:country>?</ws:country> </ws:postaladdress> <ws:mainphone>?</ws:mainphone> <ws:otherphone>?</ws:otherphone> <ws:email>?</ws:email> <ws:contactlanguage>?</ws:contactlanguage> <ws:personpermissiondate>?</ws:personpermissiondate> <ws:personexpeditionzone>?</ws:personexpeditionzone> <ws:personmaritalstatus>?</ws:personmaritalstatus> <ws:nationality>?</ws:nationality> </ws2:holder> <ws2:alias> <ws:useralias>?</ws:useralias> <ws:organizationalias>?</ws:organizationalias> </ws2:alias> <ws2:bankaccount>  <ws2:iban>?</ws2:iban> <ws2:ccc> <ws:entity>?</ws:entity> <ws:office>?</ws:office> <ws:controldigits>?</ws:controldigits> <ws:accountnumber>?</ws:accountnumber> </ws2:ccc> </ws2:bankaccount> </ws2:preparequoterequest> </soap:body> </soap:envelope> Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: Página 61

de 168 <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:ws2="http://www.codeoscopic.com/avant/2016/ws/xmlschema"> <soap:header/> <soap:body> <ws2:preparequoteresponse> <ws2:code>?</ws2:code>  <ws2:url>?</ws2:url> <ws2:error>?</ws2:error> </ws2:preparequoteresponse> </soap:body> </soap:envelope> 4.23 QUOTE Este método recibe como parámetro de entrada una estructura con los datos necesarios para realizar una tarificación en Avant, y si la información aportada es correcta, lanza el proceso de cotización y devuelve una estructura con los precios obtenidos. El proceso es muy similar al de preparequote, primero se obtiene los alias del usuario y la organización y se validan sus credenciales. Tras esta validación, se inicia el proceso de cotización en Avant. Este proceso se queda esperando a que las diferentes compañías de las que se intenta obtener precios devuelvan sus resultados, durante un periodo de tiempo determinado. Si en ese periodo no se han obtenido precios de las compañías, el servicio devolverá un error. Con los precios obtenidos de las diferentes compañías se monta la estructura de datos que se devuelve. Dado que la cotización con las diferentes compañías se está llevando a cabo en este instante, este método puede tardar en ejecutarse, por lo que es recomendable incrementar el timeout del servicio en la llamada. El tipo de riesgo dependerá del ramo que estemos preemitiendo. Los posibles tipos de riesgo son: Ramo Namespace Tipo de dato Autos Hogar http://www.codeoscopic.com/avant/2016/car/x MLSchema http://www.codeoscopic.com/avant/2016/hom e/xmlschema AutosRisk HomeRisk Página 62

de 168 Datos de entrada: QuoteRequest quoterequest Datos necesarios para realizar la cotización en Avant. Datos de salida: QuoteResponse quoteresponse Respuesta con el número de cotización en Avant y los precios para las diferentes compañías Ejemplo de mensaje SOAP 1.2 con detalle de validación de esquema: <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap="http://www.w3.org/2003/05/soap-envelope" xmlns:xsi="http://www.w3.org/2001/xmlschema-instance" xmlns:ws="http://www.codeoscopic.com/avant/2011/ws/xmlschema" xmlns:ws2="http://www.codeoscopic.com/avant/2016/ws/xmlschema" xmlns:car="http://www.codeoscopic.com/avant/2016/car/xmlschema"> <soap:header/> <soap:body> <ws2:quoterequest> <ws:authentication>  <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication> <ws2:effectdate>?</ws2:effectdate> Página 63