Demo langsung

Integrasi pemasok hotel

Integrasi Hotelbeds API: konten, pemetaan, dan pemesanan langsung

Integrasi Hotelbeds API terdiri dari dua pekerjaan, bukan satu. Anda mengunduh dan menyimpan konten hotel, lalu memesan berdasarkan tarif langsung. PHPTRAVELS mengerjakan keduanya di dalam modul hotel, dengan kontrak dan kunci Hotelbeds milik Anda sendiri.

  • Sinkronisasi Content API
  • Alur Booking API
  • Tarif BOOKABLE dan RECHECK
  • Pemetaan hotel

Cara API Hotelbeds saling terhubung

Integrasi Hotelbeds API: konten di satu sisi, pemesanan di sisi lain

Hotelbeds membagi API hotelnya menjadi dua. Content API mengembalikan data statis: deskripsi, gambar, fasilitas, jenis makan, dan kamar. Booking API mengembalikan ketersediaan dan harga langsung, serta menerima pemesanan. Pilih langkah di tengah untuk melihat panggilan yang digunakan.

Content API

Statis, disimpan di sisi Anda
  • Daftar hotelhotels · from=1&to=1000Semua hotel dalam portofolio Anda, dalam halaman berisi hingga 1,000 hotel per permintaan.
  • Fasilitas, jenis makan, dan kamarfacilities · boards · roomsTabel kode yang mengubah kode Booking API menjadi kata-kata yang dipahami tamu Anda.
  • Gambarphotos.hotelbeds.com/giata/Jalur gambar parsial, digabungkan dengan host foto Hotelbeds dalam ukuran yang Anda perlukan.
  • Perubahan harianlastUpdateTimeSetelah pemuatan pertama, satu permintaan per hari dengan lastUpdateTime hanya mengembalikan data yang berubah.

Alur permintaan

Booking API

Langsung, dipanggil per tamu
  • KetersediaanPOST /hotelsKamar, jenis makan, harga, dan biaya pembatalan untuk kode hotel, tanggal, dan jumlah tamu Anda.
  • Cek tarifPOST /checkratesHarga dan ketentuan terbaru untuk tarif bertanda RECHECK, beserta opsi upgrade.
  • PemesananPOST /bookingsMengonfirmasi rateKey yang dipilih dengan nama pemesan dan tamu, lalu mengembalikan nomor referensi.
  • PembatalanDELETE /bookings · simulateMenyimulasikan pembatalan untuk menampilkan biayanya, atau membatalkan pemesanan sungguhan.
Layar contoh. Panggilan sesuai dokumentasi di developer.hotelbeds.com; alurnya adalah cara PHPTRAVELS menggunakannya.

Sebagian besar proyek Hotelbeds yang gagal mencampuradukkan kedua sisi ini. Mereka memanggil Content API saat tamu mencari, yang lambat dan, seperti diperingatkan Hotelbeds, dapat membuat kredensial Anda diblokir. Atau mereka mencari secara langsung tanpa kode tersimpan sehingga tidak dapat menampilkan gambar atau fasilitas. PHPTRAVELS memisahkan keduanya: konten disinkronkan di latar belakang, dan hanya panggilan ketersediaan, cek tarif, dan pemesanan yang berjalan saat tamu menunggu.

Jika Anda ingin mengenal pemasoknya sendiri, produknya, dan cara membuka akun, baca profil pemasok Hotelbeds. Halaman ini membahas integrasi teknis.

Jenis tarif

Empat kolom tarif yang mengubah proses checkout Anda

Setiap tarif Hotelbeds membawa beberapa atribut yang menentukan apakah Anda dapat langsung memesannya, harga apa yang boleh ditampilkan, dan siapa yang menerima pembayaran. Inilah kolom yang harus dibaca mesin Anda pada setiap hasil.

KolomKasus pertamaKasus keduaYang dilakukan PHPTRAVELS

Bisa dipesan atau perlu dicek ulang

rateType		BOOKABLE

Tarif sudah terbaru. Anda dapat memesannya tanpa panggilan tambahan.

RECHECK

Anda harus memanggil cek tarif terlebih dahulu untuk mendapatkan harga dan ketentuan terbaru.

Menjalankan cek tarif sebelum langkah pembayaran untuk tarif RECHECK dan menampilkan setiap perubahan kepada tamu.

Net atau komisi

net · sellingRate		net

