Configuration: Arrive Parking

Setup Checklist

Prerequisite Tasks

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 Parking does limit the number of times their data can be accessed, which could cause some orders to fail.

• Obtain and provide Aspenware with the following from Arrive Parking:

  • Arrive URL (production and sandbox)

  • Client ID (production and sandbox)

  • Client Secret (production and sandbox)

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

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

Hoorooh Tasks

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

  1. Availability URL (production and sandbox)

  2. Availability API Key (production and sandbox)

Infrastructure 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
     
     

     Open

     

• Configure catalogsettings.hiddenattributes setting

  1. Go to Configuration > Settings > All settings (advanced).

  2. Search catalogsettings.hiddenattributes

  3. Click Edit.

  4. Enter the following in the Value field: Arrive Parking Lot Id, Arrive Parking Date, Arrive Parking Price, Arrive Parking Event Id, Arrive Quote Id, Parking Time, Arrive Booking Id

  5. Click Update.

Detailed Setup Guide

1. Configure Arrive Parking Plugin

2. Verify Square is Installed and Active

3. Create Category for the Parking Product

4. Create Product for the Parking Product

5. Configure Arrive Parking Refund Email Template (Optional - only with Square)

6. Add a Customized Parking Sales Report (Optional)

7. Customize Arrive Parking Language Strings (Optional)

1. Configure the Arrive Plugin

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

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

• 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 (Share 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 Square as a payment provider.
     
     

     Open

     

• Click Save Settings.

• Share Refund Webhook API Key and Refund URL with Arrive Parking (see notes below).

2. Verify Square is Installed and Active

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

   

3. Create Category for the Parking Product

• For details on configuring a category, see Configuration: Categories.

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

4. Create Product for the Parking Product

• Create a product shell following the instructions in Configuration: 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”.

5. Configure Arrive Refund Email Template (Optional - Only with Square)

• 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 Configuration: Emails.  

6. Add a Customized Parking Sales Report (Optional)

• In order to track revenue recognition across disparate fulfillment systems, contact your Aspenware Representative (support@aspenware.com) to add a customized parking sales report.

• Once added, go to nop4you > SQL REPORT MANAGER > Reports. There are 3 reports available for Arrive Parking:

  1. Online Prepaid Parking Export

  2. Online Prepaid Parking Refunds

  3. Online Prepaid Parking Export with Cancels
     
     

• Select Aspenware Reports>[Report Name] and enter/select the following:

  1. Enter from date and To date: This is the date range for the report you’d like to see.

  2. Select Payment Status: This enables the selection of the types of transactions you’d like to see.

  3. Click Generate or Export to Excel.
     
     

The report will list all relevant data for the Arrive Parking transactions.

7. Customize Arrive Parking Language Strings (Optional)

There are several customizable language strings available in conjunction with Arrive Parking. For instructions on editing a language string, see the Language Strings Library. The following language strings are available for customization: