Introduction

The Integrated Quote functionality allows the clients to fully integrate the terraCotta Quote engine into their websites and booking process.

It uses a SOAP web service that allows the user to obtain quotes for the desired criteria and subsequently book the desired policy.

This guide covers the following:

  • Integrated Quote Process – It will explain how the Integrated Quote web service works and list the available web methods.
  • Integrated Quote Methods – It will explain each of the available web methods, including their requests and responses.

Please note that the web-service URLs presented in this document are generic, e.g. http://yourdomain.com. Please contact us to obtain the correct URLs to use for your integration.

 

Integrated Quote Web service The Process

The Process

The integrated quote is divided into 3 steps:

  1. Request quotes that fit a specific quote criteria and user. This web method iscalled ‘ProvideQuotation’.
  2. Request the necessary screening questions to be asked to the client for aselected quote. This web method is called ‘ScreeningQuestions’.
  3. Convert the selected quote into a live policy. This web method is called‘SavePolicyDetails‘.

The web service list of methods and definitions can be found in the following URL:

http://yourdomain.com/ws/integratedquote.asmx

 

ProvideQuotation Method

The first action taken is calling the ‘ProvideQuotation’ method to obtain a list of possible quotes for the desired criteria.

To do so, the web method should be called with the following request details, which include the type of products to be quoted, the list of people to be insured and the terraCotta user:

    • userID – The user ID to associate the quotes to and that will define the possible products to be quoted
    • userCode – The user code to validate the user requesting the quotes. This can be taken from user’s direct URL, available in terraCotta’s ‘Company Admin’
    • quoteDetails
      • ResidenceID – Residence ID for the insured party. Please contact us for a
        comprehensive list of possible ‘ResidenceID’.
      • TypePolicyID – This is a comma-separated list of IDs for the ‘Type of
        Policy Types’ you would like the system to quote. The list of possible IDs
        can be accessed on ‘OPALS>Other Settings>Types of Policy Types’.
      • TypePackageID – This is the ID of the ‘Type of Package’ you would like
        the system to quote. Please contact us for a comprehensive list of
        possible ‘TypePackageID’.
      • Destination – The name of the destination the insured is travelling to.
        This needs to be the same as defined on OPALS for the products to quote.
      • StartDate – Insurance Start Date, using the format ‘YYYY/MM/DD’.
      • EndDate – Insurance End Date, using the format ‘YYYY/MM/DD’.
      • Travellers
        • TravellerNumber – Each Traveller’s number, e.g. 1, 2, 3, 4, …
        • Title – Traveller’s Title
        • FirstName – Traveller’s Initials
        • LastName – Traveller’s Surname
        • DateOfBirth – Traveller’s date of birth
        • Age – Traveller’s age
      • Contact Details
        • Address – Main Person’s Address
        • Postcode – Main Person’s Postcode
        • Email – Main Person’s Email address
        • Telephone – Main Person’s Telephone

The system will then reply with a list of possible quotes that fit the criteria and products available to the user. The response will have the following information:

  • Message – System message with information about the result returned
  • quoteResults
    • QuoteID – Identifying ID for the quote
    • schemaName – Name of the product being quoted
    • policyTypeName – Name of the policy type being quoted
    • SI – URL for summary of cover PDF file
    • PW – URL for the policy wording PDF file
    • Currency – Quote Currency symbol
    • IPT – Quote IPT amount
    • GrossPrice – Quote Price

Please note that the definition for this web method can be obtained here:

http://yourdomain.com/ws/integratedquote.asmx?op=ProvideQuotation

 

ScreeningQuestions Method

After selecting a quote, the client’s website should call the ‘ScreeningQuestions’ method to obtain the screening questions that need to be asked to the customer.

The request requires the following information that contains the user and quote identification:

  • userID – The user ID used to originally request the quotes
  • userCode – The user code to validate the user requesting the information
  • quoteID – The quote ID for the selected quote

If the request is valid, the system will return the following information that includes the screening questions, any messages to be presented for each answer and consequent action:

  • Message – System message with information about the result returned
  • screeningQuestion
    • questionNumber – Question number
    • question – Screening question text
    • yesMessage – Message that should be presented to the customer for a ‘Yes’
    • noMessage – Message that should be presented to the customer for a ‘No’.
    • yesAction – ID for the action that will be taken by the system for a ‘Yes’.
    • noAction – ID for the action that will be taken by the system for a ‘No’.
    • yesActionText – Text for the action that will be taken by the system for a ‘Yes’
    • noActionText – Text for the action that will be taken by the system for ‘No’

Please note that the definition for this web method can be obtained here:

http://www.asuaonline.com/ws/integratedquote.asmx?op=ScreeningQuestions

 

SavePolicyDetails Method

Finally, once a quote is selected and all the screening questions have been answered, the client’s website should call the ‘SavePolicyDetails’ to convert the quote into a live policy.

The requester this web method will include the following information, which contains the user and quote identification and screening answers:

  • userID – The user ID used to originally request the quotes
  • userCode – The user code to validate the user requesting the information
  • quoteID – The quote ID for the selected quote
  • screeningQuestionAnswer
    • questionNumber – Number of the screening question
    • answer – The screening question answer (‘yes’ or ‘no’)
  • medicalScreeningReference – Medical Screening Reference (if necessary)

 

The web method will validate the screening answers sent and will return the following information on the response:

  • Message – System message with information about the result returned
  • policySaved – Confirmation if the quote was converted into a policy (‘Yes’ or ‘No’)
  • policyID – Policy Number for the saved policy
  • certificate – URL for the policy certificate page
  • PW – URL for the policy wording PDF file
  • SI – URL for the summary of cover PDF file

Please note that the definition for this web method can be obtained here:

http://www.asuaonline.com/ws/integratedquote.asmx?op=SavePolicyDetails