Merchant sitemap guide

24 merchant screens · 17 built · 7 planned. Each step has a SIPOC — who supplies it, what it needs, what it does, what it produces, and who uses the result — and suppliers and customers are links, so you can follow a whole workflow by clicking.

Workflows

Start here. Each chain is one seller journey, in order — click a step to see what it does and who it hands off to.

Get set up to sellGo from applying to having an approved, presentable storefront.

Activation / onboarding wizard

→Storefront profile

→Licenses & attestations

→Storefront configuration

List a productGet a product through approval and in front of shoppers.

Product create / edit

→Product documentation upload

→Product list (own catalog)

→Bulk product upload

Offer a serviceDefine a bookable service and open real capacity for it.

Service definitions

→Practitioner management

→Intake-field configuration

→Availability & blackout editor

Keep stock rightStay accurate so nothing oversells and nothing runs out unnoticed.

Inventory management

→Low-stock view / alerts

Fulfil an orderTurn a paid order into a delivered parcel.

Suborder management

→Fulfillment / shipment workflow

Deliver an appointmentRun the booked work and record what happened.

Booking calendar

→Assigned bookings / intake view

→Booking reminders

Handle problemsDeal with returns, complaints and feedback.

Return decision queue

→Delivery issue response

→Review response

Get paid and stay informedSee what was earned and what still needs attention.

Commission expectation

→Notification prefs & feed

All screens

“How it works” opens the SIPOC; the screen name opens the live page or its placeholder.

Onboarding & storefront

Activation / onboarding wizardPlannedHow it works →

Build & submit activation record; respond to Additional-Information-Required (mirrors the 10-state machine).

Storefront profilePlannedHow it works →

Edit Marketplace-only fields; Commerce-owned fields read-only.

Storefront configurationPlannedHow it works →

Standardized storefront, slug, featured products - no custom HTML/theme.

Catalog

Product list (own catalog)BuiltHow it works →

Own products with Active/Inactive listing-status toggle.

Product create / editBuiltHow it works →

Product + variant fields, images, category-driven required fields; material edits return to review.

Product documentation uploadPlannedHow it works →

Upload/version COAs, safety, licences with type/expiry.

Bulk product uploadPlannedHow it works →

Structured file upload with row-level validation results.

Services

Service definitionsBuiltHow it works →

Define/manage services and submit for approval.

Practitioner managementBuiltHow it works →

Practitioners, qualifications, credential docs w/ expiry, service assignments.

Availability & blackout editorBuiltHow it works →

Recurring windows + blackouts; conflict warnings over existing bookings.

Intake-field configurationBuiltHow it works →

Typed intake fields from a closed catalog; edits return the service to review.

Booking calendarBuiltHow it works →

View bookings, reassign practitioner, reschedule, mark Completed/NoShow.

Inventory, orders & fulfillment

Inventory managementBuiltHow it works →

Set/adjust on-hand with reason + history; guarded against below-reserved.

Low-stock view / alertsBuiltHow it works →

Low-stock threshold config and in-app view; alert delivery pending D-38.

Suborder managementBuiltHow it works →

Own suborders - accept, process, mark ready; acceptance-window flags.

Fulfillment / shipment workflowBuiltHow it works →

Create shipments/packages, generate labels, partial shipment, recall-blocked lines.

Returns, delivery issues, reviews & commission

Return decision queueBuiltHow it works →

Approve/deny returns; mark received + restock decision.

Delivery issue responsePlannedHow it works →

Respond to delivery issues with a reason-coded resolution + evidence; Jira hidden. Named "delivery issues", not "disputes" or "cases" — card disputes are a BlackOak Commerce portal screen and a different object entirely.

Review responseBuiltHow it works →

One public response per review.

Licenses & attestationsPlannedHow it works →

Upload product licenses, credentials and attestations; receive renewal reminders. Distinct from "Compliance standing" in the Commerce portal (VAMP / ECM / Nacha network thresholds) — same word there, unrelated object.

Commission expectationBuiltHow it works →

Expected marketplace commission and net proceeds per suborder, from Commerce references — never settled funds. Settlement, payouts and reserve live in the BlackOak Commerce portal (its Settlements screen), which this screen links to for the authoritative figures.

Notification prefs & feedBuiltHow it works →

Per-alert preferences/channels (org; per-user pending D-05 identities) and in-app feed.

Practitioner (folded in)

Assigned bookings / intake viewBuiltHow it works →

A practitioner-scoped view of their assigned bookings and intake responses (readable only by the assigned practitioner, MKT-SVC-028).

Booking remindersBuiltHow it works →

Practitioner booking confirmations and reminders (MKT-SVC-022) — primarily a notification channel; a screen here surfaces their delivery/preferences.

Outside the apps

Participants in these workflows that are not screens in any of the three apps. Each explains where the ownership boundary sits.

Marketplace servicesOutside the apps

The Marketplace back-end: catalog, inventory, orders, fulfilment, returns, reviews and the rules that decide what may be listed and sold.

BlackOak CommerceOutside the apps

The financial platform: funds the shopper’s order, allocates each merchant’s share, and executes refunds.

Shared Services messagingOutside the apps

Sends SMS and email on behalf of every BlackOak product.

Shipping carrierOutside the apps

Produces labels and tracking scans that move a parcel to the shopper, and carries returns back.