Skip to main content

​
Overview

The order management system provides comprehensive tools to process customer orders, update delivery and payment statuses, and manage order fulfillment across all sellers on the platform.

​
Order Views

​
All Orders

View every order placed on the platform. Route: /admin/all_orders

​
In-House Orders

Orders for products sold directly by the platform (not through sellers). Route: /admin/inhouse-orders

​
Seller Orders

Orders for products sold by individual sellers. Route: /admin/seller_orders

​
Pickup Point Orders

Orders designated for pickup at specific locations. Route: /admin/orders_by_pickup_point

​
Viewing Order Details

1

Access Orders List

Navigate to the appropriate order view (All Orders, Seller Orders, etc.)Screenshot Description: Order management dashboard showing order list with status filters
2

Filter Orders

Use filters to find specific orders:
  • Payment status (paid, unpaid)
  • Delivery status (pending, processing, shipped, delivered, cancelled)
  • Order code search
3

Open Order Details

Click on an order to view complete detailsRoutes:
  • All orders: /admin/all_orders/{id}/show
  • In-house: /admin/inhouse-orders/{id}/show
  • Seller: /admin/seller_orders/{id}/show

​
Order Information

When viewing an order, you can see:
  • Customer Information: Name, email, phone
  • Shipping Address: Full delivery address
  • Order Items: Products, quantities, prices
  • Payment Details: Method, status, transaction info
  • Delivery Status: Current fulfillment stage
  • Order Timeline: Status change history

​
Managing Order Status

​
Updating Delivery Status

1

Open Order Details

Navigate to the specific order page
2

Select New Delivery Status

Choose from available statuses:
  • Pending
  • Confirmed
  • Processing
  • Picked Up
  • On The Way
  • Delivered
  • Cancelled
Screenshot Description: Delivery status dropdown with all available status options
3

Update Status

Click “Update Status” to save changesRoute: POST /admin/orders/update_delivery_status
4

Customer Notification

Customer receives automated notification about status change
When an order is marked as “Cancelled”, the system automatically:
  • Refunds wallet payments to customer balance
  • Returns product stock quantities
  • Updates all order detail items

​
Updating Payment Status

1

Access Order Payment Section

Open the order and locate the payment status section
2

Change Payment Status

Select new status:
  • Unpaid
  • Paid
Route: POST /admin/orders/update_payment_status
3

Trigger Commission Calculation

When marked as “Paid”, the system automatically calculates:
  • Seller commissions
  • Affiliate commissions (if applicable)
  • Club points (if applicable)

​
Adding Tracking Code

Provide customers with shipment tracking information.
1

Locate Tracking Section

In the order details, find the tracking code field
2

Enter Tracking Code

Input the carrier’s tracking numberRoute: POST /admin/orders/update_tracking_code
3

Save and Notify

Save the tracking code - customer receives notification with tracking details

​
Bulk Order Operations

​
Bulk Status Update

Update multiple orders simultaneously.
1

Select Multiple Orders

Check the boxes next to orders you want to update
2

Choose Bulk Action

Select “Update Status” from the bulk actions dropdownRoute: POST /admin/bulk-order-status
3

Apply Status

Choose the new status and confirm to update all selected orders

​
Bulk Order Delete

1

Select Orders

Check multiple orders for deletion
2

Execute Bulk Delete

Click “Delete Selected”Route: POST /admin/bulk-order-delete
3

Confirm Deletion

Confirm to permanently remove the orders
Use bulk operations to efficiently process multiple orders with the same status update, such as marking multiple orders as “shipped” at once.

​
Delivery Boy Assignment

If the delivery boy addon is activated, assign orders to delivery personnel.
1

View Order Details

Open the order requiring delivery assignment
2

Select Delivery Boy

Choose from available delivery personnel in the customer’s city
3

Assign Order

Click “Assign” to assign the orderRoute: POST /admin/orders/delivery-boy-assign
Delivery boys are filtered by city based on the order’s shipping address to ensure efficient local delivery.

​
Order Deletion

Permanently remove orders from the system. Route: /admin/orders/destroy/{id}
Before deleting orders:
  • Ensure all necessary data has been backed up
  • Verify refunds have been processed (if applicable)
  • Export order data for record-keeping

​
Commission Management

​
Paying Seller Commissions

Process commission payments to sellers.
1

Access Commission Section

Navigate to Commissions from the admin menu
2

Select Seller

Choose the seller to pay
3

Process Payment

Enter payment details and confirmRoute: POST /admin/pay_to_seller

​
Order Notifications

The system sends automatic notifications when:
  • Delivery status changes
  • Payment status is updated
  • Tracking code is added
  • Order is cancelled

​
Notification Channels

  • Email: Sent to customer email address
  • SMS: If OTP system addon is activated
  • Push Notifications: If Firebase is configured
  • In-App: Displayed in customer dashboard

​
Best Practices

  1. Timely Updates: Update order statuses promptly to keep customers informed
  2. Accurate Tracking: Always provide tracking codes when available
  3. Clear Communication: Use the order notes field for internal coordination
  4. Regular Monitoring: Check pending orders daily
  5. Payment Verification: Confirm payment before marking orders as paid

Build docs developers (and LLMs) love

Get started for freeTalk to us