Service Rates
Service Rates define the pricing rules Mative Cloud Fleet Management uses to calculate the cost of an order. Each rate specifies a calculation method, base fee, distance or parcel components, and optional surcharges.
Calculation Methods
| Method | Field Value | Description |
|---|---|---|
| Per Meter | per_meter | A flat rate per unit of distance traveled |
| Fixed Rate | fixed_meter | Banded distance pricing — a flat fee per 1-unit distance band |
| Per Drop-off | per_drop | Tiered by the number of stops on the order |
| Multi-zone Distance | multi_zone_distance | Different per-distance rates per Zone or Service Area |
| Parcel Rate | parcel | Per-parcel pricing — size tiers matched against each parcel's dimensions |
| Algorithm | algo / algorithm | A custom math expression resolved at quote time |
Rate Components
Every service rate can include:
| Component | Description |
|---|---|
| Base Fee | Starting charge before the calculation method is applied |
| Distance Component | Per-unit rates, distance unit (km/mile/meter), maximum distance cap |
| COD Fee | Flat fee or percentage surcharge for cash-on-delivery orders |
| Peak Hours Surcharge | Time-based additional charge during high-demand periods |
| Banded/Tiered Fees | Method-specific pricing tables (per drop, parcel size tiers, etc.) |
| Geographic Rules | Zone or service-area-specific rate overrides |
Rate Scoping Priority
When multiple rates could match an order, Mative Cloud Fleet Management applies the most specific one:
- Zone-scoped — most specific, applies within a sub-zone
- Service area-scoped — applies within a broader geographic area
- Order config-scoped — applies to a specific order type
- Global — least specific, fallback rate
Creating Service Rates
Navigate to Fleet Management → Operations → Service Rates → + New Rate:
- Select the Calculation Method
- Set the Base Fee and currency
- Configure method-specific fields (distance unit, bands, parcel tiers)
- Optionally scope to a Service Area or Zone
- Optionally scope to an Order Configuration
- Save
API Access
Service rates are accessible via the REST API:
GET /v1/service-rates
Filter by service_area, zone, or order_config parameters.