# Task Wise Material

<p class="doc-lead">Task Wise Material shows material requirements per project task — required, requested, and received quantities compared to current stock — and lets you create a Material Request for shortages.</p>

<div class="doc-toc">
<p class="doc-toc-title">On this page</p>
<div class="doc-toc-links">
<a href="#/project/reports/task-wise-material?id=overview">Overview</a>
<a href="#/project/reports/task-wise-material?id=use-cases">Use Cases</a>
<a href="#/project/reports/task-wise-material?id=filters">Filters</a>
<a href="#/project/reports/task-wise-material?id=columns">Columns</a>
<a href="#/project/reports/task-wise-material?id=actions">Actions</a>
<a href="#/project/reports/task-wise-material?id=faq">FAQ</a>
</div>
</div>

<hr class="doc-section-divider">

<h2 id="overview">Overview</h2>

Go to <b>Project → Reports → Task Wise Material</b>. Report title: <b>Task Wise Material Report</b>.

<p><b>What it shows.</b> One row per task-material combination with quantities required from the task BOM, quantities already requested and received, shortage, and available stock.</p>

<hr class="doc-section-divider">

<h2 id="use-cases">Use Cases</h2>

<ul>
<li><b>Procurement planning</b> — Filter to Active Tasks on a project and identify items with shortage &gt; 0.</li>
<li><b>Site material check</b> — Before starting a task, confirm stock covers Required Qty.</li>
<li><b>Material request creation</b> — Select rows with shortages and click <b>Create Material Request</b>.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="filters">Filters</h2>

| **Filter** | **Description** |
|------------|-----------------|
| Project | Project to analyse (required). |
| Task status | Active Tasks, All Tasks, Not Started, Ongoing, or Completed. |
| Search item | Free-text search on item name or code. |
| Consolidated | When on, rolls up quantities across tasks (hides Assigned To column). |
| Advanced filter | Item, Task, Category, Item Type (via filter modal). |

<hr class="doc-section-divider">

<h2 id="columns">Columns</h2>

| **Column** | **Description** |
|------------|-----------------|
| (checkbox) | Select rows for Material Request creation. |
| Task # | Task reference number. |
| Task Name | Task name. |
| Status | Task status. |
| Due Date | Task due date. |
| Category | Project category. |
| Assigned To | Employee in charge (hidden when Consolidated is on). |
| Item Code | Inventory item code. |
| Item Name | Item description. |
| Type | Item type. |
| UOM | Unit of measure. |
| Required Qty | Quantity from task materials / BOM. |
| Requested Qty | Quantity on material requests. |
| Received Qty | Quantity received against requests. |
| Shortage | Required minus received (and requested where applicable). |
| Stock | Current available stock. |

<hr class="doc-section-divider">

<h2 id="actions">Actions</h2>

<ul>
<li><b>Generate</b> — run the report.</li>
<li><b>Consolidated</b> — toggle consolidated vs per-task view.</li>
<li><b>Filter</b> — open advanced filter modal.</li>
<li><b>clear</b> — remove advanced filters.</li>
<li><b>Create Material Request</b> — create a <a href="#/inventory/material-request">Material Request</a> for selected rows with shortage (requires inventory permission).</li>
<li><b>Export</b> — download to Excel.</li>
<li><b>Print</b> — print the report.</li>
</ul>

<hr class="doc-section-divider">

<h2 id="faq">FAQ</h2>

<b>Where do Required Qty values come from?</b><br>
From the <b>Materials / BOM</b> lines on each <a href="#/project/project-task">Project Task</a>.

<b>Why is Assigned To hidden?</b><br>
<b>Consolidated</b> mode aggregates the same item across all tasks, so per-task assignee is not shown.

<b>How is Shortage calculated?</b><br>
Required quantity minus received quantity (and quantities already on material requests where applicable). A positive shortage means more stock is needed.

<b>Why is Create Material Request disabled?</b><br>
Select one or more rows with shortage and ensure your user has inventory permission. Rows with zero shortage cannot generate requests.

<b>Does Stock show reserved quantity?</b><br>
Stock reflects current available stock company-wide (or per your inventory setup), not reserved for this project alone.

<b>Why does a task show Required Qty but no material request yet?</b><br>
Material lines on the task are planning only. Raise a <a href="#/inventory/material-request">Material Request</a> from selected shortage rows to start procurement.

<b>Can I filter to one category?</b><br>
Yes. Use the advanced filter modal to filter by Category, Task, Item, or Item Type after selecting the project.

<hr class="doc-section-divider">

<h2 id="related">Related</h2>

<ul>
<li><a href="#/project/project-task">Project Task</a></li>
<li><a href="#/inventory/material-request">Material Request</a></li>
</ul>
