Akerun連携の設定

Akerun（Photosynth社のスマートロック）をfixUと連携すると、会員のチェックイン・チェックアウトに合わせてドアを解錠できます。この記事では、Akerun側のAPI利用申込からfixUでの連携、ドアへの紐付け、稼働確認までを説明します。

このページでできること

Akerun APIの利用申込を行い、クライアントID・クライアントシークレットを取得する
スマートロック管理 でAkerunアカウントをfixUに連携し、デバイス情報を取り込む
ドア管理 でドアにAkerunを紐付ける
解錠・施錠テストで動作を確認する

事前に必要なもの

Akerunの契約と、Akerun管理画面にログインできるアカウント
Akerun API利用申込で発行されるクライアントID・クライアントシークレット（下記Step1で取得）
fixU管理画面の管理者権限

手順 Step1：Akerun APIの利用申込

fixU管理画面の スマートロック管理 でAkerunの設定を開き、表示されるリダイレクトURLを控えます（申込時に入力します）。
AkerunのAPI利用申込フォームから申請します。申込種別は「新規申込」、利用用途は「他社サービスとの連携」、連携先は「fixU」を選び、リダイレクトURLには前の手順で控えたURLを入力します。
2〜3営業日で、AkerunサポートからクライアントID・クライアントシークレットが記載されたファイルが届きます（開封用のパスワードは別送されます）。

手順 Step2：fixUにAPI情報を登録して連携する

管理画面の左メニュー スマートロック管理 を開き、スマートロックアカウント管理 タブでAkerunの設定をクリックします。
Step2. API Client設定 にクライアントIDとクライアントシークレットを入力し、スマートロックAPI情報を更新する をクリックします。
スマートロックAPIとの連携を実行 をクリックします。Akerun管理画面のログイン画面が開くので、Akerunのアカウントでログインして連携を許可します。
スマートロック情報をfixUに取り込む をクリックすると、Akerunに登録されているデバイスがfixUに取り込まれます。

手順 Step3：ドアにAkerunを紐付ける

Akerunが1台の場合は、基本設定 の スマートロック連携 で、メインドア（チェックイン時に解錠されるドア）に使うスマートロックとして取り込んだAkerunを設定します。
2台目以降は、ドア管理 でドアを作成し、スマートロック選択 で取り込んだAkerunを選んで保存します。

完了の確認方法

スマートロック管理 の スマートロック稼働確認 で、設定済みのAkerunに対して解錠・施錠のテストができます。実際にドアが動作することを確認してください。会員ごとの解錠結果は、顧客管理 の顧客詳細ページ Akerun解除 タブの 解錠結果を確認する で確認できます。

Akerunを追加する・別アカウントを連携する

同じAkerunアカウントにデバイスを追加した場合は、Step2の スマートロックAPI情報を更新する → スマートロックAPIとの連携を実行 → スマートロック情報をfixUに取り込む を順に再度クリックし、ドア管理 で紐付けます。
別のAkerunアカウントを使う場合は、スマートロック管理 でスマートロックアカウントを新しく登録してください。

NFCカードで解錠する

Akerun連携では、社員証などのNFCカードを会員に紐付けて解錠に使えます。顧客管理 の顧客詳細ページ（顧客情報 タブ）で NFC情報を登録する をクリックし、カード情報を登録します。

うまくいかないとき

fixUから解錠できないが、Akerunアプリからは解錠できる：fixUとのAPI連携の障害、または連携トークンの失効が考えられます。Akerunアプリからの解錠とfixUからの解錠の両方をテストして切り分け、スマートロック管理 の連携状態と スマートロック稼働確認 の結果を確認してください。
会員がドアを開けられない：会員がチェックイン中か、プランの ドア解錠権限情報 でそのドアが許可されているかを確認してください。未払いが続いている会員は入退室できなくなる場合があります。
デバイスが取り込まれない：Akerun管理画面側で対象のデバイスが登録されているかを確認し、スマートロック情報をfixUに取り込む を再度実行してください。