Integration Avant2 API Copyright Codeoscopic S.A.

Transcripción

1 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. Confidencial

2 Página 2 de 168 HISTORIAL DE VERISONES Versión Fecha Modificación V /05/2012 V /04/2013 Método getversions: Se añade el parámetro category V /05/2013 Nuevo método getquotationresults V /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 /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 /11/2016 Nuevos métodos: getinsurancetypes, getproducts, getpaymenttypes, getinstallments, getpersondescriptors, preparequote, quote, preissue, issue, getissuanceresult, getproductcompanytuningsdefaultvalues, getproductcompanytuningsvalues, getjobs y getproductlist. Página 2

3 Página 3 de 168 ÍNDICE DE CONTENIDO 1 Objetivo Servicio Web Autenticación Métodos Expuestos echodummy PrepareCarQuote (Obsoleto) CarQuote (Obsoleto) getenginetypes getbrands getmodels getversions getmatchingversions getvehicleaccessoriesbyversionid getvehicleaccessoriesbyversionbase7code gettownsfrompostalcode getregistrationdatebyplate exportpoliciesdata getpolicydocument getinsurancetypes getproducts getpaymenttypes getinstallments getpersondescriptors searchquotations getquotationresults preparequote quote preissue issue Página 3

4 Página 4 de getissuanceresult getproductcompanytuningsdefaultvalues getproductcompanytuningsvalues getjobs getproductlist Tipos de Datos PrepareCarQuoteRequestType PrepareCarQuoteResponse CarQuoteRequestType CarQuoteResponse GetEngineTypesResponse GetBrandsRequest GetBrandsResponse GetModelsRequest GetModelsResponse GetVersionsRequest GetVersionsResponse GetMatchingVersionsRequest GetMatchingVersionsResponse GetVehicleAccessoriesByVersionIdRequest GetVehicleAccessoriesByVersionIdResponse GetVehicleAccessoriesByBase7CodeRequest GetVehicleAccessoriesByVersionIdResponse GetTownsFromPostalCodeRequest GetTownsFromPostalCodeResponse GetRegistrationDateByPlateRequest GetRegistrationDateByPlateResponse ExportPoliciesDataRequest ExportPoliciesDataResponse GetPolicyDocumentRequest GetPolicyDocumentResponse GetInsuranceTypesResponse Página 4

5 Página 5 de GetProductsRequest GetProductsResponse GetPaymentTypesRequest GetPaymentTypesResponse GetInstallmentsRequest GetInstallmentsResponse GetPersonDescriptorsRequest GetPersonDescriptorsResponse PersonDescriptor PersonFieldList PersonField SearchQuotationsRequest SearchQuotationsResponse GetQuotationResultsRequest GetQuotationResultsResponse Car ProductCommercialApiList ProductCommercialApiSupport ProductCompanyList ProductCompany PaymentTypesApiList InstallmentsApiList PersonsDescriptorsApiList PersonDescriptor Base7Version Person PersonDriver ComplementaryData Accessories Accessory NonBase7Accessories NonBase7Accessory Página 5

6 Página 6 de UserIdentification QuotationResults QuotationCompanyResultsList QuotationCompanyResults QuotationTaskState QuotationResultPriceList QuotationResultPrice TuningsList ProductCopmanyTuning TuningValuesList TuningValue ProductCompanyTuningWarningsList ProductCompanyTuningWarnings WarningsList Modality ProductModality EngineTypesList EngineType VehicleBrandList VehicleBrand VehicleModelsList VehicleModel VehicleVersionsList VehicleVersion VehicleAccessoriesList VehicleAccessory TownsList Town BankData PostalAddress IssuedProductsList IssuedProduct Página 6

7 Página 7 de DocumentsList Document QuotationSearchFilter QuotationSearchResultsList QuotationSummary PersonSummary RiskSummary CarSummary HomeSummary LastPolicySummary SinistersHistorySummary IssuanceSummariesList IssuanceSummary PrepareQuoteRequest AutosRisk HomeRisk AddressPostalCodeAndTown PrepareQuoteResponse QuoteRequest QuoteResponse PreissueRequest PreissuanceProduct PreissuanceAutosRisk TuningList ProductTuning PreissuanceHomeRisk PreissueResponse PreissuanceResult ProductResult ProductCompany ComplementaryProductResultList ResultPrice Página 7

