API連携エラー通知メール
SCシステム(STOCKCREWシステム)のAPI連携でエラーが発生した際に自動でお送りする通知メールについて、配信条件・宛先・受信設定を説明します。
SCシステムでは、ECサイトとのAPI連携でエラーが発生した際に、自動で通知メールをお送りしています。
本記事では、通知メールの種類・配信条件・宛先・受信設定について説明します。
通知メールの種類
通常エラーの通知
件名は「【要確認】API連携エラー」で始まり、対象の店舗名が続きます。
API連携でエラーが発生したときにお送りします。
エラーの内容は「API連携ログ」画面でご確認ください。
-png-1.png?width=670&height=420&name=%E3%83%98%E3%83%AB%E3%83%97-%E8%A8%AD%E5%AE%9A%20(3)-png-1.png)
認証切れの通知
件名は「【認証切れ・要対応】API連携が停止しています」で始まり、対象の店舗名が続きます。
認証が切れて連携が停止しているときにお送りします。
再認証を行うまで、その店舗の受注取込・在庫連携・出荷連携は停止したままとなります。
再認証は、[設定] → [店舗設定] のAPI連携設定画面から行います。
認証切れの通知メールには、店舗設定へのリンクと通知設定へのリンクが並んで記載されています。
再認証を行う場合は、店舗設定側のリンクをご利用ください。
Yahooをご利用の場合、認証の有効期限が近づいた段階でも別途通知メールをお送りしています。
詳しくは「認証期限の通知メールについて(Yahoo)」をご確認ください。
通知が届く条件
検知と配信のタイミング
API連携ログを5分ごとに確認し、エラーが記録されている場合に通知メールをお送りします。
対象となるのはエラーレベルのログのみで、警告・情報レベルのログでは配信されません。
配信は店舗ごとに1通です。エラーが何件発生していても、その店舗の分は1通にまとまります。
送信時間帯の制限はありません。
夜間・早朝・土日祝日にも配信されます。
同じエラーで繰り返し届かない仕組み
一度通知をお送りした店舗には、一定時間は再送しません。
- 通常エラー:1時間
- 認証切れ:24時間
この間隔は店舗ごとにかかります。
ある店舗に通知をお送りした直後に別の店舗でエラーが発生した場合、別の店舗の通知はすぐに届きます。
通常エラーと認証切れは別々に扱うため、通常エラーの間隔中でも認証切れの通知は届きます。
通知が届かないケース
次の場合は、エラーが発生していても通知メールは届きません。
- その店舗のAPI連携がすべてOFFになっている(受注取込・受注更新・在庫更新の3つともOFF)
- 店舗が閉鎖済みである
- ご契約が解約済みである
- その会社に、通知をONにしているユーザーが1人もいない
使わなくなった店舗の通知を止めたい場合は、その店舗のAPI連携設定をOFFにしてください。
通知の宛先と受信設定
宛先
通知メールは、その会社に所属するすべてのログインユーザーのログイン用メールアドレス宛にお送りします。
通知専用のメールアドレスやメーリングリストへの配信はできません。
メーリングリストで受け取りたい場合は、メーリングリストのアドレスでアカウントを作成してご利用ください。
受信を停止する
受信の設定はユーザーごとに行います。
既定はONで、新しく追加されたユーザーもONです。
SCシステムにサインイン後、[設定] → [アカウント設定] をクリックし、通知設定のトグルを切り替えます。
トグルを切り替えた時点で保存されるため、保存ボタンの操作は必要ありません。
店舗ごとに停止することはできません。
停止するとすべての店舗の通知メールが届かなくなります。
-png-3.png?width=670&height=158&name=%E3%83%98%E3%83%AB%E3%83%97-%E8%A8%AD%E5%AE%9A%20(2)-png-3.png)
複数の会社に所属している場合
受信設定は、会社とアカウントの組み合わせごとに保持されます。
会社を切り替えると、トグルの状態も切り替わります。
会社の切り替え手順は「アカウント設定」をご確認ください。
同じメールアドレスで複数のアカウントをお持ちの場合、一方を停止しても、もう一方がONであれば通知は届き続けます。
受信設定がメールアドレス単位ではなくユーザー単位のためです。
なお、同じアドレスに同じ通知が2通届くことはありません。
注意点
- 通知メールは夜間・早朝・土日祝日にも配信されます。受信のタイミングを調整したい場合は、ご利用のメールソフトの通知設定でご調整ください。
- 停止していた期間に発生したエラーは、受信を再開しても遡って配信されません。その期間のエラーはAPI連携ログ画面でご確認いただけます。
- 通知メールは最大3回まで自動で再送を試みます。3回とも失敗した分は、あらためて配信されることはありません。
- 通知メールは送信専用です。ご返信いただいても確認できませんので、お問い合わせはカスタマーポータルをご利用ください。
- 通知メールにエラーの内容そのものは記載していません。詳細は必ずAPI連携ログ画面でご確認ください。
- 通知メールの本文は日本語のみです。通知設定の画面表示は日本語と英語に対応しています。