Stocky 移行ガイド

事前準備

• Shopify ストア管理者権限
• UreyukiBox がインストール済み（Free プランで OK）
• Stocky 管理画面にログインできること（API キー取得のため）

移行されるデータ

• 仕入先（Suppliers） — 名称、連絡先、リードタイム、適格請求書発行事業者番号
• 発注書（Purchase Orders） — 過去の発注履歴、明細、ステータス
• 在庫調整（Stock Adjustments） — 棚卸し・破損・返品など
• 税区分（Tax Types） — 軽減税率 8% / 標準税率 10% の紐付け

注意: 在庫数量そのものは Shopify 本体側に保持されているため、UreyukiBox は Shopify Admin API から直接取得します。Stocky からの転送は不要です。

移行手順

ステップ 1: Stocky API キーを取得

1. Shopify 管理画面で Stocky アプリを開きます。
2. 右上の Preferences（設定）→ API をクリック。
3. 表示された API キーをコピー（長い英数字の文字列）。

このキーは Stocky の読み取り専用権限のみを持ちます。UreyukiBox は移行完了後、サーバー側にキーを保持しません。

ステップ 2: 店舗名を確認

Shopify 管理画面 URL の先頭部分（例: your-shop.myshopify.com の your-shop 部分）が店舗名です。

ステップ 3: UreyukiBox の移行ウィザードを実行

1. UreyukiBox を開き、サイドナビの「Stocky 移行」をクリック。
2. イントロ画面で「次へ」を押す。
3. API キーと店舗名を入力し、「移行を開始」をクリック。
4. 進捗バーが完了するまで数分〜十数分待ちます（タブを閉じても処理は継続）。

ステップ 4: 完了確認

1. 完了画面に取り込んだレコード数（仕入先 N 件、発注書 N 件 ...）が表示されます。
2. ダッシュボードに戻り、売れ筋 TOP 10 と在庫合計が表示されることを確認。
3. 「発注書」ページで仕入先セレクタに移行した取引先が表示されることを確認。

よくある質問

移行に失敗した場合、Stocky のデータは消えますか？

いいえ。本移行は Stocky からの読み取りのみで、Stocky 側のデータは一切変更しません。失敗した場合は Stocky に戻して問題ありません。

途中で中断したらどうなりますか？

バックエンドのジョブとして実行されているため、ブラウザを閉じても処理は継続します。再度ウィザードを開くと最新の進捗が表示されます。

移行を再実行できますか？

できます。同じ仕入先・発注書は重複登録されず、追加・更新分のみが反映されます（idempotent）。

Stocky 以外のアプリから移行できますか？

v1 では Stocky 専用です。他アプリからの移行は CSV インポートで対応予定です（時期未定）。