YStay

Connect your distribution channels

Airbnb, Booking.com, Vrbo and iCal calendars: the six-step wizard, states that only advance on proof, and the Booking.com reports on a reservation.

The Distribution channels page — Sales & marketing menu, Channels entry — gathers three platforms under the Online travel agencies heading: Airbnb, Booking.com and Vrbo/Abritel, each on its own card, with its state and its six-step progress. Further down, iCal calendars & other channels covers platforms with no direct connection: importing and exporting availability, nothing more. One principle governs the whole screen: no state advances on a promise. A card's badge comes from the server, and Last sync only appears once a push has really succeeded — otherwise the card says Never synced.

The connection wizard, step by step

  1. Open the Channels page

    A card that has never been connected shows the Not connected state and a button carrying the platform's name — Connect Airbnb, for instance. A setup already begun offers Continue setup, a connection in error Resume connection, a finished one Manage; the button opens the wizard at the step your account has really reached, never beyond it.

    The Distribution channels page: the three platforms and their state.
    The Distribution channels page: the three platforms and their state.
  2. Introduction

    The wizard opens, titled Connect followed by the platform's name, with its step rail: Introduction, Listings, Connection, Confirmation, Mapping, Sync. Start moves on to the next one.

    The first step of the connection wizard.
    The first step of the connection wizard.
  3. Listings

    Choose the listings to distribute only lists your published listings. Distribute, on a row, creates the remote inventory — property, room type, rate plan — and the row turns to Provisioned; there is nothing to do on the platform side. With no published listing, the step says so and will not let you continue.

  4. Connection

    This step changes entirely from one platform to the next. On Airbnb, Authorize on Airbnb opens Airbnb's official authorization on Airbnb's own site: you sign in there, grant access, then come back here. If Airbnb answers that another channel manager already manages your account, disconnect it at Airbnb first; and on a test environment, the wizard states that this authorization is not available there.

    On Booking.com, everything is prepared in your extranet: open “Account”, then “Connectivity provider”, select the provider the wizard names, accept the connectivity (XML) agreement and note your Booking.com Hotel ID. Entered in the field of the same name, Test the connection answers straight away — “Connection verified: the property is reachable.” or “Property not found”. Once the request has gone out, the card shows Waiting for the OTA: YStay checks on its own at regular intervals, Restart the check asks for proof again, and the state will never advance without it.

  5. Confirmation, mapping and first sync

    Proof received, the step shows Connection confirmed and offers Continue to mapping: the only moment the state turns to Connected. Link your listings then puts the channel's listings side by side with your YStay ones — Link on each row, then a button confirms all the mappings on the platform; Import channel listings brings down those that existed before YStay. What remains is Start the first synchronization, which goes through a queue: Refresh follows the real state, Sync active only appears on the first push that genuinely succeeded, and Finish closes the wizard.

What a channel's state means

| The state shown | What it means | | --- | --- | | Not connected | Nothing has been attempted on that platform yet. | | Ready to connect | At least one listing is provisioned; the connection can be started. | | Waiting for the OTA | The request has gone out, the platform has not confirmed yet. | | Connected | The platform has confirmed — mapping opens. | | Listings mapped | Listings are linked and confirmed; the sync is still to be started. | | Sync active | A push of rates and availability has really succeeded. | | Connection declined | The platform rejected the request; the card offers Resume connection. | | Sync error | A push failed; same resume button. |

Disconnect removes the connection at the aggregator but keeps your provisioned listings and the history of imported reservations.

When a sync fails

A Sync failures panel appears at the top of the page as soon as a push has failed. Each row names the listing and the channel, shows the platform's message, groups repeated attempts into a counter and dates the latest; Retry replays that one push. Archive resolved errors removes from the view the failures already superseded by a successful sync of the same flow, the history itself being kept — and if archiving answers “No resolved error to archive — the failures shown are still active.”, nothing has been fixed: retry rather than hide.

Booking.com reports

This part does not live on the Channels page but on a reservation's page, in the Booking.com reports card — which only appears on a reservation that came from Booking.com. These are the channel's own official actions, sent through our connectivity partner: YStay does not invent them.

Four actions exist, in this logical order. Report a no-show attests that the guest did not show up and protects your fees; that report brings out the No-show fees row, which asks for one explicit, single choice — Waive the fees or Keep the fees, and once sent that choice never turns back into two buttons. Report an invalid card asks Booking.com to have another one entered. Finally Cancel the reservation, the only Booking.com-side cancellation you can trigger from YStay, requires that invalid-card report and then the delay imposed by the channel.

Every action opens a confirmation before being sent. Once gone, it stops being a button and shows its exact milestone: “Sent to Su on … — queued for processing”; the card never claims Booking.com has confirmed, the channel's answer being asynchronous. A row the channel does not allow right now shows Not currently available, an eligibility computed server-side on Booking.com's real windows. A refusal reads in plain words: window closed, report already sent, cancellation without an invalid card reported, delay not elapsed, action unavailable for this channel — or a reservation imported before reporting was enabled, hence with no channel reference.

Next

Updated on