Install the Module

Go to Settings → Apps. Search for WT POS Delivery Driver and click Install. The only required dependency is point_of_sale which is already installed with Odoo POS. Wait for the install to complete, then refresh the page. You will see a new Delivery menu under Point of Sale.

Create Your First Driver

Go to Point of Sale → Delivery → Drivers. Click New and fill in:

• Full Name — The driver's name shown in the POS picker and on the receipt
• Phone Number — Printed on the receipt under Delivery Details
• Vehicle Type — Motorcycle, Car, Van, Bicycle or Other
• Vehicle Number / Plate — Plate number printed on the receipt
• Assigned POS Terminals — Select which POS terminals this driver appears in

Save the driver. You can create as many drivers as you need.

Configure Your POS Terminal

Go to Point of Sale → Configuration → Settings. Select your POS terminal and scroll down to the Delivery Driver section.

• Click Assign All Active Drivers to add all your drivers in one click
• Enable Require Driver for Delivery Orders (recommended — it's on by default)
• Optionally set a Delivery Fee Product — see Level 4 for full setup details

Click Save. Your POS terminal is now ready for delivery orders.

Complete Your First Delivery Order

Open a POS session and follow this sequence:

1. Add a product to the order as normal
2. Tap the Delivery button (motorcycle icon) in the control bar — it turns blue
3. Go to the payment screen — a Select Driver button appears
4. Tap it, choose a driver from the popup — the button turns green
5. Select the payment method and tap Validate
6. The receipt shows a Delivery Details section at the bottom ✓

Your first delivery order is done. The driver's order count and total sales update automatically.

The Delivery Button — How It Works

On the POS Product Screen, the Delivery button (motorcycle icon) sits in the control button bar on the right side.

• Grey button = standard dine-in / pickup order
• Blue button = delivery order active — fee line added automatically
• Tap once to enable delivery — fee line appears in the order
• Tap again to disable delivery — fee line removed, assigned driver cleared

Tip: If the Delivery button is not visible, no drivers are assigned to this POS terminal yet. Go to POS Settings to assign drivers.

Full Delivery Order Flow — Step by Step

Follow this exact sequence for every delivery order:

1. Add the customer's products to the order as normal.
2. Tap Delivery → button turns blue → delivery fee line appears automatically.
3. Adjust the fee line quantity or price if needed (it's a regular order line).
4. Tap Payment to go to the payment screen.
5. Tap Select Driver (or driver name if already selected) → popup opens → tap the driver.
6. The driver button turns green with their name and a checkmark.
7. Select payment method → tap Validate.
8. Receipt prints with Delivery Details section showing rider name, phone, vehicle and plate.

Changing or Clearing the Driver

On the payment screen, you can tap the driver button at any time to re-open the popup. The popup remembers your current selection as pre-highlighted. To clear the driver without disabling delivery, open the popup and tap Clear (if available), or simply tap another driver. To remove the driver entirely and cancel delivery mode, go back to the product screen and tap the Delivery button again — this clears the driver and the fee line together.

What Happens If No Driver Is Selected

If Require Driver for Delivery Orders is enabled (default ON) and the cashier tries to validate a delivery order without selecting a driver, a dialog appears: “This is a delivery order. Please select a delivery driver before completing the payment.” The cashier must dismiss the dialog and select a driver before the order can be completed. This prevents delivery orders from being finalised without driver accountability. To allow orders without a driver, disable this setting in POS Configuration.

View Driver Statistics

Go to Point of Sale → Delivery → Drivers. The list view shows each driver with their order count and total sales at a glance. Click on any driver to open their form. Two stat buttons at the top show:

• Orders (shopping cart) — total count of paid orders assigned to this driver. Click to see the filtered order list.
• Total Sales (money) — sum of all paid order amounts for this driver.

These values update automatically when orders are paid. No manual calculation needed.

Print the Driver PDF Report

Open any driver's form view and click the Print button (or Action → Print) to generate a professional PDF report. The report includes the driver's full profile (name, phone, vehicle, plate), a stats summary box with order count and total sales, and a table of their last 20 paid orders with order reference, date and amount. Use this report for driver performance reviews, payout calculations or record keeping.

Archive Inactive Drivers

When a driver is on leave, resigned, or no longer active, open their record and toggle the Active switch to off (or use Action → Archive). Archived drivers immediately disappear from the POS driver selector — cashiers cannot accidentally assign them to new orders. Their full history (orders, amounts) is preserved and the red Archived ribbon appears on their form. Use the Archived filter in the driver list to find and restore them at any time.

Use Filters and Grouping

In the driver list, use the Search bar to find drivers quickly:

• Filter: Active / Archived — show only active or archived drivers
• Filter: Motorcycle / Car / Van / Bicycle — filter by vehicle type
• Filter: Has Orders — show only drivers who have completed at least one order
• Group by: Vehicle Type — group the list by motorcycle / car / van / bicycle
• Group by: Status — separate active and archived drivers

Set Up the Delivery Fee Product

Go to Point of Sale → Products → New:

• Set the Product Type to Service for clean accounting
• Set the Sales Price to your standard delivery fee (e.g. 5.00)
• Enable Can be Sold and Available in POS
• Save the product

Then go to POS Settings → Delivery Orders → Delivery Fee Product and select it.

From now on, every time a cashier taps Delivery, this fee line is added at the configured price automatically. The cashier can still manually edit the fee amount on the line if a different charge applies.

Manage Multiple POS Terminals

Each POS terminal has its own independent driver pool. This is useful when you have multiple locations or counters:

• Main Counter — drivers assigned only to the main counter appear only there
• Drive-Through — can have its own separate pool of drivers
• A driver can appear in multiple terminals simultaneously by assigning them to all relevant terminals

To configure: go to each POS terminal's settings page, scroll to Delivery Driver and add the specific drivers for that terminal. Or use the driver form view — the Assigned POS Terminals field lets you manage all assignments from one place.

All POS Settings Explained

In POS Configuration → Settings → Delivery Driver:

• Delivery Drivers — the pool of drivers available in this terminal's selector popup. Only these drivers appear in the POS.
• Assign All Active Drivers — one-click button that adds every active driver in the system to this terminal. Convenient for initial setup.
• Require Driver for Delivery Orders (default ON) — when ON, payment cannot be validated on a delivery order without a driver selected. When OFF, validation proceeds without checking.
• Delivery Fee Product — the product that is auto-added as a line when delivery mode is toggled ON. Leave blank for no automatic fee.

Delivery Button Not Showing in POS

The Delivery button only appears when at least one active driver is assigned to the current POS terminal.

• Open the POS terminal form and scroll down to the Delivery Drivers section — confirm at least one driver is listed
• If the list is empty, click Auto-assign All Active Drivers
• If drivers are listed but the button still doesn't appear, go to Point of Sale → Delivery → Drivers and check they are not archived
• Close and reopen the POS session after any changes to the terminal settings

Fee Line Not Added When Toggling Delivery

Check the following:

• Open the POS terminal form, scroll to Delivery Drivers and confirm a product is selected in the Delivery Fee Product field
• The product must have Available in POS ticked on its product form
• The product must have Can be Sold ticked
• If you recently changed the fee product, close and reopen the POS session to reload the settings
• If no fee product is configured, delivery mode still works but no fee line is added — this is by design

Best Practices for Running Deliveries

• Create one driver record per person — do not share a single driver record between multiple riders. Order counts and totals are tracked per driver record.
• Archive, never delete — when a driver leaves, archive them instead of deleting. Their full order history is preserved and their stats remain visible for reporting.
• Use the PDF report for payouts — open a driver form and click Print to get a clean summary of their orders and totals for the period. Use this for weekly or monthly payout calculations.
• Keep the fee product price updated — the fee line uses the product's current sales price. If your delivery fee changes, update the product price. Cashiers can also manually edit the fee line on any individual order.
• Multi-terminal tip — assign different driver pools per terminal when you have multiple counters or locations. Drivers only appear in the terminals they are assigned to.