8 Página 8 de ConditionList Modality Installment PaymentType IssueRequest IssuanceAutosRisk IssuanceHomeRisk JewelList Jewel SpecialValueObjectList SpecialValueObject DangerousDogList DangerousDog IssueResponse IssuanceError IssuanceResult IssuanceProductResult IssuanceComplementaryProductResultList GetIssuanceResultRequest GetIssuanceResultResponse GetProductCompanyTuningsDefaultValuesRequest GetProductCompanyTuningsDefaultValuesResponse GetProductCompanyTuningsValuesRequest GetProductCompanyTuningsValuesResponse ProductCompanyTuningValues FieldTuningValues FieldTuningOption getjobsrequest getjobsresponse JobsList Job getproductlistrequest Página 8

9 Página 9 de getproductlistresponse ProductListItemList ProductListItem Tipos de datos JSON (descuentos y coberturas) Tipos de datos simples Fechas Tipos de datos complejos País Código postal Población Tipo de vía Dirección postal Plus Ultra Autos: Opciones / Packs de vehículos Mutua Madrileña Autos: Opciones / Packs Base Mutua Madrileña Autos: Accesorios no Base Liberty Autos: Desglose de vehículos asegurados en Liberty Reale Hogar: Desglose de asegurados Reale Hogar: Desglose de vehículos Reale Hogar: Desglose de animales Nationale Hogar: Desglose de obras de arte Nationale Hogar: Desglose de obras de arte frágiles Nationale Hogar: Desglose de vehículos Nationale Hogar: Desglose de equipamiento profesional Helvetia Hogar H15: Desglose de construcciones anexas Helvetia Hogar H15: Desglose de animales de compañía Helvetia Hogar H15: Desglose de vehículos Fidelidade Hogar: Desglose de vehículos Mapfre Hogar: Desglose de animales de compañía Liberty Hogar: Desglose de vehículos Liberty Hogar: Desglose de otras medidas de seguridad Tablas maestras Género Página 9

10 Página 10 de TipoGaraje TipoCombustible KilometrosAnuales AñosSinAccidentes AntiguedadCompañiaActual Siniestros2ultimosAños TipoIdentificación CompañiasDGS Estado de la cotización EstadoCivil ZonaExpedición TipoAccesorioNoBase CategoriaVehiculo Modalidad de Producto Pais Idioma TipoDeVia HomeSituation HomeType HomeHousingUse HomeHousingRegime HomeBuildQuality HomeMaterial HomeAlarm HomeContractingPattern DogGender IssuanceState Página 10

11 Página 11 de 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

12 Página 12 de 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: Se ha implementando también una versión para SOAP 1.1, cuyo wsdl se encuentra en la url Página 12

13 Página 13 de 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> <!--You may enter the following 2 items in any order--> <xs1:user>codeoscopic</xs1:user> <xs1:key>926e27eecdbc7a ba99bddd</xs1:key> </xs1:authentication> </xs:carquoterequest> Página 13

14 Página 14 de 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: 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

15 Página 15 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=" xmlns:xs=" xmlns:xs1=" xmlns:xsi=" <soap:header/> <soap:body> <xs:preparecarquoterequest> <!--You may enter the following 7 items in any order--> <xs1:authentication> <!--You may enter the following 2 items in any order--> <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs1:risk xsi:type="xs:car"> <!--You may enter the following 12 items in any order--> <xs:base7> Página 15

16 Página 16 de 168 level--> <!--You have a CHOICE of the next 3 items at this <!-- Item 1 - Base7 Literals --> <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> <!-- Item 2 - Base7 Code --> <xs:base7code>?</xs:base7code> <!-- Item 3 Avant Version Code --> <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> <!--You may enter the following 7 items in any order--> <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

17 Página 17 de 168 </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1: >?</xs1: > <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> <!--You may enter the following 7 items in any order--> <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: >?</xs1: > Página 17

18 Página 18 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> <!--You may enter the following 4 items in any order--> <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: >?</xs1: > <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> Página 18

19 Página 19 de 168 <xs1:nationality>?</xs1:nationality> </xs:owner> </xs1:risk> <xs1:holder> <!--You may enter the following 4 items in any order--> <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: >?</xs1: > <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

