D2IR Local Endpoint (Circulation): Create INN-Reach Item Hold - Create FOLIO Request

Purpose:

Create an item request in FOLIO's Requests app (mod-circulation) based on the creation of an INN-Reach Item Hold transaction

Requirements:

When an Item Hold transaction is created via mod-inn-reach (MODINREACH-83)

• Check to see if indicated item is requestable for immediate fulfillment:
  • Item is of status "Available" in FOLIO, or
  • Item is of status "In transit" in FOLIO with no open requests, or
  • Item is of status "In process" in FOLIO with no open requests, or
  • Item is not of statuses: "Withdrawn", "Missing", "Checked out", "Declared lost", "Aged to lost", or another status configured a "not available" in the settings defined in MODINREACH-81
• If item is requestable for immediate fulfillment
  • Retrieve the FOLIO patron barcode for for the provided central server/central patron type indicated in the request
  • Place a request (page or hold, depending on item state) on on the item indicated by itemId in the request body on behalf of the indicated patron, with optional request expiration date set to FOLIO datetime equivalent or "neededBefore" value in the request body, the user's default pickup service point, and the patronAgency and pickupLocation in the requsterComments field (eg. "INN-Reach request: Patron Agency - <patronAgency>, Pickup Location - <pickupLocation>")
  • Store the requestId in the maser INN-Reach request model record for this central transactionId (MODINREACH-8)
  • Store the patronId of the patron with which the local request is associated on the INN-Reach request model record for this central transactionId
  • Store the FOLIO itemId of the requested item on the INN-Reach request model record for this central transactionId
• If request creation fails (item is no longer available or some other error)
  • Issue a "Owning site cancels request" call to the central server
    • See D2IR API docs for specification of this request
      • If item was no longer available set reason code to "Item not available"
      • If request creation failed set reason code to "Request not permitted"