New ACQ Request per Title
The resource may be accessed with a GET method to retrieve the needed ACQ request parameters for a specific patron and title.
The ACQ request information includes the reason and order information that the patron may submit when creating a Title-level ACQ request.
The resource may be accessed with a PUT method to create a new ACQ request for a specific patron and on a specific Title.
For creating a totally new ACQ request on non existing title, please refer to the “New Blank ACQ Reques” page.
Product Version Compatibility
Versions 22.01 and later.
REST Resource IDs:
Patron ID: The Aleph patron system identifier.
Record ID: The Aleph BIB record identifier. The identifier is composed of the BIB library code + the system number. For example, USM01000050362
Item ID: The Aleph item record identifier. The item ID may be used to fetch a specific item’s information. The identifier is composed of the ADM library code + the item record key. For example, USM50000238843000320.
<Base URL>:patron/<patron ID>/record/<record ID>/acqRequest
To submit an ACQ request for a specific BIB record 000000300 and for the patron ID 00000036, use:
To submit an ACQ request for a specific BIB record and patron, use the same URL with a PUT method of HTTP.
The request “Body” of the “PUT” method must contain input XML with the ACQ request details.
The PUT XML must have the following structure:
post_xml=<?xml version="1.0" encoding="UTF-8" ?><get-rec-acq> <acq_parameters allowed="Y"> <reason>I need it</reason> <order-group>Art Dep</order-group> </acq_parameters> </get-rec-acq>
(The “post_xml=” is mandatory).
Output XML Format
If a new request was successfully created using the PUT method, a reply such as the following will be reported:
<?xml version="1.0" encoding="UTF-8"?> <put-rec-acq> <reply-text>ok</reply-text> <reply-code>0000</reply-code> <create-acq-request> <note type="info">Action Succeeded</note> </create-acq-request> </put-rec-acq>
Possible Error Codes
0002 The patron ID is invalid.
0019 Record does no exist
0025 Failed to create request
0029 Patron is not privileged
0028 Match records found