Skip to content

Update Daily Rates by Range

PUT
/api/managing-entity/{managingEntityIdentifier}/extranet/master-rate/{masterRateIdentifier}/rate/bulk
curl --request PUT \
--url https://api.wink.travel/api/managing-entity/hotel-1/extranet/master-rate/master-rate-1/rate/bulk \
--header 'Content-Type: application/json' \
--header 'Wink-Version: 2.0' \
--data '{ "startDate": "", "endDate": "", "rateSource": "TRAVELIKO", "master": true, "closedOnArrival": false, "closedOnDeparture": false, "numberOfUnits": "", "rate": { "amount": 1, "currency": "example" }, "minLengthOfStay": "", "maxLengthOfStay": "", "singleOccupancyRateModifier": { "type": "FIXED", "percent": "", "fixedAmount": "" }, "extraPaxRateModifier": { "type": "FIXED", "percent": "", "fixedAmount": "" }, "extraChildRateModifier": { "type": "FIXED", "percent": "", "fixedAmount": "" } }'

Bulk update daily rates by date range

managingEntityIdentifier
required
string
""

Update daily rates by date range owned by this property identifier.

Example
hotel-1
masterRateIdentifier
required
string
""

Update daily rates by date range owned by this master rate.

Example
master-rate-1
Wink-Version
string
default: 2.0.0
Allowed values: 2.0
Media type application/json
object
startDate
required

Start date for where you want to begin updating rates

string format: date
""
Example
2020-08-24
endDate
required

End date for where you want to stop updating rates

string format: date
""
Example
2020-08-26
rateSource
required

Indicate where this rate originated from. Leave as TRAVELIKO unless you are a channel manager and responsible for the property’s rates externally of this platform.

string
default: TRAVELIKO
Example
TRAVELIKO
master
required

This flag indicates whether this rate is available for this date.

boolean
default: true
Example
true
closedOnArrival
required

This flag indicates whether a guest can arrive at the property on this date.

boolean
Example
true
closedOnDeparture
required

This flag indicates whether a guest can leave the property on this date.

boolean
Example
true
numberOfUnits

Update the amount of rooms available for this date range. Leave empty if you don’t want to update this property.

integer format: int32
""
Example
10
rate
object
amount
required
number
currency
required
string
>= 1 characters
minLengthOfStay

Control the minimum length of stay at the day-level. This means that a guest arriving within this date range is required to stay at least these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
""
Example
4
maxLengthOfStay

Control the maximum length of stay at the day-level. This means that a guest arriving within this date range is required to stay no longer than these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
""
Example
8
singleOccupancyRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
Example
0.25
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
extraPaxRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
Example
0.25
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
extraChildRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
Example
0.25
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters

OK

Media type application/json
Array<object>

Holds all the information for one rate date

object
id

Document UUID

string
""
hotelIdentifier
required

Owner of daily rate.

string format: uuid
"" >= 1 characters
rateSource
required

Indicate where this rate originated from. Leave as TRAVELIKO unless you are a channel manager and responsible for the property’s rates externally of this platform.

string
default: TRAVELIKO >= 1 characters
ratePlanIdentifier
required

Rate plan associated with this daily rate.

string format: uuid
"" >= 1 characters
guestRoomIdentifier
required

Guest room associated with this daily rate.

string format: uuid
"" >= 1 characters
rate
required

Guest room associated with this daily rate.

number
""
currencyCode
required

The currencyCode property operates in.

string
"" >= 1 characters
master
required

This flag indicates whether this rate is available for this date.

boolean
default: true
closedOnArrival
required

This flag indicates whether a guest can arrive at the property on this date.

boolean
closedOnDeparture
required

This flag indicates whether a guest can leave the property on this date.

boolean
day

Day of month

integer format: int32
""
month

Month

integer format: int32
""
year

Year

integer format: int32
""
quantity

Amount of rooms available for this date.

integer format: int32
0
minLengthOfStay

Control the minimum length of stay at the day-level. This means that a guest arriving within this date range is required to stay at least these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
maxLengthOfStay

Control the maximum length of stay at the day-level. This means that a guest arriving within this date range is required to stay no longer than these number of days in order to get this rate. Leave empty if you don’t want to update this property.

integer format: int32
default: -1
singleOccupancyRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
extraPaxRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
extraChildRateModifier
object
type
required

When the type is FIXED, fixedAmount is required. When the type is PERCENTAGE, percent is required.

string
""
Allowed values: FIXED PERCENTAGE
percent

A percentage of the total stay amount for an early check-in or late check-out

number format: float
""
fixedAmount

A localized amount

object
amount
required
number
currency
required
string
>= 1 characters
ttl
required

When this rate can be safely removed.

string format: date-time
""
available
boolean
Example
[
null
]

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
"type": "https://example.com",
"title": "example",
"status": 1,
"detail": "example",
"instance": "https://example.com",
"properties": {
"additionalProperty": "example"
}
}

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

Internal Server Error

object
Example generated
{}