Private Medical Insurance Consumer Pricing

individualHealthCarePolicy

object

PMI Product Details

idstring

Quote ref ID. Any unique quote ref.

commercialAdjustmentnumber(double)

Adjustments to the book rates.

paymentTypestringrequired

Payment mode. For e.g. B for direct debit.

Allowed values:BCA

paymentFrequencyinteger(int32)required

Payment term, Specify how many times payment will be made in a year say, 12 for monthly payment, 4 for quarterly

Allowed values:1124

experienceAdjustmentnumber(double)

Adjustment to the book rates based on claims experience.

pmiPolicyTypestring

Type of PMI Policy.

policyholderPostcodestring

Postcode for Policy Holder.

priceRequiredDatestringrequired

Date for which price is calculated. This needs to be treated same policy start date. Format e.g YYYY-MM-DD

groupSizeinteger(int32)

Number of family groups in the policy.

salesChannelstring

This should be name of the channel who provided that particular sale. Can be set as Internet if unknown.

fsaNumberstring

Agent code.

originalEffectiveDatestring

Original effective date of Policy. Format e.g YYYY-MM-DD

productIdinteger(int32)

Product ID. Not in use.

productVersioninteger(int32)

Product version. Not in use.

productNamestringrequired

Product description. HrSol for consumer policies.

Allowed values:HrSol

transactionTypestring

Type of transaction. New business , MTC or Renewal. Considered as New Business if left blank.

Allowed values:New BusinessMTCRenewal

grossPricenumber(double)

Gross premium, this gets calculated by Business Rules Engine and sent back in response.

netPricenumber(double)

Gross premium, this gets calculated by Business Rules Engine and sent back in response.

memberCategoryarray[object]required

Category of Members.

Show Child Parameters
incentivearray[object]

Incentives applied, if any. Incentives need to be applied as applicable to the agent/broker ID that exists in Aviva. Currently there’s no API exposed externally to provide the list of incentives associated with your agent/broker ID so you should have received the applicable deals from Aviva Business Teams.

Show Child Parameters
maxAllowableDiscountnumber(double)

Maximum allowed discount. Not in use.

taxRequiredDatestring

The date against the tax is calculated.Format e.g YYYY-MM-DD

callingSystemstringrequired

Name of the system which makes the price call. There must be an entry in Aviva’s systems for your system to call this API. You should ask for one if it’s the first time you’re integrating with this API.

sourceCodestring

Source of the request.

competitorPricenumber(double)

The price quoted by the competitor insurance companies for same kind of policy.

previousPaymentFrequencyinteger(int32)

Previous Payment term.

Allowed values:1124

previousPaymentTypestring

Previous Payment type.

Allowed values:BCA

previousIncentivearray[object]

Previous incentive details.

Show Child Parameters
previousCommercialDiscountnumber(double)

Previous commercial discount.

noOfPeopleinteger(int32)

Number of people of policy.

isRequoteboolean

Requote flag to indicate whether it’s recalculation after changing the options etc. Applies only to Price Beater.

Example

quote

object

Quote request

idstring

Quote ref ID. Any unique quote ref.

commercialAdjustmentnumber(double)

Adjustments to the book rates.

paymentTypestringrequired

Payment mode. For e.g. B for direct debit.

Allowed values:BCA

paymentFrequencyinteger(int32)required

Payment term, Specify how many times payment will be made in a year say, 12 for monthly payment, 4 for quarterly

Allowed values:1124

experienceAdjustmentnumber(double)

Adjustment to the book rates based on claims experience.

pmiPolicyTypestring

Type of PMI Policy.

policyholderPostcodestring

Postcode for Policy Holder.

priceRequiredDatestringrequired

Date for which price is calculated. This needs to be treated same policy start date. Format e.g YYYY-MM-DD

groupSizeinteger(int32)

Number of family groups in the policy.

salesChannelstring

This should be name of the channel who provided that particular sale. Can be set as Internet if unknown.

fsaNumberstring

Agent code.

originalEffectiveDatestring

Original effective date of Policy. Format e.g YYYY-MM-DD

productIdinteger(int32)

Product ID. Not in use.

productVersioninteger(int32)

Product version. Not in use.

productNamestringrequired

Product description. HrSol for consumer policies.

Allowed values:HrSol

transactionTypestring

Type of transaction. New business , MTC or Renewal. Considered as New Business if left blank.

Allowed values:New BusinessMTCRenewal

grossPricenumber(double)

Gross premium, this gets calculated by Business Rules Engine and sent back in response.

netPricenumber(double)

Gross premium, this gets calculated by Business Rules Engine and sent back in response.

memberCategoryarray[object]required

Category of Members.

Show Child Parameters
incentivearray[object]

Incentives applied, if any. Incentives need to be applied as applicable to the agent/broker ID that exists in Aviva. Currently there’s no API exposed externally to provide the list of incentives associated with your agent/broker ID so you should have received the applicable deals from Aviva Business Teams.

Show Child Parameters
maxAllowableDiscountnumber(double)

Maximum allowed discount. Not in use.

taxRequiredDatestring

The date against the tax is calculated.Format e.g YYYY-MM-DD

callingSystemstringrequired

Name of the system which makes the price call. There must be an entry in Aviva’s systems for your system to call this API. You should ask for one if it’s the first time you’re integrating with this API.

sourceCodestring

Source of the request.

competitorPricenumber(double)

The price quoted by the competitor insurance companies for same kind of policy.

previousPaymentFrequencyinteger(int32)

Previous Payment term.

Allowed values:1124

previousPaymentTypestring

Previous Payment type.

Allowed values:BCA

previousIncentivearray[object]

Previous incentive details.

Show Child Parameters
previousCommercialDiscountnumber(double)

Previous commercial discount.

noOfPeopleinteger(int32)

Number of people of policy.

isRequoteboolean

Requote flag to indicate whether it’s recalculation after changing the options etc. Applies only to Price Beater.

Example

PreviousIncentive

object

Previous incentive details.

idinteger(int32)

Incentive ID.

incentiveParameterstringrequired

Incentive parameter value such as 1, 2.

incentiveTypestringrequired

Incentive type such as NCD Uplift.

Allowed values:Price BeaterNCD UpliftgiftmonthsFreefreeOptionSwitchDecpsDiscount

subkeystring

Sub key for Incentive if any. Not used for New Business.

Example

quoteResponse

object

Price Response

grossPricenumber(double)

Gross premium, this gets calculated by Business Rules Engine and sent back only in response.

netPricenumber(double)

Net premium, this gets calculated by Business Rules Engine and sent back only in response.

memberCategoryarray[object]

Category of Members.

Show Child Parameters
Example

ProblemDetail

object

Problem detail exception.

typestring

An absolute URI [RFC3986] that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type.

titlestring

A short, human-readable summary of the problem type. It SHOULD NOT change from occurrence to occurrence of the problem, except for purposes of localisation.

statusstring

The HTTP status code ([RFC7231], Section 6) generated by the origin server for this occurrence of the problem.

detailstring

An human readable explanation specific to this occurrence of the problem.

instancestring

An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

codestring

This is an Aviva extension type that could be used for sending common mapped business error codes back to the consumer

Example