ដំឡើង Cloudbeds PMS Integration

ការដំឡើងរហ័ស

ការភ្ជាប់ Cloudbeds ជាទូទៅចំណាយពេលប្រហែល 10 នាទី។ Cloudbeds ឥឡូវនេះស្នើសុំសិទ្ធិចូលប្រើ item, សិទ្ធិ read-only add-on access, និងសិទ្ធិអាន hotel, rate, និង taxes/fees។

មគ្គុទ្ទេសក៍នេះជួយអ្នកភ្ជាប់ Cloudbeds។ វារក្សាទិន្នន័យ reservation, guest, housekeeping, payment, room, currency, hotel, rate, និង tax ឲ្យធ្វើសមកាលកម្ម។ បើ Cloudbeds បដិសេធការភ្ជាប់ AVA នឹងបង្ហាញមូលហេតុជាក់លាក់នៅលើ error banner។

កន្លែងស្វែងរក

Settings → Essentials → Property Management System (PMS) Integration

មុនចាប់ផ្តើម

អ្នកត្រូវការ៖

• គណនី Cloudbeds ដែលមានសិទ្ធិ admin
• ព័ត៌មានចូល Cloudbeds របស់អ្នក
• សិទ្ធិអនុញ្ញាតកម្មវិធីភាគីទីបី

ព្រមាន

អាចភ្ជាប់គណនី Cloudbeds បានតែមួយក្នុងមួយអចលនទ្រព្យ។

ការភ្ជាប់ទៅ Cloudbeds

ជំហានទី 1: ជ្រើស Cloudbeds ជា PMS របស់អ្នក

1. ទៅកាន់ Settings → Essentials
2. រំកិលទៅ Property Management System (PMS) Integration
3. ចុចកាត Cloudbeds
4. សញ្ញាធីក (✓) នឹងបង្ហាញដើម្បីបញ្ជាក់ការជ្រើសរើស

ជំហានទី 2: ចាប់ផ្តើមការភ្ជាប់

1. ចុចប៊ូតុង Connect to Cloudbeds
2. បង្អួចថ្មីមួយនឹងបើកទៅ Cloudbeds

ជំហានទី 3: អនុញ្ញាតការចូលប្រើ

1. ចូលទៅគណនី Cloudbeds របស់អ្នក
2. ពិនិត្យសិទ្ធិដែល AVA កំពុងស្នើ
3. ចុច Authorize ឬ Allow
4. បង្អួចនឹងបិទដោយស្វ័យប្រវត្តិ

AVA ឥឡូវនេះស្នើសុំសិទ្ធិទាំងនេះ៖

Permission	AVA ប្រើសម្រាប់អ្វី
read:hotel	មើល metadata សណ្ឋាគារ
read:guest	មើលព័ត៌មានលម្អិតភ្ញៀវ
write:guest	អាប់ដេតព័ត៌មានលម្អិតភ្ញៀវ
read:housekeeping	មើលទិន្នន័យ housekeeping
write:housekeeping	អាប់ដេតទិន្នន័យ housekeeping
read:rate	មើលទិន្នន័យ rate plan
read:payment	មើលទិន្នន័យការទូទាត់
write:payment	អាប់ដេតទិន្នន័យការទូទាត់
read:reservation	មើលទិន្នន័យ reservation
write:reservation	អាប់ដេតទិន្នន័យ reservation
read:room	មើលទិន្នន័យបន្ទប់
write:room	អាប់ដេតទិន្នន័យបន្ទប់
read:currency	អានការកំណត់រូបិយប័ណ្ណរបស់ property
read:taxesAndFees	មើលទិន្នន័យ tax និង fee
read:item	មើលទិន្នន័យ item catalog
write:item	អាប់ដេតទិន្នន័យ item catalog
read:addon	មើលទិន្នន័យ add-on catalog

ការភ្ជាប់ចាស់

បើអ្នកបានភ្ជាប់ Cloudbeds មុនអាប់ដេតនេះ សូមភ្ជាប់ឡើងវិញ ដើម្បីបច្ចុប្បន្នភាព read scopes ដែលបានអនុញ្ញាត។

ជំហានទី 4: ផ្ទៀងផ្ទាត់ការភ្ជាប់

1. ត្រឡប់ទៅ AVA settings
2. រង់ចាំ "Finalizing connection..." (5-10 វិនាទី)
3. ស្ថានភាពនឹងបង្ហាញសញ្ញាធីកពណ៌បៃតង
4. សារនឹងបង្ហាញ៖ "Cloudbeds Account Linked"

