Delivery Configuration

The Configuration section controls the foundation of the Delivery add-on: branch settings, service zones, customer delivery pricing, and peak-time surcharges.

Configure this section before using dispatch, provider integrations, driver earnings, or COD settlement.

Delivery Settings

Delivery Settings are branch-specific. They define whether delivery is active for a branch and how basic delivery behavior works.

Main Fields

Field	Purpose
Branch	Branch where this delivery configuration applies.
Currency	Currency used for delivery fees and settlement values.
Active	Enables or disables delivery for the branch.
Auto Dispatch	Allows eligible deliveries to be dispatched automatically.
Own-fleet Retry Policy	Controls retry behavior when own-fleet assignment fails or times out.
Own-fleet Batching	Allows nearby deliveries to be grouped into one driver batch.
Batch Max Deliveries	Maximum deliveries allowed in one own-fleet batch.
Batch Max Radius	Maximum distance used when grouping deliveries into a batch.
Batch Pickup Window	Pickup-time window used to decide if deliveries can be batched together.

Setup Notes

• Create one active delivery setting per branch.
• Make sure the currency matches branch finance and order currency expectations.
• Enable batching only when drivers can realistically handle multi-stop routes.
• Enable auto dispatch only after drivers, zones, and provider settings are tested.

Delivery Zones

Delivery Zones define the geographic service areas for each branch.

Supported Zone Types

Type	Use Case
Radius	Fast setup for circular service areas around a center point.
Polygon	More accurate boundaries using multiple map points.

Where Zones Are Used

• Delivery pricing rules.
• Peak surcharge rules.
• Branch provider zone availability.
• Driver earning rules such as zone_flat.
• Delivery filtering, analytics, and reporting.

Best Practices

• Use clear names such as Downtown, North Area, or Airport Zone.
• Avoid overlapping zones unless your operating model requires it.
• Keep zones branch-specific when branches serve different areas.
• Test customer addresses after creating zones to confirm they resolve correctly.

Pricing Rules

Pricing Rules calculate the delivery fee charged to the customer for a zone.

Main Fields

Field	Meaning
Branch	Branch where the rule applies.
Zone	Delivery zone covered by the rule.
Calculation Method	Standard method is zone flat pricing.
Base Fee	Standard delivery fee for the zone.
Free Delivery Above	Order subtotal threshold where delivery becomes free.
Small Order Threshold	Order subtotal below which a small-order surcharge applies.
Small Order Surcharge	Extra fee applied when the order is below the threshold.
Active	Only active rules are used for calculation.

How Pricing Is Applied

1. The customer address is resolved to a delivery zone.
2. The active pricing rule for the zone is selected.
3. The base fee is calculated.
4. If the order qualifies for free delivery, the base fee can be waived.
5. If the order is below the small-order threshold, the surcharge is added.
6. If a peak surcharge matches, it can be added on top.

Common Setup Examples

Scenario	Setup
Standard city fee	Zone base fee only.
Free delivery for large orders	Set Free Delivery Above.
Protect margin on small orders	Set Small Order Threshold and Small Order Surcharge.
Different areas have different costs	Create separate zones and rules.

Peak Surcharges

Peak Surcharges add an operational fee during busy windows.

Main Fields

Field	Meaning
Branch	Branch where the surcharge applies.
Zone	Optional zone. If empty, the rule can apply branch-wide.
Days of Week	Days when the surcharge can apply.
Start Time / End Time	Time window when the surcharge applies.
Surcharge Type	Fixed amount or percentage.
Value	Amount or percentage value.
Priority	Used when multiple surcharge rules could match.
Active	Only active rules are considered.

Examples

• Add a fixed fee during Friday dinner hours.
• Add a percentage surcharge on weekends.
• Add a zone-specific surcharge for difficult delivery areas.

Troubleshooting

Delivery fee is not calculated

Check:

• Branch delivery settings are active.
• Customer address has enough location data.
• Delivery zone exists and matches the address.
• Active pricing rule exists for the matched zone.
• Currency and fee values are configured.

Wrong zone is selected

Check:

• Zone boundaries are accurate.
• Radius values are not too large.
• Polygon points are saved correctly.
• Customer address latitude/longitude is correct.

Peak surcharge is not applied

Check:

• Rule is active.
• Branch and zone match.
• Current day is selected in days of week.
• Time window matches branch operating timezone.
• Rule priority is correct when more than one surcharge can match.