api.hirepos.com/WebsiteBookings
This document provides information on how developers can utilise the WebsiteBookings endpoint to submit bookings from third-party Online Stores to HirePOS. The bookings can then be managed through the HirePOS app by accepting or declining them.
Submitting Bookings to HirePOS
To submit a booking, a JSON structured like the example below must be sent via the POST method to https://api.hirepos.com/WebsiteBookings
Branches Module
To specify a Branch for the booking, include a BranchCode value in the JSON, which matches the relevant Branch Code in Setup > Branches.
POST https://api.hirepos.com/WebsiteBookings
Headers:
AuthKey={YourAPIKey}
AuthSecret={YourAPISecret}
Parameters:
GET
Id=545
// Example Request...
{
"BookingDate": "1/01/2021",
"EstDateFrom": "1/02/2021 8:00 am",
"EstDateTo": "1/03/2021 4:00 pm",
"EventDate": "10/02/2021 6:00 pm",
"Company": "AnyDay Hire",
"FirstName": "John",
"LastName": "Smith",
"AddressLine1": "1 Any Street",
"AddressLine2": "",
"City": "Cairns",
"State": "QLD",
"Postcode": "4870",
"Country": "Australia",
"Phone1": "(07) 1000 0000",
"Phone2": "",
"Phone3": "",
"Fax": "",
"Email": "",
"DeliveryAddressLine1": "10 Somewhere",
"DeliveryAddressLine2": "",
"DeliveryCity": "Cairns",
"DeliveryState": "QLD",
"Reference": "Holiday Special",
"InvoiceCategoryName": "Baby Equipment Hire",
"Message": "Thank you for your business.",
"Comments": "Call on arrival.",
"Items": [{"Code": "1000", "Quantity": 7}, {"Code": "2000", "Quantity": 3}],
"CustomField1": "Pick up from airport.",
"CustomField2": "",
"CustomField3": "",
"CustomField4": "",
"CustomField5": "",
"CustomField6": "",
"CustomField7": "",
"CustomField8": ""
}
// Example Response...
{
"ErrorRaised": "False",
"ErrorType": null,
"ErrorMessage": null,
"Bookings": [
{
"Id": "545",
"BookingDate": "1/01/2021",
"EstDateFrom": "1/02/2021 8:00 am",
"EstDateTo": "1/03/2021 4:00 pm",
"EventDate": "10/02/2021 6:00 pm",
"Company": "AnyDay Hire",
"FirstName": "John",
"LastName": "Smith",
"AddressLine1": "1 Any Street",
"AddressLine2": "",
"City": "Cairns",
"State": "QLD",
"Postcode": "4870",
"Country": "Australia",
"Phone1": "(07) 1000 0000",
"Phone2": "",
"Phone3": "",
"Email": "",
"DeliveryAddressLine1": "10 Somewhere",
"DeliveryAddressLine2": "",
"DeliveryCity": "Cairns",
"DeliveryState": "QLD",
"Reference": "Holiday Special",
"InvoiceCategoryName": "Baby Equipment Hire",
"Message": "Thank you for your business.",
"Comments": "Call on arrival.",
"CustomField1": "Pick up from airport.",
"CustomField2": "",
"CustomField3": "",
"CustomField4": "",
"CustomField5": "",
"CustomField6": "",
"CustomField7": "",
"CustomField8": "",
"Items": [
{
"Code": "1000",
"Quantity": 7
},
{
"Code": "2000",
"Quantity": 3
}
]
}
}
Retrieving Order Details
To retrieve the details of an existing booking, developers should make use of a GET request. In the request, ensure to include the Id of the order as a parameter. This will allow you to access specific information related to the booking stored within the system.