D2IR Local Endpoint (Circulation): Report Item Received to Owning Site for Item Hold

Purpose:

Endpoint receives message from central server to owning site indicating that a shipped item has been received by the borrowing site.

Local Endpoint: 

[PUT] /innreach/v2/circ/itemreceived/<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)
  • centralItemType: integer (0-255)
  • title: string (256 bytes maximum, sent if item has a title)
  • author: string (256 bytes maximum, sent if item has an author)
  • itemBarcode (optional)
  • callNumber: string (256 bytes maximum, sent if item has a call number)
  • centralPatronType: integer 0-255
• Retrieve INN-Reach transaction with trackingId
  • Check transaction is in state ITEM_SHIPPED
    • If not state ITEM_SHIPPED, return 4xx Bad Request
    • If state ITEM_SHIPPED
      • Set transaction state to ITEM_RECEIVED
      • Return 200