header

object

Y

 /

 /

@supplierId

string

Y

The ID of hotel supplier in DerbySoft's system.

Max Length: 32

HILTON

@distributorId

string

Y

The ID of the distributor in DerbySoft's system

Max Length: 32

GTA

@version

string

Y

Version of API

Max Length: 20

v4

@token

string

Y

A unique identifier is used for requests and responses, typically a UUID. Note that this is an echo token, not an access token.

Max Length: 64

18393849028490234

reservationIds

 /

Y

 /

 /

@distributorResId

string

Y

Distributor's reservation ID. Distributors should keep the ID unique on their system to avoid any potential issues caused by duplicate reservation IDs.

PS: If distributors don't generate reservation IDs during the stage, you can fill in a blank value in the request for the field like distributorResId="", but the null value is not accepted since it's a mandatory field.

C2084DFL0

iata

string

N

IATA

 /

hotelId

string

Y

Hotel IDs provided by hotel suppliers, only the following characters are allowed.

1. Digits (0-9) 

2. Uppercase letters (A-Z) 

3. Hyphen ('-')

100001

GATHI

00016

PEP-B3T2

B8W7

stayRange

object

Y

 /

 /

@checkin

string

Y

Check in date expressed YYYY-MM-DD

2028-01-01

@checkout

string

Y

Check out date expressed YYYY-MM-DD

2028-01-04

contactPerson

object

Y

 /

 /

@firstName

string

Y

Contact person first name

James

@lastName

string

Y

Contact person last name

Bond

@email

string

N

Contact person email

007@james.com

@phone

string

N

Contact person phone number, including country code

34123456789

@address

string

N

Contact person home address

King's Road in Chelsea, specifically in Wellington Square

roomCriteria

object

Y

 /

 /

@roomCount

integer

Y

Total room count per request

 /

@adultCount

integer

Y

Adult count per room

 /

@childCount

integer

N

Child count per room

 /

@childAges

array

N

Child ages for each child, array size MUST be the same as the child count

 /

total

object

Y

Object used to share the total amount of the reservation, either ABT or AAT, or both

 /

@amountBeforeTax

number

C

ABT, mandatory if AAT is not provided

640

@amountAfterTax

number

C

AAT, mandatory if ABT not provided

The total room rate for the entire reservation,  including taxes and fees.

700

payment

object

No

It is used to share payment information with property.

If the credit card information is not going to be passed to the property, this information will be ignored.

 /

@cardCode

string

Y

VI, MC, AX, etc.

Card Code

VI

@cardNumber

string

C

Credit card number

4111111111111111

@cardHolderName

string

C

Cardholder name

Sherlock Holmes

@expireDate

string

C

It should be 2 digits for month, 2 digits for year, expressed MMYY

0119

Card verification value

loyaltyAccount

object

N

 /

 /

@programCode

string

C

Loyalty program code of the supplier

BW

@accountId

string

C

Loyalty program account ID

1234567890123457

corpAccount

object

N

Please note that the current feature will be deprecated. Instead, please implement the 'corpCodes' node.

 /

@corpProgramCode

string

C

Corporate Hotel Program of hotel supplier

CR

@corpId

string

C

Corporate ID in the program account

A-1232

promoteCode

string

N

Promotion code defined by the hotel, the promotion code is required if making a reservation under the promotion

 /

guests

array[object]

Y

 /

 /

@firstName

string

Y

Guest First Name

James

@lastName

string

Y

Guest Last Name

Bond

@email

string

N

Guest Email

007@james.com

@phone

string

N

Guest phone number including country code

34123456789

@address

string

N

Guest home address

King's Road in Chelsea, specifically in Wellington Square

@age

integer

N

Age of guest

 /

@type

string

N

Enum: [ Adult, Child, Infant ]

Type of guest

Adult

@index

integer

N

Indicate guest will be allocated to which room.

For a one-room reservation, the room index is 1 for all guests.

For multi-room reservations, the index starts from 1, and the max room index is equal to the number of booked rooms.

index = 1, Indicate the guest will be allocated to the first room.

index = 2, Indicate the guest will be allocated to the second room.

comments

array[string]

N

Any preference or comment can be communicated in this field

[ "no smoking", "high floor" ]

roomRates

array[object]

Y

Min Items: 1 Max Items: 1

meal plan, fee, and cancel policy are optional fields as some distributors do not support these in the API.

 /

@roomId

string

Y

Room ID in supplier's system

10000101

@rateId

string

Y

Rate ID in supplier's system

123456

@currency

string

Y

Currency code [ISO-4217]

USD

@amountBeforeTax

array[number]

N

ABT, mandatory if AAT is not provided

[ 100, 100, 120 ]

@amountAfterTax

array[number]

C

AAT, mandatory if ABT is not provided

