AltoVita for Mews Operations

Mews Marketplace

You can learn more about AltoVita here.


Here are some things to know before you set up AltoVita for Mews Operations:

  • If you're already live with Mews, Mews does not configure the entire channel manager integrations for you. If you have any problems fixing the mapping errors within Mews, contact the Mews support team to help you troubleshoot.
  • This channel is a two-way connection meaning that Mews manages availability, rates, and restrictions. Reservations are pushed from AltoVita into Mews.
  • The integration does not currently support multi-room reservations and credit card flow.
  • Reservation modifications are done by cancelling an old reservation and creating a new one.
  • Only one rate can be mapped in the AltoVita integration.
  • If you already have a contract with AltoVita, click Connect.



In this article you can learn how to set up the AltoVita integration in Mews Operations:

Step 1: Connect AltoVita 

  1. Go to the main menu image.png > Marketplace.
  2. Under Categories, click Distribution.
  3. Locate the AltoVita integration and click Explore.
  4. Click Connect integration.

Note: AltoVita works with mapping codes generated in Mews or AltoVita.

 

Step 2: Update mapped space categories

When you connect the AltoVita integration, Mews automatically maps all your space categories.
If you don't want Mews to send a space category to AltoVita, you can remove it.

 

To remove mapped space categories

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click Channel manager rates.
  4. Find the rate that the space category is connected to, and click on the channel manager ID.
  5. In the Channel manager categories section, find the space category you want to remove and click the icon.
  6. Click Delete.
  7. Repeat steps 4-6 for every space category that you don't want to send to AltoVita.

If you need to add more space categories in the future, you can manually map them.

 

To manually map space categories

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click Channel manager categories.
  4. Click +.
  5. In the Channel manager ID field, enter a unique code for this space category. Mews recommends that you create a short code to describe the space category, for example, "PRES" for "Presidential Suite". Make sure not to include spaces or special characters. Note: The upper/ lower case in the mapping codes needs to be identical in Mews and AltoVita.
  6. Under Category, select the space category you want to send to AltoVita.
  7. Select the Synchronized checkbox to send availability updates to the channel manager. Note: If a space category is unsynchronized, Mews doesn't send any updates.
  8. Click Create.

Repeat steps 4-8 for every space category that you want to map.

 

Step 3: Update mapped rates

When you connect the AltoVita integration, Mews automatically maps all your public rates.

Note: The AltoVita integration supports only one mapped rate with the specific Rate code “ALT”.
 

 

To remove mapped rates 

If you want to completely remove a rate so that no reservations can be created with it, delete or unsynchronize the rate in both Mews Operations and AltoVita.
If you want to send private rates, you can manually map them.

 

To manually map rates

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click Channel manager rates.
  4. Find the rate you want, and click on the channel manager ID.
  5. Click +.
  6. In the Channel manager ID field, enter a unique code for this rate provided by AltoVita - “ALT”. Make sure not to include spaces or special characters.
  7. Under Rate, select the rate you want to send to AltoVita .
  8. Find the Synchronized checkbox and decide which updates you want to send to the channel manager.
  • Synchronized rates send pricing and restriction updates to the channel manager.
  • Unsynchronized rates don’t send pricing or restriction updates to the channel manager, but can still receive reservations.

If you want to manage rate pricing in AltoVita rather than Mews Operations, make sure the rate is unsynchronized.

  1. Click Create.

 

Step 4: Connect space categories to rates

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click Channel manager rates.
  4. Find the rate you want, and click on the channel manager ID.
  5. Connect the rate to one or more space categories:
  • Click +, and then click + Channel manager category to connect only specific space categories. For example, if it's a promotional rate.
  • Click Connect all to connect all mapped space categories to the rate.

 

Step 5: Mapping products

Package products to ensure that you add them to your channel manager reservations.

  • If you charge the product per night or per person per night, you can package it with a rate.

 

