EC注文連携

First Crack は 外部 EC の注文を収集 し、焙煎必要量を計算して完成品在庫の出荷と接続します。
プラットフォームの API キーは サーバーのみ に保存され、デスクトップアプリには再表示されません。

料金プラン

注文・チャンネル連携は Enterprise（または注文連携が含まれるプラン）で利用できます。ロック画面が出る場合は設定 → お支払いでプランを確認してください。

対応チャンネル

チャンネル	接続方式	収集方式
Naver Smart Store	Client ID + Client Secret	定期ポーリング（Webhook なし）
Shopify	ショップドメイン + Admin API access token	ポーリング（将来 Webhook）
Cafe24	Mall ID + Access token	ポーリング（将来 Webhook）

全体フロー

1. アプリ → 注文 → チャンネル
2. プラットフォームを選び資格情報を入力 → 接続（サーバーが実 API で検証）
3. 今すぐ同期 または自動同期で注文収集
4. SKU マッピング の後、焙煎必要量・出荷を利用

EC で注文発生
    ↓
同期 (order-sync)
    ↓
orders / order_lines 保存
    ↓
products.sku と照合 → 焙煎必要量カード
    ↓
出荷処理 → 完成品在庫減

アプリでの開き方

1. First Crack にログイン
2. サイドバー 注文
3. 上部タブ チャンネル
4. 連携するプラットフォームボタンを押す

次に読むドキュメント

• Naver Smart Store — Commerce API アプリ発行
• Shopify — カスタムアプリとスコープ
• Cafe24 — Mall ID と OAuth トークン
• SKU マッピング — 注文明細 ↔ 焙煎商品
• トラブルシューティング — 接続失敗・注文が来ないとき