# Pharmacy Disposal Issue — Allow Same Department

## Feature Overview

The **"Allow Disposal Issue to Same Department"** feature enables pharmacy departments to create disposal/waste issue bills where both the source and destination department are the **same pharmacy department**.

By default, this is **disabled** for safety and audit trail clarity. Each department can enable this feature if their workflow requires internal disposal tracking.

## When to Use This Feature

### Enable if your department:
- Manages multiple pharmacy sections and needs to track internal waste transfers
- Has a central disposal/waste management section that needs internal routing
- Requires detailed internal consumption/disposal audit trails
- Needs to balance stock between different pharmacy areas

### Keep Disabled if your department:
- Sends all waste to a centralized disposal department
- Prefers strict separation between internal and external transfers
- Does not need to track internal waste movements
- Wants simplified pharmacy module workflows

## How It Works

### Before Enabling

When staff try to create a disposal issue to their own department, they get an error:

> **Cannot Make an Issue to the Same Department**

And must select a different department (e.g., "Waste Management" or "Disposal").

### After Enabling (Department Preference Enabled)

When staff create a disposal issue, they can now select **their own department** as the destination:

1. Go to **Pharmacy → Disposal Issue**
2. Click **"Select"** and choose your department from the autocomplete
3. The system allows this selection (no error)
4. Proceed to add items and finalize the disposal bill

The bill is created with:
- **From Department:** Your Pharmacy
- **To Department:** Your Pharmacy (same)
- Acts like an internal transfer/consumption record

## Setting Up This Feature

### For Department Administrators

1. Go to **Administration → Department Preferences**
2. Under **Pharmacy Settings**, check: "Allow Disposal Issue to Same Department"
3. Click **Save**
4. Inform your staff that the feature is now enabled

For detailed instructions, see [Department Preferences — Administrator Guide](Department-Scoped-Preferences-Administrator-Guide.md).

### For System Administrators

If you need to enable this feature for multiple departments:

1. Log in to each department's admin account
2. Follow the steps above for each department
3. OR modify the `ConfigOption` table directly:

```sql
INSERT INTO ConfigOption (optionKey, scope, department_id, optionValue, valueType, retired)
VALUES ('Pharmacy - Allow Issue to Same Department', 'DEPARTMENT', <DEPT_ID>, 'true', 'BOOLEAN', false);
```

Where `<DEPT_ID>` is the department's ID in the `DEPARTMENT` table.

## Impact on Other Features

**This preference only affects:**
- Pharmacy disposal issue creation (validation logic)
- Error messages when selecting a destination department

**This preference does NOT affect:**
- Regular pharmacy transfers between departments
- Pharmacy GRN (goods received notes)
- Pharmacy direct purchase
- Any other inventory or billing features

## Examples

### Example 1: Internal Waste Management

**Scenario:** A pharmacy has a "Disposal Section" within the same department.

1. Admin enables "Allow Disposal Issue to Same Department"
2. Pharmacy staff creates a disposal issue:
   - Select medicine/device to dispose
   - Select **"Pharmacy"** as destination (same dept)
   - Add reason/comment: "Expired stock"
   - Finalize the bill
3. Bill shows internal waste movement: Pharmacy → Pharmacy

### Example 2: Centralized Waste Disposal (Disabled)

**Scenario:** Hospital has a separate "Waste Management Department".

1. Admin leaves "Allow Disposal Issue to Same Department" **disabled** (default)
2. Pharmacy staff creates a disposal issue:
   - Select medicine/device
   - Must select **"Waste Management"** (different dept) — cannot select Pharmacy
   - Finalize the bill
3. Bill shows external transfer: Pharmacy → Waste Management

## Troubleshooting

### "Cannot Make an Issue to the Same Department" Error

**Problem:** Staff gets this error even though you thought you enabled the feature.

**Solutions:**
1. **Verify preference is saved:** Go to Department Preferences and confirm the checkbox is checked
2. **Clear cache:** Have the user log out, clear browser cache, and log back in
3. **Verify privilege:** Confirm your user account has **Admin** privilege
4. **Check department:** Ensure you're modifying preferences for the correct department (name shown at top of page)

### Staff Can Select Same Department, But Get Error on Save

**Problem:** The autocomplete allows selection, but clicking "Select" shows an error.

**Possible Cause:** Preference was just enabled, but user's session needs refresh.

**Solution:** User should log out and log back in to refresh their session.

## Related Documentation

- [Department Preferences Overview](Department-Scoped-Preferences.md)
- [Department Preferences — Administrator Guide](Department-Scoped-Preferences-Administrator-Guide.md)
- [Pharmacy Disposal Issue](Pharmacy-Disposal-Issue.md) — Main disposal issue documentation
- [Privileges and Access Control](Privileges-and-Access-Control.md)

---

**Questions or issues?** Contact your system administrator.