ការភ្ជាប់បានបញ្ចប់ហើយ! 🎉

កំហុស Cloudbeds OAuth

ពេល Cloudbeds រារាំងការភ្ជាប់ AVA នឹងបង្ហាញសារដែលអាចអានបាន។ អ្នកមិនចាំបាច់ស្មានពីកំហុសទូទៅទៀតទេ។

អ្វីដែលអ្នកឃើញ	អត្ថន័យ	អ្វីត្រូវធ្វើ
Cloudbeds did not return the OAuth state parameter.	callback របស់ Cloudbeds ខ្វះទិន្នន័យ state ។	ចាប់ផ្តើមការភ្ជាប់ម្តងទៀត។
Cloudbeds did not return an authorization code.	Cloudbeds មិនបានបញ្ចប់ការអនុញ្ញាត។	ភ្ជាប់ឡើងវិញពី Settings → Essentials។
Cloudbeds OAuth state verification failed.	state របស់ callback មិនត្រឹមត្រូវ ឬផុតកំណត់។	ភ្ជាប់ Cloudbeds ឡើងវិញ។
Could not identify the merchant for this Cloudbeds link.	AVA មិនអាចផ្គូផ្គង callback ទៅអចលនទ្រព្យរបស់អ្នកបាន។	ពិនិត្យថាអ្នកកំពុងចូលគណនីត្រឹមត្រូវ។
Cloudbeds rejected the authorization code exchange.	Cloudbeds រារាំងការផ្លាស់ប្តូរទៅ token។	ពិនិត្យ scopes និង redirect URI បន្ទាប់មកសាកល្បងម្ដងទៀត។
Failed to link Cloudbeds account.	AVA មិនអាចផ្គូផ្គងកំហុស backend បានទេ។	ចម្លងសារពេញលេញ ហើយទាក់ទង support។

អ្វីដែលធ្វើសមកាលកម្មដោយស្វ័យប្រវត្តិ

Cloudbeds ប្រើ webhooks សម្រាប់ការអាប់ដេតពេលវេលាជាក់ស្តែង។ ពេលមានការផ្លាស់ប្តូរនៅ Cloudbeds AVA នឹងទទួលបានការជូនដំណឹងភ្លាមៗ៖

ព្រឹត្តិការណ៍	អ្វីកើតឡើង
Reservation created	AVA ទទួលការជូនដំណឹង ហើយអាចកំណត់ពេលសារ pre-arrival
Reservation dates changed	AVA អាប់ដេតសារដែលបានកំណត់ពេលណាមួយ
Check-in/out status	ស្ថានភាពធ្វើសមកាលកម្មពេលវេលាជាក់ស្តែង

ពេលអ្នកមើល reservation ក្នុង AVA ប្រព័ន្ធនឹងទាញទិន្នន័យចុងក្រោយបំផុតដោយផ្ទាល់ពី Cloudbeds។ វាធានាថាអ្នកតែងតែឃើញព័ត៌មានថ្មីបំផុត។

ព័ត៌មាន

ទិន្នន័យហូរជាចម្បងពី Cloudbeds → AVA។ ការអាប់ដេតភ្ញៀវដែលធ្វើក្នុង AVA (ដូចជា check-in បញ្ចប់) នឹងត្រូវផ្ញើត្រឡប់ទៅ Cloudbeds។

Cloudbeds read protection

បើបុគ្គលិកច្រើនស្នើទិន្នន័យ Cloudbeds ដូចគ្នា ក្នុងពេលតែមួយ AVA នឹងចែករំលែក read request តែមួយ។ បើ Cloudbeds ត្រឡប់ access ឬ success:false error ដូចគ្នាម្តងទៀត AVA នឹងផ្អាកការព្យាយាមឡើងវិញម្តងហើយម្តងទៀតជាបណ្ដោះអាសន្ន។

Cloudbeds arrival time updates

ពេល primary guest sync AVA អាចផ្ញើ estimated arrival time របស់ reservation ទៅ Cloudbeds v3។ Companion guests មិនធ្វើបច្ចុប្បន្នភាពពេលវេលានោះទេ។ ពេលវេលាមិនត្រឹមត្រូវ ខ្វះ ឬទទេ នឹងត្រូវមើលរំលង ដូច្នេះ AVA មិនលុបទិន្នន័យ PMS ដែលមានស្រាប់ទេ។ បើការអាប់ដេតជាជម្រើសនេះបរាជ័យ ឬ Cloudbeds មិនគាំទ្រ វាទេ ការសមកាលកម្មភ្ញៀវនៅតែជោគជ័យ។

