Provider guide

Provider booking detail tutorial

This tutorial explains the provider booking detail page: booking status, charter timing, meeting point, guest notes, provider items, payout policy, invoice generation, PDF download, and mobile layout.

Booking detail Provider package Payout policy Invoice flow
Provider booking detail · /[locale]/provider/bookings/[ref]
Page overview
Full provider-side view of a booking reference
01
Booking reference — loaded from the route ref parameter.
ProviderNav — bookings nav item is active.
Main column — shows charter details, meeting point, guest info, provider items, and extras.
Side column — shows operator contact, operator notes, and payout policy.
Invoice tools — completed bookings can generate and submit an invoice.
Purpose: This page is the provider’s operational checklist for one confirmed/completed booking.
What you see — full-width page preview
← Dashboard
CHR-YWVTLW
Morpheus
Confirmed
Charter details
Thursday, 25 June 2026
3:00pm – 7:00pm · 4h
Board at King Street Wharf
Disembark King Street Wharf
Your meeting point
King Street Wharf 9
📍 Open in Google Maps
Arrive 60 minutes before charter start
Your package
Gourmet Canapé
10 guests × $50.00/head
$500.00
Operator contact
Tooup Sailing
dave@example.com 0412 000 000
Notes from operator
Please arrive early and coordinate setup before guests board.
Your payout policy
Your booked items total $1,000.00
✅ Charter completed
Platform fee (10%) −$100.00
Your payout $900.00
Provider booking detail · Charter details
Charter date, time, pickup and dropoff
Each booking slot is shown as a card
03
Date format — dates display with weekday, day, month, and year in en-AU style.
Time format — 24-hour DB time is converted to 12-hour am/pm display.
Duration — each slot shows duration hours.
Board at — prefers slot-specific pickup location, falls back to customer pickup.
Disembark — prefers slot-specific dropoff location, falls back to customer dropoff.
Provider action: Use this section to confirm the real service time and locations before preparing staff or goods.
Slot cards
Charter details
Thursday, 25 June 2026
3:00pm – 7:00pm · 4h
Board atKing Street Wharf
DisembarkKing Street Wharf
Friday, 26 June 2026
10:00am – 1:00pm · 3h
Board atRose Bay
DisembarkRose Bay
Provider booking detail · Provider meeting point
Your meeting point
Provider pickup wharf, Google Maps, and arrival instruction
04
Provider wharf — if provider_pickup_wharf is set, it is shown as the meeting point.
Google Maps link — appears only if provider_wharf_maps_url exists.
Fallback message — if meeting point is not set, tells provider to check back or contact operator.
Arrival time — shows provider_arrival_mins_before, defaulting to 60 minutes.
Operational note: This is provider-specific and can differ from customer boarding location.
Meeting point set
King Street Wharf 9
📍 Open in Google Maps
Arrive 60 minutes before charter start
Meeting point not set
Not set yet — check back closer to the date or contact the operator.
Arrive 60 minutes before charter start
Provider booking detail · Guest information
Guest info and customer notes
Number of guests, event type, and notes relevant to the provider
05
Guests — displays booking.guest_count as people count.
Event type — shown only if event_type exists; underscores become spaces and words are capitalised.
Customer notes — shown as a full-width cell if customer_notes exists.
Responsive layout — two columns on desktop, one column on mobile.
Provider action: Use notes for dietary, event, timing, or service preparation details.
Guest info grid
Guests
10 people
Event type
Birthday 18 21
Customer notes
Please prepare vegetarian options and serve food after boarding.
Provider booking detail · Provider items/package
Your F&B items or package
Active and cancelled provider line items
06
Conditional section — shown only when menu_items has at least one item.
Title changes — F&B providers see “Your F&B items on this booking”; other providers see “Your package”.
Item image — shown if image_filename exists.
Cancelled items — faded out, show Cancelled badge, and line total is struck through.
Charge detail — F&B items show per_head, per_hour, or qty detail.
Line total — F&B items show the provider-facing line total.
F&B item rows
Gourmet Canapé
Assorted premium canapé package.
10 guests × $50.00/head
$500.00
Silver Canapé Cancelled
Cancelled item excluded from payout totals.
10 guests × $50.00/head
$500.00
Provider booking detail · Extras ordered
Extras ordered
Additional extras tied to the provider booking
07
Conditional section — shown only when extras array has items.
Extra name — each row displays the extra name.
Quantity detail — per_head extras show guest count; other extras show qty.
Line total — right side displays extra line total.
Extras list
Extra Waitstaff
Qty: 2
$240.00
Kids Snack Pack
10 guests
$120.00
Provider booking detail · Side column
Operator contact and notes
Sticky side cards for provider communication
08
Operator contact — shows operator name, email link, and phone link if available.
Email — mailto link opens email client.
Phone — tel link appears only when operator_phone exists.
Notes from operator — amber card appears only when notes_from_operator exists.
Sticky desktop — side column stays visible on desktop; stacks below main content on mobile.
Side cards
Operator contact
Tooup Sailing
dave@tooupsailing.com.au0412 612 106
Notes from operator
Please arrive early and coordinate setup with the skipper before guests board.
Provider booking detail · Payout policy sidebar
Your payout policy
Provider payout scenarios based on active booked items
09
Total booked — sums active menu items only; cancelled items are excluded.
Cancelled >14 days — provider payout is $0.00.
Cancelled within 14 days — platform fee 5%, then provider receives 50% of the after-fee amount.
Charter completed — platform fee 10%; provider payout is 90% of booked active items total.
Visibility — payout card appears only when menu items exist and booking is not cancelled.
Calculation note: The card is a provider-facing estimate based on active items on this booking.
Payout policy card
Your payout policy
Your booked items total$1,000.00
📅 Cancelled >14 days before charter
Your payout$0.00
Job is removed. No payout is made to you.
⚠️ Cancelled within 14 days
Booked items total$1,000.00
Platform fee (5%)−$50.00
Your share (50%)$475.00
Your payout$475.00
✅ Charter completed
Platform fee (10%)−$100.00
Your payout$900.00
Figures based on active items. Cancelled items are excluded.
Provider booking detail · Invoice modal
Generate, review and submit invoice
Completed-booking invoice workflow for provider payout
10
Generate — POST action generate returns invoice data and opens the modal.
Review Invoice — modal lets provider review line items, platform fee, GST included, and total payable.
Provider type — invoice label changes between F&B Services and Service Partner.
Download PDF — exports a PDF copy before submitting.
Send to Admin — confirms, then submits invoice for platform admin processing.
Submitted state — modal closes and booking header shows invoice submitted state.
Important: The modal warns that invoice cannot be edited after submission.
Invoice modal
Review Invoice
✕
Review your invoice below. Click Send to Admin to submit for payout processing.
F&B Services
INV-BMW-000123
↓ Download PDF
Gourmet Canapé$500.00
10 guests × $50.00/head
Silver Canapé$500.00
10 guests × $50.00/head
Subtotal$1,000.00
Platform fee (10%)−$100.00
GST included (1/11)$81.82
Total payable to you$900.00
Once submitted, platform admin will review and process your payout. You cannot edit your invoice after submission.
Provider booking detail · PDF invoice download
Downloading invoice PDF
Client-side jsPDF export with logo and invoice lines
11
jsPDF import — loaded dynamically only when the provider clicks Download PDF.
Logo — reads BookMyWave logo image and embeds it into PDF.
Invoice header — title changes by provider_type, then invoice number, booking ref, boat name, and date are printed.
Line items — descriptions wrap to fit page width and include optional item detail.
Totals — includes subtotal, platform fee if present, GST included, and total payable.
Pagination — adds pages if line items exceed available page height.
PDF contents
Tax Invoice — F&B Services
Invoice #: INV-BMW-000123
Booking: CHR-YWVTLW · Morpheus
LINE ITEMS: Gourmet Canapé$500.00
10 guests × $50.00/head
Total payable:$900.00
Filename: PDF saves as the invoice number, for example INV-BMW-000123.pdf.
Provider booking detail · Loading and error states
Loading, login redirect, and errors
How the page behaves before booking data is available
12
Loading — ProviderNav plus centred loading spinner while booking is fetched.
401 — redirects provider to provider login.
Booking not found — error state shows message and dashboard link.
Invoice errors — generate or submit errors are shown via browser alerts.
Network error — invoice actions alert “Network error. Please try again.”
Loading state
Loading booking…
Error state
Booking not found — Back to dashboard
Provider booking detail · Mobile layout
Mobile layout
Main and side content stack on small screens
13
Single column — provider body changes from two columns to one column below 768px.
Side cards — no longer sticky; they appear under the main booking details.
Info grid — guest info becomes one column.
Page padding — smaller padding improves phone readability.
Header wrap — status/invoice controls wrap under booking title when needed.
Mobile use case: Providers can open this page at the wharf and quickly check arrival time, meeting point, and operator contact.
Mobile-style booking detail
CHR-YWVTLW
Morpheus
Confirmed
Your meeting point
King Street Wharf 9
📍 Open in Google Maps
Arrive 60 minutes before charter start
Guests
10 people
Operator contact
Tooup Sailing
dave@example.com