Circulation Troubleshooting

Start with the message beside the relevant Member lookup or Item lookup field. Libcodesk keeps rejected rows out of an issue queue and preserves blocked attention rows so staff can see the exact reason rather than guessing.

Scanner Or Lookup Problems

Problem	What to check
Member scan does not work	Confirm the enabled identifiers in Member Lookup Settings. Search by visible Member ID, library card, RFID, name, phone, or email as permitted.
Item scan does not work	Search by an enabled barcode, QR value, accession, RFID, call number, or title. Confirm the copy belongs to the active library.
Exact value is not selected automatically	Confirm the identifier is unique and exact matching is enabled. Duplicate values must open a selection result.
Search returns too many rows	Add more characters or use an exact identifier. Use the result filters without hiding the required status/type.
Wrong row appears	Check duplicate barcode, accession, RFID, visible Member ID, card, phone, or email values.
Multiple-result popup cannot be operated	The first row should be selected. Use Up/Down and Enter, click anywhere on a row, and use vertical scrolling for longer lists.

Member And Plan Problems

Problem	What to check
Member cannot issue	Check active status, Membership Plan status/expiry, total active loans, borrowing limit, dues/blocks, and Collection/Facility Access.
Expired member does not open renewal	Enable Open Renew Popup for Expired in Member Lookup Settings and confirm renewal permission.
Current Loans does not refresh	If automatic clearing is off, wait for transaction completion and refresh the tab. Otherwise rescan the member.
Accession copy button has no feedback	Confirm clipboard permission. The shared copy icon should change to a tick briefly after success.

Issue And Policy Problems

Problem	What to check
Due date looks wrong	Check Membership Plan loan duration, matching Borrowing Rule, active library calendar, closing time, holidays, and any authorized date override.
Item is rejected	Read the inline reason. Check copy status, lending restriction, reference-only access, active loan, reservation, collection access, and member limits.
Same-title copy is rejected	Review the active loans, current queue, canonical catalogue identity, and Same-title active copy limit in Issue Policy.
Reference-only item is rejected	Confirm both reference collection access and Reading Room facility access.
Issue All remains disabled	Select an eligible member and add at least one ready item. Correct or remove attention rows.
Blank Item lookup Enter does nothing	The queue must contain a ready row. With a value present, Enter searches; with a blank field and ready queue, Enter runs Issue All.

Return And Renewal Problems

Problem	What to check
Member return scan does not select every row	This is intentional. Select only physically returned items or use the heading checkbox after reviewing the list.
Scanned returned item is not selected	Confirm the copy has an active loan in the selected library and its identifier is unique.
Return Selected is disabled	Select at least one active returnable loan; already returned or blocked rows are not active returns.
Renew loads the wrong member	Stop and verify the scanned copy and active-loan borrower before completing the queue.
Proposed renewal date looks wrong	It should use current due date plus effective renewal duration. Check the plan, matching rule, calendar, and holidays.
Renewed item still appears overdue	Refresh and verify the active loan stores the new due date. The old date remains only in Circulation History.

Reservation And Reminder Problems

Problem	What to check
Reserve title is not offered	Confirm no issuable copy exists, the selected member does not already hold the title, and the normal issue queue is clear.
Reservation does not become Ready	Check the returned copy's canonical title, eligibility, queue order, member eligibility, and active library.
Pickup deadline is blank	A Queued reservation has no deadline; the deadline begins when it becomes Ready for pickup.
Send reminder is disabled	Select an active overdue loan and verify notification permission and Overdue Reminder event rules.
App notification is unavailable	OPAC app notification requires Cloud setup. Local setup uses only supported configured local channels.
Reminder failed	Review Notification History, member contact data, template, gateway/channel, and retry result.

Transaction Memo And Printer Problems

Problem	What to check
Print dialog does not open	Enable Print transaction memo, select the transaction template/printer behavior, and check browser or operating-system print permission.
Wrong memo format opens	Check the independent Issue, Return, Renew, and Reserve format selections in Printer setup.
Automatic printing opens a dialog	The Standalone app falls back to the system dialog when no usable default printer is available.

History And Data Problems

Problem	What to check
History is empty	Confirm the active library, clear search/type filters, and refresh. Missing catalogue display details do not remove recorded events.
Older circulation is missing after an update	Restart or refresh after migration/recovery finishes. Recovery is repeat-safe and should not duplicate events.
Summary loads but history reports an error	Update to the current release and retry. If it continues, ask the organization admin to export diagnostic logs.
“Return date not set” is shown	The older/incomplete active transaction has no stored due date. Review and correct the loan; the desk does not invent one.

Need More Help

Staff should ask their organization admin to review permissions, member/plan access, copy status, rules, printer configuration, notification setup, and diagnostic logs. Organization admins may contact CodeAchi support for cloud access, licence, billing, or unresolved product errors. Members should contact their library.

Cloud setup and Local setup are separate data worlds. Always reproduce and diagnose the problem in the setup where the transaction occurred.