20 Página 20 de 168 <xs:yearsinpreviouscompany>?</xs:yearsinpreviouscompany> <xs:yearswithoutaccident>?</xs:yearswithoutaccident > <xs:lasttwoyearsaccidents>?</xs:lasttwoyearsaccidents > <xs:referenceprice>?</xs:referenceprice > </xs:complementarydata> <xs:accessories> <!--Zero or more repetitions:--> <xs:accessory> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 --> <xs:name>?</xs:name> <xs:value>?</xs:value> <!-- Item 2 - Base7 Code --> <xs:code>?</xs:code> </xs:accessory> </xs:accessories> <xs:nonbase7accessories> <!--0 to 5 repetitions:--> <xs:accessoryo> <!--You may enter the following 3 items in any order--> <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> <!--1 or more repetitions:--> <xs1:productcompanytuning> <xs1:productcompany>?</xs1:productcompany> <xs1:tuningvalues> <!--1 or more repetitions:--> <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

21 Página 21 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=" <env:header/> <env:body> <ns3:preparecarquoteresponse xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - URL --> <ns3:url>?</ns3:url> <!-- Item 2 - Error --> <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

22 Página 22 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=" xmlns:xs=" xmlns:xs1=" xmlns:xsi=" <soap:header/> <soap:body> <xs:carquoterequest> <!--You may enter the following 7 items in any order--> <xs1:authentication> <!--You may enter the following 2 items in any order--> <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> Página 22

23 Página 23 de 168 level--> <xs1:risk xsi:type="xs:car"> <!--You may enter the following 12 items in any order--> <xs:base7> <!--You have a CHOICE of the next 3 items at this <!-- Item 1 - Base7 Literals --> <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> <!-- Item 2 - Base7 Code --> <xs:base7code>?</xs:base7code> <!-- Item 3 Avant Version Code --> <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> <!--You may enter the following 7 items in any order--> <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

24 Página 24 de 168 <xs1:rest>?</xs1:rest> <xs1:country>?</xs1:country> </xs1:postaladdress> <xs1:mainphone>?</xs1:mainphone> <xs1:otherphone>?</xs1:otherphone> <xs1: >?</xs1: > <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> <!--You may enter the following 7 items in any order--> <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: >?</xs1: > Página 24

25 Página 25 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> <!--You may enter the following 4 items in any order--> <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: >?</xs1: > <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> Página 25

26 Página 26 de 168 </xs:owner> </xs1:risk> <xs1:holder> <!--You may enter the following 4 items in any order--> <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: >?</xs1: > <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

27 Página 27 de 168 <xs:lasttwoyearsaccidents>?</xs:lasttwoyearsaccidents > <xs:referenceprice>?</xs:referenceprice > </xs:complementarydata> <xs:accessories> <!--Zero or more repetitions:--> <xs:accessory> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 --> <xs:name>?</xs:name> <xs:value>?</xs:value> <!-- Item 2 - Base7 Code --> <xs:code>?</xs:code> </xs:accessory> </xs:accessories> <xs:nonbase7accessories> <!--0 to 5 repetitions:--> <xs:accessoryo> <!--You may enter the following 3 items in any order--> <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> <!--1 or more repetitions:--> <xs1:productcompanytuning> <xs1:productcompany>?</xs1:productcompany> <xs1:tuningvalues> <!--1 or more repetitions:--> <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

28 Página 28 de 168 Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env=" <env:header/> <env:body> <ns3:carquoteresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 - Prices --> <ns3:results> <!--You may enter the following 3 items in any order--> <ns4:quotationid>?</ns4:quotationid> <ns4:quotationurl>?</ns4:quotationurl> <ns4:mainproductsresults> <!--Zero or more repetitions:--> <ns4:resultslist> <!--You may enter the following 5 items in any order--> <ns4:companyname>?</ns4:companyname> <ns4:produccompanyid>?</ns4:produccompanyid> <ns4:productcompanyname>?</ns4:productcompanyname> <ns4:companyresultid>?</ns4:companyresultid> <ns4:state> <!--You may enter the following 2 items in any order--> <ns4:id>?</ns4:id> <ns4:description>?</ns4:description> </ns4:state> <ns4:prices> <!--One or more repetitions:--> <ns4:pricelist> <!--You may enter the following 3 items in any order--> <ns4:companypriceid>?</ns4:companypriceid > <ns4:modality> <!--You may enter the following 4 items in any order--> <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

