# 店舗を管理する

リーダーを実際の使用場所ごとにグループ化して管理します。

店舗とゾーンを使用することで、さまざまな実店舗での複数のリーダーの管理を効率化できます。

店舗とゾーンは、各リーダーを特定の運用サイトに関連付けることで役立ち、正しい地域設定がダウンロードされます。

- **店舗**: リーダーをグループ化し、接続ステータスをモニタリングして、実際の使用店舗に基づいて設定を変更することができます。この機能は、複数の連結アカウントのマーケットプレイスで役立ちます。

- **ゾーン**: 店舗とリーダーをさらに細かく分類するためのオプションの方法です。ゾーンを使用して、リーダーと店舗のより大きいグループ (国などのより大きな地域や組織のサブブランドなど) を表すことができます。複数の店舗を単一のゾーンに所属させることができ、ゾーンの下に複数のゾーンをグループ化して、階層後続を作成することができます。

> ゾーンは、店舗をグループ化する追加の方法を提供します。さらに、リーダーを店舗に割り当てる必要があります。店舗を割り当てることができるのは 1 つのゾーンのみです。
サンプル組織の戦略 (See full diagram at https://docs.stripe.com/terminal/fleet/locations-and-zones)
## 店舗

リーダーを運用する実際の店舗ごとに店舗を作成できます。各店舗に複数のリーダーを[登録](https://docs.stripe.com/terminal/fleet/register-readers.md)し、それらの店舗をゾーン内にネストできます。リーダーを使用する前に、それを店舗に登録する必要があります。

店舗に必要な[住所プロパティは](https://docs.stripe.com/api/terminal/locations/create.md#create_terminal_location-address)国によって異なります。

### 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

> ダッシュボードまたは API を使用して `Location` オブジェクトを更新できます。店舗の作成後に、国を変更することはできません。代わりに、新しい国で新しい店舗を作成して、古い店舗に関連付けられているリーダーを再登録することは可能です。

## ゾーン

ゾーンは最上位のグループであり、複数のゾーンまたは店舗で構成できます。既存のゾーンの下にネストされたゾーンをさらに追加し、「西海岸」のような追加の階層レベルを作成できます。ただし、ゾーンに店舗を整理することはオプションです。

## 店舗とゾーンの作成

# ダッシュボード

> This is a ダッシュボード 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.

まず、決済を導入するには、[リーダーを店舗に登録](https://docs.stripe.com/terminal/fleet/register-readers.md?dashboard-or-api=dashboard)する必要があります。店舗やゾーンは、[店舗管理](https://dashboard.stripe.com/terminal/locations/manage)ページで管理することができます。このページを開くには、 **店舗**タブの **店舗を管理** ボタンをクリックしてください。

### 店舗を作成する

店舗を作成するには：

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページで、 **店舗の作成** をクリックします。
1. 名前と有効な住所を入力してください。住所を提供することで、リーダーが稼働している地域に基づいて正しい構成と設定が適用されます。
1. **完了**をクリックします。

その店舗に固有の[設定](https://docs.stripe.com/terminal/fleet/configurations-overview.md)を作成することもできます。

### ゾーンを作成する

ゾーンを作成するには

1. **すべての店舗**行のオーバーフローメニュー (⋯) をクリックして、**ゾーンを作成**をクリックします。
1. 名称を入力
1. **完了**をクリックします。

### ネストされたゾーンを作成する

ネストされたゾーンを作成するには

1. ネストされたゾーンを作成するゾーンのオーバーフローメニュー (⋯) をクリックして、**ゾーンを作成**をクリックします。
1. 名称を入力
1. **完了**をクリックします。

### ゾーンに店舗を追加または移動

ゾーンに店舗を追加または移動するには：

1. 店舗のオーバーフローメニュー (⋯) をクリックして、**店舗を移動**をクリックします。
1. 店舗を移動するゾーンまたはネストされたゾーンを選択します。
1. **完了**をクリックします。

### 店舗の削除

店舗を削除するには、その店舗に関連付けられているリーダーを削除する必要があります。

1. [Terminal Locations](https://dashboard.stripe.com/terminal/locations) ページで、店舗のオーバーフローメニュー (⋯) をクリックします。または、店舗をクリックして、詳細ページのオーバーフローメニューボタンをクリックします。
1. **店舗を削除** をクリックします。
1. **削除** をクリックします。

### ゾーンを削除する

ゾーンを削除するには、そのゾーンに関連付けられているリーダーを削除する必要があります。

1. 削除する店舗からすべてのリーダーを削除し、そのゾーンの下のすべての店舗を削除します。
   - (オプション) リーダーがある店舗を別のゾーンに移動します。
1. ゾーンのオーバーフローメニュー (⋯) をクリックして、**ゾーンを削除**をクリックします。
1. **はい、ゾーンを削除します**をクリックします。


# 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.

> API を使用してゾーンを作成または変更することはできません。

まず、決済を受け付ける[店舗にリーダーを登録](https://docs.stripe.com/terminal/fleet/register-readers.md?dashboard-or-api=api)する必要があります。

API を使用して新しい Terminal [店舗](https://docs.stripe.com/api/terminal/locations.md)オブジェクトを作成するには、[店舗作成](https://docs.stripe.com/api/terminal/locations/create.md)リクエストを使用します。

```curl
curl https://api.stripe.com/v1/terminal/locations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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
```

### ダイレクト支払いを使用してアカウントの店舗を作成する

[ダイレクト支払い](https://docs.stripe.com/connect/direct-charges.md)を使用するアカウントの店舗を作成するには、リクエストで `Stripe-Account` ヘッダーを使用します。これらの店舗にアクセスできるのは、認証を行った Connect アカウントのみです。ビジネスを複数の物理的な場所で展開している場合は、ダイレクト支払いを使用する個々のアカウントに対して、複数の店舗を作成できます。

```curl
curl https://api.stripe.com/v1/terminal/locations \
  -u "<<YOUR_SECRET_KEY>>:" \
  -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
```

### デスティネーション支払いを使用してアカウントの店舗を作成する

[デスティネーション支払い](https://docs.stripe.com/connect/destination-charges.md)を使用する実装の場合、店舗は *platform* アカウントに属し、厳密には Connect アカウントにマッピングされません。プラットフォームでデスティネーション支払いを使用するアカウントと店舗を関連付ける必要がある場合は、店舗の[メタデータ](https://docs.stripe.com/api/terminal/locations/object.md#terminal_location_object-metadata)プロパティに、関連するアカウントへの参照を格納できます。

#### curl

```bash
curl https://api.stripe.com/v1/terminal/locations \
  -u <<YOUR_SECRET_KEY>>: \
  -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}}"
```

[リーダーを店舗に登録すると](https://docs.stripe.com/terminal/fleet/register-readers.md)、指定した店舗でリーダーがグループ化され、その国の設定が定義されます。

## 接続トークンの範囲を指定する (サーバー側) (スマートリーダー)

Terminal SDK の [ConnectionToken](https://docs.stripe.com/api/terminal/connection_tokens.md) を作成する際は、`店舗`パラメーターを指定して、スマートリーダーへのアクセスを制御できます。店舗を指定すると、ConnectionToken はその店舗に割り当てられたスマートリーダーでのみ利用可能になります。店舗を指定しなければ、すべてのリーダーで ConnectionToken を使用できます。

> Bluetooth リーダーの場合、ConnectionToken の `location` は何も影響しません。このため、いつでも近くにある Bluetooth リーダーを検出できます。

```curl
curl https://api.stripe.com/v1/terminal/connection_tokens \
  -u "<<YOUR_SECRET_KEY>>:" \
  -d location="{{TERMINALLOCATION_ID}}"
```