Model net: harga adalah harga net, jadi Anda menambahkan margin sendiri.

sellingRate

Model komisi: komisi sudah termasuk dalam sellingRate, dan harga itu adalah harga final.

Menerapkan aturan markup Anda pada tarif net dan menjual tarif komisi pada sellingRate.

Harga jual tetap

hotelMandatory		true

hotelMandatory bernilai true: Anda harus menjual pada sellingRate.

false · null

False atau kosong pada tarif net: Anda boleh menetapkan margin sendiri.

Mengunci harga yang ditampilkan pada sellingRate jika hotel mewajibkannya, apa pun aturan markupnya.

Kapan tamu membayar

paymentType		AT_WEB

Pembayaran diambil saat pemesanan dibuat, melalui situs Anda.

AT_HOTEL

Tamu membayar langsung ke hotel.

Memberi label tarif bayar sekarang atau bayar di hotel, dan mengarahkan checkout sesuai label tersebut.

Model harga yang Anda dapatkan bergantung pada kontrak Hotelbeds Anda. Seperti dinyatakan Hotelbeds, manajer penjualan Anda akan merekomendasikan model yang sesuai untuk bisnis Anda.

Pemetaan hotel

Cocokkan hotel Hotelbeds dengan hotel yang sudah Anda jual

Jika Anda memiliki kontrak sendiri atau pemasok kedua, hotel yang sama akan datang dengan kode berbeda. Pemetaan menghubungkannya, sehingga tamu melihat satu hotel dengan tarif terbaik, bukan tiga salinan.

Cara kerja pemetaan di PHPTRAVELS

Setelah setiap sinkronisasi konten, PHPTRAVELS membandingkan hotel Hotelbeds dengan daftar hotel Anda berdasarkan nama, alamat, kota, dan koordinat. Kecocokan yang dekat ditautkan otomatis. Kecocokan yang meragukan menunggu konfirmasi petugas, dan hotel tanpa kecocokan dapat diimpor sebagai properti baru atau diabaikan.

Hotel yang sudah dipetakan berbagi satu halaman, satu galeri, dan satu skor ulasan di Hotel, sementara setiap pemasok tetap memiliki tarif dan aturannya sendiri. Pemetaan yang sama digunakan oleh situs publik dan Portal travel B2B Anda.

Pemetaan hotel
  • Harbour View HotelLisbon48291397%Cocok
  • Old Town SuitesPraha11735492%Cocok
  • Palm Court ResortDubai66201874%Tinjau
  • Casa Azul BoutiqueSevilla–0%Tidak cocok
  • Northern Lights LodgeTromsø90522766%Tinjau
  • Riverside ApartmentsBudapest33076198%Cocok

Layar contoh dengan hotel dan kode fiktif.

Hotelbeds XML atau JSON

Setiap permintaan ditandatangani, dan pengujian dimulai dari skala kecil

Banyak tim masih mencari Hotelbeds XML, tetapi dokumentasi saat ini menunjukkan permintaan JSON. Apa pun formatnya, operasinya sama, dan setiap permintaan membawa dua header.

availability-request.sh (contoh)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
Dua header
Api-key berisi kunci Anda, dan X-Signature: hash SHA256 dari kunci, secret, dan waktu saat ini dalam detik.
Host pengujian
Seperti dinyatakan Hotelbeds, server pengujian sama dengan produksi, tetapi pemesanan di sana tidak nyata dan kartu tidak ditagih.
50 permintaan per hari
Kunci baru membuka lingkungan evaluasi dengan kuota 50 permintaan per hari. Kuota bertambah setelah sertifikasi.
Tanpa panggilan konten langsung
Hotelbeds memperingatkan bahwa memanggil Content API secara real time dapat membuat kredensial diblokir. PHPTRAVELS tidak pernah melakukannya.

Perencana sinkronisasi konten

Berapa banyak panggilan Content API yang dibutuhkan daftar hotel Anda

Seperti dinyatakan Hotelbeds, daftar hotel dikirim dalam halaman berisi hingga 1,000 hotel, dan setelah pemuatan pertama, satu permintaan lastUpdateTime per hari hanya mengembalikan perubahan. Masukkan angka Anda untuk merencanakan sinkronisasi.

Permintaan untuk pemuatan penuh pertama
20
Permintaan per pembaruan harian
3
Hari untuk memuat sekali dengan kuota evaluasi
1

