ทดลองใช้งานจริง

API จองล่องเรือสำราญ

API ล่องเรือสำราญสำหรับเอเจนซี่: รอบเรือ ห้องพัก และตารางชำระเงิน

API ล่องเรือสำราญช่วยให้เว็บไซต์ของคุณแสดงรอบเรือแบบเรียลไทม์ คิดราคาตามประเภทห้องพัก และสร้างการจองล่องเรือกับสายการเดินเรือได้ หน้านี้อธิบายหน้าตาของข้อมูล วิธีทำงานของห้องพักและการชำระเงิน และสองวิธีในการนำสต็อกล่องเรือขึ้นเว็บไซต์ PHPTRAVELS ของคุณเอง

  • รอบเรือและเส้นทาง
  • ประเภทห้องพักและผังดาดฟ้า
  • เงินมัดจำและการชำระส่วนที่เหลือ
  • การเชื่อมต่อล่องเรือแบบกำหนดเอง

API ล่องเรือสำราญส่งข้อมูลอะไรกลับมา

หนึ่งรอบเรือ ในรูปแบบข้อมูล

การล่องเรือขายเป็นรอบเรือ คือเรือหนึ่งลำ เส้นทางหนึ่งเส้น และวันเดินทางหนึ่งวัน API ล่องเรือทุกตัวไม่ว่ารูปแบบใดล้วนสร้างขึ้นรอบหน่วยนี้

การค้นหาจะส่งภูมิภาค เดือนหรือช่วงวันที่ จำนวนวัน และจำนวนผู้เดินทางไป ผลลัพธ์เป็นรายการรอบเรือ แต่ละรอบมีชื่อเรือ สายการเดินเรือ วันขึ้นเรือและวันกลับ ท่าเรือที่แวะพร้อมเวลา จำนวนวันที่อยู่กลางทะเล และราคาเริ่มต้นต่อคนของแต่ละประเภทห้องพักที่ยังว่าง

จากนั้นการเรียกอื่น ๆ จะคิดราคาประเภทที่เลือกตามผู้เดินทางจริง แสดงรายการห้องที่เลือกได้ สร้างการจอง และรับชำระเงินสำหรับการจองนั้น เนื่องจากแต่ละสายการเดินเรือใช้ชื่อและรูปแบบต่างกัน แพลตฟอร์มจึงแมปทุกแหล่งข้อมูลเข้ากับโมเดลรอบเรือ ห้องพัก และการจองแบบเดียวกันก่อนที่ลูกค้าจะเห็น

สายการเดินเรือ

สายการเดินเรือพันธมิตรของคุณ

เรือพันธมิตร · 7 คืน

ว่าง
ขึ้นเรือ
2027-05-15
กลับถึงท่า
2027-05-22

เส้นทาง

  1. D1เซาท์แธมป์ตัน--:-- · 17:00
  2. D2กลางทะเล
  3. D3บรูช (เซบรูช)08:00 · 18:00
  4. D4อัมสเตอร์ดัม09:00 · 19:00
  5. D5กลางทะเล
  6. D6โคเปนเฮเกน07:00 · 17:00
  7. D7ออสโล09:00 · 16:00
  8. D8เซาท์แธมป์ตัน07:00 · --:--
ราคาเริ่มต้นต่อคน พักสองคนต่อห้องEUR 899

ข้อมูลตัวอย่างเพื่อประกอบการอธิบาย ไม่ใช่รูปแบบของสายการเดินเรือใดโดยเฉพาะ

แพลตฟอร์มจองล่องเรือหนึ่งเดียวที่รับรอบเรือ ประเภทห้องพัก และราคาจากระบบของสายการเดินเรือ

ประเภทห้องพัก

สี่ระดับบนเรือ: ห้องด้านใน ห้องวิวทะเล ห้องระเบียง และห้องสวีท

