Services and Operations > Patron service > createMyHold

createMyHold

The createMyHold operation allows you to make a hold for the current session user and get a hold key back.

This operation is different than the placeMyHold operation, which returns the hold key plus additional information about the request.

Synopsis

Service

Patron service

Namespace

http://schemas.sirsidynix.com/symws/patron

Prerequisites

Valid clientID (see clientID)

Request

CreateMyHoldRequest

Response

CreateMyHoldResponse

Operation faults

None (see Faults)

CreateMyHoldRequest

The CreateMyHoldRequest has the following request parameters:

Parameter

Type

Description

Required?

itemID and titleKey are a choice. Specify a value for one or the other.

itemID

xs:string

Specifies the item ID for the item being placed on hold.

Note: Only specify an itemID or a titleKey. Do not specify both.

Y

titleKey

xs:long

Specifies the titleKey for the item being placed on hold.

Note: Only specify a titleKey or an itemID. Do not specify both.

callNumber

xs:string

Specifies the call number for the item being placed on hold.

This is mainly used for placing volume-level holds. For information about how to determine whether this is needed, see Volume holds.

N

holdType

HoldType

Specifies the enumerated hold type value.

If you do not specify a holdType value, the system assumes TITLE by default.

N

holdRange

HoldRange

Specifies the enumerated hold range value.

If you do not specify a holdRange value, the system assumes GROUP by default.

N

pickupLibraryID and mailServiceID are a choice. Specify a value for one or the other.

pickupLibraryID

xs:string

Specifies the pickup library Library ID if the hold will be picked up by the patron.

Note: Do not specify a pickupLibraryID if you specify a mailServiceID.

Y

mailServiceID

xs:string

Specifies the Mail Service Tracking ID if the hold will be delivered by mail.

Note: Do not specify a mailServiceID if you specify a pickupLibraryID.

expiresDate

NillableDate

Specifies the hold expiration date.

You can specify a value that will override what is existing, or you can specify to nullify the existing date entirely.

If you do not specify an expiresDate value, the expiresDate will be calculated by the ILS.

N

suspendStartDate

xs:date

Specifies the start date of the hold suspension.

N

suspendEndDate

xs:date

Specifies the date the hold suspension ends.

N

comment

xs:string

Specifies optional text to display with the hold information.

N

CreateMyHoldResponse

The CreateMyHoldResponse is xs:long (see xs:long). The output will be the holdKey.

Related topics 

 


© 2009-2012 SirsiDynix