Hanya perkiraan, untuk daftar hotel. Tabel kode dan gambar menambah beberapa panggilan. Dengan kuota evaluasi 50 permintaan per hari, uji dengan satu destinasi terlebih dahulu.

Daftar periksa go-live

Yang perlu disiapkan sebelum beralih ke live

Hotelbeds memindahkan Anda dari evaluasi ke sertifikasi lalu ke kunci live melalui dasbornya. Inilah poin yang harus dicakup lebih dulu oleh integrasi Hotelbeds API, dan cara PHPTRAVELS mencakupnya.

  • Kunci evaluasi ditambahkan di admin, host pengujian dipilih
  • Content API tersinkron ke database Anda, dengan pembaruan harian terjadwal
  • Hotel dipetakan ke daftar Anda, kecocokan yang meragukan sudah ditinjau
  • Tarif RECHECK melewati cek tarif sebelum pembayaran
  • sellingRate dipatuhi saat hotelMandatory bernilai true
  • Catatan tarif dan biaya pembatalan ditampilkan sebelum tamu membayar
  • Voucher menampilkan referensi Hotelbeds dan catatan tarif
  • Pembatalan disimulasikan dulu, lalu dikonfirmasi, dengan biaya tercatat

Langkah sertifikasi dan akses live ditetapkan oleh Hotelbeds sesuai kontrak dan pasar Anda.

Biaya

Satu lisensi untuk mesin, kontrak Anda sendiri dengan Hotelbeds

PHPTRAVELS adalah lisensi sekali bayar dengan kode sumber. Hotelbeds adalah perjanjian terpisah antara Anda dan Hotelbeds, sehingga tarif net dan kunci tetap milik Anda.

Startup
Lisensi sekali bayar
lisensi sekali bayar
Agensi
Lisensi sekali bayar
lisensi sekali bayar
Enterprise
Lisensi sekali bayar
lisensi sekali bayar

Hotelbeds adalah salah satu dari beberapa sumber hotel yang dapat Anda jalankan berdampingan. Lihat cara kerjanya bersama RateHawk di ikhtisar API perjalanan, atau bandingkan pemasok di daftar pemasok XML.

Lihat hargaCoba demo hotel

FAQ

Pertanyaan seputar integrasi Hotelbeds API

Hal yang ditanyakan developer dan perusahaan perjalanan sebelum menghubungkan Hotelbeds.

Hubungi sales

Dua bagian. Sinkronisasi latar belakang dengan Content API yang menyimpan hotel, gambar, fasilitas, jenis makan, dan kamar di database Anda, serta alur langsung dengan Booking API untuk ketersediaan, cek tarif, pemesanan, dan pembatalan. PHPTRAVELS menjalankan keduanya di modul hotel.

Orang masih menyebutnya Hotelbeds XML, tetapi dokumentasi Hotelbeds saat ini menunjukkan permintaan dan respons JSON. Operasinya sama, dan PHPTRAVELS menangani formatnya untuk Anda.

Tarif BOOKABLE sudah terbaru dan dapat langsung dipesan. Tarif RECHECK memerlukan panggilan cek tarif terlebih dahulu, yang mengembalikan harga dan ketentuan terkini. PHPTRAVELS melakukan panggilan itu sebelum langkah pembayaran.

Karena lambat, dan Hotelbeds memperingatkan bahwa menggunakan Content API secara real time dapat menyebabkan kredensial diblokir. Konten sebaiknya diunduh per halaman, disimpan, dan diperbarui sekali sehari dengan lastUpdateTime, seperti cara kerja PHPTRAVELS.

Ya. Anda mendaftar ke Hotelbeds, menandatangani kontrak, dan menerima API key serta secret milik Anda sendiri. Kunci baru bekerja di lingkungan evaluasi dengan 50 permintaan per hari hingga Anda menyelesaikan sertifikasi.

Bisa. Pemetaan hotel menghubungkan properti yang sama dari berbagai sumber, sehingga tamu melihat satu hotel dengan tarif terbaik yang tersedia, sementara setiap sumber tetap memiliki markup dan aturannya sendiri.

Paket PHPTRAVELS mulai dari sebagai lisensi sekali bayar dengan kode sumber. Kontrak Hotelbeds Anda terpisah dan disepakati langsung dengan Hotelbeds. Lihat halaman harga atau hubungi tim penjualan untuk penawaran.

Jelajahi lebih lanjut

Selengkapnya tentang platform