Operacione ditore Channex: inventar, rezervime dhe UI e embedded

Pas connect-and-map, Channex ditë me ditë reduktohet në pak veprime. Ky guide është reference për operatorin — çfarë bën çdo buton, kur përdoret cili, dhe si lexohet UI Channex e embedded pa lëvizur HotelBee.

Ku jeton gjithçka

Dy zona: Settings → Integrations → Channel Managers është karta e konfigurimit (aktivizo, regjistro, sync, disconnect). Channel Manager → (nën-faqe) është zona ditore me iframe Channex — Properties, Rooms, Channels, Bookings, Inventory/Rate Calendar.

Katër butonat ditorë

Send Inventory

Force-push i tarifave/avl/restriksioneve te Channex dhe nga aty te OTA-t. Save normale shtyn automatikisht; përdor butonin kur dyshon sync gap, pas import bulk, ose kur support kërkon. Konfirmon "inventory refreshed". Async — prit një minutë.

Pull Reservations

Merr rezervime nga Channex në HotelBee. Kthen total / created / updated / failed. Përdor pas outage të njohur, ose javore si zakon. Failures listohen me bookingId dhe arsye — zakonisht mapping rate plan.

Pull Unacked Reservations

Si Pull Reservations por vetëm për rezervime që HotelBee s'i ka acknowledged — webhook dështoi (network, restart). Channex mban radhë unacked. Buton i duhur kur "ka një Booking.com që s'doli në HotelBee". Ekzekuto, shih failed, eskalo.

Disconnect (vetëm super-admin)

Heq integrimin nga ana e HotelBee. Channex, kanalet dhe rezervimet OTA s'preken. Pas disconnect, asnjë sync derisa rilidhesh dhe ri-mapping. Fshehur prapa super-admin sepse ri-lidhja s'është e thjeshtë.

Faqet Channex të embedded

Channel Manager monton pesë faqe Channex brenda HotelBee me token iframe — qëndron logged në HotelBee por sheh UI Channex reale. Secila është workspace i fokusuar:

• Properties — settings property-level, kontakt, valutë, time zone.
• Rooms — tipe dhomash si i sheh Channex, me përshkrime dhe amenities.
• Channels — regjistro/çregjistro Booking.com, Expedia, Airbnb. Lidhjet OTA të reja nisin këtu.
• Bookings — listë me detaj guest. E dobishme për të shqyrtuar payload incoming kur një booking erdhi i çuditshëm.
• Inventory (rate calendar) — grid Channex i tarifave/avl. Krahaso me HotelBee për të konfirmuar push.

Po faqja s'ngarkohet, klik Refresh — token iframe skadon dhe refresh merr të ri. Gjuha ndjek HotelBee ku mundet (en, it, de, es, pt të mbështetura nga Channex).

Të shtosh kanal të ri OTA — hap pas hapi

Ky është flow që do bësh çdo herë që shton Booking.com, Expedia, Airbnb, Agoda, Hotelbeds ose ndonjë OTA tjetër. Të njëjtit hapa në forma pak të ndryshme per kanal. Para se të nisësh, sigurohu që tipet e dhomave dhe rate plans që do të shesësh në këtë OTA janë të regjistruara te Channex (shih mapping flow më poshtë — kjo është prerequisite, jo opsionale).

1. Nga menuja majtas e HotelBee, hap Channel Manager. Faqja ngarkohet me sub-tabs lart — Properties, Rooms, Channels, Bookings, Inventory. Kjo është UI Channex e embedded brenda HotelBee.
2. Klik tab Channels. Lista e kanaleve ngarkohet — bosh nëse është i pari, ose me kanalet ekzistuese me status me ngjyrë (jeshile = aktiv, e verdhë = pending, e kuqe = error).
3. Klik "Create Channel" (lart djathtas). Del picker me logot e çdo OTA të mbështetur — Booking.com, Expedia, Airbnb, Agoda, Hotelbeds, Vrbo, Despegar, dhjetra të tjera. Zgjidh atë që po lidh.
4. Vendos identifikuesin dhe kredencialet specifike për kanalin. Fushat varen nga OTA:
   • Booking.com: Hotel ID (kodi 6–8 shifror nga URL e extranet) plus username/password XML të gjeneruara nga support i Booking.com. Channex i shkruan Booking.com në emrin tënd për të aktivizuar XML.
   • Expedia: Property ID + kredencialet Expedia Partner Central. Aktivizimi brenda 24–48h pas dorëzimit nga Channex.
   • Airbnb: OAuth — Channex të dërgon te Airbnb për të autorizuar, hyn, klik Allow, kthehesh. S'duhet ID manuale.
   • Agoda / Hotelbeds / Vrbo / Despegar: property ID plus partner code ose API key nga extranet i OTA-s.