29 Página 29 de 168 order--> order--> </ns4:prices> </ns4:resultslist> </ns4:mainproductsresults> <ns4:complementaryproductsresults> <!--Zero or more repetitions:--> <ns4:resultslist> <!--You may enter the following 5 items in any order--> <ns4:companyname>?</ns4:companyname> <ns4:produccompanyid>?</ns4:produccompanyid> <ns4:productcompanyname>?</ns4:productcompanyname> <ns4:state> <!--You may enter the following 2 items in any <ns4:id>?</ns4:id> <ns4:description>?</ns4:description> </ns4:state> <ns4:prices> <!--One or more repetitions:--> <ns4:pricelist> <!--You may enter the following 3 items in any <ns4:companypriceid>?</ns4:companypriceid > <ns4:modality> <!--You may enter the following 4 items in any order--> <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> <!--One or more repetitions:--> <ns4:productcompanywarings> <ns4:productcompanyid>?</productcompanyid> <ns4:productcompanyname>?</productcompanyname> <ns4:warnings> <!--One or more repetitions:--> <ns4:warning>?</ns4:warning> </ns4:warnings> </ns4:productcompanywarings> </ns4:tuningdatawarings> </ns3:results> </ns3:carquoteresponse> </env:body> </env:envelope> Página 29

30 Página 30 de 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getenginetypesrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns3:getenginetypesresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Engine Types --> <ns3:enginetypes> <!--Zero or more repetitions:--> <ns3:enginetype> <ns3:code>?</ns3:code> Página 30

31 Página 31 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getbrandsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns3:getbrandsresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> Página 31

32 Página 32 de 168 <!-- Item 2 Brands --> <ns3:brands> <!--Zero or more repetitions:--> <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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getmodelsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> Página 32

33 Página 33 de 168 <ns3:getbrandsresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Models --> <ns3:models> <!--Zero or more repetitions:--> <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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getversionsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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

34 Página 34 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=" <env:header/> <env:body> <ns3:getversionsresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Versions --> <ns3:versions> <!--Zero or more repetitions:--> <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

35 Página 35 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getmatchingversionsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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

36 Página 36 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=" <env:header/> <env:body> <ns3:getmatchingversionsresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Versions --> <ns3:versions> <!--Zero or more repetitions:--> <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

37 Página 37 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getvehicleaccessoriesbyversionidrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns3:getvehicleaccessoriesbyversionidresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Accessories --> <ns3:accessories> <!--Zero or more repetitions:--> <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

38 Página 38 de 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getvehicleaccessoriesbyversionbase7coderequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns3:getvehicleaccessoriesbyversionbase7coderesponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> Página 38

39 Página 39 de 168 <ns3:error>?</ns3:error> <!-- Item 2 Accessories --> <ns3:accessories> <!--Zero or more repetitions:--> <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=" xmlns:xs=" <soap:header/> <soap:body> <xs:gettownsfrompostalcoderequest> <xs:authentication> <!--You may enter the following 2 items in any order--> <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

40 Página 40 de 168 Ejemplo de mensaje SOAP 1.2 que devolverá el servicio, con detalle de validación de esquema: <env:envelope xmlns:env=" <env:header/> <env:body> <ns3:gettownsfrompostalcoderesponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns3:code>?</ns3:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> <!-- Item 2 Towns --> <ns3:towns> <!--Zero or more repetitions:--> <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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getregistrationdatebyplaterequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> Página 40

41 Página 41 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=" <env:header/> <env:body> <ns3:getregistrationdatebyplateresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <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=" xmlns:xs=" <soap:header/> <soap:body> <xs:exportpoliciesdatarequest> <xs:authentication> <!--You may enter the following 2 items in any order--> <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

42 Página 42 de 168 <xs:includechildorganizations>?</xs:includechildorganizations> <xs:productid>?</xs:productid> <xs:companies> <!--1 or more repetitions:--> <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=" <env:header/> <env:body> <ns2:exportpoliciesdataresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns2:code>?</ns2:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns2:error>?</ns2:error> <!-- Item 2 Data --> <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

43 Página 43 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=" xmlns:xs=" <soap:header/> <soap:body> <xs:getpolicydocumentrequest> <xs:authentication> <!--You may enter the following 2 items in any order--> <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 quotation id --> <xs:quotationid>?</xs:quotationid> <!-- Item 2 policy number --> <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=" <env:header/> <env:body> <ns2:getpolicydocumentresponse xmlns:ns3=" xmlns:ns2=" xmlns:ns4=" <ns2:code>?</ns2:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns2:error>?</ns2:error> <!-- Item 2 Data --> <ns2:issuedproducts></ns2:issuedproducts> <!--1 or more repetitions:--> <ns2:issuedproduct> <ns2:companyname>?</ns2:companyname> <ns2:productcompanyid>?</ns2:productcompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:complementary>?</ns2:complementary> <ns2:policynumber>?</ns2:policynumber> <ns2:documents> <!--1 or more repetitions:--> <ns2:document> <ns2:documentname>?</ns2:documentname> <ns2:documenttype>?</ns2:documenttype> <ns2:documentcontent>?</ns2:documentcontent> </ns2:document> </ns2:documents> Página 43

