Lewati ke konten
Blog

API booking hotel dan tiket pesawat: satu perjalanan, dua pemesanan

Redaksi Tekravel
Ditulis dengan bantuan AI

Tiketnya berbunyi: "tambahkan hotel ke alur penerbangan, satu checkout, satu total". Permintaan yang wajar dari product manager, dan kedengarannya pekerjaan sehari, karena pencarian penerbangan sudah ada dan halaman pembayaran juga sudah ada. Tiga minggu kemudian tim berdebat tentang apa yang harus terjadi ketika maskapai mengonfirmasi dan hotel tidak. API booking hotel dan tiket pesawat bukan satu integrasi dengan dua jenis hasil. Ini dua integrasi yang berbagi satu keranjang.

Semakin cepat kode mengakuinya, semakin sedikit yang harus ditulis ulang. Berikut bagian yang dilewati panduan integrasi: bagaimana kedua separuh berbeda, mana yang dikunci lebih dulu, dan harus menjadi apa sebuah perjalanan di model data Anda.

Kedua separuh tidak berperilaku sama

Keduanya kembali sebagai JSON dengan harga dan referensi, jadi di jaringan keduanya terlihat mirip. Keduanya tidak mirip dalam hal apa yang dijanjikan setelah referensi ada di tangan Anda.

PertanyaanPenerbanganHotel
Apa yang Anda pegang setelah bookingReservasi (PNR) yang belum menjadi tiketKonfirmasi yang biasanya sudah merupakan barang yang Anda jual
Berapa lama harga berlakuSampai tarif dihitung ulang saat booking, yang bisa berbeda dari hasil pencarianSampai rate kedaluwarsa, dan rate bisa berubah antara ketersediaan dan booking
Apa yang mengonfirmasinyaPenerbitan tiket, sering dengan batas waktuKonfirmasi pemasok, kadang langsung, kadang tertunda
Bagaimana membatalkannyaVoid bila tertangkap lebih awal, selain itu refund sesuai aturan tarif, sering dengan penaltiPembatalan menurut kebijakan rate itu sendiri, gratis sampai batas waktu di banyak rate
Apa yang mengubah angka di akhirTarif, pajak, kadang mata uang tarifPajak dan biaya yang dibayar di properti, jenis makan, kamar yang benar-benar diberikan

Anda boleh tidak setuju dengan satu baris, karena pemasok berbeda-beda, tetapi tidak dengan bentuknya: satu separuh punya langkah penerbitan tiket dan yang lain punya jendela pembatalan, dan keduanya tidak sejajar dalam waktu. Sisi penerbangan kami bahas di integrasi API booking penerbangan, dan masalah pemasok lambat di sisi hotel di desain klien API ketersediaan hotel. Tulisan ini dimulai di tempat keduanya berakhir, di sambungan.

Mana yang dipesan lebih dulu?

Tidak ada yang memberi tahu Anda bahwa ini keputusan desain, dan justru keputusan inilah yang menentukan biaya sebuah kegagalan.

Misalkan pelanggan membeli penerbangan dan hotel untuk tanggal yang sama. Anda mengirim satu booking lalu yang lain. Tiga hal bisa terjadi: keduanya berhasil, atau satu gagal, atau satu gagal setelah yang lain sudah berhasil. Yang pertama adalah hari yang baik. Dua lainnya menentukan antrean support Anda.

Jika Anda menerbitkan tiket lebih dulu lalu hotel menolak, Anda punya pelanggan dengan kursi ke sebuah kota tanpa kamar, yang sudah ditagih, dan refund atas tiket yang dikenai penalti. Jika Anda memesan hotel lebih dulu lalu penerbangan gagal, Anda memegang kamar yang sering bisa dibatalkan gratis, jadi perbaikannya murah. Risiko sebaliknya juga nyata, karena rate hotel yang tidak bisa dibatalkan adalah hal yang lebih buruk untuk dipegang, jadi baca syarat pembatalan rate sebelum membiarkannya jalan lebih dulu.

