Circulation Actions

General Purpose

Retrieves sub-resources of the Circulation Actions resource, with each sub-resource being a circulation action type. In addition, a summary of how many of each circulation action type are registered for the patron is also reported. The information is exported per institution (ADM library).

Product Version Compatibility

Versions 18, 20.1 and later

Interface Type

RESTful API

Hierarchy

Input Parameters

REST Resources IDs:

Patron ID: The Aleph patron system identifier

URL Parameters:

Institution ID: The ID of an institution (ADM library) for which the information is requested. Optional.

Input URI

<Base URL>:/patron/<patron ID>/circulationActions?institution=<Institution ID>

For example: To retrieve the circulation actions for the patron ID 00000036, use:

http://server.name:1893/rest-dlf/patron/00000036/circulationActions

To retrieve the circulation actions for the patron ID 00000036 for a specific institution, use:

http://server.name:1893/rest-dlf/patron/00000036/circulationActions?institution=USM50

Output XML Format

The returned XML includes links to the Circulation Actions sub-resources, with summaries of each action. The information is reported per institution. The list of institutes can be limited to those in which the patron is active, depending on the institute’s setup of the FILTER-LIBRARY-CARD tab100 variable.

Example:

<?xml version="1.0" encoding="UTF-8"?>
<get-circ-acts>
  <reply-text>ok</reply-text>
  <reply-code>0000</reply-code>
  <circulationActions>
    <translate-change-active-library>USM50</translate-change-active-library>
    <institution code="USM50">
      <inst-name>Exlibris Demo Libraries</inst-name>
      <action type="Loans" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/loans?institution=USM50">
        <amount>4</amount>
      </action>
      <action type="Cash" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/cash?institution=USM50">
        <sum>-27.62</sum>
      </action>
      <action type="Requests" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/requests?institution=USM50">
        <amount>50</amount>
      </action>
      <note type="cash">Please note that there is an additional accrued overdue items fine of: 112.00.</note>
    </institution>
    <translate-change-active-library>USM51</translate-change-active-library>
    <institution code="USM51">
      <inst-name>USM51 Demo Libraries</inst-name>
      <action type="Loans" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/loans?institution=USM51">
        <amount>2</amount>
      </action>
      <action type="Cash" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/cash?institution=USM51">
        <sum>-4.00</sum>
      </action>
      <action type="Requests" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/requests?institution=USM51">
        <amount>0</amount>
      </action>
      <note type="cash">Please note that there is an additional accrued overdue items fine of: 0.00.</note>
    </institution>
    <translate-change-active-library>MAB50</translate-change-active-library>
    <institution code="MAB50">
      <inst-name>MAB Demo Library</inst-name>
      <action type="Loans" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/loans?institution=MAB50">
        <amount>0</amount>
      </action>
      <action type="Cash" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/cash?institution=MAB50">
        <sum>0.00</sum>
      </action>
      <action type="Requests" href="http://server.name:1893/rest-dlf/patron/00000036/circulationActions/requests?institution=MAB50">
        <amount>0</amount>
      </action>
      <note type="cash">Please note that there is an additional accrued overdue items fine of: 0.00.</note>
    </institution>
    <total type="Loans">6</total>
    <total type="Cash">-31.62</total>
    <total type="Requests">50</total>
    <total type="ActiveRequests">25</total>
  </circulationActions>
</get-circ-acts>

Note:

In Aleph 22.1 and later, the returned XML includes – for each < action type="Cash" ...> – the < sum > and also the < currency > .

Possible Error Codes

01 : The supplied institution ID is invalid

02 : The patron ID is invalid