1. Oracle Hospitality Cruise REST API
  2. Tasks
  3. Excursions
  4. Bookable Tours

Create a new bookable tour

post

/spms/v2/ships/{shipId}/configurations/excursions/bookableTours

This is to create a new bookable tour

Request

Supported Media Types
Path Parameters
Body ()
Root Schema : Create new bookable tours
Type: object
Title: Create new bookable tours
Show Source
Nested Schema : additionalInfo
Type: object
Show Source
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 1
    Example: Wonderful view
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 10
    Example: Superb
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 2
    Example: Nice
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 3
    Example: Beautiful
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 4
    Example: Relaxing
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 5
    Example: Lovely
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 6
    Example: Pleasing
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 7
    Example: Marvelous
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 8
    Example: Amazing
  • Minimum Length: 0
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 9
    Example: Awesome
Nested Schema : capacity
Type: object
Show Source
Nested Schema : costs
Type: object
Show Source
Nested Schema : details
Type: object
Show Source
Nested Schema : groupLinkings
Type: array
Show Source
Nested Schema : interfaces
Type: object
Show Source
Nested Schema : linking
Type: object
Show Source
Nested Schema : packageLinkings
Type: array
Show Source
Nested Schema : pricing
Type: object
Show Source
Nested Schema : promotion
Type: object
Show Source
Nested Schema : setup
Type: object
Show Source
Nested Schema : time
Type: object
Show Source
Nested Schema : vendors
Type: array
Show Source
Nested Schema : fixedCosts
Type: array
Show Source
Nested Schema : variableCosts
Type: array
Show Source
Nested Schema : fixedCostsRequest
Type: object
Show Source
Nested Schema : variableCostsRequest
Type: object
Show Source
  • Minimum Value: 0
    Maximum Value: 1.0E18
    Variable cost for adult cost
    Example: 20.5
  • Minimum Value: 0
    Maximum Value: 1.0E18
    Variable cost for child cost
    Example: 10.5
  • Minimum Value: 1
    Maximum Value: 999999999
    Max number of people price can be applied to
    Example: 20
Nested Schema : groupLinkingRequest
Type: object
Show Source
  • Minimum Value: 1
    Maximum Value: 999999999
    Group Account Reference (Only accept group with a reservation status that is either reservation, embark today, no show, checked in or leaving today)
    Example: 1234567
