Verfügbarkeitsdaten für Reservierungen strukturieren

Damit Ihre Zeitblöcke im Buchungsvorgang angezeigt werden, müssen Sie eine korrekte und aktuelle Zuordnung Ihres Inventars senden. Die Anzahl der verfügbaren Plätze kann sich nach einer einzelnen Buchung aufgrund der Art der Gastronomiebetriebe und der Möglichkeit, Tische zusammenzulegen oder die Gruppengröße zu ändern, erheblich ändern. Die Beispiele in diesem Dokument zeigen, wie Sie Ihr verfügbares Inventar richtig verwalten und zuordnen.

Im Folgenden finden Sie die Parameter, die in Availability definition angegeben sind:

  • party_size: Die Anzahl der Personen, die das Unternehmen zu diesem Zeitpunkt unterbringen kann. In den Diagrammen in diesem Artikel sehen Sie die verschiedenen Möglichkeiten, die Gruppengröße zu konfigurieren.
  • spots_open: Die Anzahl der Tabellen, die derzeit für einen bestimmten Verfügbarkeitszeitraum und eine bestimmte Gruppengröße verfügbar sind.
  • spots_total: Die Gesamtzahl der Tabellen, die der Händler für diese Konfiguration hat, einschließlich der nicht verfügbaren Tabellen.

Diese drei Parameter bilden zusammen eine digitale Darstellung des Grundrisses. party_size ist die Anzahl der Personen, die an jedem Tisch Platz finden. Für jede Größe, die in einer Tabelle dargestellt werden kann, gibt es einen Eintrag. spots_open und spots_total sind die Anzahl der Tische, an denen party_size Platz finden.

Beispiel für einen leeren Grundriss

Stellen Sie sich ein Restaurant mit dem folgenden Grundriss und ohne aktive Reservierungen vor:

Abbildung 1: Grundriss ohne aktive Buchungen

Abbildung 1. Grundriss ohne aktive Buchungen:

Die Werte für party_size, spots_open und spots_total sind:

party_size spots_open spots_total
4 3 3
5 3 3
6 4 4
7 1 1
8 1 1

Der Verfügbarkeitsfeed für einen Zeitrahmen bei diesem Händler sieht so aus:

{
  "availability": [
        {
          "spots_total": 3,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 4
          }
        },
        {
          "spots_total": 3,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 5
          }
        },
        {
          "spots_total": 4,
          "spots_open": 4,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 6
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 7
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 8
          }
        }
      ]
}

Beispiel für einen Grundriss mit einer Buchung

Ein Restaurant, in dem einer der runden Tische zuvor reserviert wurde, sieht so aus:

Abbildung 1: Grundriss mit einer aktiven Buchung

Abbildung 2. Grundriss mit einer aktiven Buchung:

Die Werte für party_size, spots_open und spots_total sind:

party_size spots_open spots_total
4 2 3
5 2 3
6 3 4
7 1 1
8 1 1

Der Verfügbarkeitsfeed für einen Zeitrahmen bei diesem Händler sieht so aus:

{
  "availability": [
        {
          "spots_total": 3,
          "spots_open": 2,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 4
          }
        },
        {
          "spots_total": 3,
          "spots_open": 2,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 5
          }
        },
        {
          "spots_total": 4,
          "spots_open": 3,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 6
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 7
          }
        },
        {
          "spots_total": 1,
          "spots_open": 1,
          "duration_sec": 3600,
          "service_id": "1000",
          "start_sec": 1535806800,
          "merchant_id": "merch1",
          "resources": {
            "party_size": 8
          }
        }
      ]
}

Verfügbarkeit von Restaurants mit Unterstützung für kombinierte Tabellen angeben

Es gibt viele Möglichkeiten, wie ein Restaurant Tische für größere Gruppen zusammenstellen kann. Sie müssen spots_open und spots_total so angeben, dass sie genau widerspiegeln, ob Sie Gruppen einer bestimmten Größe akzeptieren können.

Nachfolgend sehen Sie ein Beispiel dafür, wie Sie das Kombinieren von Tabellen angeben können. Ihre Feeds können je nach verwendeter Berechnungsmethode unterschiedlich sein. Sie können spots_open und spots_total so angeben, dass sie Ihrer Geschäftslogik entsprechen.

Wenn ein Restaurant das Zusammenlegen von Tischen für eine größere Gruppe unterstützt, können Sie spots_open und spots_total entsprechend aktualisieren.

Ein Restaurant, das beispielsweise zwei kleine Tische für eine Gruppe von 7 bis 10 Personen zusammenstellen kann:

Abbildung 1: Grundriss ohne aktive Buchungen

Abbildung 3. Grundriss ohne aktive Buchungen:

Wenn keine aktiven Buchungen vorhanden sind, sind die Werte für party_size, spots_open und spots_total:

party_size spots_open spots_total
4 3 3
5 3 3
6 4 4
7 1 1
8 1 1
9 1 1
10 1 1

Nun wird mit demselben Grundriss eine Reservierung für eine Gruppe von zehn Personen vorgenommen, bei der zwei kleine Tische kombiniert werden.

Abbildung 1: Grundriss mit einer aktiven Buchung, die sich über zwei Tische erstreckt

Abbildung 4 Grundriss mit einer aktiven Reservierung, die sich über zwei Tische erstreckt.

Die Werte für party_size, spots_open und spots_total sind dann so:

party_size spots_open spots_total
4 1 3
5 1 3
6 2 4
7 1 1
8 1 1
9 0 1
10 0 1