ផលប៉ះពាល់លើភ្ញៀវ និងបុគ្គលិក

• ទម្រង់ភ្ញៀវសម្របតាមច្បាប់ Cloudbeds។ វាលដែលត្រូវការ និងវាលដែលលាក់នឹងផ្លាស់ប្តូរតាមការកំណត់ Cloudbeds ដូច្នេះភ្ញៀវឃើញតែអ្វីដែលចាំបាច់។
• Reservation lookup ប្រើ Cloudbeds។ បើ Cloudbeds មិនបានភ្ជាប់ ជំហានស្វែងរកភ្ញៀវនឹងបរាជ័យ។
• ស្លាកប្រភព booking អាចប្រើ metadata ប្រភពពី Cloudbeds។ បើ reservation ខ្វះ sourceName AVA នឹង fallback ទៅឈ្មោះ Cloudbeds source ដែលបានភ្ជាប់។
• Source collect មកពីកំណត់ត្រាប្រភពដែលបានភ្ជាប់ ពេលមាន។ វាធ្វើឲ្យអាកប្បកិរិយាប្រភពរបស់សណ្ឋាគារ និង channel ស្របតាមការកំណត់ Cloudbeds។
• វិក្កយបត្រ channel-collect នៅតែ waived។ ពេល Cloudbeds v3 សម្គាល់ invoice ប្រភេទ channel-collect ថា waived AVA នឹងកំណត់ payable totals ទៅសូន្យ ហើយបង្ហាញ waiver ក្នុង Streamliner។
• ការកំណត់ room condition ប៉ះពាល់តែ housekeeping sync ប៉ុណ្ណោះ។ ការកំណត់នេះគ្រប់គ្រងថា AVA ផ្ញើស្ថានភាព Clean ឬ Inspected ទៅ Cloudbeds ពេលបន្ទប់ត្រូវបានសម្គាល់ថាស្អាតក្នុង AVA។ វា មិន ផ្លាស់ប្តូរ UI របស់ភ្ញៀវទេ។
• AVA ស្នើ item access និង read-only add-on access។ write:addon ត្រូវបានដកចេញដោយចេតនា។
• Cloudbeds read scopes បច្ចុប្បន្នភាពពេល reconnect។ ភ្ជាប់ឡើងវិញ បើអ្នកត្រូវការទិន្នន័យ hotel, rate, ឬ taxes/fees នៅលើ grant ចាស់។

ផ្តាច់ Cloudbeds

ផ្តាច់តែបើអ្នកកំពុង៖

• ប្ដូរទៅ PMS ផ្សេង
• ប្ដូរគណនី Cloudbeds
• ដោះស្រាយបញ្ហា sync

ដើម្បីផ្តាច់៖

1. ទៅកាន់ Settings → Essentials
2. ចុច Disconnect from Cloudbeds
3. បញ្ជាក់ពេលមានសំណើ

ការប្រុងប្រយ័ត្ន

ការផ្តាច់នឹងបញ្ឈប់ការធ្វើសមកាលកម្មទាំងអស់ភ្លាមៗ។ ទិន្នន័យដែលមានស្រាប់នៅតែមាន ប៉ុន្តែមិនអាប់ដេតទៀតទេ។

ការដោះស្រាយបញ្ហា

ការភ្ជាប់ជាប់នៅ "Connecting..."

1. រង់ចាំ 30 វិនាទី
2. ផ្ទុកទំព័រឡើងវិញ
3. ពិនិត្យការតភ្ជាប់អ៊ីនធឺណិត
4. សាកល្បង browser ផ្សេង
5. បិទ popup blockers

សារ​កំហុស Cloudbeds OAuth

អ្វីដែលអ្នកឃើញ: សារ Cloudbeds OAuth បង្ហាញនៅលើ banner។

ដោះស្រាយ៖

1. អានសារជាមុន។
2. ផ្គូផ្គងវាទៅតារាងខាងលើ។
3. ភ្ជាប់ Cloudbeds ឡើងវិញ បើសារនោះនិយាយអំពី state, code, ឬ token exchange។
4. បញ្ជាក់ថាអ្នកកំពុងប្រើគណនី Cloudbeds admin។
5. ពិនិត្យ redirect URI បើ token exchange បន្តបរាជ័យ។

ព័ត៌មាន

