Skip to main content

How to Connect Zaui with Musement

  • Updated


Overview

Musement helps travellers get the best from destinations by providing a great choice of local tours and attractions bookable on multiple devices. Musement's range includes temporary, exclusive, hidden-gem and even free activities. 

You can automate your relationship with Musement using API Connectivity and Zaui's Channel Manager. API Connectivity will allow your Zaui system and Musement to talk to each other. Specifically, Musement will be able to: 

  • Pull availability information;
  • Create new bookings;
  • Update and cancel existing bookings in your Zaui system

To connect Zaui and Musement via the Marketplace Integration you will need to do the following steps:

Registering with Musement

You must have a Supplier Account with Musement to have your products listed and connected to your Zaui system.  If you don't already have an account, you can sign up here.

 

You will need to register for Musement Business and speak to a Musement representative to arrange partnership terms. Please note Zaui is not involved here and cannot assist in this process.

If you haven't yet, please create product listings on Musement for tours/activities you are looking to offer on this marketplace. Contact your Musement Account Manager if you need assistance with this step. 

noun_attention_1436012__1_.png API Connectivity with Musement currently only automates updates for inventory (availability), rates, booking creations, amendments and cancellations. Product content (descriptions, pictures) on Musement is NOT automatically updated with information in your Zaui system. We recommend you regularly check your product listings on Musement to ensure all information is correct and up-to-date.

Create Musement as an Agency in Zaui

All bookings created via API Connectivity automatically appear in Zaui as PAID with Voucher payment type, therefore it is important Musement is set up as a Wholesale Company in your Zaui system.

To set up Musement as a Wholesale Company:

  1. From the navigation bar, select Resellers > Companies > Company List. If Musement is not on the list of companies, click Create Company from the shortcuts panel. If it is on the list, click on it to view details.
  2. Fill out the Company Information section (only Company Name is required, other fields are optional).
  3. In the Rate Type section, select Wholesale Discount/Invoice type and leave all boxes unchecked.
  4. In the Rate Codes section, assign a rate code to Musement based on your negotiated commission/net rate with them and define to which products it applies. This will ensure your reports account for the correct Net Rate. Learn more about rate codes here.

 

GetYourGuide.gif

Enabling the Musement channel in Zaui

By default, API Connectivity is disabled to protect your business information. As a business manager/owner, you need to enable this for each Channel Partner and define any applicable rules. 

To enable Musement channel:

  1. From the navigation bar, select Resellers > Channel Partners.
  2. Click on "Musement" in the list of channel partners. 
  3. In the Map reseller to account field within the Channel Information section, select the Musement company created earlier. 
  4. Check Enable Channel box to turn this channel on.
  5. If you would like Zaui to also notify you via email every time Musement performs actions via API Connectivity (i.e. pulls a list of available activities, creates, updates, cancels bookings, etc.), check Enable Alerts box and enter email for notifications to be sent to.
    noun_attention_1436012__1_.png If you see a message in the Channel and Exports section saying Your system has not been added to our Zaui I/O Platform. Please contact our office, please contact Zaui using this form or email connectivity@zaui.com letting us know you would like to enable the Musement channel. Skip this step if this message is not shown.

  6. In the Channel Rules and Controls section, define which activities you allow Musement to access via API Connectivity and what rules to apply. Learn more about Channel Rules and Controls here.
  7. Don't forget to click  Save. 
  8. Once saved, click Download Supplier Mapping File. You will need this file for the following steps.

Obtain the Supplier ID

The next step is to obtain your supplier ID (Musement will refer to this as your Zaui ID). Musement will need this ID in order to establish a connection between the two systems allowing Zaui to update availability, capacity and price. 
To obtain the Supplier ID please contact connectivity@zaui.com. Once you hear back from out team (usually within a few business hours) you can let your Musement representative know the Supplier ID (Zaui ID).

Create your activity in Musement

For an up-to-date guide on creating activities within the Musment system, visit this official Musment guide.

Mapping Products in Between Musement and Zaui

Now that you have created Musement as a Wholesale Agency in Zaui, have enabled the channel, defined its' rules, and obtained your Supplier ID, you will have to create your activities within the Musement system. Once created, the Musment team will be in touch with you about which of your products on Musement correspond to which activities in Zaui. This process is also called Product Mapping or API Mapping. You can do this by following the steps below or you can contact your Account Manager at Musement for assistance. 

 

Musement's finishing touches

That's it. Congratulations. Musement's content team will review your experience page and reach out if they have any questions or concerns. Once everything looks good, they will initiate the API to pull the necessary data from your Zaui system.

 

Important FYI's

  • API Connectivity with Musement currently only supports Standard, Interval and Ticket activities in Zaui. Custom, Point to Point and Rental activities as well as Packages and Merchandise Products CANNOT be connected to Musement . 
  • Your passenger types in Zaui must exactly match those listed on your Musement product listing for the connection to work. It is not possible to change the mapping for passenger types at this time. Zaui pricing options are cannot be connected.
  • Make sure Zaui activity date ranges and start times on Musement are the same.
  • Musement products with operating hours configuration are not supported by API Connectivity. Only products with start time configuration can be connected.  
Icons made by Eucalyp from www.flaticon.com