Retrieving a policy

After the claim system knows what policy it needs, the claim system calls the retrievePolicy method of the policy search web service to retrieve the policy.

The claim system identifies the requested policy by using the following items.

Policy number of type String which corresponds to the CCPolicySummary field _policyNumber
Effective date of type java.util.Calendar which corresponds to the CCPolicySummary field _effDate

An example invocation is shown in the following lines.

Calendar asOfDate = Calendar.getInstance();
myEnv = myCCPolicySearchIntegrationAPI.retrievePolicy("ABC:1234", asOfDate);
myCCPolicy = myEnv.CCPolicy;

The method returns an instance of gw.webservice.pc.pcVERSION.ccintegration.entities.Envelope. The Envelope type is an XSD type that encapsulates XML objects that mirror the PolicyCenter policy, but are simplified for use in a claim system. In the built-in implementation, the policy structure is similar to what is needed for ClaimCenter.

The returned policy entity of type CCPolicy is defined in the PolicyCenter data model, not the claim system data model. If you need custom properties defined in the external system, add data model extension properties to the PolicyCenter data model version of the CCPolicy entity.

Service tiers enable an insurer to provide special handling or value-added services for certain customers, typically high-value customers. For an integration with ClaimCenter, the policy information that ClaimCenter retrieves from PolicyCenter includes the service tier. The integration maps the optional PolicyCenter Account.ServiceTier value to a ClaimCenter Policy.CustomerServiceTier. In PolicyCenter, the typekey values for ServiceTier are configurable.