Operations FAQ and Troubleshooting

This document collects common operational questions that appear while using AnyVet Smart.

Q. Inventory looks lower or higher than reality.

Check in this order:

1. Turn on Show Depleted Lots in /stock.
2. Review remaining quantity and expired lots by lot.
3. Open /stock/movement-history and review recent PURCHASE, WITHDRAWAL, ADJUSTMENT, and SALE.
4. Create a new adjustment only after the movement review.

Related docs:

• Monitor Stock and Manage the Catalog
• Record Stock Adjustments and Withdrawals

Q. A PO was created, but stock did not increase.

Creating a PO alone does not increase stock. Stock increases only after receiving is recorded.

Check in this order:

1. review the PO status
2. confirm whether receiving was processed
3. review /stock/receive-order history

Q. A user cannot see the Admin menu.

The admin menu is primarily for super_admin and admin. Check the role first.

Related docs:

• Roles and Access Matrix

Q. Grooming or Pet Taxi is not available.

This may be a role issue, but branch feature enablement should be checked first.

Check in this order:

1. open facility settings for the branch
2. confirm Grooming or Pet Taxi is enabled
3. confirm the user is in the correct branch context
4. then review role-based access

Related docs:

• Run Grooming Appointments
• Dispatch Pet Taxi Bookings
• Roles and Access Matrix

Q. Hotel rooms, grooming stations, or taxi vehicles look wrong.

This is usually caused by resource configuration or view-mode misunderstanding.

Check in this order:

1. confirm whether the current view is booking or daily
2. review room, station, or vehicle resources in the settings hub
3. separate same-day timing issues from duration or period booking issues
4. check for duplicate or inactive resources

Related docs:

• Manage Hotel Bookings and Stays
• Run Grooming Appointments
• Dispatch Pet Taxi Bookings

Q. I need to know who changed something.

Open /admin/logs, narrow the results by user, category, action, and search term, then inspect the detail diff.

Related docs:

• Use Audit Logs

Q. A newly created bill does not appear in Receipt.

/pos/receipt currently loads only PAID and VOID. Unpaid ISSUED bills should be reviewed from Shop or unpaid-bill flows instead.

Related docs:

• Manage POS Sales and Payment
• Manage Receipts, Tax Invoices, and Voids

Q. A tax invoice does not print.

Before blaming the printer, check the billing prerequisites:

1. confirm the bill is already in a paid context
2. confirm the customer address is complete enough
3. confirm whether full-tax conversion is still needed
4. confirm customer data loads correctly in the invoice modal

Related docs:

• Manage Receipts, Tax Invoices, and Voids

Q. Payment is complete, but an extra service was missed.

Service reservations require one more cart review at checkout. Hotel, Grooming, and Pet Taxi often miss add-on services at the end of service.

Recommended response:

1. reopen the reservation or checkout context and confirm whether the item was missed
2. review the payment and receipt history first if payment is already complete
3. follow the hospital's correction or additional billing policy

Related docs:

• Manage Hotel Bookings and Stays
• Manage POS Sales and Payment

Q. Login failures suddenly increased.

Review the LoginFailed trend in audit logs and check whether the failures cluster around a specific user or network pattern. If needed, force logout or instruct a password reset.

Q. The document and the current UI look slightly different.

These user docs are written against the current code baseline, but recent releases can still move labels or UI positions. First confirm the route and button names. If the gap is large, the documentation should be updated.

Related Docs

• Roles and Access Matrix
• Use Audit Logs
• Welcome