Tourplan Rate Sync

For: Suppliers Where to find it: Sidebar → Integrations → Tourplan

Tourplan Rate Sync is a paid add-on that pushes your confirmed Tourium rates straight into your Tourplan system, so you don't have to re-key them. You keep extracting and confirming rates in Tourium exactly as you do today; once a rate is confirmed, one click sends it to Tourplan as a rate update. It's aimed at suppliers who already run Tourplan as their reservation back-end.

Before you start

You need three things from Tourplan (not from Tourium). If you already use Tourplan's productConnect for another integration, your Tourplan administrator will have these on file; otherwise contact Tourplan support to have productConnect enabled:

  • Endpoint URL — the web address of your Tourplan productConnect installation. It's unique to your Tourplan system, so there's no general link to look up — Tourplan provides it.
  • Username and password — a Tourplan login that has been granted productConnect access. A supplier-level login is what you want; it's automatically limited to your own options and rates.
  • (Optional) Supplier code — your 6-character Tourplan supplier code, used for display.

Enabling productConnect and issuing the login go together. A URL without an enabled login won't connect, so ask Tourplan for both at the same time.

This module is supplier-only — it won't appear for agent accounts.

Enable the module

  1. Go to Organisation → Billing.
  2. Find Tourplan Rate Sync in the add-on modules card and switch it on. There is no plan to buy first — if this is your first paid module, you'll be taken through a short checkout that sets up billing for it.
  3. Open Integrations → Tourplan from the sidebar.

Connect your Tourplan account

  1. On the Tourplan page, click Configure connection.
  2. Enter your endpoint URL, username, password, and optional supplier code.
  3. Save, then click Test connection. A green badge means Tourium reached your Tourplan system ("Connected", or "Connected as supplier {code}" if you set a supplier code, with the last-tested time); a red banner shows the error returned so you can correct the details.

Your credentials are stored encrypted and are never shown back on the page — only whether a connection is configured.

Set your sync defaults

You must save your sync defaults before you can map or sync anything — until then a warning appears ("Set your sync defaults (price code) to start mapping and syncing rates") and the Map/Sync buttons are disabled.

  • Price code — the 2-letter Tourplan price code the rates are written to, for example ST (wholesale) or EB (early booker). Each price code is loaded as a separate rate.
  • Buy / sell currency — the currency your costs and selling prices are held in (for example ZAR / USD). A rate that already carries its own currency overrides these.
  • Sale window — the booking window (when the rate can be sold, not the travel dates).

Map your room types

Tourplan identifies each bookable option by a 17-character OptionCode — and each option is one room type on one meal basis. So the same room sold on B&B and on Full Board maps to two different OptionCodes. You map each room type once:

  1. Rates are grouped by property · room type · meal plan. On an unmapped group, click Map room type.
  2. Enter the 17-character OptionCode. Tourium calls Tourplan to confirm the code before saving, so a wrong code is caught immediately.
  3. Save. Every rate in that group is now ready to sync.

Use Edit mapping or Remove mapping on a group to change it later.

Route compulsory levies to Extra slots

If the Tourplan option has Extra slots, the mapping dialog shows a Compulsory levy routing section. Map each fixed compulsory charge on the rate (park fees, conservation levies — the name must match the rate's) to one of the option's Ex1–Ex5 slots so it loads as a Tourplan Extra, and tick Exempt for tax-exempt levies. Percentage taxes such as VAT stay in the rate's tax list and don't need routing. Click Save routing when done.

Sync rates

  1. Make sure the rate is confirmed in Tourium (see Reviewing and editing rates).
  2. Expand a room-type group to see its rates — each row shows the season, room/occupancy (e.g. "2 adults, 1 child"), price, and sync status.
  3. Click Sync on a rate — or Sync all on a group, or the Sync N rates button to push everything in your current filtered view.
  4. Tourium validates the option, pushes the rate, then reads it back to confirm it landed.

While rates are pushing, a banner shows how many are in flight ("{n} rates are syncing…") with a View link that filters the list to them. Statuses update live — no refresh needed.

Reading the status column

Each rate shows where it stands, and each group header shows a per-status summary:

  • Unmapped — the room type has no Tourplan OptionCode yet. Map it before you can sync.
  • Pending — mapped but not yet pushed.
  • Syncing — currently being pushed (retries automatically a few times on transient errors).
  • Synced — successfully sent to Tourplan, with the time of the last sync.
  • Error — the last attempt failed. Hover the badge (or click View error) for the reason; failures also appear in a dismissable alerts strip at the top.

Use the search box (search by property, room type, or meal plan) and the filter chips — Sync status, Property, Meal plan, and Booking type (Early booker / Standard) — to narrow a long list. Your filters are remembered between visits.

What gets pushed

The sync carries the full rate structure you captured in Tourium's rate editor, including:

  • Meal plan — part of the option mapping (see above). Rates without one show "No meal plan".
  • Additional adult price — used to build full triple and quad room rates from the per-adult charge for a 3rd/4th guest sharing.
  • Day bands — a rate priced differently midweek (Sun–Thu) vs weekend (Fri–Sat) loads as two entries.
  • Stay/Pay offers — free-night deals (e.g. Stay 4, Pay 3).
  • Early-booker rates — advance-purchase rates load under their own price code, filterable via the Booking type filter.
  • Compulsory levies — loaded as Tourplan Extras via the slot routing on the mapping.

Troubleshooting

  • Test connection fails — double-check the endpoint URL and that your login has productConnect access. A login without that access will be rejected even if the URL is correct.
  • Map/Sync buttons are disabled — save your sync defaults (price code) first.
  • An OptionCode won't save — it must be exactly 17 characters and exist in your Tourplan system; Tourium checks it before saving. The dialog shows Tourplan's response if the option can't be found.
  • A rate shows Error after syncing — hover the badge for the message. Common causes are a price code that doesn't exist in Tourplan or an option whose rates are locked. Fix in Tourplan, then sync again.

Good to know

  • One sync sends one rate for one date range. Rates with multiple seasons are pushed per season.
  • The current release covers accommodation property rates. Service and activity rates aren't synced yet.
  • Turning the module off in Billing stops syncing and removes it from your bill at the end of the period; your Tourplan credentials and mappings are kept in case you re-enable it.
Previous Specials Next Uploading rates