D2IR Local Endpoint (Circulation): Recall Item Message for Patron Hold

Purpose:

Endpoint receives message from central server to the borrowing site indicating that an INN-Reach item has been recalled.

Local Endpoint: 

[PUT] /innreach/v2/circ/recall/<trackingId>/<centralCode>

• Accepts the following URL Parameters
  • trackingId: a unique ID used for transaction tracking
  • centralCode: Unique code that identifies the central server (3-5 character lower-case alphanumeric, must match requesting X-From-Code header value)
• Accepts the following application/json request body (all attributes required)
  • transactionTime: integer Epoch UNIX timestamp
  • patronId: lower-case alphanumeric string, maximum 32 characters (User UUID with hyphens stripped out or other system-supplied unique identifier from non-FOLIO systems)
  • patronAgencyCode: 5 character lowercase alphanumeric string
  • itemAgencyCode: 5 character lowercase alphanumeric string
  • itemId: lowercase alphanumeric string (max 32 characters: item HRID or UUID, depending on record contribution implementation)
  • dueDateTime: Integer, UNIX epoch timestamp
• Retrieve INN-Reach transaction with trackingId
  • If item is on loan to the patron, create a local FOLIO recall request on the item using INN-Reach Recall Patron (MODINREACH-171)
  • If item is on the hold shelf, cancel the local FOLIO request associated with the transaction
  • Set transaction state to RECALL
  • If the above are successful, return 200, else 4xx Bad Request