Create check-refund endpoint for multiple selected accounts

This story is part of the fees/fines refactoring feature. Design doc: https://wiki.folio.org/pages/viewpage.action?pageId=36576978

Currently, calculations for fee/fine actions are happening on FE without any checks on the BE side.

Instead, when a value is entered in the amount field, an additional call to the new "check" endpoint needs to be made prior to the action in order to check if this value is valid and if the action is allowed.

New endpoint to be added to the mod-feesfines module:

POST /accounts-bulk/check-refund

Request body

{
  "accountIds": [
    "e74d50c9-0c69-4f80-9e1b-a819719fc0c9",
    "983d43fc-2fa8-4eb7-b3e7-30e60159f237"
  ],
  "amount": "3.55"
}

Reponse

• In case of success:
  Status code: 200
  Response body:

  {
    "amounts": [
      {
        "accountId": "e74d50c9-0c69-4f80-9e1b-a819719fc0c9",
        "amount": "1.0"
      },
      {
        "accountId": "983d43fc-2fa8-4eb7-b3e7-30e60159f237",
        "amount": "2.55"
      }
    ],
    "allowed": true,
    "amount": "3.55",
    "remainingAmount": "6.45"
  }
  

• In case if the amount is too high:
  Status code: 422
  Response body:

  {
    "accountIds": [
      "e74d50c9-0c69-4f80-9e1b-a819719fc0c9",
      "983d43fc-2fa8-4eb7-b3e7-30e60159f237"
    ],
    "amount": "3.55",
    "allowed": false,
    "errorMessage": "Requested amount exceeds remaining amount"
  }
  

• In case of invalid amount value (e.g. negative or not parsable):
  Status code: 422
  Response body:

  {
    "accountIds": [
      "e74d50c9-0c69-4f80-9e1b-a819719fc0c9",
      "983d43fc-2fa8-4eb7-b3e7-30e60159f237"
    ],
    "amount": "abcdefg",
    "allowed": false,
    "errorMessage": "Invalid amount entered"
  }