Assigning claims
When a claim completes the FNOL process (either through the user interface or through the
/submit
endpoint), it is assigned to a group and a user in that group. The
assigned user has the primary responsible for managing the claim.
When you submit a claim through the system APIs, ClaimCenter automatically executes the claim
assignment rules to initially assign the claim to a group and user. You can use the POST
/claims/{claimId}/assign
endpoint to reassign the claim as needed.
Assignment options
A claim can be assigned through the system APIs in the following ways:
- To a specific group and user in that group
- To a specific group only (and then ClaimCenter uses assignment rules to select a user in that group)
- By re-running the claim assignment rules
- This can be appropriate if you have modified the claim since the last time assignment rules were run and the modification might affect who the claim would be assigned to.
The root resources for the /claims/{claimId}/assign
endpoints is
ClaimAssignee
. This resource specifies assignment criteria. The schema
has the following fields:
Field | Type | Description |
---|---|---|
autoAssign |
Boolean | Whether to assign the claim using assignment rules |
groupId |
string | The ID of the group to assign the claim to |
userId |
string | The ID of the user to assign the claim to |
The ClaimAssignee
resource cannot be empty. It must specify a single logical
assignment option (group and user, group only, or automatic assignment). For more
information on how assignment rules execute assignment, see the Gosu Rules Guide.
Assignment example - Assigning to a specific group (and user)
The following assigns claim cc:34 to group demo_sample:31 (Auto1 - TeamA) and user demo_sample:2 (Sue Smith).
POST /claim/v1/claims/cc:34/assign
{
"data": {
"attributes" : {
"groupId" : "demo_sample:31",
"userId" : "demo_sample:2"
}
}
}
The following assigns claim cc:34 to group demo_sample:31 (Auto1 - TeamA). Because no user has been specified, ClaimCenter will execute assignment rules to assign the claim to a user in group demo-sample:31.
POST /claim/v1/claims/cc:34/assign
{
"data": {
"attributes" : {
"groupId" : "demo_sample:31"
}
}
}
Note that there is currently no endpoint that returns groups or group IDs. To assign claims to a specific group, the caller application must determine the group ID using some method other than a groups system API.
Assignment example - Using automated assignment
The following assigns claim cc:34 using automated assignment rules.
POST /claim/v1/claims/cc:34/assign
{
"data": {
"attributes": {
"autoAssign" : true
}
}
}