Suppliers
The Suppliers navigation group in Arkana manages every land-service provider (DMC) that Volāre buys from, their bookable inventory, the commercial contracts behind that inventory, insurance products, and the operational queues that suppliers and staff use day to day.
Menu items
Section titled “Menu items”Ordered as they appear in the sidebar:
| Item | Manages |
|---|---|
| Suppliers | The provider companies (DMCs): contacts, banking, currency, documents |
| Supplier Hotels | Master hotel catalog (rooms, amenities), per supplier |
| Supplier Activities | Master activity catalog, per supplier |
| Supplier Transfers | Master transfer catalog, per supplier |
| Supplier Services | Sellable services with their own rates, linked to a hotel/activity/transfer/insurance |
| Tours | Tour programs (the primary product entry point) |
| Travel Windows | Bookable date ranges (with blackout dates) for a tour |
| Supplier Contracts | Commercial contracts with Signaturit e-signature lifecycle |
| Insurance Policies | Intermundial insurance products available for sale |
| Insurance Contracts | Issued/attempted insurance certificates tied to bookings (read-only) |
| Stop Sales | Date-range blocks that pull a tour’s offers off the web |
| Trips to Deliver | Supplier-facing operational queue of trips to fulfil (read-only) |
Supplier lifecycle
Section titled “Supplier lifecycle”A Supplier is the top-level provider record: contacts (commercial, emergency), address, banking details, default content language (source_locale) and the currency all its prices are quoted in. Changing the currency only re-labels existing prices — it never converts values — so it is treated as a deliberate, high-impact edit.
Under each supplier sit the master catalogs — Supplier Hotels, Supplier Activities, Supplier Transfers — and the sellable Supplier Services that reference them and carry the actual rates. Tours assemble these into day-by-day programs, and Travel Windows define when a tour can be sold.
For the full data model (suppliers, hotels, per-hotel rate periods, tour itineraries and how a tour becomes a market product) see the Suppliers service, and the allotment counters that cap how many bookings a rate can absorb in the Allotment reference.
Excel template import
Section titled “Excel template import”Supplier Services can be bulk-loaded from a spreadsheet instead of hand-entering rows. From the Supplier Services list, Export Template downloads an .xlsx for a chosen supplier and type (Hotel, Activity, Package or Transfer); Import from Template uploads the filled file and creates the services, rates and prices in one pass.
Prices are entered in occupancy columns — 1A through 8A (1 to 8 adults), plus mixed-occupancy variants such as 2A+1CH, 2A+2CH and 2A+1B (adults + children / baby) — each priced in the supplier’s own currency. Column semantics live in SupplierTemplateService; the import is handled by SupplierTemplateImportService.
Content translation
Section titled “Content translation”Hotels, activities, transfers and services are translatable. Their edit screens carry a Manage Translations action (per-locale field forms across the markets’ supported locales) and an Auto-translate with AI helper that pre-fills a translation for review before saving. Untranslated fields fall back to the source-locale content.
Contracts and e-signature
Section titled “Contracts and e-signature”Supplier Contracts are the formal agreements between Volāre and a supplier, optionally generated from a tour (pulling its title, currency, validity and covered service rates). Each contract carries a status lifecycle — Draft → Sent → Negotiating → Signed → Active → Expired, with Terminated available at most stages.
Contracts are sent for digital signature through Signaturit directly from the contract’s edit page: Send for Signature generates the PDF and sends it to the supplier’s commercial contact, with Resend Email, Sync from Signaturit (a manual pull for when the webhook never arrives), Cancel Signature, and PDF downloads (contract and signed copy). Signed and active contracts can then be activated, and terminated with a recorded reason. See the Signaturit integration for the signing flow and recipient resolution.
Insurance
Section titled “Insurance”Insurance Policies is the catalog of Intermundial insurance products available for sale: product name, Intermundial policy IDs, the market it applies to (blank = global / all markets), whether it is included by default, and its checkout display order. This is an admin-managed global catalog — it is not scoped per supplier.
Insurance Contracts are the actual certificates issued (or attempted) against a booking. This resource is read-only — contracts are emitted asynchronously during booking finalization, so operations can only inspect them, never create them. Each contract carries a status of Pending, Issued or Failed, the full request/response for auditing, and (when Issued) a live Download certificate action that fetches the Intermundial e-cert on demand. See Travel Insurance (Intermundial).
Stop Sales
Section titled “Stop Sales”A Stop Sale marks a tour unavailable for a date range with a required reason. When creating one, Arkana previews the affected offers live — matched by the offer’s arrival date in destination (suppliers care about when the client lands, not the origin departure). Stopped offers are hidden from the web and flagged in the Trips to Deliver view. See Stop Sales for how the block propagates to offer visibility.
Trips to Deliver
Section titled “Trips to Deliver”Trips to Deliver is a supplier-facing operational queue, backed by bookings but stripped of all commercial data. It shows only what a supplier needs to operate a trip: passengers, dates, contact details, allotment, stop-sale and extra-night flags, flights, and the hotels/activities/transfers actually purchased. It carries no pricing, payment, sales attribution or checkout-funnel data, and is strictly read-only (no create/edit/delete). See Trips to Deliver.
Supplier-manager visibility
Section titled “Supplier-manager visibility”Several people using Arkana are supplier managers — external partner users tied to a single supplier via supplier_id. The Suppliers group enforces this scoping in code:
- Row scoping — Suppliers, Hotels, Activities, Transfers, Services, Tours, Travel Windows, Contracts and Stop Sales all filter their listings to the manager’s own supplier. Admins see everything.
- Catalog privacy — the Supplier filter is hidden from supplier managers on the Tours, Travel Windows, Services and Contracts tables, so the partner catalog cannot leak between suppliers.
- Trips to Deliver is visible only to supplier managers (staff use the full Bookings resource instead), and on multi-supplier tours a manager sees only their own hotels/activities/transfers.
- Price gating — where a supplier manager can reach a booking or offer view scoped to their supplier, Volāre’s internal figures (margins, costs, flight economics) are replaced by a “Not visible” placeholder (
GatesSupplierManagerPrices). Insurance Policies and Insurance Contracts are not supplier-scoped at all — they are global/ops resources.
Related
Section titled “Related”- Suppliers service — data model, per-hotel pricing, publishing tours to markets
- Allotment — per-date inventory caps
- Signaturit E-Signature — contract signing
- Travel Insurance (Intermundial) — insurance issuance
- Stop Sales — offer availability blocks
- Trips to Deliver — supplier fulfilment queue