Uplisting API Documentation
Instructions:
- Document will have portal, plugin settings, each, and everything to setup
- The basic setup instructions for each PMS, any settings to amend in the portal, what is pulled, what can be changed, any maintenance, etc.
- In a word format and tom can then create it on site as a docs
- We might need to use screenshots as well
Index:
- Introduction
- Portal
- Add Listings
- Add Calendar / Availability
- Add Reservations
- Cancel Reservations
- API Integration
- Credentials Required
- Endpoints
- All listings
- Single listing
- Reservations (Create/Cancel)
- Prices (Extra guest fee, daily price, Taxes, Discounts)
- Availability (Min stay, Available)
- Missing Endpoints
- Manual sync all or single listing
- Auto Sync settings
- Website Settings
- Plugin Settings
- Overriding
- Cronjobs (Enable/Disable)
- Customization
- Auto Registration
- Path of files for custom code.
- Gateways
- Stripe
- Options on theme settings
- Path of files for custom code.
- Code
- Child Theme.
- API Plugin.
1. Introduction
Uplisting API
Uplisting is a short-term rental property management software which supports property, channel and guest management with rates, bookings and availability syncing, centralized bookings, and a unified single inbox, plus linked listings, smart rates and more. Uplisting keeps all bookings in one place, and all information synced with popular booking sites such as Airbnb and Booking.com. Uplisting also gives users the flexibility to manage their rental properties anytime, anywhere, via any internet-enabled device.
2. Portal
Add Listings
Add Calendar / Availability
Add Reservations
Cancel Reservations
Booking Engine:
API key can get from here:-
3. API Integration
Credentials Required
- API Key
- Booking URL
API Key is required for getting response of all requests.
Endpoints
API Doc: https://documenter.getpostman.com/view/1320372/SWTBfdW6
- GET Listings https://connect.uplisting.io/properties
- GET Single Listing
https://connect.uplisting.io/properties/:id
- GET Prices & Availability
https://connect.uplisting.io/calendar/:listing_id?from=2020-12-10&to=2020-12-20
Missing data
- No create reservation endpoint although a Booking URL for booking on portal
- No cancel reservation endpoint
- No cleaning fee
Manual sync options
- All Data sync
- Single listing sync (Go single listing edit page)
Auto Sync Settings
- Plugin Setting page (Go to Listings > Settings)
- View existing auto schedules
- Can enable/Disable each auto sync by clicking checkbox under Action Column.
4. Website Settings
Plugin Settings
- Plugin Setting page (Go to Listings > Settings)
- Enter required API credentials
- Override options
- You can enable / disable override settings for API data.
- Can view and enable/disable Auto Syncs.
5. Customization
Auto Registration
Changes for auto registrations module are in following files.
- homey-child\template-parts\boostly-modal-register.php
- homey-child\template-parts\instance-booking\nightly.php
- plugin\uplisting\assets\js\uplisting.js
- plugin\uplisting\uplisting.php
6. Gateways
Stripe
Changes regarding stripe to Uplisting reservation are in the following files.
- theme\homey-child\template-parts\instance-booking\nightly.php
- plugin\uplisting\uplisting.php
- plugin\uplisting\assets\js\uplisting.js
- plugin\uplisting\classes\class-stripe.php
Homey theme settings to enable / disable Stripe gateway
7. Code
Child Theme
Path: theme\homey-child
API Plugin
Path: plugin\uplisting