44 Página 44 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getinsurancetypesrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns4:getinsurancetypesresponse xmlns:ns4=" xmlns:ns2=" xmlns:ns3=" xmlns:ns5=" Página 44

45 Página 45 de 168 xmlns:ns6=" xmlns:ns7=" <ns4:code>?</ns4:code> <!--You have a CHOICE of the next 2 items at this level--> <ns4:error>?</ns4:error> <ns4:products> <!--Zero or more repetitions:--> <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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getproductsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> <xs:productcommercialid>?</xs:productcommercialid> </xs:getproductsrequest> </soap:body> Página 45

46 Página 46 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=" <env:header/> <env:body> <ns4:getproductsresponse xmlns:ns4=" xmlns:ns2=" xmlns:ns3=" xmlns:ns5=" xmlns:ns6=" xmlns:ns7=" <ns4:code>?</ns4:code> <!--You have a CHOICE of the next 2 items at this level--> <ns4:error>?</ns4:error> <ns4:products> <!--Zero or more repetitions:--> <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

47 Página 47 de 168 <?xml version="1.0" encoding="utf-8"?> <soap:envelope xmlns:soap=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getpaymenttypesrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns4:getpaymenttypesresponse xmlns:ns4=" xmlns:ns2=" xmlns:ns3=" xmlns:ns5=" xmlns:ns6=" xmlns:ns7=" <ns4:code>?</ns4:code> <!--You have a CHOICE of the next 2 items at this level--> <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

48 Página 48 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=" xmlns:xs=" xmlns:xs1=" <soap:header/> <soap:body> <xs:getinstallmentsrequest> <xs1:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns4:getinstallmentsresponse xmlns:ns4=" xmlns:ns2=" xmlns:ns3=" xmlns:ns5=" xmlns:ns6=" xmlns:ns7=" <ns4:code>?</ns4:code> <!--You have a CHOICE of the next 2 items at this level--> <ns4:error>?</ns4:error> <ns4:types> <!--Zero or more repetitions:--> <ns4:type> <ns4:id>?</ns4:id> <ns4:name>?</ns4:name> <ns4:installments>?</ns4:installments> </ns4:type> Página 48

49 Página 49 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=" xmlns:ws=" xmlns:ws2=" <soap:header/> <soap:body> <ws2:getpersondescriptorsrequest> <ws:authentication> <!--You may enter the following 2 items in any order--> <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication> <!--You have a CHOICE of the next 2 items at this level--> <ws2:insurancetypeid>?</ws2:insurancetypeid> <ws2:productid>?</ws2:productid> <ws2:stage>?</ws2:stage> </ws2:getpersondescriptorsrequest> </soap:body> </soap:envelope> Página 49

50 Página 50 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=" xmlns:ws2=" <soap:header/> <soap:body> <ws2:getpersondescriptors2request> <ws2:code>?</ws2:code> <!--You have a CHOICE of the next 2 items at this level--> <ws2:error>?</ws2:error> <!--Zero or more repetitions:--> <ws2:persondescriptor> <ws2:role>?</ws2:role> <ws2:required>?</ws2:required> <ws2:overwritable>?</ws2:overwritable> <ws2:corporateallowed>?</ws2:corporateallowed> <ws2:fields> <!--Zero or more repetitions:--> <ws2:field> <!--You may enter the following 2 items in any order--> <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

51 Página 51 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=" xmlns:xs=" <soap:header/> <soap:body> <xs:searchquotationsrequest> <xs:authentication> <!--You may enter the following 2 items in any order--> <xs:user>?</xs:user> <xs:key>?</xs:key> </xs:authentication> <xs:filter> <!--You may enter the following 16 items in any order--> <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

52 Página 52 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=" <env:header/> <env:body> <ns2:searchquotationsresponse xmlns:ns2=" xmlns:ns3=" xmlns:ns4=" <ns2:code>?</ns2:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns2:error>?</ns2:error> <!-- Item 2 Data --> <ns2:quotations> <!--1 or more repetitions:--> <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

