Before installing this module, please ensure the following dependency modules are installed:

• Download Shipping Methods Base module here

Then install the Lalamove Integration module:

The module includes a comprehensive, interactive dashboard that provides a complete view of your delivery operations. Access it by navigating to: Delivery → Dashboard.

The dashboard features three distinct viewing modes, selectable from the top-left dropdown:

1. Delivery Analytics

This is the default view, providing an overview of all your delivery orders across all carriers.

• Status Overview Cards: Color-coded KPI cards showing order counts by status (Draft, Confirmed, In Transit, Delivered, Cancelled, Failed, etc.), each card is clickable to drill down into filtered order lists.
• Carrier Breakdown Table: A detailed table listing each carrier with total orders, average and total shipping costs, paid/unpaid amounts, COD (Cash on Delivery) orders and amounts, and delivery success rate.
• Status Distribution Chart: A doughnut chart visualizing the proportion of orders in each delivery status.
• Order Trends Chart: A line chart showing daily order volumes over the selected period to identify trends and peak times.
• Cost Comparison Chart: A bar chart comparing estimated shipping costs versus actual costs by carrier, helping you identify cost discrepancies.

2. Webhook Monitoring

This view focuses on the health and performance of your webhook integrations.

• Webhook KPI Cards: Six cards showing total webhooks received, successful, errors, ignored, success rate percentage, and average response time in milliseconds.
• Webhook Volume Chart: A line chart tracking daily webhook traffic over time.
• Status Distribution Chart: A doughnut chart showing the ratio of success, error, and ignored webhooks.
• Response Time by Carrier: A horizontal bar chart comparing average webhook processing times across different carriers.
• Webhook by Carrier Table: Detailed breakdown of webhook statistics per carrier, including total, success, error counts, average response time, and success rate.
• Recent Webhook Errors: A list of the latest webhook failures with carrier type, tracking reference, error message, and processing time for quick troubleshooting.

3. Performance Analytics

This view helps you evaluate and compare carrier performance to make data-driven decisions.

• Carrier Scorecard: A comprehensive ranking table scoring each carrier on four dimensions - Success Rate, Speed, Cost Efficiency, and Reliability - with a weighted final score. Top carriers are highlighted with trophy badges.
• Carrier Comparison Radar Chart: A radar/spider chart visually comparing carrier scores across all four performance dimensions for easy side-by-side comparison.
• Cost Efficiency Table: Detailed cost analysis per carrier including total orders, delivered/failed counts, average cost per shipment, true cost per successful delivery, cost overrun percentage, and success rate.
• Delivery Speed & SLA Table: Speed metrics per carrier including average, median, fastest, and slowest delivery times, plus SLA 48-hour compliance percentage.
• Failure Trend Chart: A weekly line chart tracking failure counts over time to identify patterns.
• Failure Reasons: A breakdown of failure reasons per carrier with progress bars showing the proportion of each failure type.
• Geographic Performance Table: Province-level delivery performance data showing total orders, delivered/failed counts, average cost, and success rate per carrier and region.

- In this section, we will proceed to set the parameters and connect to Lalamove Server to get the access token. This access token will help authenticate API connections with the Lalamove Server.

Step 1: Go to Lalamove portal

Step 2: Copy: API Key and API Secret

Step 3: Go to: Inventory/Configuration/Delivery/Shipping Methods/Lalamove/Integrated Configuration Tab

Step 4: Paste: API Key and API Secret

Step 5: Configure default parameters for delivery orders

- Weight Unit: The unit of measure for your shipment. You don't need to change it because Lalamove's rules are Kilograms

- Regional: The country in which you are using the service.

- Vehicle Type: The service type you want to use

- Service Type: The service type you want to use

- Coordinates Use: If you enable this option, all requests (Get Quote and Create Order) add the coordinates of the recipient and sender.

Step 6: Configure webhook to track orders called from Lalamove system through 2 ways

- Way 1: Register with 1 click from Odoo system

- Activate "Authentication Use". Then click the button to get the access token code. If you do not want to use protection for your Odoo system. You can skip this step.

