Buy Module
Overview
The Buy module is where users manage all purchase orders across selected sites. It provides visibility into order status, vendor details, due dates, and financial totals.
Key Elements
- Site selector to filter data by location
- Purchase order table with sortable and filterable columns
- Status indicators such as Complete, Cancelled, Waiting for Payment, Waiting for Delivery, Overdue
- Total Order Value displayed in selected currency
- Actions for creating, scanning, exporting, and managing purchase orders
How to Use
- Select a site from the Site Dropdown
- Review purchase orders in the table
- Use filters under each column to narrow results
- Click on an Order Number to open full details
- Use the action menu on each row for additional actions
Notes
- Data shown is always scoped to the selected site
- Status labels reflect real-time order progress
Best Practices
- Always confirm the selected site before taking actions
- Use filters instead of scrolling through large datasets
Update Status
Allows users to change the status of a purchase order.
How to Use
- Open the action menu on a purchase order
- Select Update Status
- Review the current and new status
- Click Continue to confirm
WarningStatus updates affect workflow progression and reporting.
Best Practices
- Only update status when the real-world action is completed
Mark as Failed Inspection
Used to flag a purchase order or item as failed during inspection.
How to Use
- Trigger the Mark as Failed Inspection action
- Enter the reason for failure in the input field
- Click Continue to confirm
Notes
- Reason input is required
WarningThis action may impact downstream processes such as inventory or supplier evaluation.
Best Practices
- Provide clear and specific reasons for traceability
Order Arrangement
Users can reorder items within the table using rank input.
How to Use
- Click the reorder control on a row
- Enter a new rank position
- The table updates based on the new order
Notes
- Ranking affects visual arrangement only
Best Practices
- Use ranking for prioritization during review sessions
Filters and Dropdowns
The Buy table includes advanced filtering options for better data control.
Available Filters
- Order Total range
- Issue Date
- Due Date
- Status
- Site
How to Use
- Click any filter field under a column
- Select or input desired values
- Table updates automatically
Site Selection
Filters purchase orders by site.
How to Use
- Click the Site dropdown
- Select a site or choose All
- Data updates based on selection
Add New Site
Allows users to create a new operational site.
How to Use
- Click + Add a new site from the dropdown
- Fill in required fields:
- Site Name
- Legal Name
- Address details
- Primary Currency
- Select enabled functions:
- Sell
- Make
- Buy
- Check
- Fix
- Stocks
- Click Add
Notes
- Site functions determine module accessibility
WarningIncorrect site configuration may limit system functionality.
Best Practices
- Only enable functions relevant to the site's operations
Active Scanner
The Active Scanner allows real-time item scanning using connected barcode devices.
How to Enable
- Toggle Active Scanner on
- Ensure a barcode scanner is connected
Notes
- Scanner must be physically connected before activation
Scan Item
Opens the scanning interface for processing items.
How to Use
- Click Scan Item
- Choose scanner type or device
- Scan the item using the selected device
Scanner Error Handling
Displays when scanner activation fails.
Common Cause
- No barcode scanner device connected
Resolution
- Connect a valid barcode scanner
- Retry activating Active Scanner
WarningScanner features will not function without a connected device.
Active Scanner Setup
Configures the scanner device before use.
How to Use
- Open Active Scanner settings
- Select a device from the dropdown
- Click Save
Notes
- Webcam devices are only usable via Scan Item, not Active Scanner
Camera Scanner
Allows scanning using a camera device such as a webcam.
How to Use
- Open Scan Item
- Switch scanner to camera
- Position barcode within the camera frame
- System detects and processes the item
Item Detected
When an item is successfully recognized.
Behavior
- Item details populate automatically
- User can confirm the action
How to Use
- Verify item details
- Adjust quantity if needed
- Click Confirm
Unassigned Item Detected
Occurs when scanned item is not linked to a purchase order.
How to Use
- Select an item manually
- Assign a purchase order
- Confirm the action
WarningUnassigned items require manual intervention before confirmation.
Barcode Scanner
Supports hardware barcode scanners for faster and more precise input.
How to Use
- Ensure barcode scanner is connected
- Open Scan Item
- Scan the barcode
- System processes automatically
Barcode Item Detected
Recognized barcode linked to a known item.
How to Use
- Review item details
- Adjust quantity if needed
- Click Confirm
Barcode Unassigned Items
Barcode is detected but not linked to a purchase order.
How to Use
- Select item manually
- Assign a purchase order
- Confirm
WarningConfirming without correct assignment may cause tracking errors.
Best Practices
- Always verify item and purchase order before confirming
- Use barcode scanning for high-volume operations to reduce manual errors
Create Purchase Order
This is the main screen where you create and manage a Purchase Order before submitting it.
How to Use
- Review or input order header details
- Add items under the Items table
- Fill in Delivery Details
- (Optional) Add tracking
- Click Create Order when complete
Notes
- Draft status means nothing is finalized yet
- Totals update automatically based on items, tax, and shipping
Add Supplier Details
Used to define or select the supplier for the Purchase Order.
How to Use
- Select an existing supplier or input a new one
- Fill in:
- Contact person
- Phone
- Billing address
- Click Add
Notes
- Incorrect supplier details may result in failed communication or delivery issues
Best Practices
- Use existing supplier records whenever possible to maintain consistency
Add Business Details
Defines internal contact or representative tied to the order.
How to Use
- Select a sales representative or contact
- Fill in:
- Phone
- Billing address
- Click Add
Notes
- This identifies internal ownership of the order
Best Practices
- Assign a responsible person to ensure accountability and follow-through
Add Delivery Details
Specifies where the order will be delivered and any relevant instructions.
How to Use
- Click the edit icon in the Delivery section
- Select a site and address
- Assign a contact person
- Input phone number and delivery instructions
- Click Add
Notes
- Delivery instructions guide logistics and receiving teams
WarningIncorrect delivery details can cause delays or failed deliveries.
Best Practices
- Provide clear and specific instructions for handling and receiving
Add Items to Purchase Orders
Allows users to define the items being purchased, including quantity, cost, and tax.
How to Use
- Click Add Item
- Select an item from the dropdown
- Enter quantity
- Review or input unit cost and tax rate
- Repeat for additional items
Notes
- Totals update automatically based on item entries
WarningIncorrect quantities or pricing will affect inventory and financial records.
Best Practices
- Double-check item selection and pricing before finalizing
Order Summary
Displays a financial breakdown of the purchase order.
Key Elements
- Subtotal
- Tax
- Shipping
- Total
Notes
- Values are calculated automatically
Best Practices
- Review totals before creating the order to ensure consistency
Add Delivery Tracking (Optional)
Allows users to attach a tracking link to monitor delivery progress.
How to Use
- Click Add Tracking above the Delivery Details section
- Input the tracking link
- Click Add
Notes
- Tracking links provide visibility into shipment status
Best Practices
- Always include tracking information when available
Manage Purchase Order
Allows users to manage order status, actions, and workflow progression after creation.
Key Elements
- Order status indicator
- Action dropdown
- Receive Item and Scan Item buttons
- Items table with receiving status
How to Use
- Open a Purchase Order
- Use the Actions dropdown to update status
- Monitor item status in the table
- Proceed with receiving items when delivered
Notes
- Status changes are logged in order history
Best Practices
- Keep status updated to reflect real-world progress
Update Status (from Purchase Order)
Allows users to change the status of a Purchase Order.
How to Use
- Click Actions
- Select a new status
- Review the confirmation modal
- Click Continue
WarningStatus changes impact reporting and workflow progression.
Best Practices
- Only update status after confirming the real-world action is completed
Mark as Failed Inspection (from Purchase Order)
Flags an item or order as failed during inspection.
How to Use
- Trigger Mark as Failed Inspection
- Enter the reason
- Click Continue
Notes
- Reason input is required
WarningThis action may affect inventory and supplier evaluation.
Best Practices
- Provide clear and specific reasons for traceability
Receive Item
Allows users to record items received from a Purchase Order.
How to Use
- Click Receive Item
- Select the item
- Verify purchase order and supplier details
- Enter quantity received
- Click Confirm
Notes
- Receiving updates inventory levels
WarningIncorrect quantities will lead to inventory discrepancies.
Best Practices
- Verify actual received quantity before confirming
Scan Items (Receiving)
Allows users to receive items using barcode or camera scanning.
How to Use
- Click Scan Item
- Select scanner or camera device
- Scan the item barcode
- Verify detected item
- Adjust quantity if needed
- Click Confirm
Notes
- Scanning reduces manual input errors
Best Practices
- Always verify detected item before confirming
Add Delivery Tracking (Post-Creation)
Allows users to add or update tracking information after order creation.
How to Use
- Open a Purchase Order
- Click Add Tracking
- Enter tracking link
- Click Add
Notes
- Update tracking as soon as shipment is dispatched
Related Orders
Displays all orders linked to the current Purchase Order.
Key Elements
- Order ID
- Issue Date
- Due Date
- Status
How to Use
- Navigate to the Related Orders tab
- Use filters to refine results
- Click an order to view details
Notes
- Provides visibility into dependencies across workflows
Best Practices
- Use this view to track linked manufacturing or sales processes
Order History
Tracks all actions performed on the Purchase Order.
Key Elements
- Date and time
- Action owner
- Activity log
How to Use
- Open the Order History tab
- Review changes and actions
Notes
- All updates are recorded for traceability
Best Practices
- Use order history for audits and issue investigation