Claims

Socotra supports recording claims data, including FNOL, managing subclaims against specific coverages, reserving, and payables.

“Subclaims” represent specific claim exposures, each of which will relate to a specific exposure and peril within the associated policy. Each subclaim has separate loss and expense reserves. Within each reserve, payables can be created and adjusted.

See also claims reports.

  • Total reserves across all subclaims are visible at the claim level

  • Loss reserves may not be entered unless coverage was in place on the incident date

  • Expense reserves may be set even if there was no coverage on the loss date

  • Closing a subclaim sets its reserves to zero

  • Closing a claim also closes all of its subclaims

  • The event stream indicates when claims are opened, updated, or closed, and when payables are created or reversed

Note

Since Socotra treats negative values as debits to the insurer and positive amounts as credits, subclaim loss and expense reserves will be negative values in the API.

Configuration

The configuration for a product’s claims is in the file /products/{productName}/claim/claim.json. This file defines the data fields at the claim level.

{
  "fields": [
    {
      "name": "incident_summary",
      "title": "Incident Summary",
      "type": "string",
      "multiline": true,
      "maximum": 3000,
      "width": 12
    },
    {
      "name": "fraud_check",
      "title": "Fraud Check Result",
      "type": "select",
      "values": [
        "Genuine",
        "Fraudulent"
      ]
    }
  ]
}

The file /products/{productName}/claim/subclaim/subclaim.json allows extending the subclaim object to capture data fields. The configuration format is the same as for claims.json:

{
  "fields": [
    {
      "name": "subclaim_review_comments",
      "title": "Subclaim Review Comments",
      "type": "string",
      "multiline": true,
      "maximum": 2000,
      "width": 12
    }
  ]
}

Claims API

Create and add data to claims using the Create Claim and Update Claim endpoints.

Create and reverse payables on subclaims using the Create Payable and Reverse Payable endpoints.

Claims in the UI

File a claim in the Socotra UI by clicking “File a claim” at the bottom of the policy view. After entering initial data for the claim, click Open to initialize the claim. Add subclaims after opening the claim by clicking “Add Subclaim” in the Subclaims area.