Tour Operator & Booking Types — for Hilda to verify
One-pager to align on tour types and operator tracking before we build out the admin tooling.
The supplier on Bokun is the company that actually runs the tour. Bokun is their system of record. We resell as an OTA. Bokun knows the commission split and handles payouts to the operator.
Examples:
- Asakusa Highlights: Street Food Crawl Tour — operated by Shinobi Travel
- Five Must-try Japanese Cultural Experiences Combo in Tokyo
- Goshin Budo Experience Lesson Derived from Aiki Jujutsu
- 20% OFF: Japan Mobile WiFi — operated by Vision Inc.
The supplier on Bokun is a reseller (e.g. BOJ), not the company running the tour on the ground. We still book through Bokun marketplace terms, but we need to track who the actual operator is via the vendor system.
Examples:
- Private Tea Ceremony in Kyoto's Garden Teahouse — Bokun supplier: BOJ, actual operator: TBD
- Private Sightseeing Tour from Shimizu Port — Bokun supplier: Local Travel Partners, actual operator: TBD
Today we can't always tell 1a from 1b automatically — it requires human knowledge about whether a Bokun supplier is the real operator or a reseller. The vendor system is how we'll track this distinction over time.
Combined: ~603 published, ~335 unpublished
The operator does not use Bokun — they use a different system (Rezio, their own operations, etc). We list the experience on Bokun on their behalf so we can use Bokun's booking infrastructure. Bokun doesn't know about the commercial relationship, so we handle everything: collecting payment from the customer, paying the operator, and tracking commission ourselves.
This group breaks into two sub-categories:
Hato Bus tours (5 total, 2 published) — commission already set at 15%:
- Mt. Fuji & Arakura Sengen Shrine Day Tour from Tokyo
- Tokyo Premium Night Drive (manual booking)
- Dynamic Tokyo Full Day Bus Tour (unpublished)
- Panoramic Tokyo Full Day Bus Tour (unpublished)
- Tokyo Morning Half Day Bus Tour (unpublished)
REZIO/HIS-bridged tours (~69 total, 28 published) — commission not yet set:
- Arashiyama Yakata-bune Sightseeing Cruise with Meal
- Kyoto Full-Day Walking Tour Starting at Kyoto Station
- Manga School - Mini Course
- Miko (Shrine-Maiden) Experience at Takenobu Inari Shrine
- Feel Mt.Fuji and Sake tasting 1 Day Private Tour
These show up on Bokun under our company name (Takanawa Travel ehf.) with a REZIO - HIS - prefix in the Bokun experience name. Setting commission_percent on these is an ongoing effort.
Tours booked through the Linktivity API. We pre-deposit funds with Linktivity. When a customer books, Linktivity draws down from our balance — this covers the full cost including their sub-vendor (operator) costs. We keep a commission on each booking (commission_amount). We don't pay operators separately — Linktivity handles that from the deposited funds.
Examples:
- teamLab Planets Tokyo Entry Ticket
- Tokyo Skytree Tickets: Panoramic Views
- Keisei Skyliner Discount Ticket
- Arashiyama Sagano Romantic Train & Hozugawa River Boat Ride
Synced from DatoCMS but have no booking integration. They appear on the site but cannot be booked. Some get significant customer interest (Mt. Fuji Private Tour by Car has been added to 32 carts).
Examples:
- Mount Fuji Private Tour by Car - English Speaking Driver
- Mt. Fuji & Hakone Full Day Private Tour with Pickup
- Asakusa History Walking Tour with Local Guide
- Snow Monkey Exploration: Tokyo's Bullet Train Day Adventure
Each platform has a different financial model:
Bokun marketplace (1a/1b): We collect from the customer → Bokun handles the split and pays the operator → we keep our commission. Bokun knows the terms.
Bokun off-marketplace (2): We collect from the customer → we pay the operator directly → we track commission_percent ourselves because Bokun doesn't know about the arrangement.
Linktivity (3): We pre-deposit funds with Linktivity → customer books → Linktivity draws down from our balance (all-inclusive: operator costs + their fees) → we keep commission_amount per booking. Operators are paid by Linktivity from the deposited funds.
For accounting and Business Central, we need commission visibility across all types — even where the platform handles payouts.
The booking platforms (Bokun, Linktivity) tell us who the platform supplier is — but that's not always the company actually running the tour. This is especially true for category 1b where resellers like BOJ list tours on behalf of other operators.
The vendor system lets us track the actual operator of record, regardless of what Bokun or Linktivity claim. This lets us:
- Distinguish 1a (direct operator) from 1b (reseller) — by assigning a vendor that differs from the platform supplier
- Track contact details for the company actually receiving and servicing our customers
- See the full chain: Platform Supplier → Actual Operator
In the admin tours table, this shows as:
| What you see | What it means | Tour type |
|---|---|---|
BOJ > Kyoto Tours Inc. |
BOJ is the platform reseller, Kyoto Tours Inc. actually runs it | 1b |
Shinobi Travel |
Platform supplier, assumed to be the actual operator | 1a |
Takanawa Travel via Rezio > Hato Bus |
We bridged from Rezio, Hato Bus is the actual operator | 2 |
— |
No supplier info yet | Any |
Two flags can modify any tour's booking behavior:
-
Unpublished (
is_published = false) — Hidden from the site. Includes 335 marketplace Bokun tours (bulk-imported, not curated), 44 off-marketplace, 25 Linktivity, and 32 no-platform tours. -
Manual booking (
manual_booking_required) — Payment goes through normally, but the actual booking with the operator is done manually by staff instead of automatically through the API. Currently only 2 tours: "Zen Vegetarian Cooking Class" (marketplace) and "Tokyo Premium Night Drive" (off-marketplace).
| Type | Published | Unpublished | Manual |
|---|---|---|---|
| 1a+1b. Bokun marketplace | 603 | 335 | 1 |
| 2. Bokun off-marketplace | 30 | 44 | 1 |
| — of which: commission set | 2 | 3 | 1 |
| — of which: commission TBD | 28 | 41 | 0 |
| 3. Linktivity | 127 | 25 | 0 |
| 4. No platform | 102 | 32 | 0 |
| Total | 862 | 436 | 2 |
The admin is becoming a real system of record with clear distinction and features for each tour type:
- Commission visibility — Show our margin for all tour types. For Bokun marketplace this comes from the platform, for off-marketplace we track
commission_percent, for Linktivity it'scommission_amountper booking. All feed into Business Central. - Source platform detection — When we bridge tours from other systems (Rezio, etc.), we detect this from the Bokun experience name and show a
via Reziobadge in admin. - Bokun vendor role —
SUPPLIER(we listed it, off-marketplace) vsRESELLER(marketplace) — auto-detected from the Bokun API. - Operator-of-record tracking — The vendor system, with contact details, notes, and assignment to tours. This is how we'll progressively distinguish 1a from 1b and build a proper operator directory.
Does this match your understanding?