API ล่องเรือสำราญแสดงรายการประเภทห้องพักภายใต้แต่ละรอบเรือ ประเภทห้องเป็นปัจจัยหลักของราคา และแต่ละประเภทเปลี่ยนหลายอย่างพร้อมกัน

  1. 01ห้องด้านในไม่มีหน้าต่าง

    ราคาเริ่มต้นของรอบเรือ สายการเดินเรือมักแบ่งเป็นหลายประเภทตามชั้นและตำแหน่ง โดยแต่ละประเภทมีรหัสของตัวเอง

    ระดับราคา
  2. 02ห้องวิวทะเลหน้าต่างหรือช่องกลม

    ยกระดับขึ้นมาเพื่อรับแสงธรรมชาติ บางประเภทมีวิวที่ถูกบัง ซึ่ง API จะระบุไว้ในคำอธิบายประเภท

    ระดับราคา
  3. 03ห้องระเบียงระเบียงส่วนตัว

    มีพื้นที่กลางแจ้งส่วนตัว ประเภทจะต่างกันไปตามความสูงของชั้นและตำแหน่งกลางลำหรือท้ายเรือ

    ระดับราคา
  4. 04ห้องสวีทระเบียงและห้องนั่งเล่น

    ระดับสูงสุดของรายการราคา มักมีสิทธิประโยชน์เพิ่มมากับค่าโดยสาร และเป็นประเภทที่มักขายเป็นห้องที่ระบุเลขห้องมากที่สุด

    ระดับราคา

รหัสประเภทห้องและรหัสค่าโดยสาร

แต่ละประเภทห้องมีรหัส และแต่ละรอบเรืออาจขายภายใต้รหัสค่าโดยสารหลายแบบ ได้แก่ราคามาตรฐาน ราคาโปรโมชัน และราคากลุ่มหรือราคาเอเจนต์ ห้องเดียวกันอาจมีราคาและเงื่อนไขต่างกันตามรหัสค่าโดยสาร

จองแบบการันตีหรือระบุห้อง

การจองแบบการันตี ลูกค้าซื้อประเภทห้อง แล้วสายการเดินเรือจะกำหนดห้องให้ภายหลังในประเภทนั้นหรือสูงกว่า ส่วนการจองแบบระบุห้องจะล็อกเลขห้องตั้งแต่ตอนจอง หลายสายการเดินเรือตั้งราคาสองแบบนี้ต่างกัน

การเลือกห้อง

เลือกห้องจากผังดาดฟ้า

เมื่อสายการเดินเรืออนุญาตให้จองแบบระบุห้อง API จะส่งรายการห้องที่ยังว่างในประเภทที่เลือก พร้อมชั้น ตำแหน่ง และจำนวนผู้เข้าพักของแต่ละห้อง

ดาดฟ้าชั้น 9

เลือกห้อง

หัวเรือท้ายเรือ
0814
242636
29
011119
  • ห้องด้านใน
  • ห้องวิวทะเล
  • ห้องระเบียง
  • ห้องสวีท
  • ไม่ว่าง

ห้อง 9110

ห้องด้านใน

ห้องด้านใน ราคาต่ำสุดบนดาดฟ้านี้ ขายแบบระบุห้องหรือแบบการันตี

ห้องวิวทะเล

ห้องที่มีหน้าต่างบริเวณหัวเรือซึ่งตัวเรือโค้งเข้า API จะส่งหมายเหตุเรื่องวิวมาพร้อมกับประเภทห้อง

ห้องระเบียง

ห้องระเบียงกลางลำเรือ ตำแหน่งบนดาดฟ้ามักแยกเป็นอีกประเภทหนึ่งที่มีราคาของตัวเอง

ห้องสวีท

ห้องสวีทหันไปทางท้ายเรือ ระเบียงกว้างกว่า โดยปกติจองแบบระบุห้อง ไม่ใช่แบบการันตี

  1. 1.แสดงรายการห้องหลังจากลูกค้าเลือกประเภทห้อง แพลตฟอร์มจะสอบถามห้องว่างในประเภทนั้นจากสายการเดินเรือ แล้ววาดลงบนดาดฟ้า
  2. 2.กันห้องไว้API ล่องเรือหลายตัวให้กันห้องที่เลือกไว้ชั่วคราว ขณะที่ลูกค้ากรอกชื่อและชำระเงิน
  3. 3.ยืนยันการจองการจองจะยืนยันเลขห้อง ผู้เดินทาง และรหัสค่าโดยสาร แล้วสายการเดินเรือส่งหมายเลขการจองของตนกลับมา

