Demo langsung

API akomodasi

API Akomodasi untuk hotel, apartemen, dan vila sewa

API akomodasi membawa semua jenis penginapan ke situs reservasi Anda: kamar hotel, apartemen berlayanan, rumah liburan, hostel, dan wisma. Halaman ini menjelaskan data di balik sebuah penginapan, aturan yang membedakan sewa dari hotel, dan cara PHPTRAVELS menjual properti milik Anda serta stok pemasok dalam satu pencarian.

  • Properti, unit, tarif, kalender
  • Minimum menginap dan biaya
  • Jendela pembatalan
  • Stok sendiri plus pasokan API

Model data

Empat lapisan di setiap penginapan

Entah hotel 300 kamar atau satu rumah pantai, API akomodasi menggambarkannya dalam empat lapisan bersarang yang sama. Tiap lapisan menjawab pertanyaan berbeda yang diajukan tamu sebelum memesan.

01Properti

Tempatnya sendiri: nama, jenis, alamat dan posisi di peta, foto, fasilitas, peringkat bintang atau kualitas, aturan menginap, dan jam check-in.

property_id · type · address · geo · photos · amenities · check_in_from

02Kamar atau unit

Yang sebenarnya dipesan: satu tipe kamar, satu apartemen utuh, atau satu tempat tidur di asrama, lengkap dengan ukuran, tempat tidur, dan kapasitas maksimum.

unit_id · beds · size_m2 · max_adults · max_children

03Rencana tarif

Cara unit itu dijual: paket makan, kebijakan pembatalan, ketentuan pembayaran, dan siapa yang boleh memesannya, misalnya publik atau khusus agen.

rate_plan_id · board · cancel_policy · payment · channel

04Ketersediaan

Satu baris per malam: harga, sisa unit, minimum menginap, dan apakah kedatangan atau kepergian diizinkan pada hari itu.

date · price · units_left · min_stay · closed_to_arrival

Sebuah gedung, kamar, label tarif, dan kalender digambar sebagai lapisan bertumpuk dari satu listing akomodasi

PHPTRAVELS menamai modul akomodasinya Stays karena model yang sama mencakup jauh lebih banyak daripada hotel. Sebuah properti memuat unit, sebuah unit dijual lewat satu atau beberapa rencana tarif, dan setiap rencana tarif punya kalender per malam berisi harga dan ketersediaan. Jika keempat lapisan ini benar, tempat tidur hostel, suite hotel, dan vila tiga kamar semuanya muat dalam pencarian dan checkout yang sama.

Pemasok menamai lapisan-lapisan ini secara berbeda, dan sebagian menggabungkan dua di antaranya, tetapi strukturnya selalu ada. Hotel memetakan setiap sumber ke struktur itu, sehingga tamu melihat satu halaman yang konsisten.

Malam demi malam

Kalender ketersediaan menentukan penginapan laku atau tidak

Setiap API akomodasi berujung pada kalender. Pencarian hanya menampilkan properti jika setiap malam dalam masa menginap yang diminta tersedia, berharga, dan diizinkan oleh aturan menginap.

Apartemen dua kamar · Tarif standarNovember 2026 · Harga per malam
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • Tersedia, berharga per malam
  • Sudah dipesan
  • Ditutup oleh pemilik
  • Minimum menginap dari kedatangan ini
  • Tertutup untuk kedatangan

Data ilustrasi, disederhanakan

  • Harga dihitung per malamTotal menginap adalah jumlah tiap malam, jadi Jumat dan Sabtu dengan tarif akhir pekan lebih mahal daripada dua hari kerja. Harga harian dan musiman ada di kalender, bukan di properti.
  • Aturan minimum menginapMinimum tiga malam untuk kedatangan hari Jumat menyembunyikan unit dari pencarian dua malam. Penyewaan jauh lebih sering memakai aturan ini dibanding hotel, sering lebih ketat saat akhir pekan dan musim ramai.
  • Tertutup untuk kedatangan atau kepergianSebuah malam bisa dipesan sebagai bagian dari menginap lebih lama, tetapi tidak sebagai malam pertama atau terakhir. Hari pergantian tamu pada rumah liburan bekerja seperti ini.
  • Malam tertutup dan stop-sellPemilik memblokir tanggal untuk pemakaian sendiri atau perawatan, dan stop-sell langsung menarik unit dari penjualan. Satu malam yang tertutup di dalam tanggal yang diminta akan mengeluarkan unit dari hasil pencarian.

Tidak semua penginapan adalah hotel

Hotel, apartemen, dan vila sewa

Model datanya sama, tetapi tiap jenis penginapan mengisinya secara berbeda. Inilah perbedaan yang harus ditangani alur pemesanan Anda saat menjual lebih dari sekadar kamar hotel.

Hotel

Termasuk hostel dan wisma