- Click on button to register your webhook with Lalamove

- Way 2: Configuration on Lalamove portal

- Go to Lalamove portal

- Copy your webhook url on Odoo and paste to Webhook URL

Step 7: When there is an endpoint change from Lalamove's system, rest assured, that it won't take you much time to edit it.

- Navigate Routes Tab, Here you can edit basic information for your restful API such as methods, headers, path, etc,

Finally, Congrats, you have successfully configured the necessary components to connect to the Lalamove system.

Step 1: Go to: Contacts/Create

This information is required

• Name: The name of customer
• Street: The street name
• State: The province name
• Country: The country name
• Phone: The number phone

Finally, Congrats, you've created your first customer.

- After creating your first customer. In this section, we will estimate the shipping costs for your sales order.

Step 1: Go to: Sales, Create a new sale order

Step 2: Click on button to open pop up Add a shipping method

Step 3: Choose Shipping Method, Service Type, Vehicle Type

Step 4: Click on button to get estimated cost from Lalamove carrier

Step 5: Click on button to confirm add cost to the sale order

Finally, You have successfully estimated the shipping costs for your sales order

- Once the cost has been estimated and confirmed by your customer. We will proceed to create a delivery order with the Lalamove carrier.

Step 1: Go to: Inventory/Delivery Orders/Choose Delivery Order/Additional Info Tab

Step 2: Choose information of delivery order

Step 3: Click on button .The system will validate the picking and automatically book the order

Finally, Congrats, You have successfully booked the shipping for your sales order.

Click on button to cancel the delivery order.

Click on button You can directly track your order in real time

The Carrier Reference Orders screen provides a centralized view to manage and monitor all delivery orders across carriers. Each record is automatically created when a delivery is booked and continuously updated via webhook notifications.

Step 1: Navigate to: Delivery → Operations → Delivery Orders.

Each carrier reference order contains the following information:

• Tracking Reference: The unique bill code assigned by the carrier
• Carrier & Service: The shipping carrier and service type used
• Delivery Status: Real-time status from the carrier (via webhook)
• Mapped Status: Standardized status for cross-carrier comparison
• COD Amount: Cash on delivery amount to be collected
• Estimated vs Actual Cost: Compare quoted shipping cost with actual carrier charges
• Driver Information: Name, phone number, and license plate of the delivery driver
• Purchase Order & Payment Status: Linked PO with invoice and payment tracking

Step 2: Use the powerful search and filter options to manage your orders:

• Filter by carrier, delivery status, payment status
• Group by carrier, mapped status, payment status, or date
• Search by tracking reference, sale order, or carrier name

This feature allows you to create Purchase Orders (POs) from your delivery records, enabling proper accounting and reconciliation of carrier shipping fees within Odoo's purchase workflow.

Step 1: Navigate to: Delivery → Operations → Delivery Orders.

This view lists all carrier reference orders with their tracking references, delivery statuses, estimated and actual shipping costs, and payment status.

Step 2: Select the carrier reference orders you want to create a Purchase Order for. You can select multiple records at once using the checkboxes.

Step 3: From the Action menu, click [Create / Merge PO].

The system will:

• Group selected orders by their shipping carrier
• Create one Purchase Order per carrier (or merge into an existing draft PO)
• Add a line item for each delivery order with the actual shipping cost as the unit price
• Link each carrier reference order to its corresponding Purchase Order
• Log a chatter message on each record confirming the PO creation

Step 4: After creation, the system will redirect you to the generated Purchase Order(s). You can then:

• Review and confirm the PO
• Create vendor bills for payment processing
• Track the payment status directly from the carrier reference order list

The carrier reference order list view displays payment-related fields including:

• Purchase Order: Link to the associated PO
• Invoice Status: Shows if the PO has been invoiced
• Payment Status: Tracks whether the carrier fee has been paid (Not Paid, In Payment, Paid, Partially Paid)

Done! You have successfully created Purchase Orders to manage and reconcile your carrier shipping fees.