2.21 Commerce Release Guide - Arrive Parking

This guide will review how to set up Arrive Parking in Aspenware Commerce.

Overview

Working with two third-party vendors, Arrive Parking and Hoorooh Digital Services, Aspenware now delivers real-time parking availability to customers purchasing through the Aspenware platform. This enhancement eliminates the need for guests to visit a different site after completing their ecommerce purchase, giving the guest the ability to purchase everything they need in a single purchase. In addition to the integration, Aspenware has enhanced Cross-Sell functionality to be more robust, providing guests with visual reminders and easy navigation to products that may not be “top of mind”, parking being an excellent example.

Feature Detail

Arrive Parking utilizes the Aspenware Commerce Cross-Sell feature to offer customers the option of purchasing paid parking ahead of time for the parking lot of their choice. When the guest adds a relevant product to their shopping cart, the Arrive Paid Parking product will appear in the mini-cart.

Open

Once the guest clicks on the Arrive Paid Parking product, they are taken to the Arrive Paid Parking screen where they can choose the date for which they would like to purchase parking. Upon date selection, a list of available lots appears with pricing for each lot. Note that a map of the mountain area is available at the top of the screen for reference.

Open

Selecting the MORE INFO dropdown for a particular parking lot will give the guest a visual of the parking lot and the physical address.

Once the desired lot is selected, the guest clicks ADD TO CART and the paid parking product is added to their cart.

Inventory is maintained by Arrive and Hoorooh, which serves as a middle layer between Aspenware and Arrive gets an update every 60 minutes. This middle layer is required because Arrive enforces traffic limits, but Hoorooh’s APIs can be checked continuously and at a high volume. When the guest clicks "complete order" the products are sold and if the lot space is no longer available, Arrive does not allow the sale to complete. The guest will then receive the following error message and the guest will need to remove the item from their cart. No inventory is managed through Aspenware.

If Arrive inventory is available upon checkout complete, the order will be completed, whereupon the parking products will be routed to Arrive Parking for fulfillment and any ski products will be routed to RTP|One or Siriusware for fulfillment. In order to track revenue recognition across disparate fulfillment systems, work with your Aspenware Representative to add a customized parking sales report.

For resorts that use Payeezy as a payment gateway, refunds that are initiated within Arrive’s ParkWhiz app are routed to Aspenware Commerce, where Unity triggers the refund to Payeezy and returns the result to Arrive for display on the ParkWhiz app. Customers are emailed from the Aspenware Commerce store when the refund request is complete.

Configuration Guide

Arrive Tasks

This function requires synchronization with Arrive/Parkwhiz and Hoorooh. If Arrive/Parkwiz or Hoorooh is down, or cannot connect for any reason, parking cannot be sold through Aspenware Commerce.

While the integration with Hoorooh does act as a middle-layer enabling higher volumes to shop for Arrive parking products at once, Arrive does limit the number of times their data can be accessed, which could cause some orders to fail.

• Configure resort in Arrive with Aspenware’s generated endpoint and key. Get these values from Configuration > Local Plugins. Locate the “Arrive Parking” plugin and click Configure. (configuration steps below)

  • The API Key is listed in a read-only field at the bottom of the screen and can be regenerated by clicking ‘Generate New Webhook Key.' Make sure you select 'Save Settings’ after generating a new webhook key or making any changes to configuration values on this page.

    • When sharing this with Arrive, ensure that they add this API Key in a header called ‘parkwhiz-auth.'
      
      

  • The refund URL provided to Arrive is always "https://<site url>/arrive/bookings/cancel", where "<site url>" would be your resort domain, i.e. 'shop.resort.com.'

  • The URL and API Key values will be different between production and test, with test values configured in the Arrive sandbox environment and production values configured in production.

• Provide Aspenware with the following values from Arrive.

  • Arrive URL (production and sandbox)

  • Client ID (production and sandbox)

  • Client Secret (production and sandbox)

  • Coupon Code (may be different between production and sandbox)

Hoorooh Tasks

• Provide Aspenware with Hoorooh’s endpoint(s) and key(s) specific to the resort.

  • Availability URL (production and sandbox)

  • Availability API Key (production and sandbox)

Commerce Tasks

• Install and Configure the Arrive Parking Plugin

  1. Go to Configuration > Local Plugins and change the “Group” filter to “Aspenware.”

  2. Locate the “Arrive Parking” plugin and click Install.

  3. Restart the application by clicking the green Restart application to apply changes button.

  4. Once complete, ensure the application is installed and enabled
     
     