5. Save. Kanali del te lista me status "pending activation". Për shumicën pastrohet brenda minutash; Booking.com dhe Expedia mund të zgjasin deri 48h sepse OTA aktivizon kontratën XML/API.
6. Klik te kanali. Dy tabela mapping: Room Mapping dhe Rate Plan Mapping. Janë join tables mes Channex dhe OTA — Channex i di tashmë dhomat e tua, tani i thua secilës se cilën dhomë OTA përfaqëson.
7. Room Mapping: për çdo dhomë Channex (kolona majtas), zgjidh dhomën që përputhet OTA (djathtas). Dropdown vjen nga API e OTA — sheh emrat saktësisht. Map "Standard Double" me "Double Room" nëse Booking.com kështu e quan.
8. Rate Plan Mapping: për çdo rate plan Channex (majtas), zgjidh rate plan OTA (djathtas). "Best Available Rate" → "BAR" ose si e quan OTA. Nëse OTA ka rate plans që s'krijove te Channex (Genius, Mobile), lëri pa map — vazhdojnë të aplikojnë OTA-side discount mbi atë që shtyn.
9. Save mapping. Channex konfirmon me checkmarks jeshile per rresht.
10. Shty inventarin: kthehu te HotelBee → Settings → Integrations → Channel Managers → klik Send Inventory. Kjo bën push të plotë te OTA i ri. (Ose prit — save tjetër në HotelBee bën auto-push.)
11. Verifiko te OTA: hyr te extranet OTA, hap rate calendar, konfirmo që përputhen me HotelBee. Verifikimi i parë rëndon sepse gabime mapping s'dalin derisa një vlerë reale rrjedh.
12. Testo një booking (opsionale por e rekomanduar): bëj një booking real me kosto të ulët përmes OTA, konfirmo që ulet në HotelBee brenda minutash. Cancel/refund testin.

Mapping flow (një herë per tip dhome / rate plan)

Kur shton tip dhome ose rate plan, s'shtyhet automatikisht — opt-in per item. Hap kartën Channex:

1. Te Room Types, tikoj të paregjistruarat (të sinkronizuarat janë gri me badge "synced").
2. Klik Register Room Types. Secila bëhet dhomë Channex me channexId te HotelBee.
3. Te Room Rates, tikoj rate plans (vetëm ato me tip dhome të regjistruar janë eligible).
4. Klik Register Room Rates. Bëhen rate plans Channex, map me channexRatePlanId.
5. Pastaj te Channels iframe, regjistro lidhjet OTA që duhet të shesin këtë kombinim.

Badges: "synced" (mapping i plotë), "partially synced" (disa tipe nën rate-in janë map, të tjerat jo — përfundo), pa badge (jo i regjistruar).

Multi-property (llogari extra)

Nëse operon dy ose më shumë prona në një tenant, klik "+ Add Channex Account". Çdo kartë lidhet me një propertyId Channex. Karta e parë primare; pjesa tjetër extras:

• Vetëm primary regjistron tipe/rates nga UI HotelBee — për extras përdor UI Channex.
• Send Inventory primary-only këtu; extras sync nga iframe i tyre.
• Pull Reservations punon te çdo kartë e aktivizuar — bookings janë per pronë.
• Email te kartë merr ftesën Channex. Adresë reale, jo inbox të përbashkët të paparë.

Kur diçka duket gabim

1. Booking mungon → Pull Unacked Reservations.
2. Tarifa gabim te Booking.com → kontrollo rate calendar HotelBee, pastaj iframe Channex Inventory, pastaj OTA. Vendi i parë ku vlerat nuk përputhen është ku u prish.
3. Dhomë sold out por ke dhoma → Send Inventory force, kontrollo AVL te Channex Inventory.
4. Tip i ri s'del te OTA → konfirmo channexId, regjistro rate plan, kontrollo regjistrim kanalin te Channex.
5. Po asnjë s'zgjidh, shih artikullin troubleshooting Channex.