データ連携

Shopify との接続設定と、Shopify から届いたデータの履歴確認・再処理、Shopify への書き戻しの記録をまとめています。

Shopify との接続

Webtop の Commerce アプリ → 接続 → Shop で設定します。

Admin API（ショップドメイン・API バージョン・クライアント ID・クライアントシークレットの 4 項目）: これを設定すると、商品・在庫・注文などのやり取りが有効になります。4 項目すべてが揃って初めて有効になります。
Webhook shared secret: 通常は設定不要です（下記の「Webhook の登録」で自動登録した通知は、この項目がなくても正しく認証されます）。Shopify の管理画面から手動で通知を作成した場合にのみ、その認証のために設定します。

Webhook の登録

Shopify からの通知（注文・商品・在庫・返金などの変化）を受け取るには、Shopify 側に通知の登録が必要です。Admin API の設定が済んでいれば、Webtop の Commerce アプリ → 接続 → Webhooks から、公開先の URL を入力してボタンを押すだけで、必要な通知をまとめて登録できます。一度登録すれば、登録状況もこの画面で確認できます。

受け取ったデータの履歴・再処理

届いたデータはすべて履歴として記録され、あとから確認・再処理できます。Webtop の Commerce Events アプリで、状況（成功・エラーなど）・種類・期間で絞り込んで確認し、必要に応じて個別またはまとめて再処理できます。

エラーになったデータは、時間をおいて自動的に再試行されます（設定回数まで）。回数を使い切っても解決しない場合は、履歴から手動で再処理してください。

Shopify への書き戻し

出荷情報の記録、商品情報の反映、価格・在庫の更新など、Shopify 側にデータを書き戻す操作は、それぞれの機能の画面（Commerce Product、注文のフルフィルメントなど）から行います。書き戻しには Admin API の接続が必要です。未接続の間は、書き戻しが必要な操作はスキップされ、こちら側の記録のみが更新されます。

書き戻しの実行結果（成功・失敗を含むすべての試行）は、Webtop の Commerce Oplog アプリで確認・ダウンロードできます。