Handbuch / Integrationen

Channex (Channel Manager)

Aktualisiert am 2026-04-29

Channex ist der Channel Manager, den BedFlow verwendet, um Booking.com, Airbnb, Expedia, OpenGDS, HRS, Check24 und Weekendesk zu synchronisieren. Ohne Channex müssten Sie pro OTA Verfügbarkeit und Preise manuell pflegen.

Unterstützte Channels (über Channex)

| Channel | Code | Region / Typ | Standardprovision | |---|---|---|---| | Booking.com | BDC | Weltweit | 18% | | Airbnb | ABB | Weltweit | 15% | | Expedia (inkl. Hotels.com / Vrbo) | EXP | Weltweit | 20% | | OpenGDS | GDS | EU + Subkanäle (VIPIO, Charmant Hotel) | 22% | | HRS | HRS | DACH-Geschäftsreisende | 15% (typisch) | | Check24 | CCK | Deutschland Metasearch | 10% (typisch) | | Weekendesk | WKD | BE/NL/FR Wochenend- & Kurztrips | 17% (typisch) |

Jeder Channel ist pro Property optional (RateRule + Zimmer-Mapping in Connections). Die Quelle der Channel-Metadaten ist App\Enums\Channel.

Was macht Channex für BedFlow?

  • Verfügbarkeits-Push: Wenn ein Zimmer in BedFlow blockiert wird → innerhalb weniger Sekunden auch bei Booking.com
  • Preis-Push: Tarifänderungen gehen automatisch an alle OTAs
  • Booking-Import: Neue OTA-Buchungen kommen über Webhook herein → BedFlow legt automatisch eine Buchung + einen Debitor an

Setup

  1. Erstellen Sie ein Channex-Konto (staging.channex.io zum Testen, app.channex.io für Produktion)
  2. Verknüpfen Sie Ihre bestehenden OTAs in Channex (Booking.com Extranet-Zugangsdaten, Airbnb usw.)
  3. In BedFlow: Settings → Integrationen → Channex-Tab — geben Sie API-Key + Property-ID ein
  4. Gehen Sie zu Zimmertypen — pro Zimmer geben Sie die Channex Room Type ID und pro Kanal die Rate Plan ID ein
  5. Aktivieren Sie Channex über den Toggle auf der Connections-Seite
  6. Klicken Sie oben rechts auf Channex Sync, um eine erste Full-Sync zu starten

Automatische Events

  • Buchung angelegt → PushRoomAvailabilityJob pro betroffenem Zimmer
  • Zelle in der Zimmerübersicht getoggelt → derselbe Job
  • Tarif geändert → SyncRoomPricesJob
  • Täglich um 06:00: vollständige Preis-Sync für alle Zimmer (365 Tage im Voraus)
  • Täglich um 06:30: Competitor-Preis-Scrape (informativ)

Rate Limiting

Channex hat ein Rate Limit:

  • Staging: 1 Request / 7 Sekunden
  • Produktion: 1 Request / Sekunde

Der ChannexService von BedFlow throttlet automatisch. Jobs laufen sequenziell über den --queue=channex-Worker (nicht parallel).

Webhooks (eingehend)

Channex sendet Webhooks an /api/channex/webhook bei:

  • booking.new — neue OTA-Buchung
  • booking.modified — OTA-Buchung geändert
  • booking.cancelled — OTA-Buchung storniert

Signature-Validierung über Shared Secret in den Settings.

Staging testen

Es gibt 4 Artisan-Commands zur Validierung:

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)
← Zurück zur Kategorie