D2IR Local Endpoint (Circulation): Item In Transit Message (Owning Site)

Purpose:

Endpoint receives message from central server to owning site indicating that a loaned item is being returned after being loaned to the borrowing patron.

Local Endpoint: 

[PUT] /innreach/v2/circ/intransit/<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)
• Retrieve INN-Reach transaction with trackingId
  • Check transaction is in state ITEM_RECEIVED or RECEIVE_UNANNOUNCED
    • Update status to ITEM_IN_TRANSIT
    • Return 200
  • Else return 4xx Bad Request