Commission overrides for section types
A policy can be divided into one or more sections. A section is a set of coverages that are treated as a group for the purposes of rating or billing. Every section has a section type, which identifies the common feature or purpose of the coverages. Section types can be based on the type of business being covered, such as agriculture or construction, or they can be based on the type of coverage, such as casualty or liability.
You can specify a commission override for charges with a specific section type on commission subplans. These are section rate overrides. If these overrides are applied, BillingCenter calculates commission for a charge with a given section type using the override value associated with the producer’s role.
These overrides are added using the Section Rates tab on commission plans in the BillingCenter user interface. For more information, see Specifying commission schedules.
You can use Cloud API to query for, create, modify, and delete section rate overrides.
Querying for section rate overrides
- GET
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates
- GET
/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates/{sectionRateId}
The following query retrieves all section rate overrides on a commission subplan:
GET /admin/v1/commission-plans/bc:134/commission-sub-plans/bc:199/section-rates
Response
{
"count": 6,
"data": [
{
"attributes": {
"id": "bc:Se8XpZqK7WPtegBMFlwB9",
"rate": "20.00",
"role": {
"code": "primary",
"name": "Primary"
},
"sectionType": {
"code": "CN",
"name": "Construction"
}
},
...
}
]
...
}
Creating section rate overrides
Use the following endpoint when POSTing a section rate override:
- POST
/admin/v1/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates
When you POST section rate overrides, you must post one rate at a time for each producer role.
rate
- The commission percentage, as a stringrole
- The role the producer must have for the override to be applied, as a reference to theProducerRole
typelistsectionType
- The section that the override applies to, as a reference to theSectionType
typelist
The following is an example POST for a section rate override:
POST /admin/v1/commission-plans/bc:134/commission-sub-plans/bc:199/section-rates
Request body
{
"data": {
"attributes": {
"rate": "15",
"sectionType": {
"code": "AH"
},
"role": {
"code": "primary"
}
}
}
}
This post creates an override of 15% on the "Accident and Health" section type for producers with a role of "primary."
Modifying section rate overrides
- PATCH
/admin/v1/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates/{sectionRateId}
The only field that can be PATCHed is rate
. For example:
{
"data": {
"attributes": {
"rate": "17"
}
}
}
Deleting section rate overrides
- DELETE
/admin/v1/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates/{sectionRateId}
No request body is required, and a success message is returned when the override is deleted.