Nested Schema : interactiveTV
Type: object
Show Source
  • This is to indicate enable child booking in Interactive TV (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate excursion is bookable in External Interactive TV System (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate show excursion in Interactive TV (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
Nested Schema : kiosk
Type: object
Show Source
  • This is to indicate enable child boooking in OHC Kiosk (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate excursion is bookable in OHC Kiosk (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate excursion to show in OHC Kiosk (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • Minimum Length: 0
    Maximum Length: 50
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Bookable Tour Kiosk Default Audio File Id
    Example: 160000002481
  • Minimum Length: 0
    Maximum Length: 500
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Bookable Tour Kiosk Default Html File Id
    Example: 160000002482
  • Minimum Value: 0
    Maximum Value: 1.0E38
    Bookable Tour Kiosk Default Picture File Id
    Example: 1.60000001221E11
  • Minimum Length: 0
    Maximum Length: 50
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Bookable Tour Kiosk Default Video File Id
    Example: 160000002480
Nested Schema : printing
Type: object
Show Source
Nested Schema : packageLinkingRequest
Type: object
Show Source
  • Minimum Value: 1
    Maximum Value: 999999999
    Package ID reference (only accept enabled package)
    Example: 1234567
Nested Schema : sales
Type: object
Show Source
Nested Schema : transferTour
Type: object
Show Source
Nested Schema : salesPosting
Type: object
Show Source
Nested Schema : salesTaxAndFees
Type: object
Show Source
Nested Schema : vatPostingSplit
Type: array
Show Source
Nested Schema : vatReportingSplit
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
  • Minimum Length: 1
    Maximum Length: 14
    Pattern: ^[a-zA-Z0-9 ]*$
    Booking type: Regular, Prepaid, Refund Prepaid. This is not case sensitive
    Example: Regular
  • Minimum Value: 1.0E-4
    Maximum Value: 1.0E18
    VAT Amount for adult
    Example: 20.5
  • Minimum Value: 1.0E-4
    Maximum Value: 1.0E18
    VAT Amount for child
    Example: 10.5
  • Minimum Length: 0
    Maximum Length: 10
    Pattern: ^[a-zA-Z0-9 ]*$
    VAT Posting Department Code (must be debit department and cannot be disabled)
    Example: 8007
Nested Schema : vendorRequest
Type: object
Show Source
Back to Top

Response

Supported Media Types

201 Response

Created
Body ()
Root Schema : Bookable Tour Setup Response
Type: object
Title: Bookable Tour Setup Response
Retrieve Bookable Tour Setup
Show Source
Nested Schema : additionalInfo
Type: object
Show Source
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 1
    Example: Wonderful view
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 10
    Example: Superb
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 2
    Example: Nice
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 3
    Example: Beautiful
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 4
    Example: Relaxing
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 5
    Example: Lovely
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 6
    Example: Pleasing
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 7
    Example: Marvelous
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 8
    Example: Amazing
  • Minimum Length: 1
    Maximum Length: 200
    Pattern: [a-zA-Z0-9 ] ~!@#$%^&*()_+-?/\|,.":;{}[]=<>`'
    Comment for bookable tour custom comments 9
    Example: Awesome
Nested Schema : capacity
Type: object
Show Source
Nested Schema : costs
Type: object
Show Source
Nested Schema : details
Type: object
Show Source
Nested Schema : groupLinkings
Type: array
Show Source
Nested Schema : interfaces
Type: object
Show Source
Nested Schema : linking
Type: object
Show Source
Nested Schema : packageLinkings
Type: array
Show Source
Nested Schema : pricing
Type: object
Show Source
Nested Schema : promotion
Type: object
Show Source
Nested Schema : setup
Type: object
Show Source
Nested Schema : time
Type: object
Show Source
Nested Schema : vendors
Type: array
Show Source
Nested Schema : fixedCosts
Type: array
Show Source
Nested Schema : variableCosts
Type: array
Show Source
Nested Schema : costsResponse
Type: object
Show Source
Nested Schema : variableCostsResponse
Type: object
Show Source
Nested Schema : groupLinkingResponse
Type: object
Show Source
Nested Schema : interactiveTV
Type: object
Show Source
  • This is to indicate enable child booking in Interactive TV (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate excursion is bookable in External Interactive TV System (default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
  • This is to indicate show excursion in Interactive TV ((default value is based on parameter 'disableFCUIAndKioskBookingOptions', if the parameter value is null then the default value will set to true)
    Example: true
Nested Schema : kiosk
Type: object
Show Source
Nested Schema : printing
Type: object
Show Source
Nested Schema : packageLinkingResponse
Type: object
Show Source
Nested Schema : sales
Type: object
Show Source
Nested Schema : transferTour
Type: object
Show Source
Nested Schema : salesPosting
Type: object
Show Source
Nested Schema : salesTaxAndFees
Type: object
Show Source
Nested Schema : vatPostingSplit
Type: array
Show Source
Nested Schema : vatReportingSplit
Type: object
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : vendorResponse
Type: object
Show Source

400 Response

Bad Request
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.1",
    "title":"Bad Request",
    "detail":[
        {
            "errorPath":"date",
            "message":"must not be null"
        }
    ]
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

401 Response

Unauthorized
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.2",
    "title":"Unauthorized",
    "detail":"Valid token is required to access this resource"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

403 Response

Forbidden
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.4",
    "title":"Forbidden",
    "detail":"Access to this resource is forbidden"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

404 Response

Not Found
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.5",
    "title":"Not Found",
    "detail":"Ship Id could not be found"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

405 Response

Method Not Allowed
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.6",
    "title":"Method Not Supported",
    "detail":"HTTP method not supported for this resource"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

406 Response

Not Acceptable
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.7",
    "title":"Not Acceptable",
    "detail":"System not allows officers to schedule a tour before the current date"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

409 Response

Conflict
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.10",
    "title":"Conflict",
    "detail":"This Bookable Tour Code is already in use on the specified Date."
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

415 Response

Unsupported Media Type
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.4.16",
    "title":"Invalid content",
    "detail":"Content type Not supported"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

500 Response

Internal Server Error
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"HTTP://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.1",
    "title":"Internal Server Error",
    "detail":"Issue fulfilling request. Please retry or contact support"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source

503 Response

Service Unavailable
Body ()
Root Schema : schema
Match All
Show Source
Example:
{
    "type":"https://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.5.4",
    "title":"Service Unavailable",
    "detail":"Service Unavailable.  Try again later"
}
Nested Schema : Error Response
Type: object
Title: Error Response
Error Response returned when encountered error
Show Source
Back to Top