Stores

Reference

A store is one selling location of a merchant. The merchant maintains it; fleets see only its public face — name, address, hours and prices — never its devices, staff, order volume or history.

Overview#

Every store belongs to exactly one merchant. The owning merchant maintains it: Merchant Owner and Merchant Admin add, edit and delete its stores. Platform operators can view every store, and tenant users see a store only when it is one their fleet can buy from. The Stores list and the store detail page serve both sides from the same screens, showing each reader only what their role allows. Opening hours, the map location and photos, and the rules for which stores fleets can see have their own pages, linked below. Switching a store off is described on Active and inactive records.

Fields#

Field	What it holds
Store name	The store's name; required
Merchant	The owning merchant; required. A merchant user never chooses it: the form hides the field and the store is saved to the user's own merchant. Only a staff user who belongs to no merchant picks one
Address, Phone, Email, Contact person	Optional contact details
Location	The store's map location, shown as its formatted address; see Store locations and photos
Storefront photo	An optional uploaded photo, with a fetched Google photo as fallback; see Store locations and photos
Operating hours	Open and close times per weekday; see Store operating hours and open status
Prices confirmed	Whether the merchant has reviewed and confirmed the store's fuel prices; set the first time a real price entry exists for the store
Price zone	The government fuel price zone the store sells in, blank when unknown; see Fuel price zones
External location code	The fuel provider's own code for the station, used to match the provider's transactions and invoices to this store
Staff	The merchant users assigned to the store
Status	Active or Inactive; new stores are always Active

Each store also has a number, shown as # on the list and ID on the detail page. Creating and editing a store is described on Create or edit a store. Every create, edit, deactivation, reactivation and delete is written to the store's audit log. Delete, in the list's Actions column, removes the store from every list; it is not the same as deactivating it.

The Stores list#

Who sees which rows:

Merchant users see their own merchant's stores, inactive ones included. A Merchant Supervisor sees only the stores they are assigned to.
Platform operators see every merchant's stores, inactive ones included.
Tenant users see the active stores their fleet can use — the same set as the store map. See Which stores tenants and drivers can see.

The columns are #, Name, Merchant, Address, Hours, Fuel and Actions, plus Status for merchant users and platform operators. Hours shows whether the store is open now, with Not set when no hours are configured. Fuel lists the government fuel items the store currently sells. A store whose prices are not confirmed shows a No price list badge next to its name for users who can edit stores; on an active store it links to the price review. The page also offers View map, Export Template, Export to Excel, and, for users who can add stores, Import and Add Store. The list shows 20 stores a page.

Filters#

The funnel button opens the filter panel; the page has no search box of its own. Filters can only narrow the stores a user may already see, never widen them.

Filter	Matches	Notes
Name	Name contains the text
Address	Address contains the text
Merchant	Merchant name contains the text	A free-text field, not a list of merchants; hidden for merchant users
Prices confirmed	Any, Yes or No
Fuel	Stores selling any of the chosen fuel items	See Find stores that sell a fuel
Status	All, Active or Inactive; defaults to All	Merchant users and platform operators only
External location code	Code contains the text	Under Advanced filters
Province / city, District / locality	The store location's province or district contains the text	Under Advanced filters; stores without a location never match

When any filter is set, the panel opens on arrival and the funnel shows how many are active. A value the filter cannot read, such as a mistyped link, gives the No results match your filters. state with Clear filters, never the unfiltered list.

Export#

Export to Excel exports the filtered rows with the columns Store Name, Address, Phone, Email, Contact Person, Latitude, Longitude and Status. An export holds at most 5,000 rows; narrow the filters to export the rest.

The store detail page#

The header shows the store's number, its status badge, and its address and phone. Below it, every reader sees whether the store is open now, closing soon, closed, or has no hours configured; a store open all day shows Open now - open 24h. What else the header holds depends on the reader's role:

Reader	Extra header content	Header buttons
Merchant users	Today: the number of orders the store received today; the price readiness signal, Price list confirmed, or Price list needs confirmation with a Review now -> link to the price review for Merchant Owner and Merchant Admin on an active store	Edit (Merchant Owner, Merchant Admin), Audit logs, Back to list
Platform operators	Today: order count	Audit logs, Back to list
Tenant users	None	Back to list

The cards follow in this order:

Card	Content	Who sees it
Store information	ID, store name, merchant, address, phone, email, contact person, location	Everyone
Storefront photo	The uploaded photo, and the Google photo when there is one	Everyone
Operating hours	All seven days, today highlighted first	Everyone
Devices	The store's shared devices, with Generate activation code and Revoke for Merchant Owner and Merchant Admin	Owning merchant and platform operators
Price list	The store's currently effective prices, a warning when no price list is confirmed yet, and, for Merchant Owner and Merchant Admin, Edit prices once prices are confirmed or Review & Confirm Prices on an active store before that	Everyone; the price zone line only for the owning merchant and platform operators
Staff	Each assigned user with an active or inactive badge; hidden when no one is assigned	Owning merchant and platform operators
Recent activity	Store edits, orders at the store and device events, newest first	Owning merchant and platform operators
Notes	Internal notes on the store, added with Add Note; see Add a note to a record	Owning merchant and platform operators

Devices are described on Merchant devices and activation codes, prices on Price lists and Review and confirm a store's fuel prices.

What tenants never see#

A store's devices, assigned staff, today's order count and amount, activity history, notes, audit log and price zone are the merchant's own business information. They are shown only to the store's owning merchant and to platform operators. For a tenant user, today's orders, the devices and the staff are not just hidden on screen: they are never loaded. A merchant user from another merchant cannot open the store at all.

Permissions#

Action	Merchant Owner, Merchant Admin	Merchant Supervisor, Merchant Accountant	Tenant roles	Platform Operator
View list and detail	Yes	Yes (Supervisor: assigned stores in the list)	Visible stores only	Yes
Add, import, edit, delete	Yes	No	No	No
Generate or revoke device codes	Yes	No	No	No
View the store's audit log	Yes	Yes (Supervisor: assigned stores only)	No	Yes

Edge cases#

Inactive store. Its maintainers can still open, edit and reactivate it; tenant users get a not-found page. The price review links and the activation code form are hidden on it. What deactivation changes for fleets, orders and prices is on Active and inactive records.
Merchant Supervisor. The list shows only assigned stores, but the detail page of any store of their merchant opens from a direct link.
Tampered merchant. A merchant user who sends another merchant in the form still saves the store to their own merchant.