Skip to main content

Service Quotes

A Service Quote is a price estimate generated for an order based on matching Service Rates. Quotes allow operators and customers to review and accept pricing before a delivery is committed.

How Quotes Are Generated​

When an order is created (or when explicitly requested), Mative Cloud Fleet Management evaluates all active Service Rates and generates quotes for any that match the order's:

  • Origin and destination (service area / zone)
  • Order type (Order Configuration)
  • Payload details (weight, volume, parcel count)
  • COD amount and payment method
  • Scheduled time (for peak-hour surcharges)

Generated quotes include: amount, currency, and expiry time.

Viewing Quotes on an Order​

Active quotes appear in the Order Detail Panel:

FieldDescription
AmountCalculated price
CurrencyQuote currency
Applied RateWhich Service Rate was used
ExpiryTimestamp when this quote expires
AcceptButton to accept and attach the quote to the order

Quote Workflows​

Operator-Managed Flow​

  1. Operator creates an order
  2. Mative Cloud Fleet Management automatically generates quotes
  3. Operator reviews and accepts a quote
  4. Order is dispatched with the accepted quote linked as a transaction

Customer-Facing Flow (API / Storefront)​

  1. Customer submits order details
  2. API returns available quotes
  3. Customer selects preferred service tier
  4. Order is created with the selected quote linked

Generating Quotes via API​

GET /v1/service-quotes

Parameters:

ParameterDescription
payloadPayload object with pickup/dropoff/entities
pickupOrigin location
dropoffDestination
waypointsArray of intermediate stops
service_typeOrder Configuration type
scheduled_atScheduled time (affects peak-hour rates)
codCash-on-delivery amount
currencyRequested currency

Quote Expiry​

Quotes have a configurable expiry time. After expiry, the quote is no longer valid and a new quote must be generated. This prevents stale prices from being applied to orders.

Multiple Quotes​

When multiple Service Rates match an order, multiple quotes are generated — allowing customers or operators to select the preferred service tier (e.g., express vs. standard delivery).

Payment Integration​

Accepted quotes can connect to payment gateways (e.g., Stripe) for online customer charging when configured in Fleet Management → Settings → Payments.