Yang dipesan
Satu tipe kamar dengan banyak kamar identik, atau satu tempat tidur di asrama bersama.
Harga
Tarif per malam per kamar dan paket makan; tambahan dewasa atau anak bisa mengubahnya.
Aturan menginap
Minimum menginap hanya pada tanggal ramai; kebanyakan malam bisa dipesan sendiri-sendiri.
Biaya dan deposit
Pajak kota atau wisata, kadang biaya resor yang dibayar di properti.
Kedatangan
Resepsionis 24 jam atau berstaf; jam check-in di voucher sudah cukup.
Sumber umum
Bedbank dan grosir, kontrak langsung, channel manager.

Apartemen berlayanan

Apart-hotel dan apartemen kota

Yang dipesan
Satu tipe unit, biasanya dengan dapur dan kamar tidur terpisah.
Harga
Tarif per malam per unit, dengan harga mingguan atau bulanan untuk menginap lama.
Aturan menginap
Minimum menginap lazim, dan menginap lama menjadi bagian besar permintaan.
Biaya dan deposit
Biaya kebersihan per menginap dan deposit yang dapat dikembalikan itu lazim.
Kedatangan
Jam resepsionis bervariasi; kedatangan larut malam butuh kotak kunci atau kode.
Sumber umum
Channel manager, kontrak langsung, dan beberapa grosir.

Vila sewa

Rumah liburan, vila, dan kabin

Yang dipesan
Satu rumah tertentu. Biasanya hanya ada satu.
Harga
Tarif per malam untuk seluruh rumah, ditambah biaya per tamu tambahan di atas jumlah dasar.
Aturan menginap
Minimum menginap, hari pergantian tetap, dan tanggal tertutup untuk kedatangan adalah hal biasa.
Biaya dan deposit
Biaya kebersihan, deposit kerusakan yang dapat dikembalikan, dan pajak daerah, masing-masing ditampilkan sebelum pembayaran.
Kedatangan
Petunjuk check-in, alamat, dan kontak dikirim sebelum kedatangan, tidak pernah di halaman publik.
Sumber umum
Pemilik dan pengelola properti, langsung atau lewat channel manager.

Menjual rumah dari banyak tuan rumah, bukan dari kontrak Anda sendiri? Itu marketplace, dibahas di halaman Portal BnB.

Jendela kebijakan pembatalan

Satu pemesanan, tiga jendela pembatalan

Kebijakan pembatalan adalah garis waktu yang dihitung mundur dari tanggal kedatangan. Setiap jendela menyatakan apa yang diterima kembali oleh tamu jika membatalkan di dalamnya.

PemesananCheck-in
  1. 01 · Hingga 14 hari sebelum kedatanganPembatalan gratisTamu membatalkan dan dananya dikembalikan penuh. Ini batas waktu yang pertama dicari wisatawan, jadi tampilkan sebagai tanggal, bukan aturan.
  2. 02 · 14 hingga 3 hari sebelumDenda sebagianDenda berlaku, sering kali malam pertama atau persentase dari total menginap. Penyewaan dapat menahan deposit dalam jendela ini.
  3. 03 · 3 hari terakhir dan tidak datangTidak dapat dikembalikanSeluruh jumlah ditahan. Tarif yang dijual sebagai tidak dapat dikembalikan masuk ke jendela ini sejak saat pemesanan.
Contoh jendela; setiap rencana tarif punya jendelanya sendiri.
  • Per rencana tarif, bukan per propertiApartemen yang sama bisa punya tarif fleksibel dan tarif non-refundable yang lebih murah, sehingga kebijakan berada di lapisan rencana tarif.
  • Tanggal dalam zona waktu properti"14 hari sebelum" dihitung dari tanggal kedatangan di lokasi properti. Ubah menjadi tanggal dan jam yang jelas di halaman dan di voucher.
  • Kebijakan pemasok yang berlakuDengan stok API, Anda tidak bisa menawarkan ketentuan yang lebih longgar daripada pemasok. Dengan kontrak sendiri, Anda menentukan jendelanya.

Stok sendiri dan stok API

Properti berkontrak Anda dan API pemasok dalam satu pencarian

Kebanyakan penjual akomodasi melakukan keduanya: memasukkan tempat yang mereka kontrak sendiri dan menambah API pemasok untuk sisanya. Wisatawan tidak perlu tahu dari mana asal sebuah penginapan.

Properti milik Anda

  • Masukkan sendiri properti, unit, dan rencana tarif di admin
  • Beri pemilik dan hotel login extranet untuk mengelola kalender mereka
  • Atur harga, minimum menginap, tanggal tertutup, dan jendela pembatalan
  • Allotment dengan hari pelepasan dan stop-sell
  • Atau terima tarif dan ketersediaan dari channel manager

