Public Booking API

Ownership contract for the website developer and Nick. Paradise Cove Resort (6850).

PMS owns extras catalogue, book-section maps, room-unit maps, deal products / offers, and hold rules. The website is the storefront — it reads those catalogs and posts a booking. It does not invent extras, deals, or hold lengths.

Who owns what

PMS

extras catalog (extraId, name, marketingName, chargeMethod, categories, compulsory), extra_maps (Transfers / Meals / Activities), room unit maps (website room type ↔ FJD unit ids + sell currency), deal products + offers, hold bands.

Website

storefront only. Renders PMS catalogs, collects guest + stay, calls the booking API. No local extras catalogue, no Deals-extras admin, no hold-length table.

Resort credit is a booking note. There is no Ibex extra and no Deals-extras page.

Read endpoints (stub)

GET /api/v1/storefront?property=6850 — extras, extraMaps, roomUnitMaps, deals, holds.

GET /api/v1/availability?property=6850 — leftover by room type (unallocated pool does not grey-block units).

Manual Book already uses the same catalogs. After Stripe sandbox, Website/Quoting POST the Seekom rooms[]+extras document — see docs/inbound-pipeline.md. Rezdy transfers later; ignore SSC for now.

Admin: Extras catalogue · Website maps · Deal products · Hold defaults. Written copy also lives in docs/booking-api.md.