Uploaded image for project: 'mod-inn-reach'
  1. mod-inn-reach
  2. MODINREACH-85

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

    XMLWordPrintable

Details

    • Front-end User Story Template
    • Volaris Sprint 124, Volaris Sprint 125, Volaris Sprint 126
    • 3
    • Volaris
    • Lotus R1 2022

    Description

      Purpose:

      Originates a patron hold at the borrowing site, including creation of local instance, holdings, and item record to represent the requested item.

      Requirements:

      Local Endpoint: 

      [POST] /innreach/v2/circ/patronhold/<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 be the central code of the requesting central server)
      • 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)
        • 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)
        • callNumber: string (256 bytes maximum, sent if item has a call number)
        • needBefore: integer Epoch UNIX timestamp (only optional field)
      • Check to see if an existing transaction exists for the specified trackingId + centralCode combination
        • If there is no existing transaction
          • Create a local transaction record for this request (MODINREACH-8) of transaction type "Patron" with the supplied information
        • If there is an existing transaction record
          • Update transaction data based on new request parameters
      • Return 200 if request received successfully and transaction record is created before performing further processing of the transaction

      TestRail: Results

        Attachments

          Issue Links

            Activity

              People

                brookstravis Brooks Travis
                brookstravis Brooks Travis
                Votes:
                0 Vote for this issue
                Watchers:
                1 Start watching this issue

                Dates

                  Created:
                  Updated:
                  Resolved:

                  TestRail: Runs

                    TestRail: Cases