Towers and layers
Create a tower when you want a coinsurance agreement to cover a range of risk in terms of financial limits. The tower can define a single range with a single risk layer, or it can be divided into multiple layers. A policy can have a tower that applies to the entire policy or a tower can be associated with one or more policy sections.
- Define the range of risk for a coinsurance agreement
- Set commission override amounts
- Decline coverage for a range of risk
For more information on the business functionality of towers and layers, see Application Guide.
Query for tower details
- GET
/jobs/{jobId}/towers
- GET
/jobs/{jobId}/towers/{towerId}
- GET
/jobs/{jobId}/towers/{towerId}/layers
- GET
/jobs/{jobId}/towers/{towerId}/layers/{layerId}
- GET
/jobs/{jobId}/towers/{towerId}/layers/{layerId}/parties
- GET
/jobs/{jobId}/towers/{towerId}/layers/{layerId}/parties/{partyID}
- GET
/jobs/{jobId}/towers/{towerId}/policy-sections
- GET
/jobs/{jobId}/towers/{towerId}/policy-sections/{sectionId}
- GET
/policies/{policyId}/towers/
- GET
/policies/{policyId}/towers/{towerId}
- GET
/policies/{policyId}/towers/{towerId}/layers
- GET
/policies/{policyId}/towers/{towerId}/layers/{layerId}
- GET
/policies/{policyId}/towers/{towerId}/layers/{layerId}/parties
- GET
/policies/{policyId}/towers/{towerId}/layers/{layerId}/parties/{partyId}
- GET
/policies/{policyId}/towers/{towerId}/policy-sections
- GET
/policies/{policyId}/towers/{towerId}/policy-sections/{sectionId}
For example, the following query returns a list of policy sections associated with job pc:Sf-bEIu7Pui2fQz_40mdJ and tower 3:
Create a tower with layers
- After reading this topic, you'll be able to:
-
- Create a tower.
- Define one or more layers to specify each coverage range.
- Associate a coinsurance agreement with a layer.
Before you begin
- The product must support layers. If you want to enable coinsurance for layers, the product must also support coinsurance. For more information, see the Coinsurance and risk section of Creating Products with APD App.
- PolicyCenter must include one or more coinsurers in the PolicyCenter database. For more information, see Application Guide.
Step 1: Create a tower
A policy can have more than one tower. You can create a tower with a section or without a section. When you create a tower without a section, the tower applies to any coverages on the policy that are not covered by other coinsurance agreements or risk towers.
For example, suppose a policy has two towers where one tower is associated with the Liability section and the other has no section. The tower associated with the Liability section covers the liability coverages. The tower without a section covers all coverages on the policy that are not part of the Liability section.
- POST
/job/v1/jobs/${jobId}/towers
For example, the following request creates a tower with a section HO for job pc:abcd1234
Step 2: Add a layer to a tower
A tower has one or more layers. The fields required to add a layer differ based on whether coinsurance is enabled or not.
- POST
/job/v1/jobs/${jobId}/towers/${towerId}/layers
excessAmount
. The starting range for the layer.limitAmount
. The end range for the layerpolicyNumberSuffix
. A string of up to 8 characters that BillingCenter appends to the policy number on the splinter policy for this agreement.- To enable coinsurance, include the following properties:
coinsured
. Set totrue
to enable coinsurance.leadersFee
. A number that specifies the leader fee percentage.model
. The model specifies which party distributes payments to the followers and which party pays claims to the insured. Valid values from the CoinsuranceModel typelist includeadminister
,administerNoClaim
,brokerClaim
, andbrokerNoClaim
.ourRole
. The role (lead
orfollow
) of the PolicyCenter insured.ourShare
. The percentage of risk for the PolicyCenter insured.
- To decline coverage by the PolicyCenter insurer, set
declined
totrue
.
For example, the following request creates a layer on tower 123 with coinsurance enabled:
If you do not want to enable coinsurance, you can instead include something like the following in the request body:
Step 3: Add a party to a layer (required for coinsured layers)
- POST
/job/v1/jobs/{jobId}/towers/{towerId}/layers/{layerId}/parties
For example, the following request adds a party pc:1 to layer 502 in tower 404 for job pc:S2dbzbNWO8Nh_PHfbYCDm:
Update a tower
- Associate sections with the tower. For more information, see Associate a section with a tower.
- Remove sections from the tower. For more information, see Remove a section from a tower.
- Add additional layers to a tower. For more information, see Step 2: Add a layer to a tower.
- Add additional parties to a layer. For more information, see Step 3: Add a party to a layer (required for coinsured layers).
- Update a layer. For more information, see Update a layer.
Associate a section with a tower
- POST
/job/v1/jobs/{jobId}/towers/{towerId}/policy-sections
The request body must include the sectionType code
.
For example, the following request adds the property section PP
to
tower 209 on job pc:SrAlPrMYv14hLu-oNBTzG:
Remove a section from a tower
- DELETE
/job/v1/jobs/{jobId}/towers/{towerId}/policy-sections/{sectionId}
Update a layer
- PATCH
/job/v1/jobs/{jobId}/towers/{towerId}/layers/{layerId}
For example, the following request updates the excessAmount
to
350000 for layer 502 in tower 404 on job pc:S2dbzbNWO8Nh_PHfbYCDm:
Delete a tower
-
DELETE
/job/v1/jobs/${jobId}/towers/${towerId}