29 Renew
- Request
- 29
- Response
- 30
- Set
- optional
- Position in BX
- 14
Renewal sets a new due date for an item the patron already has. The item stays with the patron; nothing is returned and nothing charged anew.
Whether renewal is allowed at all is decided by the library system alone – holds, the maximum number of renewals, outstanding fees and blocks all play a part. The device asks and displays the answer.
A device that shows an account list, however, has to know this BEFORE it offers a
button. That is what XR in the
patron information
is for: it states, for every charged item, whether a renewal would succeed, what
it would cost and how long it would run.
State the fee first, post it afterwards#
BO exists to settle the renewal in two steps, and a self-checkout unit should
do exactly that:
- Request without
BOor withBON. If the renewal costs anything, the library system posts nothing, reports0in the ok field and states the amount inBV. - The device displays the amount. If the patron confirms, the same request goes
out again with
BOY.
That way no fee can arise at the device that nobody was shown.
Request 29#
29<third party allowed><no block><timestamp><nb due date><AO...><AA...>
<AB...><AJ...><AC...><AD...><CH...><BO...>
| Field | Length | Required | Content |
|---|---|---|---|
| third party allowed | 1 | yes | Y a third party may renew on the patron's behalf |
| no block | 1 | yes | Y transaction filed later from offline operation |
| timestamp | 18 | yes | date and time on the device |
| nb due date | 18 | yes | due date from offline operation; otherwise blank |
| Identifier | Required | Content |
|---|---|---|
AO |
yes | institution identifier |
AA |
yes | patron identifier |
AB |
no | item identifier |
AJ |
no | title of the item |
AC |
no | terminal password |
AD |
no | patron password |
CH |
no | item properties |
BO |
no | Y the patron has acknowledged a fee |
At least one of the fields AB and AJ must be filled, otherwise it is not
apparent which item is meant. In practice it is AB.
Response 30#
30<ok><renewal ok><magnetic media><desensitize><timestamp><AO...><AA...>
<AB...><AJ...><AH...><BT...><CI...><BH...><BV...><CH...><AF...><AG...>
| Field | Length | Required | Content |
|---|---|---|---|
| ok | 1 | yes | 1 renewed, 0 not renewed |
| renewal ok | 1 | yes | Y the item was renewable |
| magnetic media | 1 | yes | Y/N/U |
| desensitize | 1 | yes | Y/N/U; without meaning for a renewal |
| timestamp | 18 | yes | date and time on the library system |
| Identifier | Required | Content |
|---|---|---|
AO |
yes | institution identifier |
AA |
yes | patron identifier |
AB |
yes | item identifier |
AJ |
yes | short title, optionally preceded by the author |
AH |
yes | new due date |
BT |
no | fee type |
CI |
no | N leave the security status of the item unchanged |
BH |
no | currency; only together with BV |
BV |
no | fee for the renewal |
CH |
no | item properties |
AF |
no | message for the screen |
AG |
no | message for the receipt |
If it is refused, the reason appears in plain text in AF – "the item is on
hold", "the maximum number of renewals has been reached", "please see the desk".
AH then still carries the previous, unchanged due date.
Example#
29YN20260728 14301220260728 143012AOBVS|AA1140360000042|AB1140360000123|AY8AZEDF7<CR>
301YUU20260728 143012AOBVS|AA1140360000042|AB1140360000123|AJEnde, Michael: Momo|AH22.09.2026|BT01|CIN|CH000|AFRenewal successful|AG|AY8AZD8B7<CR>