> ## Documentation Index
> Fetch the complete documentation index at: https://docs.deskboy.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Σύνδεση Hospitable

> Συνδέστε τον λογαριασμό σας Hospitable και φέρτε τις κρατήσεις από όλα τα κανάλια σας — Airbnb, Booking.com, Vrbo και άμεσες.

# Σύνδεση Hospitable

Αν χρησιμοποιείτε τη **Hospitable** ως σύστημα διαχείρισης, μπορείτε να συνδέσετε τον λογαριασμό σας στο Etherly Sync. Οι κρατήσεις από **όλα τα κανάλια** που έχετε εκεί — Airbnb, Booking.com, Vrbo και άμεσες — έρχονται αυτόματα, μαζί με τα ποσά, τις ημερομηνίες και τις ακυρώσεις τους.

<Note>
  Η κάρτα **Hospitable** είναι για όσους δουλεύουν ήδη με τη Hospitable ως σύστημα διαχείρισης. Αν δουλεύετε μόνο με Airbnb, η κάρτα **Airbnb Live** φέρνει τις κρατήσεις σας απευθείας από το Airbnb.
</Note>

## 1. Εκδώστε κλειδί API στη Hospitable

<Steps>
  <Step title="Ανοίξτε τις Ρυθμίσεις → Integrations">
    Συνδεθείτε στη Hospitable και ανοίξτε τις **Ρυθμίσεις** (γρανάζι) → **«Integrations»**.
  </Step>

  <Step title="Δημιουργήστε νέο κλειδί">
    Στην ενότητα **«Tools»** επιλέξτε **«API access»** και μετά **«Add new»**.
  </Step>

  <Step title="Δώστε όνομα και πρόσβαση">
    Δώστε ένα όνομα (π.χ. `Etherly`) και επιλέξτε πρόσβαση σε **ακίνητα** και **κρατήσεις**.
  </Step>

  <Step title="Αντιγράψτε το κλειδί">
    Αντιγράψτε το κλειδί που εμφανίζεται. Η Hospitable το δείχνει **μία φορά**.
  </Step>
</Steps>

## 2. Συνδέστε τον λογαριασμό στο Etherly

<Steps>
  <Step title="Ανοίξτε την κάρτα Hospitable">
    Στις **Ρυθμίσεις → Διασυνδέσεις**, βρείτε την κάρτα **Hospitable** και πατήστε **Σύνδεση**.
  </Step>

  <Step title="Επικολλήστε το κλειδί">
    Επικολλήστε το κλειδί στο πεδίο **«Κλειδί API (Personal Access Token)»** και συνεχίστε. Το Etherly ελέγχει το κλειδί με τη Hospitable πριν το αποθηκεύσει — κρυπτογραφημένο.
  </Step>

  <Step title="Ο πρώτος συγχρονισμός ξεκινά">
    Μόλις επιβεβαιωθεί το κλειδί, ο πρώτος συγχρονισμός ξεκινά αυτόματα. Τα ακίνητα και οι κρατήσεις σας εμφανίζονται μόλις ολοκληρωθεί.
  </Step>
</Steps>

<Note>
  Τα ακίνητα της Hospitable προστίθενται ως **ξεχωριστό σετ**, δίπλα σε αυτά που ήδη έχετε. Κάθε σετ κρατά δικές του κατηγορίες Τέλους Ανθεκτικότητας (ΤΑΚΚ) και ρυθμίσεις τιμολόγησης — τις ορίζετε μία φορά στα **Ακίνητα**.

  Οι κρατήσεις Airbnb που έρχονται ήδη από άλλη σύνδεση **τιμολογούνται μία φορά**.
</Note>

## 3. Ενεργοποιήστε τις άμεσες ενημερώσεις

Με τις άμεσες ενημερώσεις, οι αλλαγές στη Hospitable φτάνουν στο Etherly αμέσως. Ο συγχρονισμός λειτουργεί και χωρίς αυτές, με προγραμματισμένους ελέγχους.

<Steps>
  <Step title="Εκδώστε τον σύνδεσμο">
    Στη γραμμή της σύνδεσης πατήστε **«Ρύθμιση άμεσων ενημερώσεων»** — ή **Ρύθμιση** και μετά την ενότητα **«Άμεσες ενημερώσεις»**. Πατήστε **Έκδοση συνδέσμου** και αντιγράψτε τον: εμφανίζεται **μόνο τότε**.
  </Step>

  <Step title="Δηλώστε τον στη Hospitable">
    Στη Hospitable ανοίξτε **Ρυθμίσεις → «Integrations» → «Webhooks»**, προσθέστε νέο webhook και επικολλήστε τον σύνδεσμο.
  </Step>

  <Step title="Επιλέξτε τα συμβάντα">
    Επιλέξτε τα συμβάντα για **κρατήσεις**, **ακίνητα** και **καταχωρίσεις** και αποθηκεύστε.
  </Step>

  <Step title="Επιβεβαιώστε">
    Μόλις φτάσει η πρώτη ενημέρωση, η ένδειξη στην κάρτα γίνεται **«Ενεργές»** και εμφανίζεται η ώρα της τελευταίας ενημέρωσης.
  </Step>
</Steps>

<Tip>
  Χρειάζεστε τον σύνδεσμο ξανά; Πατήστε **Έκδοση νέου συνδέσμου** και δηλώστε τον στη Hospitable. Ο προηγούμενος παύει να ισχύει.
</Tip>

## Τι σημαίνει «κράτηση σε χειροκίνητο έλεγχο»

Αν μια κράτηση έχει χρέωση που η εφαρμογή δεν αναγνωρίζει ακόμη, η κράτηση εμφανίζεται στις **Κρατήσεις** με ένδειξη **«Χρειάζεται ενέργεια»** και περιμένει την επιβεβαίωσή σας.

Είναι σκόπιμο: κάθε κανάλι ονομάζει διαφορετικά τις χρεώσεις του, και το ποσό που δηλώνεται πρέπει να είναι αυτό που πραγματικά εισπράχθηκε. Ελέγχετε την κράτηση, επιβεβαιώνετε τα ποσά και το παραστατικό προχωρά κανονικά.

## Διαχείριση της σύνδεσης

Από την κάρτα **Hospitable → Ρύθμιση** βλέπετε τον συνδεδεμένο λογαριασμό, τον τελευταίο συγχρονισμό και τα ακίνητα που ήρθαν από αυτή τη σύνδεση.

### Αντικατάσταση κλειδιού

Αν εκδώσετε νέο κλειδί στη Hospitable, πατήστε **Αντικατάσταση κλειδιού** και επικολλήστε το. Το νέο κλειδί πρέπει να ανήκει στον **ίδιο** λογαριασμό Hospitable, ώστε τα ακίνητα και οι κρατήσεις που έχετε ήδη να παραμείνουν συνδεδεμένα. Για άλλον λογαριασμό, δημιουργήστε νέα σύνδεση.

### «Απαιτείται νέο κλειδί»

Αν δείτε αυτή την ένδειξη, η Hospitable δεν δέχεται πλέον το κλειδί και ο συγχρονισμός σταμάτησε. Εκδώστε νέο κλειδί στη Hospitable και επικολλήστε το — οι κρατήσεις και τα παραστατικά σας παραμένουν όπως είναι.

<Note>
  Κάθε λογαριασμός Hospitable συνδέεται μία φορά, ώστε κάθε κράτηση να τιμολογείται μία φορά.
</Note>