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

Use the following endpoints to retrieve 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:

Command
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.

The following fields are required:
  • rate - The commission percentage, as a string
  • role - The role the producer must have for the override to be applied, as a reference to the ProducerRole typelist
  • sectionType - The section that the override applies to, as a reference to the SectionType typelist

The following is an example POST for a section rate override:

Command
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

You can modify individual section rates. Use the following to PATCH a section override:
  • PATCH /admin/v1/commission-plans/{commissionPlanId}/commission-sub-plans/{commissionSubPlanId}/section-rates/{sectionRateId}

The only field that can be PATCHed is rate. For example:

Example request body
{
    "data": {
        "attributes": {
            "rate": "17"
        }
    }
}

Deleting section rate overrides

You can delete section rate commission overrides if the commission plan is not in use. Use the following endpoint to delete a section-based override:
  • 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.