D2IR Local Endpoint (Circulation): Cancel Request for INN-Reach Patron Hold

Purpose:

Cancels patron hold transaction when no item is available to fill the request.

Local Endpoint: 

[PUT] /innreach/v2/circ/cancelrequest/<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, unless indicated)
  • 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)
  • reason (optional): string
  • reasonCode: integer=7 (always "7")
• Retrieve INN-Reach transaction with trackingId
• Update INN-Reach transaction state to CANCEL_REQUEST
• Cancel associated request
  • Request reason: INN-Reach
    • Additional information: reason provided in cancellation request
• Remove call number and barcode from associated item record (if present)
• Remove call number from holdings record (if present)
• Return 200 response if update is successful
• Return 4xx error if bad request
• Return 500 error is internal server error