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
Página 2 de 77 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. Página 2
Página 3 de 77 ÍNDICE DE CONTENIDO 1 Objetivo...7 2 Servicio Web...8 3 Autenticación...9 4 Métodos Expuestos... 10 4.1 echodummy... 10 4.2 PrepareCarQuote... 10 4.3 CarQuote... 17 4.4 getenginetypes... 26 4.5 getbrands... 27 4.6 getmodels... 28 4.7 getversions... 29 4.8 getmatchingversions... 30 4.9 getvehicleaccessoriesbyversionid... 32 4.10 getvehicleaccessoriesbyversionbase7code... 34 4.11 gettownsfrompostalcode... 35 4.12 getregistrationdatebyplate... 36 4.13 exportpoliciesdata... 37 4.14 getpolicydocument... 38 4.15 searchquotations... 40 4.16 getquotationresults... 42 5 Tipos de Datos... 45 5.1 PrepareCarQuoteRequestType... 45 5.2 PrepareCarQuoteResponse... 45 5.3 CarQuoteRequestType... 45 5.4 CarQuoteResponse... 46 5.5 GetEngineTypesResponse... 46 5.6 GetBrandsRequest... 46 5.7 GetBrandsResponse... 46 5.8 GetModelsRequest... 47 Página 3
Página 4 de 77 5.9 GetModelsResponse... 47 5.10 GetVersionsRequest... 47 5.11 GetVersionsResponse... 47 5.12 GetMatchingVersionsRequest... 47 5.13 GetMatchingVersionsResponse... 49 5.14 GetVehicleAccessoriesByVersionIdRequest... 49 5.15 GetVehicleAccessoriesByVersionIdResponse... 49 5.16 GetVehicleAccessoriesByBase7CodeRequest... 49 5.17 GetVehicleAccessoriesByVersionIdResponse... 49 5.18 GetTownsFromPostalCodeRequest... 50 5.19 GetTownsFromPostalCodeResponse... 50 5.20 GetRegistrationDateByPlateRequest... 50 5.21 GetRegistrationDateByPlateResponse... 50 5.22 ExportPoliciesDataRequest... 50 5.23 ExportPoliciesDataResponse... 51 5.24 GetPolicyDocumentRequest... 51 5.25 GetPolicyDocumentResponse... 51 5.26 SearchQuotationsRequest... 51 5.27 SearchQuotationsResponse... 51 5.28 GetQuotationResultsRequest... 51 5.29 GetQuotationResultsResponse... 52 5.30 Car... 52 5.31 Base7Version... 53 5.32 Person... 53 5.33 PersonDriver... 54 5.34 ComplementaryData... 55 5.35 Accessories... 56 5.36 Accessory... 56 5.37 NonBase7Accessories... 56 5.38 NonBase7Accessory... 56 5.39 UserIdentification... 57 5.40 QuotationResults... 57 Página 4
Página 5 de 77 5.41 QuotationCompanyResultsList... 57 5.42 QuotationCompanyResults... 57 5.43 QuotationTaskState... 57 5.44 QuotationResultPriceList... 58 5.45 QuotationResultPrice... 58 5.46 TuningsList... 58 5.47 ProductCopmanyTuning... 58 5.48 TuningValuesList... 58 5.49 TuningValue... 58 5.50 ProductCompanyTuningWarningsList... 58 5.51 ProductCompanyTuningWarnings... 59 5.52 WarningsList... 59 5.53 Modality... 59 5.54 ProductModality... 59 5.55 EngineTypesList... 60 5.56 EngineType... 60 5.57 VehicleBrandList... 60 5.58 VehicleBrand... 60 5.59 VehicleModelsList... 60 5.60 VehicleModel... 60 5.61 VehicleVersionsList... 60 5.62 VehicleVersion... 61 5.63 VehicleAccessoriesList... 61 5.64 VehicleAccessory... 61 5.65 TownsList... 62 5.66 Town... 62 5.67 BankData... 62 5.68 PostalAddress... 62 5.69 IssuedProductsList... 62 5.70 IssuedProduct... 63 5.71 DocumentsList... 63 5.72 Document... 63 Página 5
Página 6 de 77 5.73 QuotationSearchFilter... 63 5.74 QuotationSearchResultsList... 64 5.75 QuotationSummary... 64 5.76 PersonSummary... 65 5.77 RiskSummary... 65 5.78 CarSummary... 66 5.79 LastPolicySummary... 66 5.80 SinistersHistorySummary... 66 5.81 IssuanceSummariesList... 67 5.82 IssuanceSummary... 67 6 Tablas maestras... 68 6.1 Género... 68 6.2 TipoGaraje... 68 6.3 TipoCombustible... 68 6.4 KilometrosAnuales... 69 6.5 AñosSinAccidentes... 69 6.6 AntiguedadCompañiaActual... 70 6.7 Siniestros2ultimosAños... 70 6.8 TipoIdentificación... 71 6.9 CompañiasDGS... 71 6.10 Estado de la cotización... 73 6.11 EstadoCivil... 73 6.12 ZonaExpedición... 74 6.13 TipoAccesorioNoBase7... 74 6.14 CategoriaVehiculo... 74 6.15 Modalidad de Producto... 75 6.16 Pais... 75 6.17 Idioma... 75 6.18 TipoDeVia... 76 Página 6
Página 7 de 77 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 7
Página 8 de 77 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_15 Se ha implementando también una versión para SOAP 1.1, cuyo wsdl se encuentra en la url http://int.avant2.es/avant/wsdl11/2_15 Página 8
Página 9 de 77 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> <!--You may enter the following 2 items in any order--> <xs1:user>codeoscopic</xs1:user> <xs1:key>926e27eecdbc7a1884290188ba99bddd</xs1:key> </xs1:authentication> </xs:carquoterequest> Página 9
Página 10 de 77 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 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 10
Página 11 de 77 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> <!--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 11
Página 12 de 77 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 12
Página 13 de 77 </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> <!--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:email>?</xs1:email> Página 13
Página 14 de 77 <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:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> Página 14
Página 15 de 77 <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: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 15
Página 16 de 77 <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 16
Página 17 de 77 </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> <!--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 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 sel 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 17
Página 18 de 77 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> <!--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--> Página 18
Página 19 de 77 level--> <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> <xs1:rest>?</xs1:rest> Página 19
Página 20 de 77 <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> <!--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:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> Página 20
Página 21 de 77 <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:email>?</xs1:email> <xs1:contactlanguage>?</xs1:contactlanguage> <xs1:personpermissiondate>?</xs1:personpermissiondate> <xs1:personexpeditionzone>?</xs1:personexpeditionzone> <xs1:personmaritalstatus>?</xs1:personmaritalstatus> <xs1:nationality>?</xs1:nationality> </xs:owner> </xs1:risk> <xs1:holder> Página 21
Página 22 de 77 <!--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: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 > <xs:lasttwoyearsaccidents>?</xs:lasttwoyearsaccidents > Página 22
Página 23 de 77 <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 23
Página 24 de 77 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> <!--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: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> </ns4:prices> Página 24
Página 25 de 77 order--> order--> </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 25
Página 26 de 77 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> <!--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="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> <!--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 26
Página 27 de 77 <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> <!--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="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> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> <ns3:error>?</ns3:error> Página 27
Página 28 de 77 <!-- 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="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> <!--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="http://www.w3.org/2003/05/soap-envelope"> <env:header/> <env:body> Página 28
Página 29 de 77 <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> <!--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="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> <!--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 29
Página 30 de 77 </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> <!--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 30
Página 31 de 77 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> <!--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 31
Página 32 de 77 </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> <!--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 32
Página 33 de 77 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> <!--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="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> <!--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 33
Página 34 de 77 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> <!--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="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> <!--You have a CHOICE of the next 2 items at this level--> <!-- Item 1 - Error --> Página 34
Página 35 de 77 <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="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> <!--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 35
Página 36 de 77 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> <!--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="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> <!--You may enter the following 2 items in any order--> <xs1:user>?</xs1:user> <xs1:key>?</xs1:key> </xs1:authentication> Página 36
Página 37 de 77 <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> <!--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 37
Página 38 de 77 <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="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> <!--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 38
Página 39 de 77 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> <!--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: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> <!--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> </ns2:issuedproduct> </ns2:exportpoliciesdataresponse > </env:body> </env:envelope> Página 39
Página 40 de 77 4.15 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 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> <!--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> Página 40