• Configure the Arrive Plugin

  1. Go to Configuration > Local Plugins and change the “Group” filter to “Aspenware.”

  2. Locate the “Arrive Parking” plugin and click Configure.

  3. Configure the following fields: Note that these will be different between test and prod.

     1. Availability Url: Input URL obtained from Hoorooh.

     2. Availability Api Key: Input key obtained from Hoorooh.

     3. Arrive Url: Input URL obtained from Arrive.

     4. Client ID: Input Client ID obtained from Arrive.

     5. Client Secret: Input Client Secret obtained from Arrive.

     6. Arrive Coupon Code: Input Coupon Code obtained from Arrive.

     7. Arrive API Scopes: Input ‘partner’

     8. Refund Webhook API Key (Shared with Arrive Parking): Click Generate Key to populate this field. ONLY CLICK GENERATE KEY ONCE. This is a key generated by Aspenware Commerce for each store, and must be provided to Arrive, along with the refund URL, to complete the configuration. Note that refunds are only available to resorts using Payeezy as a payment provider.

• Click Save Settings.

   

• Verify Payeezy is Installed and Active

  • Go to Configuration > Payment Methods and search for Payeezy. Check to make sure that Is active is checked if you are using Payeezy as a payment gateway.

     

• Create Category for the Parking Product

  1. For details on configuring a category, see the documentation on Configuration: Categories

  2. Choose a name for your category that is best for your resort, examples include Parking, Paid Parking, Reserved Parking, Parkwhiz Parking.

• Create Product for the Parking Product

  1. Create a product shell following the instructions in the documentation for Configure Products and then include the following specifics for Arrive Parking.

     1. Short Description: Enter the short description for the product. Note that HTML and Long Descriptions are not supported for Arrive Parking products and can cause PDP issues if used.
        
        

     2. Email description: Input the email content HTML messaging that guests should receive when purchasing this product. Guests will receive two emails, one from Aspenware for the order confirmation and a second from Arrive to manage their parking reservations. The Arrive email is controlled within Arrive’s platform.
        
        

     3. Published: Check to enable.

     4. Product tags: Enter tags if you want them displayed in the classification window.

     5. Product Template: Set to “Arrive Parking Product”, then click Save and Continue Edit. This will automatically generate the majority of required attributes for the product.
        
        

     6. Pictures: This product requires two images. Product images should follow standard product specifications - 1700 x 700 px and 275 KB. The remaining lot images are populated from Arrive and must be managed from the Arrive platform.

        1. The first product image that is uploaded is displayed as the product card image and also as the main product image on the PDP when the screen is scaled to display the image.

        2. The second image uploaded is displayed as the parking map image and is required to have the Title set to “Parking Map”.
           
           

     7. Product Attributes: The majority of attributes will automatically be added after the product template “Arrive Parking Product” is saved. Start Date will need to be configured manually with Text prompt [Date], Is Required DISABLED, and the Control type set as “Date Picker”.

• Price: Scroll down to the Price section on the Product detail page (PDP) and enter a value for Price. Parking pricing is supplied from Arrive via the API. The only price you need to define is the lowest price the parking is available for, so that it populates correctly when displayed with the label “STARTING AT”.
  
  

   

• Configure the Arrive Refund Email

  • To configure the Arrive Refund email template go to Content Management>Message Templates and Edit to edit the ‘ArriveParkingRefund.CustomerNotification’ email template. 

    • To edit the email HTML, go to Tools>Source Code and adjust the HTML from there in the Source code window. In the body portion of the email template, paste the following code and customize as desired.
      
      

      %Store.Name%. Order #%Order.OrderNumber% refunded <p><a href="%Store.URL%">%Store.Name%</a> <br /><br />Order #%Order.OrderNumber% has been just refunded<br /><br />Amount refunded: %Order.AmountRefunded%<br /><br />Date Ordered: %Order.CreatedOn%</p>

      Copy

  • For more details on email configuration, refer to: Login - Aspenware Customer Hub

• Work with your Aspenware Representative to add a customized parking sales report in order to track revenue recognition across disparate fulfillment systems.

Common Troubleshooting guide

Q: I can’t see Arrive orders in RTP, how can I manage them?

A: Aspenware will generate an order# in RTP|One but currently any Arrive product(s) will show as a blank line item in the order. Therefore resort’s guest services teams will not be able to see or manage Arrive orders within RTP|One and will need to reference Arrive for managing parking reservations.

Q: My images aren’t showing as expected, how do I fix this?

A: Depending on the image at issue there are several resolutions:

• The first image uploaded in admin will be shown on the product card and when the guest first navigates to the PDP.

• The second image uploaded needs to be tagged with the Title “Parking Map” and this will trigger the image to show in the parking map area of the PDP.

• Lot images are configured in Arrive parking. To modify these make changes in Arrive.

Q: When is the latest opportunity a guest can trigger a refund?

A: The guest can submit a refund through Arrive’s email, Arrive’s website, or Arrive’s app up to one hour prior to lot opening.

Q: Can I issue a guest a refund after their reservation has expired?

A: Resort guest services teams at resorts cannot perform this action. Guests or resort staff will need to contact Arrive directly to request this.