Handleiding / Интеграции

Channex (channel manager)

Bijgewerkt op 2026-05-24

Channex е channel manager-ът, който BedFlow използва, за да синхронизира Booking.com, Airbnb, Expedia, OpenGDS, HRS, Check24 и Weekendesk. Без Channex бихте поддържали ръчно наличността и цените си на всяка OTA поотделно.

Поддържани канали (през Channex)

| Канал | Код | Регион / тип | Стандартна комисионна | |---|---|---|---| | Booking.com | BDC | Глобално | 18% | | Airbnb | ABB | Глобално | 15% | | Expedia (вкл. Hotels.com / Vrbo) | EXP | Глобално | 20% | | OpenGDS | GDS | ЕС + sub-channels (VIPIO, Charmant Hotel) | 22% | | HRS | HRS | DACH корпоративен сегмент + business travellers | 15% (типично) | | Check24 | CCK | Германия metasearch | 10% (типично) | | Weekendesk | WKD | BE/NL/FR weekend & short-break | 17% (типично) |

Всеки канал е опционален per-property (RateRule + room mapping в Connections). Source-of-truth-а за метаданните е в App\Enums\Channel.

Какво прави Channex за BedFlow?

  • Push на наличност: ако дадена стая бъде блокирана в BedFlow → в рамките на няколко секунди и в Booking.com
  • Push на цени: промените в тарифите отиват автоматично към всички OTA-та
  • Импорт на резервации: новите OTA резервации пристигат през webhook → BedFlow автоматично създава Booking + Debtor

Setup

  1. Създайте Channex акаунт (staging.channex.io за тестове, app.channex.io за production)
  2. Свържете съществуващите си OTA-та в Channex (Booking.com extranet credentials, Airbnb и т.н.)
  3. В BedFlow: tab Settings → Интеграции → Channex — попълнете API key + property ID
  4. Отидете в Типове стаи — за всяка стая попълнете Channex Room Type ID и за всеки канал Rate Plan ID
  5. Активирайте Channex чрез toggle-а на страницата Connections
  6. Кликнете Channex Sync горе вдясно, за да изпълните първоначален full sync

Автоматични събития

  • Създадена резервация → PushRoomAvailabilityJob за всяка засегната стая
  • Cell toggled в Преглед на стаите → същият job
  • Променена тарифа → SyncRoomPricesJob
  • Ежедневно в 06:00: пълен price sync за всички стаи (365 дни напред)
  • Ежедневно в 06:30: scrape на competitor prices (информативно)

Rate limiting

Channex има rate limit:

  • Staging: 1 request / 7 секунди
  • Production: 1 request / секунда

ChannexService на BedFlow throttle-ва автоматично. Jobs работят последователно през --queue=channex worker (не паралелно).

Webhooks (входящи)

Channex изпраща webhooks към /api/channex/webhook при:

  • booking.new — нова OTA резервация
  • booking.modified — променена OTA резервация
  • booking.cancelled — отменена OTA резервация

Signature validation през shared secret в настройките.

Тестване на staging

Налични са 4 artisan команди за валидиране:

php artisan channex:test          # check credentials
php artisan channex:sync-rooms    # push room types
php artisan channex:sync-prices   # push prices (365 days)
php artisan channex:sync-availability  # push availability (365 days)
← Terug naar categorie