Stok pemasok lewat API

  • Katalog besar di destinasi yang tak mungkin Anda kontrak sendiri
  • Harga dan ketersediaan langsung saat pencarian
  • Paket makan, kebijakan, dan biaya pemasok pada setiap tarif
  • Diaktifkan dengan kontrak dan kredensial pemasok Anda sendiri
  • Pemesanan dan pembatalan dikirim langsung ke pemasok

Yang diterima tamu

  • Satu daftar hasil dengan satu halaman properti per tempat
  • Kamar yang sama dari beberapa sumber ditampilkan sekali, dengan harga Anda
  • Markup Anda per pemasok, destinasi, atau kanal, plus tarif agen B2B
  • Satu format voucher, apa pun sumber yang mengonfirmasi

Cara menghubungkan channel manager dibahas di Integrasi channel manager. Untuk kamar yang Anda pegang lewat kontrak, lihat Sistem inventaris pemesanan.

Siap di PHPTRAVELS

Pemasok akomodasi yang sudah terhubung

Pemasok akomodasi ini sudah terhubung ke modul Stays. Anda menandatangani kontrak dengan pemasok, memasukkan kredensial sendiri di admin, menguji di sandbox mereka, lalu tayang. Daftarnya diambil langsung dari direktori integrasi kami.

Butuh pemasok yang tidak ada di daftar, misalnya jaringan sewa regional? API akomodasi apa pun yang punya dokumentasi dapat ditambahkan, lihat Integrasi API kustom. Untuk jenis pemasok hotel dan pemetaan konten, baca halaman API Hotel, serta dua panduan bedbank terbesar: Integrasi API RateHawk dan Integrasi Hotelbeds API.

Pesan penginapan seperti yang akan dilakukan tamu Anda

Cari, bandingkan tarif, dan pesan di demo langsung, lalu beri tahu kami properti dan pemasok apa yang ingin Anda jual.

Coba demo langsungTanyakan soal pemasok Anda

Membangun aplikasi sendiri atau feed mitra? REST API PHPTRAVELS menyajikan semua sumber akomodasi yang terhubung dalam satu format, dengan webhook untuk peristiwa pemesanan. Tersedia di paket Enterprise, lihat Harga dan dokumentasi developer. Gambaran lebih luas ada di API travel.

FAQ

API Akomodasi: pertanyaan developer dan agensi

Hubungi sales

API akomodasi adalah sekumpulan layanan web yang memungkinkan situs reservasi mencari penginapan, membaca harga dan ketersediaan untuk tanggal dan jumlah tamu tertentu, serta membuat, membaca, dan membatalkan pemesanan. Cakupannya hotel dan jenis penginapan lain: apartemen, vila sewa, hostel, dan wisma.

Panggilan intinya sama. API akomodasi juga harus menangani kebutuhan penginapan non-hotel: pemesanan satu unit utuh, minimum menginap dan hari pergantian tamu, biaya tamu tambahan, biaya kebersihan, deposit yang dapat dikembalikan, dan petunjuk check-in yang dikirim sebelum kedatangan.

Bisa. Di PHPTRAVELS, modul Stays memakai satu model properti, unit, rencana tarif, dan ketersediaan untuk setiap jenis akomodasi, sehingga hotel, apartemen, dan rumah liburan muncul di pencarian yang sama dengan aturannya masing-masing.

Setiap malam di kalender dapat memiliki lama menginap minimum, biasanya terkait tanggal kedatangan. Jika tamu mencari lebih sedikit malam dari minimum, unit tidak dikembalikan. Penanda tertutup untuk kedatangan dan kepergian bekerja dengan cara yang sama untuk hari pergantian tamu.

Bisa. Anda dapat menambahkan properti, unit, rencana tarif, dan kalender sendiri, memberi pemilik login extranet, atau menerima tarif dari channel manager, lalu menjualnya berdampingan dengan stok pemasok dalam satu daftar hasil.

Dari rencana tarif. Stok pemasok membawa kebijakan pemasok, sedangkan properti milik Anda memakai jendela yang Anda atur. Batas waktunya ditampilkan kepada tamu sebelum pembayaran dan dicetak di voucher.

Tidak. Anda menandatangani kontrak dengan setiap pemasok akomodasi dan memasukkan kredensial sendiri di admin. PHPTRAVELS menyediakan platform pemesanan, modul Stays, dan konektor siap pakai.

Bisa. Pada paket Enterprise, REST API PHPTRAVELS membuka pencarian dan pemesanan di semua sumber yang terhubung dalam satu format, dengan webhook untuk peristiwa pemesanan dan kode sumber lengkap untuk dikembangkan.

Lisensi PHPTRAVELS, domain sendiri, dan minimal satu sumber stok: properti yang Anda kontrak sendiri, channel manager, atau kontrak pemasok dengan grosir akomodasi. Demo langsung menunjukkan alur lengkapnya lebih dulu.

Jelajahi lebih lanjut

Selengkapnya tentang platform