---
articleId: 9f3a589f-ef1c-4875-ae5a-67a83e34631b
slug: connection-configuration-smaregi
title: 接続情報 - スマレジ
parentCategoryId: 4db89ef6-4431-4a1f-a7c6-6c3b8a1a224c
languageCode: ja
---
本ページでは、スマレジに接続するための設定（接続情報）について説明します。
転送設定については、[転送元 - スマレジ](/docs/data-source-smaregi)を参照ください。

## 認証方式

スマレジ接続情報では、以下の認証方式をサポートしています。

- OAuth 2.0

### OAuth 2.0認証について

スマレジAPIは、OAuth 2.0標準に準拠した認証方式を採用しています。
TROCCOでは、OAuth 2.0のAuthorization Code Flowを使用してユーザー委譲アクセスを行います。

:::(Warning) (OAuth 2.0認証による設定の前に)

TROCCOで接続情報を設定する前に、スマレジAppMarketで利用申し込みが必要です。
詳しくは[スマレジ側で必要な作業](/docs/connection-configuration-smaregi#スマレジ側の事前準備)を参照ください。

:::

OAuth 2.0認証では、以下のフローで認証を実施します。

1. TROCCOからスマレジの認証画面にリダイレクトされます。
2. ユーザーがスマレジアカウントでログインし、権限の付与を許可します。
3. 認証が成功すると、TROCCOにアクセストークンとリフレッシュトークンが発行されます。
4. TROCCOは、このトークンを使用してスマレジAPIにアクセスします。

:::(Info) (リフレッシュトークンの有効期限)

スマレジのリフレッシュトークンの有効期限は、**30日間**です。
30日間アクセスがない場合、再度認証が必要になります。
定期的に転送設定を実行することで、自動的にトークンが更新されます。
:::

## スマレジ側の事前準備

認証を行う前に、スマレジAppMarketで利用申込が必要です。まずは以下の手順でTROCCOアプリの利用申込を完了してください。

1. スマレジAppMarketの[TROCCOアプリページ](https://apps.smaregi.jp/apps/2791) にアクセスし、「ログインして申込」をクリック
2. スマレジへログインし、プラン「無料プラン」を選択し、「利用を開始」をクリック
3. 権限許可の画面が表示されるので「許可して進む」をクリック

## 設定項目

スマレジ接続情報の設定項目は以下のとおりです。

| 項目名 | 必須 | デフォルト値 | 内容 |
| --- | --- | --- | --- |
| 接続情報名 | Yes | - | 接続情報の識別名を入力します。わかりやすい名前を付けることを推奨します。 |
| 説明 | - | - | 接続情報の説明を入力します。この接続情報の用途などを記載できます。 |
| スマレジアカウント | Yes | - | スマレジアカウントで認証を行います。**スマレジアカウント認証**ボタンをクリックして、OAuth 2.0認証を実施してください。 |

### スマレジアカウント認証の手順

スマレジアカウント認証は、以下の手順で実施します。

1. 接続情報の新規作成画面または編集画面で、**スマレジアカウント認証**ボタンをクリックします。
2. スマレジのログイン画面にリダイレクトされます。
3. スマレジアカウントの認証情報（メールアドレスとパスワード）を入力してログインします。
4. 権限の許可画面が表示されます。TROCCOが要求する権限を確認し、**許可**をクリックします。
5. TROCCOの接続情報画面に戻ります。認証日時が表示されていることを確認してください。
6. 接続情報を保存します。

:::(Info) (要求される権限について)

TROCCOは、以下の読み取り専用権限を要求します。

- 商品情報の読み取り
- 顧客情報の読み取り
- 在庫情報の読み取り
- 在庫変動情報の読み取り
- 取引情報の読み取り
- 仕入先情報の読み取り
- 店舗情報の読み取り
- スタッフ情報の読み取り

すべて読み取り専用権限のため、TROCCOがスマレジのデータを変更することはありません。
:::

## スマレジ側での権限付与

スマレジからデータを取得する場合、認証に使用するユーザーアカウントに適切なロールが付与されている必要があります。

認証したユーザーアカウントがアクセス可能なデータのみが転送対象となります。
必要なデータにアクセスできない場合は、スマレジの管理者に連絡して、適切なロールを付与してもらってください。

:::(Warning) (ロールとロケーションによる制限)

スマレジのOAuth 2.0認証（UserAccessToken）では、ロールとロケーションに基づいたアクセス制御が適用されます。
認証したユーザーが管理画面でアクセスできるデータと同じ範囲のデータのみが、TROCCOで取得可能です。

データが取得できない場合は、スマレジの管理画面で該当ユーザーのロールとロケーション設定を確認してください。
:::