ในเรือสำราญของ PHPTRAVELS เรือแต่ละลำมีดาดฟ้าและประเภทห้องพักของตัวเอง ลูกค้าจึงเลือกได้โดยเห็นข้อมูลครบถ้วน ไม่ว่าห้องจะเป็นของคุณเองหรือมาจากสายการเดินเรือที่เชื่อมต่อไว้

ตารางชำระเงิน

มัดจำตอนนี้ ส่วนที่เหลือก่อนออกเดินทาง

การล่องเรือจองล่วงหน้าหลายเดือนและชำระเป็นงวด วันที่และจำนวนเงินของแต่ละรอบเรือและค่าโดยสารกำหนดโดยสายการเดินเรือ และ API จะส่งกลับมาพร้อมการจอง

  1. 01

    การจองและเงินมัดจำ

    ลูกค้าชำระเงินมัดจำตามที่สายการเดินเรือกำหนด ต่อคนหรือต่อการจอง เพื่อยืนยันห้อง

  2. 02

    กำหนดชำระส่วนที่เหลือ

    ยอดคงเหลือต้องชำระภายในวันที่สายการเดินเรือกำหนดก่อนออกเดินทาง การจองที่ยังไม่ชำระอาจถูกสายการเดินเรือยกเลิกหลังจากนั้น

  3. 03

    เอกสาร

    เมื่อชำระครบแล้ว สายการเดินเรือจะออกเอกสารการล่องเรือ และลูกค้ากรอกข้อมูลเช็คอิน

  4. 04

    วันออกเดินทาง

    ลูกค้าขึ้นเรือ การเปลี่ยนแปลงหลังจากนี้จะดำเนินการบนเรือหรือตามกฎของสายการเดินเรือ

ค่าปรับยกเลิกตามช่วงเวลา

ช่วงเงินมัดจำค่าปรับเพิ่มขึ้นค่าปรับสูงสุด

ยิ่งใกล้วันออกเดินทาง สัดส่วนค่าโดยสารที่ถูกหักเมื่อยกเลิกก็ยิ่งมากขึ้น ช่วงเวลาและเปอร์เซ็นต์เป็นของแต่ละสายการเดินเรือและค่าโดยสาร API ล่องเรือจึงส่งมาพร้อมการจอง และแพลตฟอร์มของคุณแสดงให้ลูกค้าเห็นก่อนชำระเงิน

เมื่อคุณขายรอบเรือที่ทำสัญญาเอง เรือสำราญก็ทำงานแบบเดียวกัน คุณกำหนดเงินมัดจำและวันครบกำหนดชำระส่วนที่เหลือของแต่ละรอบเรือ และยอดค้างชำระจะถูกติดตามในระบบหลังบ้านจนกว่าจะชำระครบ

การตั้งราคาล่องเรือ

ราคาล่องเรือประกอบกันอย่างไร

ราคาล่องเรืออ่านต่างจากราคาโรงแรมหรือตั๋วเครื่องบิน API ล่องเรือส่งส่วนประกอบมาแยกกัน และระบบจองของคุณต้องรวมเข้าด้วยกันแบบเดียวกับที่สายการเดินเรือทำ

