Update Skip Tags

The skip tags can be updated on a claim in the status change. The operation updateskiptags is available on the claims resource when claim is in the status change and there is at least one skip tag (claim tag action).

 ... claim properties ...
 "links": [
    {
      "href": "http://<host>:<port>/api/generic/claims/<id>",
      "rel": "self"
    },
    {
      "href": "http://<host>:<port>/api/claims/<claim id>/updateskiptags",
      "rel": "claim:updateskiptags",
      "httpMethod": "POST"
    }
  ]
}

Clients must send one or more claim skip tags in the POST payload:

{
  "claimTagActionList": [
  {
    "action": "<updated action>",
    "skipTagId": "<id of skip tag>"
  },
  {
    "action": "<updated action>",
    "skipTagId": "<id of skip tag>"
  }]
}

The system performs the following business operations:

  • Updating the skip action to Redo, Skip or Hold, the system updates the claim tag action to the appropriate action.

  • Updating the skip action to Undo

    • All the existing tagged results for that claim are discarded and the tag action is updated to Redo.

    • Edits are reversed per skip tag. Note that edits on locked claim lines are not reversed.

      • Claim lines that have the skip tag are removed. If the added line replaced original lines, the original lines are restored. The consumption taken by the deleted lines are transferred to the claim header level.

      • Any allowed amount and allowed number of units field that have the skip tag is cleared (set to 0) and the accompanying skip tag for allowed is cleared.

      • Any claim line message that has skip tag are removed

Authorization

The operation in this section is protected by access restriction "claims.updateskiptags IP". A grant must be given with both the Read and Update flag set. Read grant must also be given to the access restriction "claims API".

Response Message

Success

HTTP 303 SEE OTHER after the operation is completed successfully, request is redirected to claims API.

Table 1. Failure
Response Description

HTTP 401

Unauthorized

HTTP 404

Claim is unknown

HTTP 409

Claim is not in the Change status

The following messages may be returned in case of an error:

Table 2. Error Messages
Code Description

CLA-HTTP-001

Skip tag is unknown

Please refer to the "Response Messages" section in the HTTP API Integration Points part of the Common Features book for more details.