ឥឡូវនេះ banner នឹងបង្ហាញព័ត៌មានកំហុសផ្ទាល់របស់ Cloudbeds នៅពេលមាន។ វាផ្តល់ចំណុចចាប់ផ្តើមច្បាស់ជាងមុនសម្រាប់ support។

reservation មិនធ្វើសមកាលកម្ម

1. រង់ចាំ 15 នាទីសម្រាប់ initial sync
2. ពិនិត្យស្ថានភាពការភ្ជាប់ (គួរតែបង្ហាញពណ៌បៃតង)
3. សាកល្បងផ្តាច់ ហើយភ្ជាប់ឡើងវិញ
4. ផ្ទៀងផ្ទាត់ថា reservation មាននៅក្នុង Cloudbeds

កំហុស access ឬ property របស់ Cloudbeds

អ្វីដែលអ្នកឃើញ: សារដូចជា You don't have access to property ID, ឬកំហុស Cloudbeds ដដែលត្រឡប់មកភ្លាមៗ។

ហេតុអ្វីកើតឡើង: គណនី Cloudbeds ដែលភ្ជាប់មក មិនអាចអាន property នោះបាន។ AVA ក៏ផ្អាកការព្យាយាមឡើងវិញជាបណ្ដោះអាសន្នផងដែរ។

ដោះស្រាយ៖

1. បញ្ជាក់ថាអ្នកបានចូលទៅ property ត្រឹមត្រូវក្នុង Cloudbeds។

2. ស្នើ Cloudbeds admin ផ្ទៀងផ្ទាត់ property access និង permissions។

3. រង់ចាំមួយភ្លែត មុនចុច Refresh ម្តងទៀត។

4. ទាក់ទង support បើសារនៅតែត្រឡប់មកវិញ។

   ✓ ការធ្វើ refresh បន្ទាប់គួរតែដំណើរការ បន្ទាប់ពីបញ្ហា access Cloudbeds ត្រូវបានដោះស្រាយ។

ផ្ទាំង catalog មិនបង្ហាញ

អ្វីដែលអ្នកឃើញ: ផ្ទាំង Items ឬ Add-ons បាត់។

ដោះស្រាយ៖

1. បើកទំព័រ Rooms ឡើងវិញ។
2. ពិនិត្យការស្នើ permission របស់ Cloudbeds។
3. បញ្ជាក់ថា prompt មាន read:item, write:item, និង read:addon។
4. ទាក់ទង support បើផ្ទាំង catalog នៅតែមិនបង្ហាញ។

បង្អួច popup មិនបើក

1. ពិនិត្យការកំណត់ popup blocker របស់ browser
2. អនុញ្ញាត popup ពី domain របស់ AVA
3. សាកល្បង browser ផ្សេង ឬ incognito mode

សុវត្ថិភាព

• ការភ្ជាប់ប្រើ OAuth 2.0 ដែលមានសុវត្ថិភាព
• ពាក្យសម្ងាត់របស់អ្នកមិនដែលត្រូវបានរក្សាទុកក្នុង AVA ទេ
• អាចដកសិទ្ធិចូលប្រើពេលណាក៏បានពី Cloudbeds
• ការភ្ជាប់ផុតកំណត់បន្ទាប់ពី 90 ថ្ងៃនៃភាពអសកម្ម

សំណួរដែលសួរញឹកញាប់

តើខ្ញុំអាចភ្ជាប់ Cloudbeds ច្រើន property បានទេ? ទេ មួយ property ក្នុងមួយ AVA account។

តើការផ្តាច់នឹងលុបទិន្នន័យរបស់ខ្ញុំទេ? ទេ ទិន្នន័យដែលមានស្រាប់នៅតែមាន ប៉ុន្តែមិនអាប់ដេតទៀតទេ។

តើបុគ្គលិកអាចភ្ជាប់ Cloudbeds បានទេ? ទេ មានតែអ្នកគ្រប់គ្រងប៉ុណ្ណោះដែលអាចគ្រប់គ្រង PMS connections បាន។

នៅតែជាប់?

ទាក់ទង success@vouch-technologies.com ប្រសិនបើ៖

• ❌ កំហុស OAuth ដដែលនៅតែបង្ហាញក្រោយភ្ជាប់ឡើងវិញ
• ❌ Cloudbeds នៅតែបដិសេធការផ្លាស់ប្ដូរ authorization code
• ❌ អ្នកមិនអាចបញ្ជាក់គណនី ឬ property Cloudbeds ត្រឹមត្រូវបាន