นอกจากราคาของสายการเดินเรือ PHPTRAVELS ยังใช้มาร์กอัปและค่าคอมมิชชันของคุณตามเรือ รอบเรือ หรือช่องทางขาย และเอเจนต์ในพอร์ทัลท่องเที่ยว B2Bจะเห็นราคาสุทธิของตัวเอง

  • คิดต่อคน ไม่ใช่ต่อห้อง

    ค่าโดยสารล่องเรือเสนอเป็นราคาต่อผู้เดินทาง ห้องสำหรับสองคนจึงเท่ากับค่าโดยสารต่อคนสองเท่า และ API คิดราคาผู้เดินทางแต่ละคนตามอายุและลำดับในห้อง

  • ตั้งอยู่บนการพักสองคนต่อห้อง

    ราคาเริ่มต้นสมมติว่ามีผู้เดินทางสองคนพักร่วมกัน คนที่สามและสี่มักจ่ายถูกกว่า ส่วนผู้เดินทางคนเดียวต้องจ่ายค่าพักเดี่ยวเพิ่ม

  • ภาษี ค่าธรรมเนียม และค่าท่าเรือ

    ภาษีรัฐ ค่าธรรมเนียม และค่าท่าเรือจะบวกเพิ่มต่อคนจากค่าโดยสารล่องเรือ ควรแสดงเป็นบรรทัดแยกเพื่อให้ยอดรวมไม่มีเรื่องน่าตกใจ

  • เครดิตบนเรือและส่วนเสริม

    ค่าโดยสารบางแบบรวมเครดิตบนเรือ แพ็กเกจเครื่องดื่ม หรือทิป API ส่งสิ่งเหล่านี้กลับมาเป็นรายการที่รวมอยู่ในค่าโดยสาร และเป็นเหตุผลหนึ่งที่ค่าโดยสารสองแบบของห้องเดียวกันต่างกัน

จะหาสต็อกล่องเรือได้อย่างไร

สัญญาของคุณเอง หรือ API สายการเดินเรือ

มีสองเส้นทางในการนำล่องเรือขึ้นเว็บไซต์ของคุณ เอเจนซี่จำนวนมากเริ่มจากแบบแรก แล้วเพิ่มแบบที่สองเมื่อปริมาณการขายคุ้มค่า

พร้อมใช้ในโมดูลล่องเรือ

ใส่สัญญาล่องเรือของคุณเอง

กรอกรอบเรือที่คุณทำสัญญาไว้ในระบบหลังบ้าน ได้แก่ เรือ ดาดฟ้า ประเภทห้องพัก เส้นทางรายท่าเรือ วันออกเดินทาง ค่าโดยสารต่อคน ฤดูกาล เงินมัดจำ และวันครบกำหนดชำระส่วนที่เหลือ พาร์ตเนอร์ล่องเรือสามารถรับสิทธิ์เข้าสู่ระบบแบบซัพพลายเออร์เพื่ออัปเดตรอบเรือของตัวเองได้

  • ที่นั่งกลุ่มและโควตาที่คุณถือไว้
  • ค่าคอมมิชชันแยกตามสายการเดินเรือ
  • ราคาสุทธิสำหรับเอเจนต์ B2B
  • ใช้งานได้ตั้งแต่วันที่ติดตั้ง
การเชื่อมต่อแบบกำหนดเอง

เชื่อมต่อ API ของสายการเดินเรือหรือคอนโซลิเดเตอร์

ในรายการการเชื่อมต่อของ PHPTRAVELS ไม่มีตัวเชื่อมล่องเรือที่พร้อมใช้ เพราะทุกแพ็กเกจรวมซอร์สโค้ดฉบับเต็ม API ของสายการเดินเรือหรือคอนโซลิเดเตอร์จึงถูกเชื่อมต่อเป็นการเชื่อมต่อ API แบบกำหนดเอง แล้วแมปเข้ากับรอบเรือ ห้องพัก และการจองที่โมดูลแสดงอยู่แล้ว

  • คุณเซ็นสัญญากับสายการเดินเรือหรือคอนโซลิเดเตอร์
  • คุณรับและเก็บข้อมูลรับรอง API เอง
  • ตัวเชื่อมแมปรอบเรือ ประเภทห้อง และห้องพัก
  • การจอง การชำระเงิน และการยกเลิกเป็นไปตามกฎของสายการเดินเรือ

กำลังมองหาซัพพลายเออร์? รายชื่อซัพพลายเออร์ XML API ท่องเที่ยวรวบรวมสายการเดินเรือที่จัดจำหน่ายผ่าน API ส่วนAPI integration คืออะไรอธิบายว่าการเชื่อมต่อแบบนี้สร้างขึ้นอย่างไร

