Objek API Hotel

---

• User
• Negara
• Kota
• Jumlah Tamu
• Tamu Utama
• Alamat
• Properti
• Kamar
• Grup Kamar

User

Objek user. Muncul pada response Booking dan Detail Booking.

Parameter	Deskripsi	Tipe	Catatan
code	Kode produk Anda	String
balance	Saldo akhir setelah transaksi	Float	Hanya muncul pada endpoint transaksi (booking dan detail booking)

Contoh

{
  "code": "skuhotel",
  "balance": 99412887972
}

Negara

Attribute	Deskripsi	Tipe
name	Nama negara	String
code	Kode negara (ISO alpha-2)	String

Contoh

{
  "name": "Indonesia",
  "code": "ID"
}

Kota

Attribute	Deskripsi	Tipe
id	ID kota	String
name	Nama kota	String
province_name	Nama provinsi	String
keywords	Kata kunci kota	Array of String
latitude	Latitude kota	String
longitude	Longitude kota	String

Contoh

{
  "id": "V1A7Q",
  "name": "Jakarta",
  "province_name": "DKI Jakarta",
  "keywords": [
    "Jakarta",
    "DKI Jakarta",
    "Jawa"
  ],
  "latitude": "-6.21462000",
  "longitude": "106.84513000"
}

Jumlah Tamu

Attribute	Deskripsi	Tipe	Catatan
total_room	Jumlah kamar	Int
total_adult	Jumlah orang dewasa (1 - 4)	Int
total_child	Jumlah anak-anak (0 - 2)	Int
child_age	Umur anak-anak, hingga 18 tahun. Sesuaikan dengan jumlah total_child	Array of Int	Hanya pada request Inisiasi

Contoh

{
  "total_room": 1,
  "total_adult": 2,
  "total_child": 2,
  "child_age": [2, 5]
}

Tamu Utama

Attribute	Deskripsi	Tipe	Catatan
salutation	Sapaan tamu utama: Mr, Mrs, Ms	String
first_name	Nama depan	String
last_name	Nama belakang	String

Contoh

{
  "salutation": "Ms",
  "first_name": "Jane",
  "last_name": "Doe"
}

Alamat

Attribute	Deskripsi	Tipe	Catatan
area	Area lokasi properti	String	Dapat digunakan ketika melakukan filter
line_1	Alamat baris ke-1	String	Nama jalan, nomor bangunan, dan nama wilayah. Muncul pada Detail Properti, Recheck, dan Booking
line_2	Alamat baris ke-2	String	Hanya muncul jika properti memiliki alamat baris ke-2

Contoh Inisiasi / Filter

{
  "area": "City Center"
}

Contoh Detail Properti / Recheck / Booking

{
  "line_1": "Jalan MH Thamrin 1, Central Jakarta",
  "area": "City Center"
}

Properti

Attribute	Deskripsi	Tipe	Catatan
id	ID properti	String
name	Nama properti	String
star	Kategori bintang properti	Int
type	Tipe properti	String	Contoh: hotel, resort, aparthotel
latitude	Latitude	String
longitude	Longitude	String
main_photo	Foto properti	String
address	Alamat properti	Object
desc	Deskripsi properti	String	Detail Properti
check_in_time	Waktu check in HH:MM:SS	String	Format 24 jam
check_out_time	Waktu check out HH:MM:SS	String	Format 24 jam
website	Website resmi properti	String
facilities	Fasilitas properti	Array of String
rooms	Kamar yang tersedia dan tarifnya	Array	Tidak muncul pada response Booking
room_summary	Ringkasan kamar	Object	Hanya pada Inisiasi dan Filter
room_summary.min_total_price	Harga kamar termurah	Int
room_summary.total_available_room	Total kamar yang tersedia	Int

Contoh Inisiasi / Filter

{
  "id": "jkt1",
  "name": "Hotel Indonesia Kempinski Jakarta",
  "star": 5,
  "type": "hotel",
  "main_photo": "https://ik.imagekit.io/vcrk/dev/hotel",
  "address": {
    "area": "City Center"
  },
  "room_summary": {
    "min_total_price": 3316126,
    "total_available_room": 3
  }
}

Kamar

Attribute	Deskripsi	Tipe	Catatan
name	Nama kamar	String
photos	Foto-foto kamar	Array of String	Hanya muncul jika properti memiliki foto
messages	Pesan terkait kebijakan penggunaan kamar	Array of String	Hanya muncul jika ada pesan
min_total_price	Tarif kamar termurah pada suatu tipe kamar	Int
groups	List tarif kamar	Array of Grup Kamar
size	Ukuran kamar	String	Detail Properti
max_adult	Jumlah maksimal orang dewasa	Int	Detail Properti
max_child	Jumlah maksimal anak-anak	Int	Detail Properti
facilities	Fasilitas kamar	Array of String	Detail Properti

Contoh Detail Properti

{
  "name": "Deluxe King Bundaran HI View",
  "photos": [
    "https://ik.imagekit.io/vcrk/dev/hotel,room,bed"
  ],
  "messages": [
    "With 64 sqm, One king bed, Overlooking to Bundaran HI"
  ],
  "min_total_price": 2978927,
  "groups": [
    {
      "group_id": "jkt1g1-success",
      "plan": "RO",
      "plan_label": "Hanya Kamar",
      "cancel_plan": "NRF",
      "is_smoking": false,
      "total_price": 2978927,
      "details": [
        {
          "price": 2978927,
          "room_no": 1
        }
      ]
    }
  ],
  "size": "36.00 Sq.m.",
  "max_adult": 2,
  "max_child": 2,
  "facilities": [
    "Shower",
    "Balcony",
    "Sofa",
    "Wardrobe"
  ]
}

Grup Kamar

Objek tarif kamar pada sesi inisiasi.

Attribute	Deskripsi	Tipe	Catatan
group_id	ID tarif	String	Selalu berbeda tiap sesi inisiasi
plan	Kode paket kamar	String	Contoh: RO (hanya kamar), BF (dengan sarapan)
plan_label	Definisi paket kamar	String
cancel_plan	Kebijakan pembatalan. NRF = tidak bisa refund	String
is_smoking	Kebijakan merokok	Boolean
total_price	Total tarif	Int
details	Detail tarif per kamar	Array
details.*.price	Tarif kamar	Int
details.*.room_no	Urutan kamar	Int

Contoh

{
  "group_id": "023d8a83-b9ae-4622-8930-6d03d65bbd66",
  "plan": "RO",
  "plan_label": "Hanya Kamar",
  "cancel_plan": "NRF",
  "is_smoking": false,
  "total_price": 2978927,
  "details": [
    {
      "price": 2978927,
      "room_no": 1
    }
  ]
}