# Adding Fully-Free Items in Direct Purchase (Zero Quantity, Free Quantity Only) ## Overview Suppliers sometimes deliver an item that is **entirely free** — the invoice shows zero payable units and only a free quantity for that item (for example, a promotional item, or a top-up on an existing product line where every unit received this time is free). On the **Pharmacy → Procurement → Direct Purchase** screen, adding such a line means entering a **Quantity of 0** together with a **Free Quantity greater than 0**. By default this is blocked — Direct Purchase requires **Quantity** to be greater than zero for every item line, regardless of Free Quantity. This page explains the application option that lifts that restriction, and when to use it. > This is a different scenario from [Receive Free Items Not on the Purchase Order (GRN)](Receive-Free-Items-Not-on-the-Purchase-Order-(GRN)). That GRN feature adds an extra, unordered *free product* alongside a purchase order. This Direct Purchase option instead allows the item **you already selected** to be entered with zero paid quantity when the whole batch received is free. ## When to Use Enable this option when: - A supplier occasionally sends items with no chargeable quantity, only a free quantity, on a Direct Purchase invoice - You need the item to enter stock with its own batch and expiry, at zero cost, exactly like a normal Direct Purchase line Leave it disabled (the default) if your organisation always expects a positive purchase quantity on every Direct Purchase line — for example, if free units should always be recorded as extra free quantity on top of a paid quantity rather than as a standalone free line. ## Behaviour | Option | Adding an item with Quantity = 0, Free Quantity > 0 | |---|---| | Disabled (default) | Blocked — **"Please enter quantity"** | | Enabled | Allowed — item added with Quantity 0, the entered Free Quantity, and its purchase/retail rates | With the option enabled, the normal "Quantity must be greater than zero" rule is relaxed to "Quantity **or** Free Quantity must be greater than zero" — if you leave both at zero, you still get **"Please enter quantity or free quantity."** Negative quantities are always rejected regardless of this option. Enter a **Purchase Rate** on the line if you know it. If you leave it at 0, the line is still added, with a reminder that its free value will be zero in reports. ![Adding a Paracetamol line with Quantity 0 and Free Quantity 5 after enabling the option](images/13509-03-item-added-qty0-free5.png) The item saves normally — Save Draft / Finalize (or Settle, depending on your [workflow configuration](Pharmacy-DIrect-Purchase)) works exactly as with any other line, and the zero quantity / free quantity are persisted on the bill item. ![Draft saved successfully with the zero-quantity free item included](images/13509-04-draft-saved-success.png) With the option left at its default (disabled), the same entry is rejected until you either enter a paid quantity or ask an administrator to enable the option: ![Quantity 0 / Free Quantity 5 rejected with "Please enter quantity" when the option is disabled](images/13509-05-negative-case-blocked.png) ## Configuration (Admin) The feature is controlled by a single application-wide option, **disabled by default**: | Option Key | Type | Default | |---|---|---| | Allow Adding Direct Purchase Items When Normal Quantity Is Zero And Free Quantity Is Present | Boolean | No | To enable it: 1. Open **Pharmacy → Procurement → Direct Purchase** 2. Click the **Config** button in the page header (visible to users with the **Admin** privilege) — this opens **Page Configuration Management** for the Direct Purchase page 3. Click **Manage Application Configuration** 4. Find **Allow Adding Direct Purchase Items When Normal Quantity Is Zero And Free Quantity Is Present** in the list and click **Edit Configuration Option** 5. Switch the value **On** and click **Save** ![The option listed under Direct Purchase's Page Configuration Management screen](images/13509-01-config-option-listed.png) ![Toggling the option to Enabled in Manage Application Configuration](images/13509-02-config-enabled.png) > **Note:** The option takes effect immediately for the next item you add — no restart or redeploy is needed. Turning it back off does not affect items already added to a bill; it only re-applies the quantity check to items added afterwards. ## Related Features - [Pharmacy Direct Purchase](Pharmacy-DIrect-Purchase) - [Receive Free Items Not on the Purchase Order (GRN)](Receive-Free-Items-Not-on-the-Purchase-Order-(GRN))