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

Purpose:

Endpoint receives message from central server to owning site indicating that an item that was not checked out to the borrowing site (shipped) has been received by the borrowing site.

Local Endpoint: 

[PUT] /innreach/v2/circ/receiveunshipped/<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_SHIPPED
    • If state ITEM_SHIPPED, return 4xx Bad Request
    • If state is ITEM_HOLD
      • Set transaction state to RECEIVE_UNANNOUNCED
      • Return 200