Linking to the Legacy Booking Engine - Additional Parameters

 Please note the below references an outdated Booking Engine which is no longer supported. Instructions for the NEW Online Booking Engine can be found in this article.

There are a few additional parameters that can be included when linking to the booking engine for additional effects.

Attaching an Automated Vendor ID - Automated Commissions

If you want to link a company to a specific activity link or the booking home page you will need to include the vendor id parameter:

1. Go to the configuration page for that commissionable company (Contacts > Manage Companies > List Companies), their unique vendor id is listed at the top of the Company page.
2. In the URL for the activity or page, add the parameter vendorId= (note the capital "I")
   1. Example: nameofyourdomain.zaui.net/modules/webBooking/index.php?vendorId=companyidnumber (additional parameters are separated by an &)
3. Use this URL when linking to an activity or the booking page if you would like a commissionable company to be linked to the booking. The Link will apply for one hour in the same browser.

Attaching an automated Agent ID - Automated Commissions

If you want to link an individual agent account to a specific activity link or the booking home page you will need to include the agent id parameter:

1. Go to the configuration page for that commissionable agent (Contacts >Manage Agents), their unique agent id is listed at the top of the Agent page.
2. In the URL for the activity or page, add the parameter agentId= (note the capital "I")
   1. Example: nameofyourdomain.zaui.net/modules/webBooking/index.php?agentId=agentidnumber (additional parameters are separated by an &).
3. Use this URL when linking to an activity or the booking page if you would like a commissionable agent to be linked to the booking. Link will apply for one hour in the same browser. If the account is wholesale, the payment option on the checkout page will be a voucher.

Attaching an automatically applied promo-code

If you want to apply a promo code to a specific activity link you will follow the exact same steps as outlined above but you will add it onto the URL for the specific activity.

1. Create an online promotional code.
2. On the URL for your specific activity (nameofyourdomain.zaui.net/modules/webBooking/index.php?action=Details&id=activityidnumber), add the parameter "&promoCode=promocodename"
3. Use this link when linking to specific activities and the promo code will be automatically applied for any bookings made that meet the promo code requirements within one hour of clicking on the link.

Filtering Results By Name

For any of the URL API's mentioned, you can add an additional parameter to the URL which will allow you to filter the results looking for a match on a particular name.

Example: nameofyourdomain.zaui.net/modules/webBooking /index.php?action=Category&groupId={someId}&nameFilter={someNameToFilter}

This will then filter all results onscreen showing only this which contains the 'someNameToFilter'.

Sending your Customers to the Checkout Screen Using the API

If you are using the API but passing your customer back to the Zaui checkout screen, you will need to pass through the cart id generated by the API in the URL.

nameofyourdomain.zaui.net/modules/webBooking/index.php?action=Contents&cartid=[APIcartid]

action- mandatory. Must be Contents.
cartid- mandatory. The cart id generated on the API site.

This will copy the contents of the customer's cart built on the API site into the cart on the Zaui checkout screen.

Conclusion

You can see that there are a number of ways that you can have your system integrated directly with the booking engine that doesn't require an API.  We hope this is helpful for you, and of course, if you have any questions, comments, suggestions, we would love to hear them.

If you require more information about our API, then feel free to contact us and we would be happy to pass along all of the details regarding ZAPI.