To map products

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click on + to map a product.
  4. In the Channel manager ID section, enter a unique code for the product. Make sure not to include spaces or special characters. Note: The choice of the number doesn't matter. Adding a number in this field makes it possible to package the product with a rate.
  5. Click Save.

Repeat steps 3-5 for every product that you want sent to AltoVita .

 

To connect the product to a mapped rate

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Click Channel manager rates.
  4. Find the rate you want to package a product with, and click on the channel manager ID.
  5. Click +, and then click + Channel manager product.
  6. Under Product, select the product you want.
  7. Click Create.

Repeat steps 5-7 for every product that you want to be available via AltoVita. Repeat these steps with the same rate to package it with multiple products.

 

Products charged once or per person

You cannot map these products. You need to create a product rule instead.

  1. Go to the main menu image.png > Settings > Services.
  2. Click on a Bookable service.
  3. From the Settings menu, click Product rules.
  4. Click the + button.
  5. Choose the condition that must be met in order for the product to be added to the reservation. For example, if you want to add the product when the reservation is made with a specific rate:
  • Under Rate condition, select Equals.
  • Under Rate, select the rate you want the product packaged with.
  • Under Origin condition, select Equals.
  • Under Origin, select Channel manager.
  1. Click Create to create the product rule.
  2. In the Rule actions section, click + Rule action.
  3. Under Product, choose the product that you want to add to a reservation. The system selects Add under the Action field by default. Note: Choosing Cancel under the Action drop-down excludes the product from the product rule. 
  4. Click Create.

 

Step 6: Map travel agencies

For each travel agency, you need to create a profile/contract and set up mapping. Then, Mews Operations can automatically detect and handle any new reservations from that agency.

With AltoVita, Mews recommends that you only map the most specific reservation sources. You can learn more about travel agency mapping here.

 

Step 7: Send mapping information to AltoVita

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Find and copy the Channel manager ID.
  4. Send it to AltoVita support: [email protected], along with an email address that is used to log in to Mews.

Note:

  • AltoVita refers to this ID as a "connection token."
  • Sending the email address is an important step for the automatic mapping of your space categories and rate on the AltoVita side.
  1. AltoVita support pulls the Mews Operations mapping information to AltoVita and instructs you how to complete the mapping in AltoVita. Once you are done, you can continue to the next step.

 

 

Step 8: Test the integration

This test fails:

  • If there are any errors with your mapping setup in AltoVita, or
  • If you don't finish this step.

To resolve any mapping issues in AltoVita, contact AltoVita support: [email protected].

To test the integration:

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Under Enabled operations, select Upload availability, Upload rates, and Upload restrictions.
  4. Click Save.
  5. From the menu on the left, click Manual actions:
  • In the Push inventory section,
    • Under From, select today's date.
    • Under To, you can select 1 week from today.
  1. Click OK and refresh the page.
  • If you have mapping errors, your selections under Enabled operations are no longer selected, and Mews sends a detailed list of the errors to the address entered in the Notification email field. Fix the errors and repeat steps 2-6.
  • If the inventory update is successful, Mews sends an email to the address you enter in the Notification email field.
  1. When you have no mapping errors, log in to your AltoVita account and compare the availability, rates, and restrictions to those in Mews Operations.
  • If they don't match, make sure you didn't add availability limits, commissions, taxes, or markups in AltoVita. If you need help with this step, contact AltoVita support: [email protected].

 

Step 9: Enable the integration

  1. Go to the main menu image.png > Marketplace > My subscriptions.
  2. Locate the AltoVita integration and click Edit to go to the settings page.
  3. Select the Enabled checkbox.
  4. In the Enabled operations section, make sure to select Upload availability, Upload rates, Upload restrictions, and Receive reservations.
  5. Click Save.
  6. From the menu on the left, click Manual actions:
  • In the Push inventory section,
    • Under From, select today's date.
    • Under To, select 365 days from today.
  1. Click OK.


You can learn more about products and channel manager here.

 

Was this article helpful?
00



Feedback