api.hirepos.com/WebsiteBookings

Edited

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.