Chapter 8: Master Data Setup — 8.10 Stock Out Reason
Use Stock Out Reason to create a list of reasons why stock might be removed — like "Damaged", "Expired", "Sample/Tester", or "Staff Consumption". When staff do a stock-out at the POS or backend, they must select a reason from this list, keeping your records clean.
When to use this: When you need to create or manage the list of reasons staff can select when doing a stock out.

This is a simple master data page that maintains a list of stock out reasons. These reasons appear as a mandatory dropdown when creating stock out transactions in the Inventory module.
| Element | Type | Function |
|---|---|---|
| + Add New | Green Button | Create a new stock out reason |
| Export | Orange Button | Export to Excel |
| Search Bar | Text Input | Filter by reason name |
| 🔽 Filter | Funnel Icon | Show/hide deleted reasons |
| Column | Description |
|---|---|
| Reason Name | Name of the reason (clickable → opens edit form) |
| Description | Additional details about when to use this reason |
| Deleted | Hidden/deleted status |
2. Click + Add New.

4. Optionally enter a Description explaining when to use this reason.
5. Click Save.
Expected Result: The stock out reason is saved.

| Field | Type | Required | Description |
|---|---|---|---|
| Reason Name | Text | ✅ Yes | The reason label (e.g., "Damaged", "Expired", "Sample/Tester") |
| Description | Textarea | No | Detailed explanation of the reason |
Edit:
2. Modify the fields.
3. Click Save.

Delete:
2. The reason is safely deleted and no longer appears in the stock out dropdown.
3. To restore: Filter → Show deleted → Click the reason → Click Restore.

| Reason | When to Use |
|---|---|
| Damaged Goods | Product is physically damaged and unsellable |
| Expired Products | Product has passed its expiry date |
| Sample / Tester | Product is used as a display sample or tester |
| Staff Consumption | Product consumed by staff (e.g., F&B staff meals) |
| Theft / Shrinkage | Stock missing due to suspected theft or unexplained loss |
| Donation | Product donated to charity |
| Return to Supplier | Product returned to the vendor/supplier |
| Transfer Error Correction | Correcting a stock transfer mistake |
Scenario: A cosmetics store needs to track why products are removed from inventory.
Setup:
2. Add reasons one by one:

[!TIP] Create specific, descriptive reasons rather than generic ones. "Damaged — Broken Packaging" is more useful for analysis than just "Damaged". This helps identify patterns (e.g., high breakage rates may indicate shipping issues).
[!IMPORTANT] Stock out reasons are required during stock out transactions. If no reasons are configured, staff cannot complete stock out operations. Always have at least 2-3 reasons set up.
| Role | View | Create | Edit | Delete |
|---|---|---|---|---|
| Admin | Yes | Yes | Yes | Yes |
| Supervisor | Yes | Yes | Yes | No |
| Cashier | No backend access | — | — | — |
[!NOTE] Exact permissions depend on the Privileges Setup configured for each role. Contact your administrator if you cannot access this page.

Click the + Add New button (green button).
Fill in the required fields in the form.

Fill in any optional fields as needed.
Click Save to create the new stock out reason.

✅ Expected Result: The new stock out reason appears in the list and is available for use across the system.

Click on the name or code link (blue text) of the record you want to edit.
The edit form opens with all current values pre-filled. Modify the fields as needed.


✅ Expected Result: The stock out reason is updated and changes take effect immediately.

Click on the name or code link (blue text) of the record you want to delete.
In the edit form, scroll down to the bottom.

✅ Expected Result: The stock out reason is soft-deleted — hidden from active lists and POS but can be restored later.
[!WARNING] Records linked to active transactions or other modules cannot be deleted. The system will display an error if deletion is not allowed.
Q: Can I delete an outlet that has transaction history? A: You can soft-delete it, but it cannot be permanently removed if it has linked transactions or POS terminals.
Q: Why are changes not showing on the POS terminal? A: The POS needs to sync. Check Terminal Status for the last sync time and trigger a manual sync if needed.
Q: What happens if I change the company name? A: The change will appear on all new receipts after the next POS sync. Existing printed receipts are not affected.
| Issue | Possible Cause | Solution |
|---|---|---|
| Cannot save the record | Required fields are empty or invalid | Check all fields marked with * and fill in valid data |
| Record not appearing in POS | POS terminal has not synced yet | Wait for the next sync cycle or manually trigger sync from Terminal Status |
| Cannot delete the record | Record is being used by other modules | Check if the record is linked to active transactions, products, or other settings |
| Changes not taking effect | Browser cache showing old data | Refresh the page (Ctrl+F5) or clear browser cache |
| "Duplicate" error on save | A record with the same name/code already exists | Search the list (including deleted records) for duplicates |
| Page not loading | Session expired or network issue | Log out and log back in. Check your internet connection |
[!NOTE] The following items may vary depending on your system version and configuration:
- Exact permission settings depend on your Privileges Setup configuration
- Sync timing to POS terminals depends on network conditions and sync schedule
- Some features may require additional licensing or module activation
- Field behavior may differ between EQuip versions
If you encounter behavior not described in this manual, contact your system administrator or EQuip support team.