# Standorte verwalten Ihre Lesegeräte nach physischem Standort gruppieren und verwalten. Sie können die Verwaltung mehrerer Lesegeräte über verschiedene physische Standorte hinweg optimieren, indem Sie Standorte und Zonen verwenden. Standorte und Zonen sind hilfreich, indem sie jedes Lesegerät mit bestimmten Betriebsstandorten verknüpfen und garantieren, dass die richtigen regionalen Konfigurationen heruntergeladen werden. - **Standorte**: Ermöglicht es Ihnen, Lesegeräte zu gruppieren, ihren Verbindungsstatus zu überwachen und Ihre Einstellungen basierend auf dem physischen Standort zu ändern. Diese Funktionalität ist für Marktplätze mit mehreren verbundenen Konten von Vorteil. - **Zonen**: Bietet eine optionale Methode zur weiteren Kategorisierung von Standorten und Lesegeräten. Bei Verwendung von Zonen können Sie weitgefasstere Gruppen von Lesegeräten oder Standorten darstellen, wie größere geografische Regionen (zum Beispiel Länder) oder Untermarken für Organisationen. Mehrere Standorte können zu einer einzelnen Zone gehören, und Sie können eine hierarchische Struktur erstellen, indem Sie mehrere Zonen unter einer einzelnen Zone gruppieren. > Zonen bieten eine zusätzliche Möglichkeit, Standorte zu gruppieren. Sie müssen weiterhin Lesegeräte einem Standort zuweisen, und Sie können einen Standort nur einer Zone zuweisen. Beispiel für eine Organisationsstrategie (See full diagram at https://docs.stripe.com/terminal/fleet/locations-and-zones) ## Standorte Sie können einen Standort für jeden physischen Ort erstellen, an dem Ihre Lesegeräte eingesetzt werden. Sie können mehrere Lesegeräte für jeden Standort [registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md) und diese Standorte innerhalb von Zonen verschachteln. Bevor Sie ein Lesegerät verwenden können, müssen Sie es bei einem Standort registrieren. Die erforderlichen [Adresseigenschaften](https://docs.stripe.com/api/terminal/locations/create.md#create_terminal_location-address) für einen Standort variieren je nach Land: ### Required Address Properties - Australia, Canada, Italy, Japan (Beta), Spain, United States: `line1`, `city`, `state`, `postal_code`, and `country` required - Austria, Belgium, Czech Republic, Denmark, Estonia (Beta), Finland, France, Germany, Hungary (Beta), Latvia (Beta), Liechtenstein (Beta), Lithuania (Beta), Luxembourg, Malaysia, Netherlands, New Zealand, Norway, Poland (Beta), Portugal, Romania (Beta), Slovakia (Beta), Sweden, Switzerland, United Kingdom: `line1`, `city`, `postal_code`, and `country` required - Bulgaria (Beta), Croatia (Beta), Cyprus (Beta), Ireland, Malta (Beta), Singapore, Slovenia (Beta): `line1`, `postal_code`, and `country` required - Gibraltar (Beta): `line1` and `country` required > Sie können das Dashboard oder die API verwenden, um ein `Location`-Objekt zu aktualisieren. Nachdem Sie einen Standort erstellt haben, können Sie das Land nicht mehr ändern. Erstellen Sie stattdessen einen neuen Standort in dem neuen Land und registrieren Sie dann alle mit dem alten Standort verbundenen Lesegeräte neu. ## Zonen Zonen sind die Gruppen der obersten Ebene, die entweder aus weitere Zonen oder aus Standorten bestehen können. Sie können weitere Zonen hinzufügen, die unter einer vorhandenen verschachtelt sind, wodurch zusätzliche Hierarchieebenen wie beispielsweise „Westküste“ erstellt werden. Die Unterteilung Ihrer Standorte in Zonen ist jedoch optional. ## Standorte und Zonen erstellen # Dashboard > This is a Dashboard for when dashboard-or-api is dashboard. View the full page at https://docs.stripe.com/terminal/fleet/locations-and-zones?dashboard-or-api=dashboard. Zunächst müssen Sie [Ihr Lesegerät für einen Standort registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md?dashboard-or-api=dashboard), um Zahlungen akzeptieren zu können. Sie können Ihre Standorte und Zonen auf der Seite [Standorte verwalten](https://dashboard.stripe.com/terminal/locations/manage) verwalten. Um diese Seite zu öffnen, klicken Sie auf der Registerkarte **Standorte** auf die Schaltfläche **Standorte verwalten**. ### Standort erstellen So erstellen Sie einen Standort: 1. Klicken Sie auf der Seite [Terminal-Standorte](https://dashboard.stripe.com/terminal/locations) auf **Standort erstellen** 1. Geben Sie einen Namen und eine gültige Adresse ein. Durch die Angabe einer Adresse wird sichergestellt, dass die richtige Konfiguration und die richtigen Einstellungen basierend auf der Region, in der das/die Lesegerät(e) betrieben werden, angewendet werden. 1. Klicken Sie auf **Fertig**. Sie können auch eine bestimmte [Konfiguration](https://docs.stripe.com/terminal/fleet/configurations-overview.md) für diesen Standort erstellen. ### Zone erstellen So erstellen Sie eine Zone: 1. Klicken Sie auf das Überlaufmenü (⋯) in der Zeile **Alle Standorte**, und klicken Sie dann auf **Zone erstellen**. 1. Geben Sie einen Namen ein. 1. Klicken Sie auf **Fertig**. ### Eine verschachtelte Zone erstellen So erstellen Sie eine verschachtelte Zone: 1. Klicken Sie auf das Überlaufmenü (⋯) in der Zone, für die Sie eine verschachtelte Zone erstellen möchten, und klicken Sie dann auf **Zone erstellen**. 1. Geben Sie einen Namen ein. 1. Klicken Sie auf **Fertig**. ### Hinzufügen oder Verschieben eines Standorts zu einer Zone So fügen Sie einen Standort zu einer Zone hinzu oder verschieben ihn zu einer Zone: 1. Klicken Sie auf das Überlaufmenü (⋯) für den Standort und dann auf **Standort verschieben**. 1. Wählen Sie die Zone oder die verschachtelte Zone aus, in die Sie den Standort verschieben möchten. 1. Klicken Sie auf **Fertig**. ### Einen Standort löschen Um einen Standort zu löschen, müssen Sie die ihm zugeordneten Lesegeräte entfernen: 1. Klicken Sie auf der Seite [Terminal-Standorte](https://dashboard.stripe.com/terminal/locations) im Überlaufmenü (⋯) auf den Standort oder klicken Sie auf den Standort und dann auf der Detailseite auf die Schaltfläche für das Überlaufmenü. 1. Klicken Sie auf **Standort löschen**. 1. Klicken Sie auf **Löschen**. ### Zone löschen Um eine Zone zu löschen, müssen Sie die mit ihr verknüpften Lesegeräte entfernen: 1. Entfernen Sie alle Lesegeräte von dem Standort, den Sie löschen möchten, und entfernen Sie alle Standorte unter den Zonen. - (Optional) Verschieben Sie die Standorte mit Lesegeräten in eine andere Zone. 1. Klicken Sie auf das Überlaufmenü (⋯) in der Zone und dann auf **Zone löschen**. 1. Klicken Sie auf **Ja, Zone löschen**. # API > This is a API for when dashboard-or-api is api. View the full page at https://docs.stripe.com/terminal/fleet/locations-and-zones?dashboard-or-api=api. > Sie können keine Zonen mit der API erstellen oder ändern. Zunächst müssen Sie [Ihr Lesegerät bei einem Standort registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md?dashboard-or-api=api), um Zahlungen annehmen zu können. Verwenden Sie zum Erstellen eines neuen Terminal-[Standort](https://docs.stripe.com/api/terminal/locations.md)-Objekts, das die API nutzt, die Anfrage zum [Erstellen des Standorts](https://docs.stripe.com/api/terminal/locations/create.md). ```curl curl https://api.stripe.com/v1/terminal/locations \ -u "<>:" \ -d display_name=HQ \ -d "address[line1]=1272 Valencia Street" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[country]=US" \ -d "address[postal_code]=94110" ``` ### Einen Standort für Konten mit Direct Charges erstellen Um einen Standort für ein Konto mit [Direct Charges](https://docs.stripe.com/connect/direct-charges.md) zu erstellen, verwenden Sie den Header `Stripe-Account` in Ihrer Anfrage. Nur das Connect-Konto, das Sie authentifizieren, kann auf diese Standorte zugreifen. Wenn das Unternehmen an mehreren physischen Standorten tätig ist, können Sie mehrere Standorte für einzelne Konten mit Direct Charges erstellen. ```curl curl https://api.stripe.com/v1/terminal/locations \ -u "<>:" \ -H "Stripe-Account: {{CONNECTEDACCOUNT_ID}}" \ -d display_name=HQ \ -d "address[line1]=1272 Valencia Street" \ -d "address[city]=San Francisco" \ -d "address[state]=CA" \ -d "address[country]=US" \ -d "address[postal_code]=94110" ``` ### Standort für Konten mit Destination Charges erstellen Bei Integrationen, die [Destination Charges](https://docs.stripe.com/connect/destination-charges.md) verwenden, gehören Standorte zum *Plattformkonto* und werden nicht streng verbundenen Konten zugeordnet. Wenn Ihre Plattform Konten mit Destination Charges mit Standorten verknüpfen muss, können Sie einen Verweis auf die relevanten Konten in der [Metadateneigenschaft](https://docs.stripe.com/api/terminal/locations/object.md#terminal_location_object-metadata) des Standorts speichern. #### curl ```bash curl https://api.stripe.com/v1/terminal/locations \ -u <>: \ -d "display_name"="HQ" \ -d "address[line1]"="1272 Valencia Street" \ -d "address[city]"="San Francisco" \ -d "address[state]"="CA" \ -d "address[country]"="US" \ -d "address[postal_code]"="94110" \-d "metadata[connected_account]"="{{CONNECTED_ACCOUNT_ID}}" ``` Wenn [Sie Ihr Lesegerät bei einem Standort registrieren](https://docs.stripe.com/terminal/fleet/register-readers.md), gruppiert der angegebene Standort das Lesegerät und legt dessen Ländereinstellungen fest. ## Verbindungs-Token beschränken (Serverseitig) (Smarte Lesegeräte) Bei der Erstellung eines [ConnectionToken](https://docs.stripe.com/api/terminal/connection_tokens.md) für das Terminal SDK können Sie einen `location`-Parameter angeben, um den Zugriff auf intelligente Lesegeräte einzuschränken. Wenn Sie einen Standort angeben, kann das ConnectionToken nur mit intelligenten Lesegeräten verwendet werden, die diesem Standort zugeordnet sind. Wenn Sie keinen Standort angeben, kann das ConnectionToken mit allen Lesegeräten verwendet werden. > Bei Bluetooth-Lesegeräten hat der `location` eines ConnectionToken keine Auswirkung. Dadurch wird sichergestellt, dass alle in der Nähe befindlichen Bluetooth-Lesegeräte auffindbar bleiben. ```curl curl https://api.stripe.com/v1/terminal/connection_tokens \ -u "<>:" \ -d "location={{TERMINALLOCATION_ID}}" ```