Claim Serial Issues/Parts

Claim multiple issues/parts from alert list.

PUT /api/.../claimalertlist

Request Information

Parameters
Name Type Required Description
dtoClaimIDData Issue records details Yes Define this parameter in the request body.
dtoClaimIDData
Property Type Nullable Description
ClaimIDList List of Int No List of issue/part ids to be claimed.
Example
application/json, text/json 
{
  "ClaimIDList": [34478,21823,22798,18327,15646,1178]
}

Response Information

Array of DtoClaimListResult
Property Type Nullable Description
ID Integer No issue/part identifier.
Success Boolean No True if the action succeeded, otherwise false.
ErrorMsg String Yes Error message if the action failed, otherwise null or an empty string.
Example
application/json, text/json 
[
  {
    "ID": 1178,
    "Success": true,
    "ErrorMsg": null
  },
  {
    "ID": 15646,
    "Success": false,
    "ErrorMsg": "Baedeker's Austria. (Jan. 2024): Issue/part cannot be claimed because it has reached the maximum claim number."
  },
  {
    "ID": 18327,
    "Success": false,
    "ErrorMsg": "J-14. (Winter Feb. 2024): Issue/part cannot be claimed because it has reached the maximum claim number."
  },
  {
    "ID": 21823,
    "Success": false,
    "ErrorMsg": "Parenting. Vol 1 No. 1  (Jan. 2021): Issue/part cannot be claimed because it does not have a supplier."
  },
  {
    "ID": 22798,
    "Success": true,
    "ErrorMsg": null
  },
  {
    "ID": 34478,
    "Success": false,
    "ErrorMsg": "Little Black Bear goes for a walk (Autumn 2021): Issue/part cannot be claimed because its holdings record does not have claim criteria."
  }
  ]

HTTP Response Codes

Code Description
200 OK. Success
500 FAILURE.
  • Bad request
  • Invalid DTO
400 FAILURE.
  • Bad request
  • Invalid id list

Required Permissions

Permission IDs found here.

    CR_AccessSerials_Allow (),
    CR_SerialIssuesStandingOrderParts_Claim (based on owner ID)