Requisitions — SanadiqCloud
Product version: 1.0.0+1
Last updated: 2026-08-13
Audience: Tenant Owners, Tenant Employees, Regular Users
A. What are Requisitions?
A Requisition is an inbound replenishment request for a stock pool — typically to bring catalog SKUs into inventory from a supplier. It is not an internal consumption ticket (use Adjustments type issue, or Pick Lists to collect within a pool).
Typical uses:
- Reorder — Bring more of an existing SKU into the pool (including automatic reorder when configured)
- Supplier inbound — Optional supplier on the header
- Expected stock — On approve,
quantity_incomingincreases; on accept, a receipt posts and incoming is reduced
On-hand changes only at accept — as a receipt (stock in), not an issue.
B. Viewing the Requisition List
Navigate to Inventory > Requisitions. The list shows:
| Column | Description |
|---|---|
| ID | Requisition business identifier |
| Inventory | Inventory being requested from |
| Status | Current status (draft, awaiting_approval, approved, processing, accepted, rejected, cancelled) |
| Items | Number of line items |
| Total Qty | Total quantity requested |
| Supplier | Supplier (if specified) |
| Created By | Requester name |
| Created | Date created |
Filter by Inventory or Status to narrow results.
C. Creating a Requisition
- Click + Create Requisition from the list, or item Operations → Create requisition (pool + item locked; you still set quantity).
- Fill in the fields:
| Field | Required | Description |
|---|---|---|
| Inventory | Yes | The inventory to request stock from |
| Supplier | No | Link to a specific supplier (optional) |
| Notes | No | Free-text notes about the requisition |
- Add line items:
| Field | Description |
|---|---|
| Item | Select an inventory item from the chosen inventory |
| Requested Quantity | Quantity requested (must be ≥ 1) |
| Notes | Per-line notes (optional) |
- Click Save.
The requisition is created in draft status. You can continue editing until you submit it.
D. Editing a Requisition
Draft Requisitions
While in draft status, you can freely edit:
- Open the requisition detail view.
- Click Edit.
- Modify the notes, supplier, or line items (add, remove, or change quantities).
- Click Save Changes.
Line items are replaced entirely on each edit — provide the complete updated list.
Submitted Requisitions
Once a requisition moves beyond draft, editing is restricted. You can still add notes, but line items and quantities cannot be changed.
E. Requisition Lifecycle
The full lifecycle of a requisition:
Draft → Awaiting Approval → Approved → Processing → Accepted
→ Rejected
→ Cancelled (at any point before acceptance)
Step 1: Draft
The initial state after creation. The requisition can be edited freely. No one else can act on it yet.
Step 2: Submit (→ Awaiting Approval)
- Open the draft requisition.
- Click Submit.
- Confirm.
The status changes to awaiting_approval. The requisition is now visible to managers and cannot be edited.
Step 3: Approve
- Open the requisition.
- Click Approve.
- Confirm.
The status changes to approved. The approved_by and approved_at fields are set. Each line’s inventory item incoming quantity increases by the requested qty.
Only users with inventory:requisition:update permission can approve requisitions.
Step 4: Reject
- Open the requisition.
- Click Reject.
- Optionally add a rejection reason.
The status changes to rejected. Stock is not affected.
Step 5: Process (→ Processing)
- Open the approved requisition.
- Click Start Processing.
- Confirm.
The status changes to processing. This indicates that warehouse staff are gathering the requested items.
Step 6: Accept (→ Accepted)
- Open the processing requisition.
- Click Accept.
- Confirm.
On acceptance:
- The status changes to
accepted - The
accepted_byandaccepted_atfields are set - On-hand increases — a
receipttransaction is written per line (reference_type=requisition) - Incoming quantity is reduced by the received amount
- The requisition is fulfilled
This is the only point where on-hand changes. Processing itself does not move stock.
Cancelling
Any user with access can cancel a requisition at any point before acceptance:
- Open the requisition.
- Click Cancel.
- Confirm.
The status changes to cancelled. No stock changes occur.
F. Fulfillment Process Walkthrough
Typical end-to-end flow:
- Staff member creates a requisition in
draft. - Staff member submits it →
awaiting_approval. - Manager reviews and approves it →
approved. - Warehouse staff starts processing inbound receiving →
processing. - Warehouse staff starts processing then accepts inbound stock →
accepted. - Receipt transactions are logged; on-hand increases.
Notifications may be sent at each stage depending on your tenant configuration (see Notifications).
G. Requisition vs Transfer
| Aspect | Requisition | Transfer |
|---|---|---|
| Purpose | Inbound replenishment into one pool | Inter-pool stock movement |
| Direction | One-way (supplier / inbound → pool) | Two-way (source pool → destination pool) |
| Stock Effect | Incoming on approve; receipt on accept | Deducted on ship, added on receive |
| Workflow | Draft → Approve → Process → Accept | Pending → Approve → Ship → Receive |
| Use Case | Reorder / supplier inbound | Moving stock between facilities |
Next: Stock & Inventory — Managing stock groups
See also: Transfers | Suppliers | Stock Items