New Blank ACQ Request
General Purpose
The resource may be accessed with a GET method to retrieve the needed parameters for a new ACQ request for a specific patron.
The ACQ request information includes the order group information that the patron may submit when creating the new ACQ request.
The resource may be accessed with a PUT method to create a new ACQ request for a specific patron.
The new ACQ request creates a new Title record according to bibliographic information submitted.
For creating an ACQ request on an existing title record please refer to the “New ACQ Request per Title” page.
Product Version Compatibility
Versions 22.01 and later.
Interface Type
RESTful API
Hierarchy
Slide21_patron-patron_id-new_acq
Input Parameters
REST Resource IDs:
Patron ID: The Aleph patron system identifier.
Input URI
<Base URL>:patron/<patron ID>/acqRequest
For example:
To create a new ACQ request for the patron ID 00000036 (a new title which does not exist), use:
http://server.name:1892/rest-dlf/patron/00000036/acqRequest
Input XML
To create a new item-level photo request, use the same URL with a PUT method of HTTP.
The request “Body” of the “PUT” method must contain input XML with the Photo request details.
The PUT XML must have the following structure:
<?xml version="1.0" encoding="UTF-8" ?> <get-rec-acq> <reply-text>ok</reply-text> <reply-code>0000</reply-code> <acq_parameters allowed="Y"> <reason>because</reason> <order-group>Art Dep</order-group> <author/> <add-author/> <title>Very Nice Title</title> <edition/> <publication-place/> <publisher/> <publication-year/> <ISBN/> <series/> <info-source/> </acq_parameters> </get-rec-acq>
Output XML Format
If a new ACQ 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