Ini patokan praktis, bukan hukum, dan intinya Anda memilih urutan dengan sengaja. Kunci separuh yang lebih mudah dibatalkan sebelum yang lebih sulit, periksa harga keduanya tepat sebelum salah satunya dikunci, dan tuliskan apa yang Anda lakukan untuk masing-masing dari tiga hasil. Reviewer jarang bertanya. Pelanggan selalu tahu.

Satu perjalanan, dua pemesanan

Bentuk yang bertahan adalah catatan perjalanan yang memiliki dua booking, masing-masing dengan referensi, status, dan ketentuannya sendiri. Pelanggan melihat satu total. Database melihat dua baris, dan totalnya adalah jumlah yang Anda hitung, bukan sesuatu yang ada di pemasok.

Pisahkan kedua status. "Terkonfirmasi" untuk hotel dan "tiket terbit" untuk penerbangan bukan keadaan yang sama, dan satu kolom status yang meratakan keduanya cepat atau lambat akan menulis "terpesan" pada perjalanan yang baru setengah terpesan.

Pisahkan juga kedua set ketentuan perubahan, dan tampilkan. Total yang ditampilkan menyembunyikan bahwa memindahkan tanggal adalah perubahan gratis di satu separuh dan berbiaya di separuh lain. Jika frontend menampilkan "ubah tanggal" sebagai satu tombol, putuskan apa yang dilakukannya bila hanya satu separuh yang bisa dipindah, sebelum pelanggan mengetahuinya lebih dulu. Hal yang sama berlaku untuk markup: jika Anda menambahkannya per layanan, seperti kebanyakan penjual, total perjalanan adalah dua markup, dan refund untuk satu separuh harus tahu markup mana yang dikembalikan. Uang adalah tempat perjalanan gabungan menjadi mahal, karena tiap baris diselesaikan pada jadwal yang berbeda, dan refund penerbangan tidak tiba bersamaan dengan pembatalan hotel.

Posisi platform ini

Terus terang: platform ini menyediakan API penerbangan dan hotel, dan akses dimulai dengan percakapan, bukan kunci swalayan. Layanan diaktifkan per tenant, sehingga tenant yang menjual hotel dan bukan tur tidak membawa permukaan tur. Tidak ada di sini yang menjanjikan satu panggilan yang memesan kedua separuh secara atomik, dan Anda sebaiknya tidak mendesain seolah-olah ada. Perlakukan keduanya sebagai dua booking, sebagaimana adanya, di bawah perjalanan yang Anda miliki.

Jika Anda ingin melihat panggilan dan ketentuan sebenarnya sebelum membangun di sekitarnya, mulailah dari halaman API perjalanan dan bawa urutan pemesanan yang Anda rencanakan. Jika Anda masih menimbang apa yang didapat dari akses gratis, API booking hotel gratis menguraikan jenis-jenis gratis.

Berapa biaya jika salah

Versi yang mahal adalah yang diam. Pelanggan sudah punya tiket ke sebuah kota dan kamarnya hilang, dan kabar pertama yang Anda dengar adalah pesan tengah malam, dari bandara. Lebih murah tetapi tetap nyata: checkout yang menampilkan satu total yang menenangkan lalu, setelah pengecekan harga, angka kedua yang tidak disetujui pelanggan; refund yang mengembalikan penerbangan dan melupakan hotel; dan status "terpesan" sementara pemasok berkata lain.

Tidak satu pun butuh solusi cerdik. Yang dibutuhkan adalah perjalanan menjadi objek nyata, urutan menjadi keputusan yang dituliskan seseorang, dan pengecekan ulang kedua harga di saat terakhir sebelum salah satunya dikunci. Bangun itu sekali dan checkout bisa terlihat sesederhana yang diminta tiketnya.

Redaksi Tekravel

Meja teknologi perjalanan

Meja teknologi perjalanan Tekravel menulis untuk pelaku industri: pemilik agen, konsolidator, dan para pengembang yang mengintegrasikan mereka. Setiap artikel diperiksa pada platform yang dijelaskannya sebelum diterbitkan.