Markets & zones

RapidMart is organised as markets → zones → stores:

• A market is a country (or region) with its own currency, timezone, languages, phone format, tax label and rider pay.
• A zone is an area you deliver to inside a market, drawn on a map. Stores belong to a zone; customers see the stores whose zone covers their address.
• One market is the default: it’s used when RapidMart can’t tell which market applies.

The installer creates one market. Edit it before adding stores, and add more markets only if you operate in several countries.

Set up your market

1. Admin → Markets → Market List → click your market.
2. Market: the name (what you’ll see in reports), a short Code and the two-letter Country code. Pick the Timezone — opening hours, reports and scheduled orders use it.
3. Currency: the ISO code (for example AED, PKR, USD), the Symbol and whether it goes before or after the amount, Decimals, and the separators. The Preview shows how 1234.5 will look.
4. Languages & region: the Languages offered in this market and the Default language (add languages first on the Languages page). Set the Phone prefix (like +971) and Phone digits after prefix, the Distance unit, and the Maps region bias (helps address search find local results first).
5. Rounding & precision: leave these on the platform setting unless your currency needs cash rounding (for example to the nearest 0.25) — then set the Cash rounding step.
6. Rider pay: the Base pay per delivery, Pay per km and the most Cash a rider may carry from cash-on-delivery orders.
7. Parcel delivery (optional): let customers in this market book parcels, with a minimum fare.
8. Save market.

Caution

Change the currency only before you have orders. Existing orders, balances and reports keep the currency they were made in.

Zones

1. Admin → Zones → Zone List → Add zone.
2. Zone details: choose the Market, a Name (for example Downtown), the City and the Country code. Keep Active on.
3. Delivery area: draw the zone on the map — click to add points around the area, and click the first point to close the shape. Use Find a place to jump to your city. You can also paste a GeoJSON polygon or a list of coordinates.
4. Save zone.

Repeat for each area. Zones in the same market may touch but shouldn’t overlap. A store’s location decides its zone; a customer’s address must fall inside a zone to order.

Several countries

Add a market per country (Markets → Market List → Add market), then its zones.

Start from a country at the top of Add market fills in everything for one of 241 countries: currency, symbol and number format, timezone, languages (those you have enabled), phone prefix and length, distance unit, and the standard sales tax (VAT, GST…) with whether prices include it. Check the fields, especially the tax rate, before you save; the tax can be changed later on the Tax page.

Each store inherits its market from its zone, so prices, fees and payouts stay in that market’s currency. Exchange rates between currencies are set in Settings → Currency & exchange rates.