ดูขั้นตอนจองล่องเรือทำงานจริง

เปิดเดโมจริงเพื่อค้นหารอบเรือ เปรียบเทียบประเภทห้องพัก และจองด้วยเงินมัดจำ จากนั้นเปรียบเทียบแพ็กเกจที่ราคา

คำถามที่พบบ่อย

คำถามเกี่ยวกับ API ล่องเรือสำราญ

คุยกับฝ่ายขาย

API ล่องเรือสำราญคือชุดเว็บเซอร์วิสที่สายการเดินเรือหรือคอนโซลิเดเตอร์เปิดให้ผู้ขายท่องเที่ยว ระบบของคุณใช้ค้นหารอบเรือ อ่านเส้นทาง คิดราคาประเภทห้องพัก แสดงรายการห้องว่าง สร้างการจอง และรับชำระเงินมัดจำและส่วนที่เหลือ

ไม่มี โมดูลล่องเรือสร้างขึ้นรอบสต็อกที่คุณจัดการเอง คือเรือ ประเภทห้องพัก และรอบเรือที่คุณทำสัญญาไว้ การเชื่อมต่อกับสายการเดินเรือหรือคอนโซลิเดเตอร์รายใดรายหนึ่งจะพัฒนาเป็นการเชื่อมต่อแบบกำหนดเองบนซอร์สโค้ดที่แถมมาให้

คุณสมัครกับสายการเดินเรือหรือคอนโซลิเดเตอร์ในฐานะผู้ขายท่องเที่ยว เงื่อนไขการเข้าถึงต่างกันไปตามสายการเดินเรือและตลาด คุณเป็นผู้เซ็นสัญญาและรับข้อมูลรับรองเอง PHPTRAVELS ไม่เคยให้ข้อมูลรับรองของซัพพลายเออร์

การจองแบบการันตีจะรักษาประเภทห้องไว้ในราคาที่กำหนด แล้วสายการเดินเรือกำหนดห้องจริงให้ภายหลังในประเภทนั้นหรือสูงกว่า ส่วนการจองแบบระบุห้องจะล็อกเลขห้องตั้งแต่ตอนจอง

สายการเดินเรือกำหนดตามรอบเรือและค่าโดยสาร และ API ของสายการเดินเรือส่งกลับมาพร้อมการจอง สำหรับรอบเรือที่คุณใส่เอง คุณกำหนดเงินมัดจำและวันครบกำหนดชำระส่วนที่เหลือของแต่ละรอบเรือในระบบหลังบ้าน

ค่าโดยสารล่องเรือเสนอเป็นราคาต่อผู้เดินทาง โดยปกติอิงการพักสองคนต่อห้อง คนที่สามและสี่จ่ายค่าโดยสารของตัวเอง ผู้เดินทางคนเดียวจ่ายค่าพักเดี่ยวเพิ่ม และภาษี ค่าธรรมเนียม กับค่าท่าเรือจะบวกเพิ่มต่อคน

ได้ เอเจนต์จองในพอร์ทัล B2B ด้วยราคาสุทธิและค่าคอมมิชชันของตัวเอง และชำระจากกระเป๋าเงินเอเจนต์ ทั้งหมดอยู่ในระบบที่ติดตั้งชุดเดียวกับเว็บไซต์สาธารณะของคุณ

แพ็กเกจ Enterprise รวม PHPTRAVELS REST API และ webhook พร้อมเอกสาร และทุกแพ็กเกจรวมซอร์สโค้ดฉบับเต็ม นักพัฒนาของคุณจึงขยายระบบจองล่องเรือหรือเชื่อมต่อกับระบบอื่นได้

เริ่มจากรอบเรือที่คุณทำสัญญาไว้แล้ว ใส่ในโมดูลล่องเรือ และดูว่าขายได้อย่างไร เมื่อความร่วมมือกับสายการเดินเรือหรือปริมาณการขายคุ้มค่า ค่อยเพิ่ม API ของสายการเดินเรือนั้นผ่านการเชื่อมต่อแบบกำหนดเอง