Sample composite first-and-final

Composite requests can mimic the functionality of ClaimCenter Auto First-and-Final, in which a claim is created, paid out, and closed without adjudication.

For more information about Auto First-and-Final, see the ClaimCenter Application Guide.

Note:
  • Mimicing auto first-and-final claim processing can create entities that cannot be closed in the composite request. For example, workplan rules can create activities that the composite request is unaware of and therefore cannot complete. Depending on your configuration, you may need to execute additional steps to completely close the claim.
  • Activities can prevent claims and exposures from closing, and therefore you may need to close all activities automatically created during a composite request for claim closure.
  • You can POST /check-sets for composite requests for only non-recurring, final-payment checks; you cannot complete a partial payment transaction using composite requests.

Subrequest order

When executing a first and final claim within a composite request, you must execute the steps in the following order. If steps are executed in a different order, then some objects may get created automatically by ClaimCenter that conflict with objects created in later subrequests.

  1. POST the claim.

  2. POST the vehicle incident.

  3. POST an exposure with the following attributes

    1. The exposure's incident is the vehicle incident.

    2. The exposure's coverage is Comprehensive.

    3. The exposure's claimant is the insured.

  4. Submit the claim.

  5. POST the payment with the following attributes:

    1. The payment draws from the exposure's reserve line.

    2. The payment's payee is the insured.

Minimum composite request example

The following composite request uses the minimum composite requests for an immediate closing of claim and transaction payment (depending on your activity patten configuration).

  1. POST the claim:
    {
"requests": [
  {
    "body": {
      "data": {
        "attributes": {
          "coverageInQuestion": false,
          "description": "Rear-ended by distracted driver",
          "faultRating": {
            "code": "nofault"
          },
          "howReported": {
            "code": "phone"
          },
          "incidentOnly": false,
          "jurisdiction": {
            "code": "CA"
          },
          "lossCause": {
            "code": "FallingObject"
          },
          "lossDate": " 2020-08-31T07:00:00.000Z)",
          "lossLocation": {
            "addressLine1": " 2850 S Delaware St ",
            "city": "San Mateo",
            "country": "US",
            "county": "San Mateo",
            "postalCode": "94404",
            "state": {
              "code": "CA"
            }
          },
          "mainContact": {
            "policySystemId": "pc:contact_1"
          },
          "policyNumber": "POLICY-ID",
          "reportedByType": {
            "code": "self"
          },
          "reporter": {
            "policySystemId": "pc:contact_1"
          }
        }
      }
      },
    "method": "post",
    "uri": "/claim/v1/claims",
    "vars": [
      {
        "name": "claimId",
        "path": "$.data.attributes.id"
      }
    ]
  },
  2. POST the vehicle incident.
      {
    "body": {
      "data": {
        "attributes": {
          "collision": true,
          "damageDescription": "Tree fell",
          "lossParty": {
            "code": "insured"
          },
          "vehicle": {
            "policySystemId": "pcveh:1"
          }
        }
      }
    },
    "method": "post",
    "uri": "/claim/v1/claims/${claimId}/vehicle-incidents",
    "vars": [
      {
        "name": "firstPartyVehicleIncidentId",
        "path": "$.data.attributes.id"
      }
    ]
  },
  3. POST an exposure associated with the vehicle incident from step 2 with comprehensive coverage and the insured and the claimant.
      {
    "body": {
      "data": {
        "attributes": {
          "coverage": {
            "policySystemId": "pc:coverage_2"
          },
          "coverageSubtype": {
            "code": "PAComprehensiveCov"
          },
          "claimant": {
            "policySystemId": "pc:contact_1"
          },
          "primaryCoverage": {
            "code": "PAComprehensiveCov"
          },
          "vehicleIncident": {
            "id": "${firstPartyVehicleIncidentId}"
          }
        }
      }
    },
    "method": "post",
    "uri": "/claim/v1/claims/${claimId}/exposures",
    "vars": [
      {
        "name": "exposureId",
        "path": "$.data.attributes.id"
      }
    ]
  },
  4. Submit the claim.
      {
    "body": {
      "data": {
        "attributes": {
          "initialAssignment": {
            "groupId": "#(args.groupId)",
            "userId": "#(args.adjusterId)"
          }
        }
      }
    },
    "method": "post",
    "uri": "/claim/v1/claims/${claimId}/submit"
  },
  5. POST a payment to the insured.
      {
    "body": {
      "data": {
        "attributes": {
          "primaryCheckToWrite": {
            "paymentsToWrite": [
              {
                "lineItems": [
                  {
                    "transactionAmount": {
                      "amount": "500",
                      "currency": "usd"
                    }
                  }
                ],
                "paymentType": {
                  "code": "final"
                },
                "reserveLine": {
                  "costCategory": {
                    "code": "body"
                  },
                  "costType": {
                    "code": "claimcost"
                  },
                  "exposure": {
                    "id": "${exposureId}"
                   },
                  "reservingCurrency": {
                    "code": "usd"
                  }
                },
                "currency": {
                  "code": "usd"
                }
              }
            ],
            "payees": [
              {
                "contact": {
                  "policySystemId": "pc:contact_1"
                },
                "payeeType": {
                  "code": "other"
                }
              }
            ],
            "paymentMethod": {
              "code": "check"
            },
            "mailTo": "Ray Newton",
            "payTo": "Ray Newton",
            "mailingAddress": {
              "addressLine1": "2850 S Delaware St ",
              "city": "San Mateo",
              "country": "US",
              "county": "San Mateo",
              "postalCode": "94403",
              "state": {
                "code": "CA"
              }
            }
          }
        }
      }
    },
    "method": "post",
    "uri": "#('/claim/v1/claims/${claimId}/check-sets')",
    "vars": [
      {
        "name": "checkId",
        "path": "$.data.attributes.checks[0].id"
      }
    ]
  }
  ]
}