The daily amount of rate with tax and fee

[ 110, 110, 130 ]

@mealPlan

string

N

Meal plan code, refers to the standard meal plan code list.

RO

@paymentType

enum

N

Indicates the product is prepaid to the hotel (PayNow) or pay at the hotel (PayLater)
Enum: [ PayLater, PayNow ]

PayNow

rguarantee

object

N

Guarantee information for this room rate.

 /

@guaranteeType

string

C

The type of guarantee method, refers to the standard guarantee type list.

CCG

fees

array[object]

N

Fee or tax by date range.

 /

dateRange

object

C

 /

 /

@startDate

string

C

Start date expressed as YYYY-MM-DD

2028-01-01

@endDate

string

C

End date expressed as YYYY-MM-DD

2028-01-04

fee

C

 /

 /

@name

string

C

pattern: \w[\w\d]+ starts with a word character (letter, number, or underscore) followed by one or more word characters or digits.

Service Charge

@type

enum

C

The fee or tax is included in the amount before tax or not

Enum: [ Inclusive, Exclusive ]

Exclusive

@amount

number

C

Amount value of fee or tax

10

@amountType

string

C

Indicates how to charge the tax, 10% per room per night in this example

Enum: [ Fix, Percent ]

Percent

@chargeType

string

C

Enum: [ PerRoomPerNight, PerPersonPerNight, PerRoomPerStay, PerPersonPerStay ]

PerRoomPerNight

@paymentType

enum

N

Enum: [ PayLater, PayNow ]

Indicates if the fee is prepaid to hotels(PayNow) or paid at the hotel(PayLater). 

Note:

The 'paymentType' field will be replaced by 'collectBy' and removed from the API in the future.

PayNow

Enum: [Distributor, Property]

Indicates that the fee (e.g., City Tax, Tourist Tax) should be collected by the hotel(Property) at check-in or by distributors when guests make a reservation(Distributor).

@effectivePerson

number

N

It indicates the fee will be charged starting from which occupancy, such as the "Extra Person Charge" fee. The EffectivePerson is 3, meaning an extra fee will be applied from the third person onward.

 /

cancelPolicy

object

N

Cancellation policy defines what penalty will be charged when a guest cancels the booking at a certain advance time range. The penalty is related to No-show or a time range before No-show

 /

@code

string

C

Code of cancel policy

AD100P_100P

@description

string

N

MaxLength: 1024

the description of the cancel policy

Non Refundable

cancelPenalties

 array

Y

Details about the cancel Penalty

/ 

@noShow

boolean

Y

If true, it means the penaltyCharge applied for No-Show, and the cancellable, cancelDeadline will NOT exist.

 /

@cancellable

boolean

N

Indicates whether cancel is allowed or not. If false, it cannot be canceled. If true, the cancelDeadline will exist.

 /

cancelDeadline

 object

N

Object that defines the cancel deadline for the reservation.

 /

@offsetTimeDropType

enum

N

Enum: [ BeforeArrival ]

An enumerated type indicates when the deadline drop time goes into effect.

 /

@offsetTimeUnit

enum

N

Enum: [ D, H ]

 /

@offsetTimeValue

number

N

The number of offset times with the time unit/

 /

@deadline

string

N

local deadline allowed for cancellation, like
4 PM, 6 PM.

 /

penaltyCharge

object

N

 /

 /

@chargeBase

enum

N

Enum: [ FullStay, NightBase ]

If FullStay, it will be a percentage or an amount. If NightBase, the nights are required.

 /

@nights

number

N

Exists if the penalty charge is based on the night, like the first night

 /

@amount

number

N

Exists if the penalty charge is a flat charge, like USD 30.00

 /

@percent

number

N

Exists if the penalty charge is a percent, like 15.5 means 15.5%

 /

Note: 

This field is primarily used by Travel Management Companies (TMCs) distributors.

extensions

object

N

Optional: Additional agreed-upon attributes between suppliers and distributors (DerbySoft will provide the specified format). Please don't transmit sensitive information through this field. For more information refer to:

Sensitive Information

 /

header

object

Y

 /

 /

@supplierId

string

Y

MaxLength: 32

The ID of the hotel supplier in DerbySoft's system

HILTON

@distributorId

string

Y

The ID of the distributor in DerbySoft's system

MaxLength: 32

GTA

@version

string

Y

MaxLength: 20

Version of API

v4

@token

string

Y

MaxLength: 64

A unique identifier is used for requests and responses, typically a UUID. Note that this is an echo token, not an access token.

18393849028490234

bookingToken

string

Y

Booking token used for booking

/

extensions

object

N

Optional: Additional agreed-upon attributes between suppliers and distributors (DerbySoft will provide the specified format). Please don't transmit sensitive information through this field. For more information refer to:

Sensitive Information

 /