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

Purpose:

Originates an item hold at the owning site.

Requirements:

Local Endpoint:

/innreach/v2/circ/itemhold/<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)
• Accepts the following as a JSON request body:
  • transactionTime: integer Epoch UNIX timestamp
  • pickupLocation: A colon-delimited list of three or four 512-byte (maximum) strings, the fourth of which is optional (<Pickup Loc Code>:<Display Name>:<Print Name>:<Delivery Stop>)
  • 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)
  • needBefore: integer Epoch UNIX timestamp (only optional field)
  • centralPatronType: integer 0-255
  • patronName: string representation of patron name provided by patron's local server
• Creates a local transaction record for this request (MODINREACH-8) of transaction type "Item" with the supplied information
• Return 200 if request received successfully before performing further processing of the request