Efficient order management is the backbone of any successful retail operation. When customers place orders whether online, through a POS system, or via third-party apps the speed and accuracy with which you process those orders directly impact customer satisfaction and your bottom line.
For administrators using the shop_admin panel, the "Incoming Orders" section is your command center for new activity. It acts as the gateway where raw order data enters your system before being converted into active sales orders. Understanding how to navigate, process, and troubleshoot these orders is essential for maintaining a smooth workflow.
This guide provides a comprehensive walkthrough of the Incoming Orders interface, helping you optimize your order management process and ensure no sale slips through the cracks.
Understanding the Role of Incoming Orders:
In the Howmuch ecosystem, an "Incoming Order" represents a transaction that has been received but not yet fully processed into the system's core workflow. These are typically orders imported from external sources, such as:
- External POS Systems: Transactions synced from physical store registers.
- Third-Party Marketplaces: Orders originating from integrated platforms.
- Manual Imports: Data entered by staff for specific offline transactions.
Think of this section as a holding area or a staging ground. Before an order becomes a finalized "Sales Order" ready for fulfillment, it lands here. This safeguard allows administrators to review data, fix potential errors (like inventory mismatches or payment discrepancies), and ensure everything is accurate before the order moves downstream.
How to Access Incoming Orders
Navigating to your incoming orders is straightforward. Follow these steps to access the dashboard:
- Log in to your shop_admin panel.
- Navigate to Dashboard > Stores > Store Dashboard.
- In the left sidebar menu, look for the "Orders" section (marked with a grid/list icon).
- Click to expand the menu and select Incoming Orders.
Navigating the Interface
Once you access the section, you will see a detailed table listing all unprocessed transactions. Familiarizing yourself with these columns will help you assess your order status at a glance.
Key Data Points
- Number: The specific order number. This is a clickable link that takes you to the full details of that transaction.
- Order Params: This column contains the raw JSON data of the order. It includes critical financial details such as the item total, tax amounts, and payment attributes. It also tracks timestamps for approval and completion.
- User: Identifies the staff member or system user who created or imported the order.
- Ordering Device ID & Token: These columns are vital for troubleshooting, as they identify the specific hardware source of the order.
- Timestamps: The Created At and Updated At columns help you track when an order arrived and if any recent changes were made.
Pro Tip: The footer of the table provides a quick financial summary, displaying the total unprocessed order amount aggregated by currency. This is a great way to gauge the value of the backlog currently sitting in your queue.
Actionable Steps: Processing and Managing Orders
The real power of this dashboard lies in the actions you can take on individual or multiple orders. Each order row features a dropdown menu with three primary functions: Show, Process, and Fix.
1. Viewing Order Details (Show)
Before processing an order, you may need to verify its contents. Clicking Show (or View) opens a detailed breakdown of the transaction. This view exposes the complete order parameters, user information, and store details.
Crucially, this is where you will find Order Errors. If an order failed to auto-process, this view will tell you why whether it's an invalid product SKU, a customer data mismatch, or a payment gateway timeout.
2. Converting to Sales (Process)
When an order is verified and ready to go, the Process action moves it to the next stage.
- Functionality: This converts the "Incoming Order" data into a complete "Sales Order." It handles payment processing and state transitions.
- Notification: You will see a message stating, "Order has been scheduled for processing."
- Timing: Depending on system load and order complexity, this happens asynchronously.
3. Resolving Issues (Fix)
If an order is stuck due to data errors, the Fix action is your solution.
- Functionality: This command triggers a retry of the validation logic, attempting to resolve known processing errors.
- Use Case: Use this when you have corrected a data issue (like updating stock levels) and need the system to re-evaluate the order.
Boosting Efficiency with Bulk Actions
For high-volume retailers, processing one order at a time is inefficient. The Incoming Orders dashboard supports bulk operations to streamline your workflow.
By selecting the checkboxes next to individual orders (or using the "Select All" box in the header), you can perform mass updates:
- Bulk Process: Convert multiple incoming orders into sales orders simultaneously.
- Bulk Fix: Attempt to resolve errors for a batch of problematic orders.
These bulk actions are processed in the background, allowing you to continue working on other tasks while the system crunches the data.
Advanced Search and Filtering
Finding specific transactions in a sea of data can be challenging. The dashboard offers robust filtering tools to help you drill down to exactly what you need.
Search by ID and Number
If a customer calls with an inquiry, you can use the Order Number search fields.
- Order Number (Contains): Perfect for partial matches if you only have the middle digits.
- Order Number End: Useful if you organize physical receipts by their suffix.
Filter by Date
To analyze performance over a specific period, use the Start Date and End Date pickers.
- Start Date: Shows all orders created from the beginning (00:00:00) of the selected day.
- End Date: Includes all orders up until the very end (23:59:59) of the selected day.
Using these filters allows you to isolate a specific shift, day, or promotional period to review how many orders are still pending processing.
Best Practices for Order Management:
To keep your retail operations running smoothly, consider adopting these administrative habits:
- Daily Monitoring: Check the Incoming Orders tab at the start and end of every shift. A clean queue means revenue is being recognized and inventory is being updated accurately.
- Immediate Error Resolution: Don't let "stuck" orders pile up. If an order has an error, investigate it immediately using the Show view and attempt a Fix. Unresolved errors can lead to inventory discrepancies.
- Leverage Bulk Tools: During peak sales events or holidays, use bulk processing to clear the queue faster.
- Verify Before Processing: If an order looks unusual (e.g., extremely high value or strange customer details), view the details before hitting process to prevent potential fraud.
By mastering the Incoming Orders dashboard, you ensure that your digital supply chain remains efficient, your inventory stays accurate, and your customers receive their purchases without delay.