53 Página 53 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=" xmlns:xs=" <soap:header/> <soap:body> <xs:getquotationresultsrequest> <xs:authentication> <!--You may enter the following 2 items in any order--> <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=" <env:header/> <env:body> <ns2:getquotationresultsresponse xmlns:ns2=" xmlns:ns3=" xmlns:ns4=" <ns2:code>?</ns2:code> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> Página 53

54 Página 54 de 168 order--> order--> order--> order--> <ns2:error>?</ns2:error> <!-- Item 2 Data --> <ns2:results> <!--You may enter the following 3 items in any order--> <ns2:quotationid>?</ns2:quotationid> <ns2:quotationurl>?</ns2:quotationurl> <ns2:mainproductsresults> <!--Zero or more repetitions:--> <ns2:resultslist> <!--You may enter the following 5 items in any order--> <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> <ns2:prices> <!--One or more repetitions:--> <ns2:pricelist> <!--You may enter the following 3 items in any <ns2:companypriceid>?</ns2:companypriceid > <ns2:modality> <!--You may enter the following 4 items in any <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:mainproductsresults> <ns2:complementaryproductsresults> <!--Zero or more repetitions:--> <ns2:resultslist> <!--You may enter the following 5 items in any order--> <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

55 Página 55 de 168 order--> <ns2:prices> <!--One or more repetitions:--> <ns2:pricelist> <!--You may enter the following 3 items in any <ns2:companypriceid>?</ns2:companypriceid > <ns2:modality> <!--You may enter the following 4 items in any order--> <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> <!--One or more repetitions:--> <ns2:productcompanywarings> <ns2:productcompanyid>?</ns2:productcompanyid> <ns2:productcompanyname>?</ns2:productcompanyname> <ns2:warnings> <!--One or more repetitions:--> <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

56 Página 56 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: 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 MLSchema e/xmlschema AutosRisk HomeRisk Datos de entrada: PrepareQuoteRequest preparequoterequest Datos necesarios para cargar la cotización en el frontend de Avant Página 56

57 Página 57 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=" xmlns:xsi=" xmlns:ws=" xmlns:ws2=" xmlns:car=" <soap:header/> <soap:body> <ws2:preparequoterequest> <ws:authentication> <!--You may enter the following 2 items in any order--> <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication> <ws2:effectdate>?</ws2:effectdate> <ws2:risk xsi:type="car:autosrisk"> <ws2:tunings> <!--1 or more repetitions:--> <ws2:tuning> <ws2:productid>?</ws2:productid> <ws2:tuningjson>?</ws2:tuningjson> </ws2:tuning> </ws2:tunings> <car:base7> <!--You have a CHOICE of the next 2 items at this level--> <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

58 Página 58 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: >?</ws: > <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

59 Página 59 de 168 </ws:postaladdress> <ws:mainphone>?</ws:mainphone> <ws:otherphone>?</ws:otherphone> <ws: >?</ws: > <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: >?</ws: > <ws:contactlanguage>?</ws:contactlanguage> <ws:personpermissiondate>?</ws:personpermissiondate> <ws:personexpeditionzone>?</ws:personexpeditionzone> Página 59

60 Página 60 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> <!--Zero or more repetitions:--> <car:accessory> <!--You have a CHOICE of the next 2 items at this level--> <car:name>?</car:name> <car:value>?</car:value> <car:code>?</car:code> </car:accessory> </car:accessories> <car:nonbase7accessories> <!--0 to 5 repetitions:--> <car:accessory> <!--You may enter the following 3 items in any order--> <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

61 Página 61 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: >?</ws: > <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> <!--You have a CHOICE of the next 2 items at this level--> <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

62 Página 62 de 168 <soap:envelope xmlns:soap=" xmlns:ws2=" <soap:header/> <soap:body> <ws2:preparequoteresponse> <ws2:code>?</ws2:code> <!--You have a CHOICE of the next 2 items at this level--> <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 MLSchema e/xmlschema AutosRisk HomeRisk Página 62

63 Página 63 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=" xmlns:xsi=" xmlns:ws=" xmlns:ws2=" xmlns:car=" <soap:header/> <soap:body> <ws2:quoterequest> <ws:authentication> <!--You may enter the following 2 items in any order--> <ws:user>?</ws:user> <ws:key>?</ws:key> </ws:authentication> <ws2:effectdate>?</ws2:effectdate> Página 63