openapi: 3.2.0
info:
  title: Folio Staff Slips API
  version: v1
  description: 'Operations tagged staffSlips across 2 of this provider''s published API definitions: folio-mod-tlr-staff-slips-openapi.json, folio-mod-tlr-staff-slips-openapi.yml. Each path carries the servers of the definition it was published in.'
servers:
- url: /tlr/staff-slips
tags:
- name: staffSlips
paths:
  /pick-slips/{servicePointId}:
    get:
      operationId: getPickSlips
      tags:
      - staffSlips
      parameters:
      - $ref: '#/components/parameters/servicePointId'
      responses:
        '200':
          $ref: '#/components/responses/pick-slips'
        '400':
          $ref: '#/components/responses/badRequestResponse'
        '404':
          $ref: '#/components/responses/notFoundResponse'
        '500':
          $ref: '#/components/responses/internalServerErrorResponse'
      summary: Get pick slips
      x-summary-source: derived
    servers:
    - url: /tlr/staff-slips
  /search-slips/{servicePointId}:
    get:
      operationId: getSearchSlips
      tags:
      - staffSlips
      parameters:
      - $ref: '#/components/parameters/servicePointId'
      responses:
        '200':
          $ref: '#/components/responses/search-slips'
        '400':
          $ref: '#/components/responses/badRequestResponse'
        '404':
          $ref: '#/components/responses/notFoundResponse'
        '500':
          $ref: '#/components/responses/internalServerErrorResponse'
      summary: Get search slips
      x-summary-source: derived
    servers:
    - url: /tlr/staff-slips
components:
  schemas:
    staffSlip:
      description: Staff slip
      type: object
      properties:
        currentDateTime:
          type: string
          format: date-time
        item:
          type: object
          properties:
            title:
              type: string
            primaryContributor:
              type: string
            allContributors:
              type: string
            barcode:
              type: string
            status:
              type: string
            enumeration:
              type: string
            volume:
              type: string
            chronology:
              type: string
            yearCaption:
              type: string
            materialType:
              type: string
            loanType:
              type: string
            copy:
              type: string
            numberOfPieces:
              type: string
            displaySummary:
              type: string
            descriptionOfPieces:
              type: string
            effectiveLocationSpecific:
              type: string
            effectiveLocationLibrary:
              type: string
            effectiveLocationCampus:
              type: string
            effectiveLocationInstitution:
              type: string
            effectiveLocationDiscoveryDisplayName:
              type: string
            effectiveLocationPrimaryServicePointName:
              type: string
            callNumber:
              type: string
            callNumberPrefix:
              type: string
            callNumberSuffix:
              type: string
            lastCheckedInDateTime:
              type: string
              format: date-time
        request:
          type: object
          properties:
            requestID:
              type: string
              format: uuid
            servicePointPickup:
              type: string
            requestDate:
              type: string
              format: date-time
            requestExpirationDate:
              type: string
              format: date-time
            holdShelfExpirationDate:
              type: string
              format: date-time
            additionalInfo:
              type: string
            reasonForCancellation:
              type: string
            deliveryAddressType:
              type: string
            patronComments:
              type: string
        requester:
          type: object
          properties:
            firstName:
              type: string
            preferredFirstName:
              type: string
            lastName:
              type: string
            middleName:
              type: string
            barcode:
              type: string
            patronGroup:
              type: string
            departments:
              type: string
            primaryDeliveryAddressType:
              type: string
            primaryAddressLine1:
              type: string
            primaryAddressLine2:
              type: string
            primaryCity:
              type: string
            primaryStateProvRegion:
              type: string
            primaryZipPostalCode:
              type: string
            primaryCountry:
              type: string
            addressType:
              type: string
            addressLine1:
              type: string
            addressLine2:
              type: string
            city:
              type: string
            region:
              type: string
            postalCode:
              type: string
            countryId:
              type: string
    parameter:
      description: List of key/value parameters of an error
      type: object
      properties:
        key:
          description: Parameter key
          type: string
        value:
          description: Parameter value
          type: string
      additionalProperties: false
      required:
      - key
    pickSlipsResponse:
      description: Pick slips response
      type: object
      properties:
        totalRecords:
          type: integer
          description: Total number of pick slips
        pickSlips:
          type: array
          description: Collection of pick clips
          items:
            $ref: '#/components/schemas/staffSlip'
    errors:
      description: A set of errors
      type: object
      properties:
        errors:
          description: List of errors
          id: errors
          type: array
          items:
            type: object
            $ref: '#/components/schemas/error'
        total_records:
          description: Total number of errors
          type: integer
      additionalProperties: false
    error:
      description: An error
      type: object
      properties:
        message:
          type: string
          description: Error message text
        type:
          type: string
          description: Error message type
        code:
          type: string
          description: Error message code
        parameters:
          type: object
          description: Error message parameters
          $ref: '#/components/schemas/parameters'
      additionalProperties: false
      required:
      - message
    searchSlipsResponse:
      description: Search slips response
      type: object
      properties:
        totalRecords:
          type: integer
          description: Total number of search slips
        searchSlips:
          type: array
          description: Collection of search clips
          items:
            $ref: '#/components/schemas/staffSlip'
    parameters:
      description: List of key/value parameters of an error
      type: array
      items:
        type: object
        $ref: '#/components/schemas/parameter'
      additionalProperties: false
  parameters:
    servicePointId:
      name: servicePointId
      in: path
      required: true
      schema:
        type: string
        format: uuid
  responses:
    internalServerErrorResponse:
      description: When unhandled exception occurred during code execution, e.g. NullPointerException
      content:
        application/json:
          example:
            errors:
            - message: Unexpected error
            total_records: 1
          schema:
            $ref: '#/components/schemas/errors'
    notFoundResponse:
      description: Not found
      content:
        application/json:
          example:
            errors:
            - message: Request not found
            total_records: 1
          schema:
            $ref: '#/components/schemas/errors'
    search-slips:
      description: Search slips response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/searchSlipsResponse'
    pick-slips:
      description: Pick slips response
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/pickSlipsResponse'
    badRequestResponse:
      description: Validation errors
      content:
        application/json:
          example:
            errors:
            - message: Request is invalid
            total_records: 1
          schema:
            $ref: '#/components/schemas/errors'
x-refined-from:
- folio-mod-tlr-staff-slips-openapi.json
- folio-mod-tlr-staff-slips-openapi.yml