# CC 配送日時指定 サポート用マニュアル (AI向け) このファイルは、Shopify アプリ「CC 配送日時指定」の問い合わせに答えるためのマニュアルです。 **この文書を読み込んだあと、ユーザーからの質問に、この文書だけを根拠に日本語で答えてください。** - この文書に書かれていないことは断定せず、「CC 配送日時指定」の開発元への問い合わせを案内し、問い合わせメールの文面を下書きする (索引の「問い合わせの下書き」参照)。送信はユーザーが行う。 - 回答には、根拠の SEE にあるマニュアル URL を 1〜2 本添える。 - ルール ID (S-1 / G-1 / SYM-1 など) は内部の根拠。ユーザー向けの文面には出さない。 - 設定手順は PROC-* のとおりに案内し、書かれていない項目名・ボタン名を作らない。 - 原因の断定を求められても、ESCALATE に該当するときは必要な情報の提供を依頼する。 --- # AI向けマニュアル 索引と回答ルール ```yaml doc: ai-manual app: CC 配送日時指定 (Shopify app) audience: サポート対応AI / 返信ドラフト作成AI source_of_truth: アプリの実装 (ウィジェット・管理画面・バックエンド) を読んで確認した内容のみ記載 ui_verified: 2026-10-12 / 2026-10-13 開発用管理画面で、項目名・カード構成・階層を読み取り確認 (グループ有効時・配送方法有効時・必須化 ON 時を含む)。2026-10-13 に capital-castle-demo-3 で、グループの追加・コピー・削除、配送方法の追加・アイコン、選択肢の追加、必須化、条件を実際に操作して確認 (操作後に元の状態へ復元) language: ja ``` ## 読み方 - 各ページは同じ構造: `SUMMARY` → `RULES` (条件→結果。ID付き) → `UI_LABELS` (管理画面の項目名と設定キー) → `QA` (正規の質問と回答) → `ESCALATE` (断定せず情報を求める条件) → `SEE`。 - ルールIDは `S-1` (最短日) / `G-1` (グループ) / `C-1` (概念) の形。ID は全ページで重複しない (CSV 基本は `CS-`、出荷リードタイムは `LT-`、商品ページは `PP-`、配送方法のカスタマイズは `SC-`、症状別の事実は `TS-`、追跡番号は `TU-` / `PROC-TU1`)。回答の根拠として内部で参照してよい。お客様向けの文面にはIDを出さない。 ## 回答の鉄則 ```text R1. このセクションまたは SEE のページに無いことは断定しない。「CC 配送日時指定」の開発元への問い合わせを案内し、問い合わせメールの文面を下書きする (「問い合わせの下書き」参照)。 R2. できる/できない は QA と RULES だけを根拠にする。 R3. 回答には SEE の人間向けマニュアルURLを1〜2本添える。 R4. 手順は管理画面の画面名で案内する (UI_LABELS 参照)。 R5. ESCALATE に該当する場合は、結論を言わず必要情報の提供を依頼する。 R6. Pro プラン限定: CSV出力 (追跡番号のアップデート・振り分けルール・出荷リードタイムを含む) / システム連携 / 配送方法のカスタマイズ / 注文タグの日付フォーマットの変更。 R7. 1つの注文には1つの配送日時しか付かない (商品ごとの別日指定は不可)。 R8. 設定手順は PROC-* のページの手順どおりに案内する。項目名は「」の表記をそのまま使い、書いていない項目名・ボタン名を作らない。 R9. 「◯◯ができるか」は、PROC-* / FACTS / QA のどれにも無ければ断定せず、「CC 配送日時指定」の開発元への問い合わせを案内し、文面を下書きする。 R10. 症状の相談 (動かない・出ない・入らない) は、原因を断定せず、症状別ページ (SYM-*) の確認の順番どおりに聞く。 R11. 「できますか」のうち支払方法別・マイページ・定期購入・POS・他アプリの質問は、できないこと・他アプリのページ (L-* / X-*) を根拠にする。別アプリ (オーダールール等) は範囲外であることを伝え、「CC 配送日時指定」の開発元への問い合わせを案内して文面を下書きする。 R12. 設定の場所を案内するときは、必ず左メニューからの道順を「アプリの左メニュー「設定」 > カード「配送希望日」 > 「営業休業日」」の形で示す (各 PROC-* の「場所:」の行をそのまま使う)。道順は「どこの画面か」「どのカードか」「どの項目か」の順に書く。Shopify 管理画面の「設定」「オンラインストア」と、アプリの左メニューの同名の項目を混同しないよう、「アプリの左メニュー」「Shopify 管理画面の」を必ず付ける。 ``` ## 要点 (よくある質問の直接回答) このページだけを読んだ場合でも、次の質問には答えられる。詳しい手順・条件は、各行のページを読む。**CSV 出力 (Pro) の話と混同しない**: 注文への保存と、CSV 出力は別の機能。 | 質問 | 要点 | 詳しくは | | --- | --- | --- | | 配送日時は注文にどう保存されるか。キー名と値の形式は | 注文の「追加の詳細」(customAttributes) に保存される。キー名は管理画面の「表示ラベル」と同じ (ラベルを変えるとキーも変わる)。値は、日付が「入力される日付のフォーマット」(既定 YYYY年M月D日。管理画面の言語による)、時間が選んだ時間帯の文字。既定のキー名の例はこのマニュアルには無く、断定しない。Pro の連携では、キーと書式を連携先に合わせて別に決められる。`order.date` などは CSV 出力用の名前で、実際のキー名ではない | [基本概念](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/010/concepts/) C-7〜C-11 | | 注文のメタフィールド・メモ・タグにも入れられるか | 入れられる。「オプション」の「注文への自動書き込み」を使う (Shopify Flow が必要)。メタフィールドはネームスペースとキーを指定する (既定 custom.delivery_date / custom.delivery_time)。型は日付型 / テキスト型。Pro の CSV の「メタフィールドを取得する」は、すでにあるメタフィールドを CSV に読み出す機能で、書き込みではない | [設定手順: オプション](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/070/setup-options/) PROC-O2 | | 営業休業日は設定できるか | できる (ノーマルでも使える)。アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日」の下 > 「営業休業日」。曜日のチェックとカレンダーで決め、祝日は「2026年の祝日を反映」「2027年の祝日を反映」(日本語の管理画面) で一括追加できる。設定はグループ・配送方法ごとに別 | [設定手順: 配送希望日](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/040/setup-date/) PROC-D4 | | 営業休業日と指定不可日の違いは | 営業休業日は最短日の営業日の数え方だけに効く (カレンダーでは選べるまま)。選べなくするのは指定不可日。祝日で配送もしないときは両方に登録する。最長日は暦日で数え、営業休業日は含まれない | [最短日・選択可否の判定](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/020/shortest-date-logic/) S-2 / S-8 / S-9 | | 商品ごとに別の配送日を選ばせられるか | できない。1 つの注文には 1 つの配送日時が付く | R7 | | 料金・プランの違いは | ノーマル 2.99 ドル/月、プロ 4.99 ドル/月。どちらも 14 日間の無料期間がある。日時指定そのものはノーマルで使える。プロは CSV 出力・外部システム連携・配送方法のカスタマイズが使える | [料金・プラン](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/065/plans-and-pre-sale/) B-1 / B-2 | | 個人情報はアプリに保存されるか | アプリのサーバーには保存しない。CSV の自由入力欄に入れた内容は保存される | [料金・プラン](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/065/plans-and-pre-sale/) B-7 | | 支払方法別・定期購入のときだけ出し分けたい | どちらも設定ではできない。支払方法別は、注記欄の文言で案内する方法がある (L-1)。定期購入は、自分でコードを書く方法があるがサポート対象外 (L-6) | [できないこと・他アプリ](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/085/limits-and-other-apps/) L-1 / L-6 | | チェックアウトの画面に日時指定を出せるか | 出せない。カートの画面に出す。サンキューページ・注文状況ページには「表示」するブロックを置ける | [できないこと・他アプリ](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/085/limits-and-other-apps/) L-2 / L-5 | | 注文に配送日時が付かない | 「今すぐ購入」などの動的チェックアウトは属性を運べない。他アプリの干渉も多い。確認の順番は症状別ページのとおり | [症状別の切り分け](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/080/troubleshooting/) SYM-2 / TS-6 | ## アプリの管理画面の左メニュー (道順の起点) アプリを開いたときの左メニュー (上から順)。道順は必ずここから始める。 | 左メニュー | 中身 | | --- | --- | | 設定 | 配送希望日・配送指定時間・配送方法・入力テキスト・注記・対象商品・商品のグループ化 など (カードの並び)。グループ化・配送方法を ON にすると、「設定」の下にグループ・配送方法ごとの項目が出る | | 非表示商品 | 「設定」の下の項目。商品ごとに配送日時を出さない設定 | | スタイル | ウィジェットの見た目 | | オンラインストア | テーマ関連の画面 (Shopify 管理画面の「オンラインストア」とは別) | | オプション | 注文タグ・メール/チェックアウト画面への表示・有効性検証・カートアトリビュートの更新・営業休業日カレンダーの設定 | | 連携(プロプラン) | Pro プランの有効化・CSV出力機能のON・外部システム連携・チェックアウトの配送オプションのカスタマイズ | | CSV | Pro の CSV 画面 (画面上部のタブ「注文一覧」「設定」「発送(追跡番号)」)。「連携(プロプラン)」で CSV出力機能を ON にすると出る | | お知らせ | お知らせの画面 | 画面上部のボタン: 「保存する」「言語」「問合せ」。 ## 質問 → ページの対応 | 質問の種類 | ページ | | --- | --- | | 用語・どこで設定するか・グループとは | [基本概念](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/010/concepts/) | | **注文データ**: 配送日時が注文にどう保存されるか・「追加の詳細」(customAttributes) のキー名と値の形式・注文メタフィールド/メモ/タグへの保存 (CSV ではない) | [基本概念](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/010/concepts/) の C-7〜C-11 と [設定手順: オプション](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/070/setup-options/) の PROC-O2 | | 最短日・最長日・カットオフ・休業日・指定不可日・選べる/選べない日 | [最短日・選択可否の判定](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/020/shortest-date-logic/) | | 商品ごとの設定・複数商品・グループ優先・非表示・ウィジェットが出ない | [グループ・非表示の判定](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/030/group-selection-logic/) | | **設定手順**: 最短日・休業日・指定不可日・地域別調整・必須化 | [設定手順: 配送希望日](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/040/setup-date/) | | **設定手順**: 時間帯・詳細な時間・配送方法(店舗受取) | [設定手順: 配送時間・配送方法](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/050/setup-time-slot/) | | **設定手順**: 商品ごとのグループ化・タグ・条件・非表示商品 | [設定手順: グループ・非表示商品](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/060/setup-groups-hidden/) | | **設定手順**: 注文タグ・メール表示・有効性検証・他アプリ干渉 | [設定手順: オプション](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/070/setup-options/) | | **設定手順**: 商品ページの「最短日の表示」ブロック・商品ページの最短日がカートとずれる | [商品ページの最短日の表示](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/075/product-page-shortest-date/) | | **設定手順**: 発売日前の商品の配送日・営業休業日カレンダーの表示・地域別の曜日制限・配送準備日と配送可能日が違う運用 | [日付ルールの特殊な組み合わせ](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/077/special-date-patterns/) | | **導入前・料金**: 料金・無料期間・開発ストアの課金・個人情報の保持・テーマ対応・メール送信機能 | [料金・プラン・導入前の質問](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/065/plans-and-pre-sale/) | | **症状別**: ウィジェットが出ない・注文に配送日時が無い・__ccValid/__ccSlot が出る・購入に進めない・最短日前の注文・レイアウト崩れ | [症状別の切り分け](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/080/troubleshooting/) | | **できないこと・他アプリ**: 支払方法別の出し分け・マイページへの表示・定期購入アプリ・All in Gift・置き配・POS・範囲外の別アプリ | [できないこと・他アプリとの併用](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/085/limits-and-other-apps/) | | **Pro・CSV**: 注文CSV出力の基本・対応する運送会社・初期テンプレート・注文の取り込み範囲・ダウンロード手順 | [Pro: 注文CSV出力の基本](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/090/csv-basics/) | | **Pro・CSV**: 各列の値の設定・固定値・注文情報・置換・条件分岐・コード(JavaScript)・メタフィールド | [Pro: CSV 出力値の設定](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/100/csv-values/) | | **Pro・CSV**: 追跡番号のアップロード・発送済みにする・上書き・部分発送・反映されない行 | [Pro: 追跡番号のアップデート](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/110/tracking-update/) | | **Pro・CSV**: 振り分けルール・運送会社ごとに分ける・出荷リードタイム・今日までに出荷 | [Pro: 振り分けルールと出荷リードタイム](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/120/routing-and-shipping-lead/) | | **Pro**: 配送方法に応じたチェックアウトの配送オプションの出し分け・ネクストエンジン/オープンロジ/Ship&Co/GoQSystem 連携 | [Pro: 配送方法のカスタマイズと外部システム連携](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/130/shipping-customize-and-connect/) | | **Pro**: 住所チェック(住所の誤りの検知・修正提案・Shopify の注文の住所を修正・変更履歴・個人情報の扱い) | [Pro: 住所チェック](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/140/address-check/) | ## 問い合わせの下書き R1 / R9 / R11 や ESCALATE に当てはまるときは、答えを創作せず、お客様が「CC 配送日時指定」の開発元に問い合わせるための**メールの文面を AI が下書きする**。送信はお客様が行う。 - 問い合わせ先: 管理画面上部の「問合せ」ボタン、または Shopify アプリストアの「CC 配送日時指定」の開発元への連絡。メールアドレスなどの連絡先は、このマニュアルに書かれていないものを創作しない。 - 文面に入れる情報は、該当するページの ESCALATE の表の「依頼する情報」を使う。お客様がまだ持っていない項目は、空欄にして、埋めてもらう。 - 顧客の氏名・住所・電話番号などの個人情報は書かない (注文番号で足りる)。「コラボレーションコード」は、調査にストアへのログインが必要なときだけ、お客様自身が発行して記載する。 - 下書きの前に、お客様にも「こちらで確認できる範囲では、◯◯は分かりません。開発元に確認するための文面を作ります」と一言伝える。 ```text 件名: 【CC 配送日時指定】<質問の要約> についてのお問い合わせ CC 配送日時指定 サポートご担当者様 お世話になっております。<店舗名・会社名>の<お名前>です。 「CC 配送日時指定」について、次の点を確認させてください。 ■ ストア: ■ ご利用プラン: ノーマル / プロ ■ 確認したいこと: <質問を具体的に。いつ・どの画面・何をしたら・どうなったか> ■ 現在の設定・試したこと: <設定の内容、試した操作> ■ 参考情報: <注文番号 / 商品URL / スクリーンショット / 他に入れているアプリ / テーマ名 など。ESCALATE の「依頼する情報」> お手数をおかけしますが、ご確認のほど、よろしくお願いいたします。 ``` ## 関連する人間向けマニュアル - [CC 配送日時指定の使い方](https://capital-castle.eastazy.com/cc-delivery-date-time/how-to-use/how-to-use/) - [よくある質問](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/010/dynamic-checkout/) --- # 基本概念とデータの構造 ## SUMMARY 配送日時の設定は **グループ** 単位。グループ1 = 標準 (紐づけのない商品の既定)。グループ内に **スロット** (配送方法の選択肢) を持てる。 ## ENTITIES ```yaml group: # 内部名: pattern ui: 設定 → グループ管理 key: グループ番号 (1 = 標準) has: priority (小さいほど優先), name, 日付/時間の設定一式 note: グループ間の設定は独立 (休業日などは共有されない) slot: # 配送方法の選択肢。グループ内に複数 ui: 設定 → 配送方法の表示 has: title, 日付/時間の設定一式 (スロットごとに別) product_link: # 商品とグループの紐づけ - 商品管理で商品ごとに指定 - 商品タグで指定 (タグ名 → グループ)。「タグ::SKU」でバリアント単位 - 条件で選択 (重量 / 合計金額 / 在庫数) - どれも無い → グループ1 ``` ## UI_LABELS 左メニュー: 設定 / 非表示商品 / スタイル / オンラインストア / オプション / 連携(プロプラン) / CSV / お知らせ。 画面上部のボタン: 「保存する」「言語」「問合せ」。 | 概念 | 管理画面の場所と項目名 | 設定キー (内部) | | --- | --- | --- | | 日付を出さない | 設定 → カード「配送希望日」→「配送希望日を表示しない」 | `display.date` | | 時間を出さない | 設定 → カード「配送指定時間」→「配送希望時間指定を表示しない」 | `display.time` | | 表示ラベル | 各カードの「表示ラベル」 | `label.date` / `label.time` | | 最短日 | 「最短日: 注文日から [ ] 日後」 | `rangeDate.start` | | カレンダーデイ | 「営業日(...)とカレンダーデイ(...)の設定にする」→「カレンダーデイ」 | `rangeDate.calStart` | | 最長日 | 「最長日: 注文日から [ ] 日後」 | `rangeDate.end` | | 最短日から数える | 「最短日から最長日を計算する」 | `rangeDate.endAs` | | カットオフ | 「カットオフの時間」(適用しない / 0:00〜23:00) | `cutOffTime` (99=適用しない) | | 営業休業日 | 最短日の下の「営業休業日」(曜日チェック+カレンダー) | `holidays` / `holidayWeeks` | | 指定不可日 | 「指定不可日」(曜日チェック+カレンダー) | `dates` / `disableWeeks` | | 指定可能日 | 「指定した日だけにする」ONで「指定不可日」が「指定可能日」に変わる | `rangeDate.valid` | | 地域別の最短日調整 | 「選択肢(配送地域など)による最短日の調整を設定する」 | `selectDays` / `label.area` | | 日付の必須化 | 「配送日の指定を必須化する」(プレースホールダー / アラートメッセージ) | `essentials.activeDate` | | 時間の必須化 | 「配送時間を必須化する」(必須化の文章 / アラートメッセージ) | `essentials.activeTime` | | 時間帯の選択肢 | カード「配送指定時間」の一覧と「追加」 | `times` | | 時間の詳細設定 | 「詳細な配送時間の設定を有効にする (...)」 | `timesDetail` | | 配送方法 (スロット) | カード「配送方法」→「配送方法を表示する」「追加する」 | `slotDisplay` / `slotOpts` | | 商品のグループ化 | カード「対象商品」→「商品毎のグループを有効にする」 | `patternChecked` | | グループ管理 | カード「商品のグループ化」→「グループ管理」「追加する」 | `patterns` | | 優先順位 | 「優先順位」の上下ボタン | `priority` | | 選択条件 | 「選択条件」→「条件を有効にする」(重量/金額/在庫数) | `conditions` | | タグでの紐づけ | 「商品管理」→「商品毎の設定に商品のタグを使用する」 | `productsControlTags` / `productsTags` | | 非表示商品 | 「非表示商品」→ 商品一覧「非表示設定」の「表示しない」 | `productsNoDisplay` | | 非表示優先 | 「複数の商品がカートに入っていた場合は「表示しない」を優先する」 | `productsNoDisplayUsual` | ## RULES ```text C-1 グループ1は削除不可の標準。紐づけの無い商品は必ずグループ1になる。 C-2 グループの設定は独立。グループ1の指定不可日はグループ2に反映されない。 C-3 priority は数字が小さいほど優先。 C-4 スロットがある場合、日付/時間の設定はスロットごとに持つ。 C-6 グループを削除すると、そのグループへの商品の紐づけ・タグ設定・配送方法のカスタマイズ設定も消え、該当商品はグループ1になる。 C-5 商品タグの特殊形式「タグ名::SKU」は、そのSKUのバリアントだけをグループに紐づける。 C-7 配送日時は、ウィジェットがカートの属性に書き込み、注文では「追加の詳細」(order.customAttributes) になる。まず保存されるのはここ (085 の L-13 / 080 の TS-1)。 C-8 「追加の詳細」のキー名は、管理画面の表示ラベル (配送希望日・配送希望時間など) と同じ。ラベルを変えるとキーも変わる (TS-1)。値は、日付が「カレンダーの設定」の「入力される日付のフォーマット」(既定 YYYY年M月D日。管理画面の言語による。040 の D-5)、時間が選んだ時間帯の選択肢の文字。 C-9 Pro プランの「連携」では、「追加の詳細」のキー (連携用のラベル) と日付・時間の書式を、表示ラベルとは別に決められる。連携先の初期値は 130 の表 (例: ネクストエンジン delivery_date / YYYY/MM/DD)。日付と時間を 1 つの値にもできる (130 の K-5)。 C-10 注文のメタフィールド・注文メモ・注文タグにも入れたいときは、「オプション」の「注文への自動書き込み」を使う (Shopify Flow が必要。070 の PROC-O2)。メタフィールドは、ネームスペースとキーを指定する (既定 custom.delivery_date / custom.delivery_time)。型は日付型 / テキスト型 (日付型は年-月-日)。 C-11 注文メタフィールドの「CSV 出力」(Pro の 090 / 100) は、すでにある注文のメタフィールドを CSV の列に読み出す機能。配送日時をメタフィールドに書き込む機能ではない。 ``` ## QA - **Q: グループとは?** A: 商品ごとに配送日時の設定を変えるための単位。標準はグループ1。商品をグループに紐づけて使う。 - **Q: 商品ごとに別々の配送日を指定できる?** A: できない。1つの注文には1つの配送日時が付く (R7)。 - **Q: 配送日時は注文にどう保存される? キー名・値の形式は? 注文メタフィールドに保存できる?** A: まず注文の「追加の詳細」(customAttributes) に、キー=表示ラベル・値=日付 (入力される日付のフォーマット) / 時間帯の文字、で保存される (C-7, C-8)。メタフィールドにも入れたいときは「オプション」の「注文への自動書き込み」(Shopify Flow が必要) を使う (C-10)。Pro の連携では、キーと書式を連携先に合わせられる (C-9)。キー名の具体例 (既定のラベル) は、管理画面の「表示ラベル」の設定による。CSV の変数 (order.date など) は CSV 出力用の名前で、実際のキー名ではない。 - **Q: スロットとグループの違いは?** A: グループは商品ごとの設定の単位、スロットは同じグループ内の配送方法 (宅配 / 店舗受取 など) の選択肢。 ## ESCALATE - 管理画面の項目が見当たらない: プラン (Normal / Pro) とアプリのバージョン表示を確認する。 ## SEE - [商品毎のグループ化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/080/products-groups/) - [商品毎のグループ化 (商品タグ設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/082/products-groups-with-tags/) - [商品毎のグループ化(条件選択設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/083/products-groups-condition/) - [配送方法の表示](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/020/delivery-method/) --- # 最短日・最長日・選択可否の判定ロジック ## SUMMARY ```text 最短日(注文日からN日後) = 営業日数 + カットオフ繰り下げ + カレンダーデイ + 選択肢の加算 営業休業日 → 最短日の計算にだけ使う (選択可否には影響しない) 指定不可日 / 指定不可曜日 → 選択可否にだけ使う (最短日には影響しない) 最長日 → 暦日で数える (営業休業日を数えない) ``` ## RULES ```text S-1 数え始めは注文日(今日)=0日目。 S-2 営業日数は営業休業日(日付・曜日)を飛ばして数える。今日が休業日なら、最初の営業日までの休業日も加算される。 S-3 カレンダーデイは営業休業日に関係なく、そのまま足す。 S-4 カットオフ: 現在の「時」>= cutOffTime なら +1日。未設定(99)は無効。 S-5 営業休業日が1つでも設定されている場合、S-4 の +1日は「営業日を数え始める日を翌日にずらす」形で反映される。 S-6 現在時刻は、配信設定にIANAタイムゾーンがあればその時刻、なければお客様のブラウザの時刻。 S-7 選択肢(エリア)を選ぶと、その選択肢の営業日・カレンダーデイが最短日に加算される。 S-8 最長日 = 注文日 + end日。ただし「最長日を最短日から数える」ONなら 最短日 + end日。 S-9 選べる日 = [最短日, 最長日] の範囲 − 指定不可日 − 指定不可曜日。 S-10 「指定した日だけにする」ON: 範囲内では、指定した日と許可した曜日だけが選べる。 S-11 最短日 > 最長日 になると選べる日は0になる (長期休業の設定で起きやすい)。 S-12 複数グループが混在し「複数グループの配送可能日とする」がONなら、各グループの選べる日の共通部分だけが選べる。 S-13 カットオフ・営業休業日・営業日数・カレンダーデイは、グループ(と配送方法)ごとに 1 組だけ。「受付日用の自社カレンダー」と「発送日用のグループカレンダー」を分けて持つことはできない。 S-14 「当日出荷 / 翌営業日出荷」という専用設定は無い。営業日を 0 (当日) / 1 (翌営業日)、配送日数をカレンダーデイに入れて表現する。営業日の数え方はそのグループの営業休業日だけを使う。 S-15 出荷の営業日数と配送日数は別欄で設定できるが、商品のグループ分けは 1 通りだけ。出荷用と配送用で別々のグループ分けにはできない。 S-16 チェックアウト時の有効性検証 (Function) は最短日・最長日・必須入力を検証するが、カットオフは検証しない。 ``` ## QA - **Q: 営業休業日に設定したのに、その日が選べる。** A: 営業休業日は最短日の計算用 (S-2)。選べなくするには指定不可日に設定する (S-9)。 - **Q: 営業休業日を最長日の日数に含めたい。** A: できない。最長日は暦日で数える (S-8)。 - **Q: 午後に注文したら最短日が1日後ろにずれた。** A: カットオフ時間の設定による (S-4)。カットオフ時間を確認する。 - **Q: 土日を選べないようにしたい。** A: 指定不可日の曜日に設定する。最短日の営業日カウントも土日を飛ばしたいなら営業休業日にも同じ曜日を設定する (S-2, S-9)。 - **Q: カレンダーに選べる日が1日もない。** A: 順に確認: (1) 最短日 > 最長日 (S-11) (2) 複数グループの共通日がない (S-12) (3) 指定可能日の設定が空 (S-10)。 - **Q: 最短日より前の日で注文された。** A: 断定しない (ESCALATE)。 - **Q: 自社の受付締め時刻と営業日で受付日を決め、さらに商品グループ別の営業日で発送日を決めたい。** A: できない (S-13)。カットオフと休業日はグループごとに 1 組だけ。 - **Q: 出荷元メーカー別に「当日出荷」「翌営業日出荷」を分けたい。** A: グループごとに営業日を 0 または 1 にして表現できる (S-14)。ただし使うカレンダーはそのグループの 1 組だけ。 - **Q: 出荷用と配送区分用でグループ分けを別々にしたい。** A: できない (S-15)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 特定の商品・日だけ選べない / 選べてしまう | ストアURL、商品URL、カート内の商品、注文した日時 (時刻) | | 最短日より前の日で注文された | 注文番号、注文日時、カート内の商品、利用ブラウザ | | 配送日が注文に残らない / 空 | 注文番号、カートに入れた商品の組み合わせ | ## SEE - [最短日の設定(営業日+カレンダーデイ)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/030/shortest-date/) - [最長日の設定](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/035/longest-date/) - [営業休業日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/040/holiday/) - [指定不可日 | 指定可能日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/041/blockout/) - [選択肢(配送地域など)による最短日の調整](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/045/shortest-date-with-selection/) - [最短日より前の配送日で注文されてしまうことがあります](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/140/checkout-invalid-date/) --- # グループの選択・非表示・複数商品の判定ロジック ## SUMMARY カート内の商品ごとにグループを決め、**priority の数字が最小のグループ** の設定がウィジェットに使われる。非表示商品はグループ決定から除外される。 ## RULES ```text G-1 商品→グループは次の順: (1) バリアント指定(タグ::SKU) (2) 商品の紐づけ(商品管理/商品タグ) (3) グループ1。 G-2 非表示商品はグループ決定の対象外。 G-3 条件グループ(重量/合計金額/在庫)が1つでも成立すれば、成立したグループのうち priority 最小が基準になる。 条件グループ以外に紐づく商品は、基準グループに置き換わる。 G-4 条件グループが1つも成立しなければ、条件付きグループに紐づく商品はグループ1になる。 G-5 最終的に、カート内の商品が属するグループのうち priority 最小のグループの設定が適用される。 G-6 「複数のグループの商品がカートに入った時は、複数のグループの設定の配送可能日とする」ON: 配送可能日は各グループの共通部分。配送希望日以外(ラベル・時間帯)は G-5 のグループ。 G-7 G-6 で共通日が0のとき、「選択できる配送希望日がない時のメッセージ」を配送希望日の入力欄の上に表示する。 G-8 非表示優先 ON: 非表示商品が1つでもカートにあれば、ウィジェットを表示しない。 G-9 非表示優先 OFF: カート内が全て非表示商品のときだけ表示しない。 G-10 非表示になるとき、入力済みの配送日・時間は注文に残らない (空で送られる)。 G-11 非表示時は「商品ノート」を代わりに表示できる。 ``` ## 判定表: 非表示 | 非表示優先 | カート内 | ウィジェット | | --- | --- | --- | | ON | 非表示商品が1つ以上 | 表示しない | | OFF | 全て非表示商品 | 表示しない | | OFF | 表示する商品が1つ以上 | 表示する | ## QA - **Q: 商品Aは3日後、商品Bは6日後。一緒に買うと?** A: priority が小さい方のグループが適用される (G-5)。長い方を使うなら、そのグループの優先順位を1にする。共通日だけにしたいなら G-6 をONにする。 - **Q: グループ1の休業日がグループ2にも効く?** A: 効かない。グループごとに設定する (C-2)。 - **Q: タグで設定したのに反映されない。** A: 順に確認: (1) 商品タグ設定がON (2) タグ名が完全一致 (3) 商品管理で直接紐づけた設定が優先されていないか (G-1)。 - **Q: 生鮮品だけ配送日を指定させたくない。** A: 商品管理で非表示に設定する。他の商品と一緒のときも隠したいなら非表示優先をONにする (G-8)。 - **Q: 非表示商品と通常商品を一緒に入れたらウィジェットが出る/出ない。** A: 非表示優先の設定で決まる (G-8, G-9)。 - **Q: 商品ごとに別の配送日を選ばせたい。** A: できない (R7)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 期待したグループが適用されない | カート内全商品のURL、商品タグ、グループの priority の画面 | | 組み合わせでメッセージが出る | G-6 の設定、メッセージ、商品の組み合わせ | | カートに入れた直後にウィジェットが出ない | 商品URL、カートの商品、ブラウザ、テーマ名 | ## SEE - [商品毎のグループ化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/080/products-groups/) - [商品毎のグループ化 (商品タグ設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/082/products-groups-with-tags/) - [商品毎のグループ化(条件選択設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/083/products-groups-condition/) - [商品毎のグループ化 (配送希望日複合設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/084/products-groups-multiple/) - [商品毎の配送日時指定の非表示](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/070/non-display-with-product/) - [商品毎の非表示優先設定](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/071/priority-non-display/) --- # 設定手順: 配送希望日(最短日・最長日・休業日・指定不可日・地域別調整) ```yaml screen: 左メニュー「設定」→ カード「配送希望日」 verified_from: 管理画面の実装 (項目名・入力形式・既定値) save: 画面上部のボタン「保存する」で確定 (変更しただけでは保存されない)。ストアフロントへの反映は保存後 ``` ## 画面の構成 (カード「配送希望日」の中の順。実画面で確認済み) 1. チェック「配送希望日を表示しない」(ONにすると日付入力欄自体を出さない) 2. 「表示ラベル」(テキスト) 3. 「最短日: 注文日から [数値] 日後」 / 「最長日: 注文日から [数値] 日後」 ← 営業休業日・カットオフはこの下の入れ子 4. 「指定不可日」(「指定した日だけにする」をONにすると名称が「指定可能日」に変わる) 5. 「選択肢(配送地域など)による最短日の調整を設定する」 6. カレンダーの設定 (フォーマットなど) 7. 「配送日の指定を必須化する」 ## PROC-D1 最短日を N 日後にする ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日: 注文日から」の数値欄 前提: なし (既定は最短日 1日後 / 最長日 90日後) 手順: 1. 「最短日: 注文日から」の数値欄に N を入力 (0〜100) 結果: 注文日から N 日後が最短日になる (営業休業日を飛ばして数える) 注意: 数値欄は営業日として数えられる。営業日とカレンダーデイを分けたい場合は PROC-D2 ``` ## PROC-D2 営業日とカレンダーデイを分ける (出荷準備 + 配送期間) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日」の下のチェック「営業日(店舗による出荷準備)とカレンダーデイ(配送業者の配送期間)の設定にする」 手順: 1. 最短日の下のチェック「営業日(店舗による出荷準備)とカレンダーデイ(配送業者の配送期間)の設定にする」をONにする 2. 「営業日」欄 (店舗の出荷準備日数) と「カレンダーデイ」欄 (配送業者の期間。1以上) に数値を入力 結果: 最短日 = 営業日 + カレンダーデイ (表示は「=」「+」の式になる) 補足: 営業日は営業休業日を飛ばして数え、カレンダーデイは暦日で数える ``` ## PROC-D3 カットオフ時間を設定する (例: 15時以降は+1日) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日」の下 > 「カットオフの時間」 手順: 1. 「最短日」の下の入れ子から「カットオフの時間」のセレクトを開く 2. 「15:00」を選ぶ (選択肢: 適用しない / 0:00〜23:00 の1時間刻み) 結果: 設定した時間以降の注文は最短日が+1日になる 注意: 1時間刻みのみ (分単位は不可)。「適用しない」が既定 ``` ## PROC-D4 営業休業日を設定する (最短日の計算からだけ除外) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日」の下 > 「営業休業日」 手順: 1. 「最短日」の下の入れ子の「営業休業日」を開く (クリックで開閉) 2. 「曜日の設定」の曜日チェックで休業の曜日を選ぶ 3. カレンダーで休業にする日をクリックする (クリックで追加、右側の一覧のごみ箱で削除) 4. 日本語の管理画面では「2026年の祝日を反映」「2027年の祝日を反映」ボタンで祝日を一括追加できる 結果: 最短日の営業日カウントから除外される。カレンダーでは選択可能なまま ``` ## PROC-D5 選べない日を設定する (指定不可日) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「指定不可日」 手順: 1. 「指定不可日」を開く 2. 「曜日の設定」で選べなくする曜日をチェック 3. カレンダーで選べなくする日をクリックして追加 結果: カレンダーで選択できなくなる。最短日の計算には影響しない 連続した期間: 日付を1日ずつクリックして追加する (範囲入力の欄は無い) ``` ## PROC-D6 指定した日だけ選べるようにする ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「指定不可日」のチェック「指定した日だけにする」 手順: 1. 「指定した日だけにする」をONにする (「指定不可日」が「指定可能日」に変わる) 2. 「指定可能日」のカレンダーで選べる日をクリックして追加 注意: 曜日のチェックは「選べる曜日」の意味に変わる。日付が空だと選べる日がなくなる ``` ## PROC-D7 年末年始を休業にする (選べない + 最短日でも休業) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 「最短日」の下の「営業休業日」と、「指定不可日」 手順: 1. PROC-D4 で期間の各日を「営業休業日」に追加 2. PROC-D5 で期間の各日を「指定不可日」に追加 注意: 最短日が最長日を超えると選べる日がなくなる。最長日の日数も確認する ``` ## PROC-D8 地域によって最短日を変える (例: 北海道・沖縄は +3日) ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > チェック「選択肢(配送地域など)による最短日の調整を設定する」 手順: 1. チェック「選択肢(配送地域など)による最短日の調整を設定する」をONにする (「表示タイトル」の既定は「配送地域」) 2. ボタン「設定を開始する」を押す 3. 「表示タイトル」を確認 (お客様に表示される選択肢のラベル) 4. 「選択肢のテキスト」に「北海道」、「営業日」に 0、「カレンダーデイ」に 3 を入力して「追加する」 5. 同様に「沖縄県」を追加 (日本語の管理画面では「都道府県にする」「エリアにする」ボタンで一括入力もできる) 任意: - 「「選択肢(配送地域など)による最短日の調整」を必須化する」: 選択を必須にする (「必須化の文章」「アラートの文章」を入力) - 「選択肢(配送地域など)を選択後に配送日を表示する」: 選択するまで日付を出さない (「注記の文章」を入力) 重要: - 営業日・カレンダーデイの入力値は「加算値」。基本の最短日に足される (マイナスも可)。 - チェックアウトの配送先住所とは照合されない。お客様が別の地域を選んだ場合は確認が必要。 ``` ## PROC-D9 配送日の入力を必須にする ```text 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > 下部のチェック「配送日の指定を必須化する」 手順: 1. カード「配送希望日」の下部のチェック「配送日の指定を必須化する」をONにする 2. 表示された「プレースホールダー」(既定: 配送日を選択してください) と 「アラートメッセージ」(既定: 配送日時を選択して購入をお願いします。) を必要なら編集 結果: 日付が未入力のまま購入ボタンを押すとアラートが出る ``` ## FACTS ```text D-1 「指定しない」の文言は「表示ラベル」とは別。場所は「カレンダーの設定」→「初期表示 (指定しない時)」(既定: 指定しない)。時間帯の選択肢にも「指定しない」が既定で入っている。 D-2 カットオフ「適用しない」の内部値は 99。 D-3 最短日の入力は 0〜100。最長日は 1 以上。 D-4 最短日・休業日・指定不可日は「グループ」と「配送方法(スロット)」ごとに別々に設定する。 D-5 「カレンダーの設定」の項目: 「配送日の選択方法」(カレンダー / セレクトボックス、既定はカレンダー)、「入力される日付のフォーマット」(既定 YYYY年M月D日 ※管理画面の言語による)、「カレンダーの月のフォーマット」、「最初の曜日」、「曜日の表記」、「初期表示 (指定しない時)」。 D-6 カード「配送希望日」の中の順: 表示ラベル → 最短日(営業日/カレンダーデイのチェック・カットオフ・営業休業日を含む) → 最長日(「最短日から最長日を計算する」を含む) → 指定不可日(「指定した日だけにする」を含む) → 選択肢による最短日の調整 → カレンダーの設定 → 配送日の指定を必須化する。 D-7 「設定」画面のカードの順: 配送方法 → 配送希望日 → 配送指定時間 → 入力テキスト → 注記 → 対象商品。 ``` ## ESCALATE - 設定したのに反映されない: 保存したか、グループ/スロットが別になっていないか、テーマの再読み込みを確認する。再現しない場合はストアURLと商品URLを依頼する。 ## SEE - [最短日の設定(営業日+カレンダーデイ)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/030/shortest-date/) - [営業休業日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/040/holiday/) - [指定不可日 | 指定可能日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/041/blockout/) - [選択肢(配送地域など)による最短日の調整](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/045/shortest-date-with-selection/) - [配送日時の必須化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/060/mandatory/) --- # 設定手順: 配送時間・配送方法(スロット)・入力テキスト ```yaml screen: 左メニュー「設定」→ カード「配送指定時間」/「配送方法」 verified_from: 管理画面の実装 (項目名・入力形式・既定値) / 2026-10-13 開発用管理画面での目視確認 (配送方法の ON/OFF・スロットのページ) ``` ## PROC-T1 時間帯の選択肢を設定する (例: 午前中 / 14:00-16:00 / 16:00-18:00) ```text 場所: アプリの左メニュー「設定」 > カード「配送指定時間」 手順: 1. カード「配送指定時間」を開く (「配送希望時間指定を表示しない」はOFFのままにする) 2. 既に入っている選択肢を、不要なものは右のごみ箱で削除する (既定値の例: 指定しない / 午前中 / 14:00-16:00 / 16:00-18:00 / 18:00-20:00 / 19:00-21:00) 3. 下の入力欄に時間帯の文字列を入力して「追加」を押す。1件ずつ追加する 4. 既存の選択肢の文字を直接書き換えることもできる 結果: 入力した文字列がそのまま選択肢として表示され、注文の追加情報にも同じ文字列が入る 注意: 区切りの規則は無い。自由な文字列。先頭の「指定しない」は未選択の選択肢として機能する ``` ## PROC-T2 配送時間の入力を必須にする ```text 場所: アプリの左メニュー「設定」 > カード「配送指定時間」 > 下部のチェック「配送時間を必須化する」 手順: 1. カード「配送指定時間」の下部のチェック「配送時間を必須化する」をONにする 2. 「必須化の選択肢」(既定: 配送時間を選択してください。画面によっては「必須化の文章」と表示される) が選択肢の一番上に入る 3. 「アラートメッセージ」(配送日と共通) を必要なら編集 4. 時間帯の選択肢から「指定しない」を削除する 結果: 必須化の選択肢のまま購入ボタンを押すとアラートが出る ``` ## PROC-T3 時間を詳細に設定する (範囲・間隔・当日受取) ```text 場所: アプリの左メニュー「設定」 > カード「配送指定時間」 > チェック「詳細な配送時間の設定を有効にする (飲食店などの当日受け取りが必要な場合)」 手順: 1. チェック「詳細な配送時間の設定を有効にする (飲食店などの当日受け取りが必要な場合)」をONにする 2. 「[ n ]時から [ m ]時までの時間を選択範囲とする」を入力 3. 「[ k ]分間隔の時間で選択肢を作成する」を選ぶ 4. 必要に応じて: - 「範囲表記にする (例: 9:00-10:00)」 - 「AM,PM表記にする (例: AM 9:00-AM 10:00)」 - 「当日受取の場合 [ x ]分後から選択可能とする」(最短日を0にすると当日受取が可能) - 「除外する時間を選択する」: チェックを入れた時間は選択肢から除外 - 「曜日毎に設定を変更する」で曜日別に別設定 5. 「プレビュー」で表示を確認する 注意: 詳細設定を有効にすると、手動の選択肢(PROC-T1)は使われない ``` ## PROC-S1 配送方法を選択肢にする (例: 配送 / 店舗受取) ```text 場所: アプリの左メニュー「設定」 > カード「配送方法」 > チェック「配送方法を表示する」 手順: 1. カード「配送方法」のチェック「配送方法を表示する」をONにする 2. カード「配送方法」の「表示ラベル」(既定: 配送方法) は、選択欄全体の見出し。個々の配送方法の名前ではない 3. 一覧の「追加する」で配送方法を増やす (ダイアログは出ず、名前「配送方法」の項目が即追加される)。 初期の一覧は「配送」(店舗によっては「配送」「ストアで受け取る」の 2 件) が入っている。一覧の配送方法をクリックすると、その配送方法のページが開く 4. 配送方法のページの「オプションボタンの設定」で、名称などを設定する: - 「ボタンの表示タイトル」: お客様に見える名称 (既定: 配送。例: 店舗受取) - 「アイコンの選択」: モーダルが開く。「アイコンを表示しない」ボタンと、約 70 個のアイコンの一覧 (名前の表示は無い)、 SVG の HTML テキストを直接入れる欄がある (アイコンは polaris-icons から探せると案内される)。アイコンをクリックすると即座に反映される - 「ノート (配送方法の説明を記載します。HTMLで記載することができます。)」 (既定: 遠方地域にお住まいの方に宅急便でご送付します。) 5. 同じページの下に、その配送方法の日付・時間の設定 (配送希望日・配送指定時間・入力テキスト・注記など) がある。配送方法ごとに変える (例: 店舗受取だけ時間帯を別にする、配送は時間帯を出さない) 6. 配送方法ごとのページは、左メニューの「設定」の下にも出る 任意: 「セレクションボックスに変更する」をONにすると、ボタンでなくセレクトボックス表示になる 結果: 配送方法の選択に応じて、日付・時間の設定が切り替わる 注意: 「配送方法を表示する」を OFF にすると、日付・時間の設定は「設定」の画面にそのまま (インラインで) 並ぶ。ON にすると、「設定」の画面には配送方法の一覧だけが出て、日付・時間の設定は配送方法ごとのページに移る ``` ## PROC-X1 入力テキストを追加する (電話番号・受取人の名前など) ```text 場所: アプリの左メニュー「設定」 > カード「入力テキスト (電話番号、受取人の名前など)」 手順: 1. 「入力タイトル」に項目名を入力 (注文の追加情報のキーになる) 2. 「入力タイプ」を選ぶ (text / number / tel / email / date) 3. 「プレースホルダー」を入力 (「選択肢化」をONにすると、この欄は「選択肢のテキスト」になり、"," 区切りで選択肢を入力する) 4. 任意: 「オートコンプリート」を選ぶ (Not Applicable / off / on / tel / name / email / organization / url / street-address) 5. 任意: 「必須化」をON → 「アラートメッセージ」(既定: 「<入力タイトル> は必須入力項目です」) を編集 (「選択肢化」をONにすると「必須化」はOFFになる) 6. ボタン「追加する」を押す ``` ## PROC-N1 ノートに Google マップを表示する ```text 場所: アプリの左メニュー「設定」 > カード「注記」 > 「google mapのボタンを設定する」 手順: 1. 「Google mapの埋め込みを設定する」で「住所(店名まで記入するとうまく表示されます)」を入力 2. 「Google mapの埋め込みコード」に、Google マップで取得した埋め込みコードを貼る 3. ボタン「ノートに追加する」を押す ``` ## FACTS ```text T-1 配送方法(スロット)は「通常プラン」の機能。「配送方法のカスタマイズ」(チェックアウトの配送方法の出し分け)は Pro プランで別物。 T-2 時間帯の選択肢の文字列は、そのまま CSV や連携用の値として使われる。変更すると連携先の値も変わる (連携用の値を別に持たせる機能は Pro)。 T-3 グループを使っている場合、時間帯・配送方法の設定はグループごとに別。 T-7 配送方法の一覧には、並べ替えの操作 (ドラッグ・上下ボタン) は無い。削除はごみ箱アイコンで、確認のダイアログは出ず即削除される。 T-8 配送方法を ON にしている間、「選択肢(配送地域など)による最短日の調整を設定する」は、グループの画面ではなく配送方法のページにある。 T-4 配送方法のページでは、営業休業日・指定不可日 (日付・曜日) を、「独自の項目を設定する」か「「◯◯」と同じ設定を使用する」から選べる。 他の配送方法と同じ設定を選ぶと、その配送方法の日付・曜日の設定がコピーされる。コピー後は別々に管理される。 T-5 配送方法のページの最後に、チェック「チェックアウトの配送オプションのカスタマイズを設定する」(既定 OFF) がある。Pro の機能 (130 を参照)。 T-6 配送方法のページには、ボタン「クリックしてPlus Shippingアプリの設定にする」もある (Plus Shipping アプリ向け。内容は未確認のため案内しない)。 ``` ## ESCALATE - 「店舗受取が表示されない」: Shopify 側の店舗受取の条件 (全商品が受取対象・在庫が受取ロケーションにある) と、グループの組み合わせを確認する。人間向けマニュアル「配送方法の表示」を案内する。 ## SEE - [配送時間の詳細化 (店舗受取の時間など)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/050/detail-time/) - [配送方法の表示](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/020/delivery-method/) - [配送日時指定の必須化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/060/mandatory/) - [配送方法のカスタマイズ (Pro)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/shipping/delivery-method-customize/) --- # 設定手順: 商品ごとのグループ化・非表示商品 ```yaml screens: 左メニュー「設定」(カード「対象商品」「商品のグループ化」) / 「非表示商品」 verified_from: 管理画面の実装 (項目名・入力形式・既定値) ``` ## 画面の対応 | やりたいこと | 場所 | 項目 | | --- | --- | --- | | 商品ごとに設定を変える | 「設定」→ カード「対象商品」→「商品毎に配送日時の設定に変更がある場合」 | チェック「商品毎のグループを有効にする」 | | グループを増やす/並べる | 「設定」→ カード「商品のグループ化」→「グループ管理」 | 「追加する」、優先順位の上下ボタン | | 配送日時を出さない商品 | 「設定」→ カード「対象商品」→「非表示商品 へ」 または左メニュー「非表示商品」 | 画面「非表示商品の設定」 (中のカード「商品管理」に商品一覧とタグのチェックがある) | ## PROC-G1 商品ごとに設定を変える (グループ化を使う) ```text 場所: アプリの左メニュー「設定」 > カード「対象商品」のチェック「商品毎のグループを有効にする」 → カード「商品のグループ化」 > 「グループ管理」 手順: 1. 「設定」のカード「対象商品」で、チェック「商品毎のグループを有効にする」をONにする 2. カード「商品のグループ化」の「グループ管理」で「追加する」を押してグループを作る (ダイアログは出ず、名前「グループ N」で即追加される。コピーは、各行の右端のアイコンで即作成される (名前は「グループ N (グループ 1 コピー)」の形)。 グループ1(標準)は削除できない) 3. グループ名を付け、左メニューの「設定」の下のグループを開いて、そのグループの日付・時間を設定する 4. 商品との紐づけ: a. 「設定」の画面 (グループを有効にすると、カード「商品のグループ化」「グループ管理」の下に出る) のカード「商品管理」の商品一覧で、商品ごとに「グループ」列のセレクトからグループを選ぶ (検索欄「商品名で検索」。列は「商品名」「ステータス」「グループ」「非表示設定」。「グループ」列はグループが有効なときだけ出る)。左メニュー「非表示商品」の画面にも、同じ商品一覧がある。または b. タグを使う (PROC-G2) 5. 「優先順位」を上下ボタンで並べ替える (数字が小さいほど優先) 結果: カートの商品に応じて、そのグループの設定がウィジェットに使われる ``` ## PROC-G2 商品タグでグループに紐づける ```text 場所: アプリの左メニュー「設定」 > カード「商品管理」 (左メニュー「非表示商品」の画面にもある) 手順: 1. カード「商品管理」(「設定」の画面。左メニュー「非表示商品」の画面にもある) で、チェック「商品毎の設定に商品のタグを使用する」をONにする 2. 各グループに表示されるタグ名を確認する (既定ではグループ名がタグ名になる)。必要なら変更する 3. Shopify 管理画面で、対象商品に同じタグを付ける (バリアント単位にしたい場合は「タグ名::SKU」の形式) 4. 「タグが設定されていない商品」は標準 (グループ1) になる 注意: タグ名は完全一致。グループ名を変更するとタグ名も変わる場合がある ``` ## PROC-G3 条件でグループを選ぶ (重量・金額・在庫数) ```text 場所: アプリの左メニュー「設定」 > カード「商品のグループ化」 > 対象グループ > 「選択条件」 手順: 1. 対象グループの設定の「選択条件」で「条件を有効にする」をONにする 2. 「重量を有効にする」(最低 [ ] g から 最高 [ ] g まで) / 「金額を有効にする」(最低〜最高) / 「商品ごとの在庫数を有効にする」(在庫数が (最低) [ ] 個より大きい / (最高) [ ] 個より小さい) を設定 3. 複数の条件を有効にした場合は AND 4. 「選択した商品もしくは商品のタグを条件に含める」で、特定商品が入っているときだけ対象にもできる 注意: 「在庫数が取得できないときはページの再読み込みを許可する」は、テーマや他アプリと干渉して再読み込みが止まらなくなることがある。ONにしたら必ず実店舗で確認する ``` ## PROC-G4 特定の商品で配送日時を出さない ```text 場所: アプリの左メニュー「非表示商品」 (または アプリの左メニュー「設定」 > カード「対象商品」の「非表示商品 へ」) 手順 (商品を直接指定する場合): 1. 「設定」→「対象商品」の「非表示商品 へ」、または左メニュー「非表示商品」を開く 2. 商品一覧の「非表示設定」列で、出さない商品の「表示しない」にチェックする (チェックした商品は「グループ」列のセレクトが消える) 手順 (タグを使う場合): 1. 「商品管理」で「商品毎の設定に商品のタグを使用する」をONにする 2. 「配送日時を「表示しない」の設定を有効にする」をONにする (既定のタグ名: 配送日時不可) 3. Shopify 管理画面で、対象商品にそのタグを付ける 任意: - 「複数の商品がカートに入っていた場合は「表示しない」を優先する」: 非表示商品が1つでもあれば全体を非表示にする - 「カートに配送日時指定が表示されない場合にノートを表示します」: 代わりに表示する文言 (例: こちらの商品は配送日時を指定できません。) ``` ## PROC-G5 複数グループが混在したときの動作を決める ```text 場所: アプリの左メニュー「設定」 > カード「商品のグループ化」 手順: 1. カード「商品のグループ化」のチェック 「複数のグループの商品がカートに入った時は、複数のグループの設定の配送可能日とする。」をONにする 2. 「選択できる配送希望日がない時のメッセージ」と「文字の色」を設定する 結果: 各グループの選べる日の共通部分だけが選択できる。共通日がなければメッセージを表示する ``` ## FACTS ```text P-1 グループの設定は独立。休業日・指定不可日・時間帯はグループごとに設定する。 P-2 グループ1(標準)には削除ボタンが無い (コピーのアイコンだけ)。グループ2以降は、ごみ箱アイコンで削除する。確認のダイアログは出ず、即削除される。 グループを削除すると、その紐づけ・タグ設定は消え、該当商品はグループ1になる。 P-3 条件グループが成立しないと、条件付きグループに紐づく商品はグループ1になる。 P-4 非表示にした注文には配送日時が残らない。 P-5 グループを有効にすると、「設定」の画面は、カード「商品のグループ化」(「商品毎のグループを有効にする」「複数のグループの商品がカートに入った時は…」) → 「グループ管理」(優先順位・グループの一覧・「追加する」) → 「商品管理」の並びになり、カード「対象商品」は無くなる。左メニューの「設定」の下に、グループごとの項目が出る。 P-6 グループの一覧の行には、優先順位の数字・上下ボタン・「標準」バッジ (グループ 1)・グループ名が出る。グループが 1 つでも上下ボタンは表示される。 P-7 グループの画面 (左メニューの「グループ 1」など): 「グループ名」(既定: グループ 1)、カード「配送方法」、カード「対象商品」、カード「選択条件」が並ぶ。 「標準」グループでは、カード「対象商品」の「商品(プロダクト)を管理する」「バリアント商品を管理する」はグレーアウトされ、「他のグループに選択されていない全ての商品が対象です」と表示される。 「選択条件」は標準グループでも表示される。 P-8 「商品毎の設定に商品のタグを使用する」を ON にすると、グループの一覧の下に「タグが設定されていない商品」が出て、商品管理に「"グループ管理" から商品毎にタグを設定してください。」が出る。 P-10 優先順位の上下ボタンを押すと、グループの順位が入れ替わる (「標準」バッジは順位でなくグループ 1 に付いたまま)。保存するまで確定しない。 P-11 「商品(プロダクト)を管理する」は Shopify の商品ピッカー「商品を選択」を開く (商品を検索して選ぶ)。「バリアント商品を管理する」はバリアント単位の指定で、 バリアント商品が選択されている場合は、バリアント商品に優先してグループが割り当てられる。標準グループではバリアントの設定はできない。 P-12 「商品毎の設定に商品のタグを使用する」を ON にすると、商品管理の表は消え、グループごとにタグを入力する。タグの既定値はグループ名。 グループの画面の「対象商品」は、タグ入力と「の商品タグが設定されている全ての商品に適用されます。」の表示に変わり、「商品(プロダクト)を管理する」は出なくなる。 P-13 「選択条件」の入力にバリデーションは無い。最低が最高より大きい値 (例: 最低 500・最高 100) でも保存でき、そのまま残る (条件が成立しないグループになる)。 P-9 「選択条件」の既定値: 「条件を有効にする」OFF。ON にすると「重量を有効にする」(最低 0 g〜最高 0 g)・「金額を有効にする」(最低 0〜最高 0)・「商品ごとの在庫数を有効にする」・「選択した商品もしくは商品のタグを条件に含める」(既定 OFF) が出る。複数の条件は AND。 ``` ## ESCALATE - 「タグを付けたのに反映されない」: タグ名の完全一致、タグ使用のチェック、商品に直接割り当てた設定が優先されていないか、商品がカートに入った直後かを確認し、商品URLを依頼する。 ## SEE - [商品毎のグループ化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/080/products-groups/) - [商品毎のグループ化 (商品タグ設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/082/products-groups-with-tags/) - [商品毎のグループ化(条件選択設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/083/products-groups-condition/) - [商品毎のグループ化 (配送希望日複合設定)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/084/products-groups-multiple/) - [商品毎の配送日時指定の非表示](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/070/non-display-with-product/) - [商品毎の非表示優先設定](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/071/priority-non-display/) --- # 料金・プラン・開発ストア・個人情報・テーマ対応 (導入前の質問) ```yaml screens: 管理画面 (課金のモーダル / 左メニュー) verified_from: 管理画面の課金処理 (initialPaymentCheck / PayClickButton / env) / 人間向けFAQ / 実際の問い合わせ対応の返信 note: 金額・期間は 2026-10 時点のコードの値。変わっている可能性があるときは断定せず、アプリのストアページを案内する。 ``` ## SUMMARY プランは **ノーマル** と **プロ** の 2 種類。どちらも月額で、14 日間の無料期間がある。 課金は Shopify の仕組みで、ユーザーが承認するまで始まらない。パートナー開発ストアでは課金されない。 ## FACTS ```text B-1 料金: ノーマル 2.99 ドル/月、プロ 4.99 ドル/月。月額のみ。いずれも 14 日間の無料期間 (承認時に開始) がある。 B-2 プロ限定の機能: CSV 出力 (追跡番号アップデート・振り分けルール・出荷リードタイムを含む)、外部システム連携、配送方法のカスタマイズ (チェックアウトの配送オプションの出し分け)、注文タグの日付フォーマットの変更。 「配送方法の表示」(ウィジェットでの配送方法の選択) はノーマルでも使える。 B-3 課金はお客様 (マーチャント) の承認なしには始まらない。管理画面を開いたときにプランの承認のモーダルが出る。 B-4 管理画面の起動のたびに、Shopify の API でそのストアのプランと契約を確認する (キャッシュしない)。 B-5 パートナー開発ストア (Shopify の「開発用ストア」) では課金のモーダルは出ず、プロの機能まで使える。 B-6 Shopify の有料プラン (Basic / Grow / Plus など) に切り替えて課金を始めたストアは、通常のストアとして扱われ、 アプリの課金 (承認) が必要になる。「クライアント移管」と表示されていても、有料契約済みのストアは同じ。 B-7 個人 (顧客) 情報は、アプリのデータベースに保持していない。API で都度取得し、ブラウザ側で加工して表示する。 例外: CSV 出力の「自由入力欄」にマーチャントが入力した内容 (発送元の情報など) はアプリ側に保存される。 顧客の個人情報を手入力しない限り、アプリ側で保持することはない。プライバシーポリシーは公開されている。 住所チェックも、氏名・住所・電話を保存しない。注文のアプリ専用メタフィールド (Shopify 側) に残るのは、修正した日時・方式・項目名だけ。 住所チェックのために、アプリのサーバーが持つデータは無い。顧客の削除依頼 (customers/redact) があっても、アプリが消す個人情報は無い。 アプリをアンインストールすると、アプリ専用のメタフィールドは Shopify により削除される。詳細は 140 (AC-17)。 アンインストールの通知を受けると、アプリのサーバーに保存していた、その店の設定 (配送パターン・時間枠・スタイル・オプション・CSV の設定) と CSV の出力履歴は削除される。 再インストールしても元には戻らず、初期状態から設定し直す。注文に書き込み済みのタグ・メモ・メタフィールド・追加の詳細は、注文側に残る。削除までの時間は案内しない。 B-8 メールを送信する機能は無い。注文確認メールなどに配送日時を載せるには、Shopify の通知テンプレートに表示コードを入れる (070 の PROC-O3)。 B-9 初期ロード時の配送日・時間は「指定なし」。顧客が選ぶと、ページを移動しても値が引き継がれる (X-5)。 B-10 テーマとの相性はテーマごとに異なる。アプリブロックとして置く方式で、テーマのカート (ドロワー式など)・他アプリとの干渉で調整が要ることがある。 動作確認の実績があるテーマの例: Palo Alto。確認が必要なときは、テーマ名・ドロワーカートの有無を聞き、断定せずに、開発元への問い合わせの文面を下書きする。 B-11 Shopify Plus のチェックアウト拡張機能 (チェックアウト画面の中への入力欄) には対応していない (L-2)。 B-12 配送日時を自動で入れる機能 (例: 「ゆっくり配送は注文の 5 日後を自動で入れる」) は無い。 B-13 技術構成: PHP は使っていない (ソースコードに PHP のファイルも Composer の構成も無い)。管理画面は React、サーバー側は Node.js (TypeScript)、 ストアに表示するウィジェットは JavaScript。基盤は Shopify と Google Cloud (Firebase)。 PHP の脆弱性 (CVE) は、PHP を使っていない本アプリに直接は影響しない。 ``` ## QA - **Q: 料金は。無料期間は。** A: ノーマル 2.99 ドル/月、プロ 4.99 ドル/月。どちらも 14 日間の無料期間がある (B-1)。金額の最新はアプリのストアページで確認してもらう。 - **Q: ノーマルとプロの違いは。** A: プロは CSV 出力・外部システム連携・配送方法のカスタマイズが使える (B-2)。日時指定そのものはノーマルで使える。 - **Q: 開発ストア (構築中) で、14 日を過ぎても無料で使えるか。** A: パートナー開発ストアなら課金されない (B-5)。Shopify の有料プランに切り替えて課金が始まると、アプリも課金が必要 (B-6)。ストアの状態を見ないと断定しない。 - **Q: 管理画面を開くと課金の承認画面が出て操作できない。** A: ストアが開発ストアでない (有料プラン契約済み) ためと考えられる (B-6)。承認するまで課金は始まらない (B-3)。ストアのプランを確認してもらう。 - **Q: 「クライアント移管」のストアなのに課金される。** A: そのストアが Shopify の有料プランを契約済みなら、通常の課金になる (B-6)。移管の表示とは別の話。 - **Q: 個人情報はアプリ内に保存されるか。** A: アプリのサーバーには保存しない (B-7)。CSV の自由入力欄に入れた内容は保存される。プライバシーポリシーの URL を案内する。 - **Q: 住所チェックで直した住所は、どこに保存されるか。** A: 直した住所は、Shopify の注文の配送先住所そのものに書き込まれる (「Shopify の注文の住所を修正」)。このアプリは、氏名・住所・電話を保存しない。注文のメタフィールドに残るのは、修正した日時・方式・項目名だけ。変更前後の値は、Shopify の注文のタイムラインに残る (B-7、140 の AC-17)。 - **Q: PHP を使っているか。PHP の脆弱性 (CVE) の影響はあるか。** A: PHP は使っていないので、PHP 自体の脆弱性が本アプリに直接影響することはない (B-13)。CVE の番号や内容には触れない。Shopify・Google Cloud など基盤側の影響は回答できないと伝え、各提供元の公表情報を案内する。Node.js や React など別の脆弱性は、断定せず開発元への問い合わせを案内する。 - **Q: 使っているテーマで動くか (Palo Alto など)。** A: テーマごとに確認する (B-10)。テーマ名・ドロワーカートの有無を聞く。 - **Q: 初期状態は「指定なし」にできるか。** A: 初期ロードは「指定なし」。顧客が選んだ値は引き継がれる (B-9)。 - **Q: 発送準備のお知らせメールを、このアプリから送れるか。** A: メール送信機能は無い (B-8)。 - **Q: Shopify Plus にしたら、チェックアウト画面で選べるか。** A: できない (B-11)。 - **Q: 注文の何日後などの日付を自動で入れたい。** A: そのような機能は無い (B-12)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 開発ストアなのに課金の承認画面が出る | ストアURL (xxx.myshopify.com)、Shopify のプラン (開発用/有料)、「クライアント移管」の表示の有無、画面のスクリーンショット | | 請求・返金・解約の相談 | ストアURL、請求の日付、Shopify の請求の画面。断定せず、開発元への問い合わせの文面を下書きする | | セキュリティ・脆弱性の照会 (PHP 以外、基盤側、社内の確認シートなど) | 対象の脆弱性の番号 (CVE) と名称、照会の目的。回答は断定せず、開発元への問い合わせの文面を下書きする | | 個人情報の取り扱いの詳細な照会 | 社内の確認項目 (データの保存先・保持期間など)。回答は断定せず、プライバシーポリシーを案内し、開発元への問い合わせの文面を下書きする | ## SEE - [チェックアウト画面に表示できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/070/checkout/) - [メールに入力された配送日時指定を表示することはできますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/120/mail/) - [CC 配送日時指定の使い方](https://capital-castle.eastazy.com/cc-delivery-date-time/how-to-use/how-to-use/) - [住所チェック(個人情報の取り扱い)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/070/address-check/) - [プライバシーポリシー](https://capital-castle.notion.site/8fe175eeb35f461b9455772e91fcca4b) --- # 設定手順: オプション(注文タグ・メール表示・有効性検証・他アプリとの干渉) ```yaml screens: 左メニュー「オプション」 > 「注文への自動書き込み」 verified_from: 管理画面の実装 (項目名・文言) ``` ## PROC-O1 注文に配送日のタグを付ける (Shopify Flow) ```text 場所: アプリの左メニュー「オプション」 > 「注文への自動書き込み」 (PROC-O2 と同じ画面) 手順: PROC-O2 の手順で Flow を取り込み、「注文に反映する内容」の「配送希望日を注文タグにする」にチェックして、アプリの「保存する」を押す 結果: 注文が入るたびに、お客様が指定した配送日がタグとして付く (日付の形は「表示のまま」か「年-月-日の形」から選べる) 制限: 画面上部の手動の「タグを追加」ボタンは廃止した (O-1)。Flow を取り込む前に入った注文には、自動ではタグが付かない ``` ## PROC-O2 注文に配送日時・発送日を自動で書き込む (Shopify Flow) ```text 場所: アプリの左メニュー「オプション」 > 「注文への自動書き込み」 前提: Shopify Flow (Shopify の無料アプリ) が使えること。プランによる制限は無い (全プランで使える)。 手順 (取り込みは 1 回だけ。オプション画面の「注文への自動書き込み」カードの「設定を開始する」ボタンで設定のモーダルが開き、その中に取り込みの手順がある。取り込み後は、カードに設定のサマリーが出て、「設定を開く」で同じモーダルが開く): 1. Shopify Flow をインストール (未インストールの場合) 2. 「Flow ファイルをダウンロード」ボタンを押す (Google ドライブが開く。開いたページのダウンロードボタンで .flow を保存する) 3. Flow の右上の「インポート」でそのファイルをインポート 4. 取り込んだワークフロー「CC Delivery Date Time Order Created Revision0」を開いて「オンにする」。ワークフローの名前は変えない 5. 旧「タグを自動で付ける」(AutoTag) の Flow を使っていたら、削除またはオフにする (二重にタグが付くのを防ぐ)。 見分け方: トリガーが「Order created」でアクションが「Add order tags」の Flow。タグの内容に order.customAttributes を並べる Liquid ({% for attribute in … %} など) が書かれている 6. 「取り込みました(Revision0)」にチェックを入れて、アプリの「保存する」を押す。アプリは取り込んだ版の番号 (Revision の数字) を保存する。今後 Flow が更新されると、古い版を取り込んだ店には「新しい Flow があります」と表示され、手順に沿って入れ替える 結果: 注文が入るたびに、「注文に反映する内容」でチェックした項目が注文に書き込まれる。注文が入ってから反映まで 1〜2 分ほどかかることがある ``` 「注文に反映する内容」(チェックしたものが書き込まれる): ```text - 配送希望日を注文タグにする (日付の形: 表示のまま / 年-月-日の形。プランによる制限は無い。配送希望日の年-月-日は、「注文への自動書き込み」を有効にした店のテーマが選んだ日付を直接渡す (__ccGroup の 4 番目)。そのため、店の日付の表示形式 (曜日の省略形・月名・言語) に関係なく「年-月-日の形」「日付型のメタフィールド」「日付の条件」「発送日の計算」が使える。テーマが古いときに作られたカートだけは、表示から読み戻すので、読めない形式 (例: 曜日の省略形 ddd を使うスペイン語・フランス語・イタリア語) だと日付が付かない。旧「タグを自動で付ける」(AutoTag) の Pro 限定だった日付フォーマット変更とは別の仕組み) - 配送希望時間を注文タグにする - タグのラベル名: 「配送希望日のタグにラベル名を付ける」「配送希望時間のタグにラベル名を付ける」「発送日のタグにラベル名を付ける」を、タグごとに選べる (各タグにチェックがあるときだけ出る。既定は OFF = 値だけ。ただし発送日だけは、「注文タグに追加する」をオンにした時点で、ラベル名もオンになる (オフに戻せる)。付けると 配送希望日: 2026年10月28日 / 発送日: 2026年10月23日 の形)。配送希望日と発送日の両方をタグにすると値だけでは見分けにくいので、その場合は付けるよう案内する - ラベル名の文字 (タグ・注文メモ・メタフィールドの「ラベル名を付ける」): 配送希望日・配送希望時間の項目名は、アプリの設定で付けた名前 (お客様のカートや注文の追加の詳細に出る名前。例: 「受取希望日」「受取希望時間」) がそのまま使われる。注文ごとに、その注文に付いた名前が使われるので、多言語のストアでは英語の注文は英語の名前になる。発送日だけは固定で「発送日」。ラベル名の文字を自由に変える設定は無い (変えたいときはアプリの設定の項目名を変える) - 「発送日(出荷予定日)を」の下の 2 つのチェック: 「注文タグに追加する」/「注文のメタフィールドに保存する」(ネームスペース・キー・型 (日付型 / テキスト型) を指定) - 注文メモに追記する (項目: 配送希望日・配送希望時間・発送日と、アプリの設定にある配送方法・入力テキスト・最短日の調整の項目 (「項目名(入力テキスト)」の形で並ぶ)、その他の追加の詳細。ラベル名を付ける / 値だけ。日付の形。見出しは通常そのままでよい。見出しの欄には既定の見出し [CC配送日時指定] が入っている。欄を空にすると見出しなしで追記する。見出しなしでも、同じ行がすでにメモにある注文には二重に追記しない)。元のメモは消えず、末尾に追記される。見出しが既にメモにある注文には二重に追記しない - 配送日時や入力内容を注文のメタフィールドに保存する (値ごとに、列「ネームスペース」「キー」を指定。「ラベル名」で「値だけ」(既定)か「付ける」(「配送希望日: 2026年10月28日」の形)を選べる。日付型で保存する値にはラベル名は付かない (日付型は日付しか保存できないため。項目名を付けたいときは、テキスト型の値で保存する)。保存できる値: 発送日 (日付型 / テキスト型)・配送希望日 (日付型 / テキスト型)・配送希望時間・配送日と時間をまとめて、と、アプリの設定にある配送方法・入力テキスト・最短日の調整の項目 (「項目名(入力テキスト)」の形で選べる)。発送日の「注文のメタフィールドに保存する」の分も含めて最大 25 件) - 注文の追加の詳細から内部の属性を削除する (「取り込みました」にチェックしたときだけ表示される)。__ccValid と __ccSlot を注文から消す。CC グループ __ccGroup (Flow が発送日を計算するために一時的に書き込む内部の属性) は、この Flow の最後に必ず消える。消えるのは注文が入ってから約 15〜30 秒後 (Flow が 10 秒待ってから、最新の属性を読み直して消すため)。同時に動く他の Flow が注文の追加の詳細を書き換えていると、消えない場合がある。消えなくても注文や配送には影響しない - 条件つきルール (任意): 「もし〜なら、タグを付ける / 外す・メモに追記・顧客タグを付ける / 外す」。条件は何本でも足せて、「すべて」か「どれか」でつなぐ。当てはまらなかったときの反映も設定できる。ルールを足すには、最初は「どんなルールから始めますか?」の選択肢から選び、2 本目以降はルールの下の「+ 別のルールを追加」を押す。追加したルールは「ルール 1」「ルール 2」と番号が付き、条件と反映をあとから書き換えられる - 条件つきルールの「追加の詳細を変換して書く」(Pro プラン限定。パートナー開発ストアでも使える。Pro でないときは「+ 追加の詳細を変換して書く」が押せず「Pro プランで使えます」と出る。任意。「当てはまったら」の下の「+ 追加の詳細を変換して書く」): 注文の追加の詳細の値を置き換えて、新しい追加の詳細として注文に書く。例: 「置き配」が「玄関ドア前」なら、「配送コード」に「01」を書く。入力は、「元の項目」(アプリの項目・そのルールの条件で使っている追加の詳細・「その他(項目名を入力)」から選ぶ)、「変換表」(もとの値 → 変換後の値。20 行まで。当てはまらない値はそのまま書く。空でもよく、そのときは値をそのまま写す)、「変換後のラベル」、「変換したあと、元の追加の詳細を削除する」(既定は OFF = 元も残る)。変換後のラベルが元の項目と同じ名前のときは、元の値を置き換える(元の値は残らない。このとき削除は選べない)。変換後のラベルが、すでにある別の項目と同じ名前のときも、その値を置き換える。配送希望日・配送希望時間も元にできる(配送希望日は「日付の書式」を指定できる。空なら 2026-11-20 の形。月名や曜日名を含む書式は書かれない)。配送希望日・時間と同じ名前や、__ で始まる名前は、変換後のラベルに使えない。書き込みは Flow が注文の約 15〜30 秒後に行う(注文の直後に取り込む外部システムには間に合わない場合がある。その場合は「連携(プロプラン)」の外部システム連携を使う)。元の項目を CSV 出力や外部システムが読んでいる場合、削除や上書きをすると読めなくなる(または変換後の値になる)ので、別のラベルに書くことを案内する。変換は、いつも元の値から行う(別の変換の結果は使わない)。他の Flow が、注文の 10 秒前後に追加の詳細を全部書き換える作りだと (自分で待ち時間を入れた Flow など)、変換が消えることがある。元の項目が無い・空・「指定しない」の注文には書かない 画面の右に「この注文ならこうなります」が出る。いまの設定を試運転の注文に当てた結果で、実際の Flow と同じ計算 (試運転の注文は変えられる) ``` 発送日の決め方 (「発送日(出荷予定日)を」の「注文タグに追加する」などにチェックすると出る「発送日の計算」): ```text 質問「発送日はどう決めますか?」の 3 択: 1. 配送パターンの最短日に合わせる (おすすめ。初期値): 配送パターンの「最短日」(と地域などの最短日の調整) の分だけ、配送希望日からさかのぼる。休業曜日と営業休業日を飛ばして数える (アプリのカレンダーと同じ数え方)。暦日で足す日数 (最短日の「暦日」の加算) は、休業日を飛ばさずそのまま足す。何も設定しなくてよい 2. 配送希望日の X 日前にする: 決まった日数 (暦日) だけさかのぼる 3. 注文日の X 日後にする: 配送希望日を使わないストア向け。日付の形式が読み取れないストアでも使える - 発送日の表示形式 (「発送日の計算」の中): 「配送希望日と同じ形式」(初期値) / プリセット (YYYY-MM-DD・YYYY/MM/DD・YYYY年M月D日・M月D日・M/D) / 「自分で指定する」(年 YYYY・YY、月 MM・M、日 DD・D と区切りの文字。曜日・月名は使えない。最大 40 文字)。タグ・メモ・テキスト型のメタフィールドに効く。日付型のメタフィールドは常に 年-月-日。ストアの日付形式が読み取れない場合 (曜日の省略形 ddd を使うスペイン語・フランス語・イタリア語など) は、「配送希望日と同じ形式」だと発送日のタグ・メモが付かないので、ここで形式を選ぶよう案内する 「詳しく設定する(任意)」(初期は閉じている): - 条件ごとに日数を変える: 「商品タグ・都道府県・配送方法の名前・追加の詳細など」の条件に当てはまる注文だけ、日数 (決まった日数 / 配送パターンの最短日) を変える。上から順に見て最初に当てはまった行を使う。どれにも当てはまらなければ、上の 3 択のとおり。1 件に条件を何本でも足せて、「すべて」か「どれか」でつなぐ (例: 「商品タグ 冷凍」かつ「配送先の都道府県 北海道」なら 3 日前。画面: 「+ 条件ごとの日数を追加」→ 条件を選ぶ →「+ 条件を追加」で 2 本目 → 「当てはまったら」で「決まった日数」を 3 日前にする)。複数の商品に当てはまる場合は日数の長い行を上に置くと長いほうが使われる - 休業日: 「決まった日数」も休業日を飛ばして数える (初期は OFF。最短日は常に休業日を飛ばす) - 配送希望日が無い注文・日付が読み取れない注文 (「発送日はどう決めますか?」が配送希望日からさかのぼる方法のときだけ出る): 発送日を付けない (初期値) / 注文日から、上で決めた日数だけあとにする (配送希望日の代わりに注文日から数える。日数は、「条件ごとに日数を変える」で当てはまった行の日数、どれにも当てはまらなければ上で選んだ方法の日数。例: 兵庫県が 5 日なら注文日の 5 日後、それ以外は配送パターンの最短日の分だけあと) / 注文日から X 日後にする (配送希望日が無い注文だけの日数を別に決める。0〜60 日。休業日を飛ばすかは「休業日」の設定に従う)。「注文日の X 日後にする」を選んだときは、この選択は出ない。発送日が配送希望日に頼らない設定 (注文日から数える) のときは、日付も時間も「指定しない」の注文にも、発送日が付く (アプリを通った注文だけ。アプリを通っていない注文には付かない) - 注文日から数えるときの締め時刻: 注文時刻が指定の時刻以降なら翌日の注文として数える ``` 制限・補足: ```text - 発送日が付かない・タグが付かないときの確認の順: (1) Flow の「最近の実行」に、注文のたびに実行が並んでいるか (並ばなければワークフローが「オン」か、取り込んだ Flow の名前を変えていないか) (2) 「取り込みました」にチェックして「保存する」を押したか。「配送パターンの最短日に合わせる」の発送日は、保存したあとにカートへ入れた注文から付く (保存前のカートには、パターンを特定する内部の属性 __ccGroup が載らない) (3) その注文に配送希望日が入っているか (「付けない」設定のとき) (4) 注文が入ってから 1〜2 分待ったか - 書き込まれるのは、注文が作られた時 1 回だけ。作成後に配送日時を変更しても、書き込み済みの内容は変わらない。取り込み前に入った注文にも書き込まれない - 設定を変えて「保存する」を押せば、取り込み済みの Flow にそのまま効く。ファイルの入れ替えは要らない。休業日 (配送パターンの休業曜日・営業休業日) を変えたときも、保存し直すまで Flow には反映されない - Flow に渡す設定の大きさは上限 120KB。超えると保存できない (画面に現在の大きさが出る)。超えたら条件つきルールを減らすか、発送日の「配送パターンの最短日に合わせる」をやめる - 発送日が付かないのは、配送希望日が無い (または日付が読めない) 注文で「付けない」を選んでいるとき、最短日の方式で配送パターンが特定できないとき、休業曜日がすべて休みのとき ``` ## PROC-O3 メール・サンキューページに配送日時を出す ```text 場所: アプリの左メニュー「オプション」 > 「メールとチェックアウト画面への表示方法」 - 「注文の確認メール」: インストラクションを開き、Liquid コードを通知メールのテンプレートに貼る (手動) - 「サンキューページ (追加スクリプト)」: 追加スクリプトによる方法 - 「(新)サンキューページと注文状況ページ」: 拡張機能による方法 (ベーシックプラン以上のマーチャント向け)。他アプリの対応も確認して切り替える 注意: コードの挿入はマーチャントの手作業。自動では入らない ``` ## PROC-O4 チェックアウトで日付の有効性を検証する ```text 場所: アプリの左メニュー「オプション」 > 「チェックアウト時の配送日の有効性検証」 > チェック「有効にする」 検証する内容: 必須化の入力有無、最短日、最長日 (失敗した場合、お客様は購入に進めない) 制限: - カットオフ時間での検証はできない。カットオフが複数のグループにある場合は、検証用に「カットオフの時間」を1つだけ選ぶ (選ばれなかったカットオフのグループ/選択肢は最短日の計算に使われない) - 選択肢(配送エリアなど)・配送指定時間・入力テキストは、必須化の入力有無だけを検証する - 保存サイズが上限を超えている場合はONにできない メッセージ: 「配送希望日の有効性検証のメッセージ」などを編集できる (既定の文言あり) ``` ## PROC-O5 他アプリと干渉するとき ```text 場所: アプリの左メニュー「オプション」 > 「カートアトリビュートのアップデート」 - 「アプリ(カートページ)の読み込み時にカートアトリビュートのアップデートを行わない」 - 「「購入する」ボタンを押した時にカートアトリビュートのアップデートを行わない」 用途: 使っている他アプリとの干渉で不具合が出るときに ON にして解消を試す 注意: ON にすると、注文に配送日時が確実に追加されるための更新を行わなくなる。実店舗で動作確認する ``` ## PROC-O6 言語ごとに配送日時指定の表示を切り替える ```text 場所: アプリの左メニュー「オプション」 > 「言語毎の表示切り替え」 説明文: 「ストアの言語毎に配送日時指定の表示/非表示の設定ができます。」 手順: 1. チェック「有効にする言語を選ぶ」を ON にする 2. ボタン「設定を開始する」を押す (ON にしたときだけ表示される) 3. 「言語毎の設定」で、「配送日時指定を表示するストアの言語を選択してください。」に従い、表示したい言語にチェックを入れる 4. 画面上部の「保存する」を押す 結果: チェックを入れた言語のページでだけウィジェットが出る。チェックの無い言語のページでは出ない。 注意: - 出ない言語のページでは、入力欄も必須のチェックも働かない。日時を指定せずにチェックアウトへ進める。 「チェックアウト時の配送日の有効性検証」を ON にしていても、出ない言語のお客様は検証で止まらない。 - 出ない言語のページを開くと、別の言語で入れた配送日時・配送地域・入力テキストなど、このアプリが書いた属性が自動で削除される。他のアプリの属性は消さない。 言語を戻したときは、お客様が選び直す必要がある。以前のバージョンのアプリでは、日本語で選んだ属性が残り、古い日付が注文に載ることがあった。 - チェック「有効にする言語を選ぶ」が OFF のときは、すべての言語で表示される。 - 「言語毎の設定」の一覧は言語名 (日本語・英語など)。お客様が見ているストアのページの言語と照合する。 - 日時指定を必須にしたい言語は、チェックを入れて表示する言語に加える。 ``` ## 「オプション」画面の見出し一覧 (上から。実画面で確認済み) 1. チェックアウト時の配送日の有効性検証 (「有効にする」。現在の保存サイズ表示あり) 2. 保存データのバックアップファイルの作成 3. 注文への自動書き込み (画面の見出しはこの名前。仕組みは Shopify Flow を使う) 4. 言語毎の表示切り替え 5. メールとチェックアウト画面への表示方法 6. カートアトリビュートのアップデート 7. 営業休業日カレンダーの設定 (日より前の日付を自動で削除する) 8. 設定サポートを有料で依頼する ## FACTS ```text O-1 画面上部の手動の「タグを追加」ボタンは廃止した。タグ・メモ・メタフィールドを注文に書き込みたいなら「注文への自動書き込み」(Shopify Flow を使う。PROC-O2)。 O-2 メールへの表示は、マーチャントがテンプレートにコードを貼る方式。アプリが自動でメールを書き換えることはない。 O-3 有効性検証を ON にしても、カットオフ時間の検証はできない。 O-4 「言語毎の表示切り替え」で表示しない言語は、ウィジェットも必須チェックも無く、有効性検証も通る (PROC-O6)。必須にしたい言語は表示する言語に加える。 O-5 「注文への自動書き込み」で保存したメタフィールドは、定義が無いもの (ネームスペースとキーを自由に決めたもの。既定は custom.delivery_date / custom.delivery_time) は、注文の管理画面のメタフィールドの一覧には出ない。値は保存されている。見る方法: 注文の詳細ページのメタフィールド (管理画面の「注文」> 該当の注文 > メタフィールド。URL は …/orders/注文ID/metafields) を開き、ページ上部の「構造化されていないメタフィールドを表示」を押す (URL は …/orders/注文ID/metafields/unstructured)。スタッフにも一覧で見せたい場合は、Shopify 管理画面の「設定」>「カスタムデータ」>「注文」で、同じネームスペースとキーのメタフィールド定義を作る (アプリは定義を作らない)。「保存したのにメタフィールドが無い」という問い合わせは、まずこれを案内する。 O-6 反映の「+ 差し込み」には、配送日時・発送日のほか、アプリの設定の配送方法・入力テキスト・最短日の調整の項目が、設定した項目名で並ぶ (配送希望日・配送希望時間もアプリの設定の項目名で並ぶ。「お祝いメッセージ(入力テキスト)」のように。選ぶと、メニューと同じ項目名の変数が入る。例: {配送希望日} {配送希望日(年-月-日)} {配送希望時間} {発送日} {発送日(年-月-日)} {お祝いメッセージ}。古い書き方の {日付表示} {入力1} {@項目名} も使える)。旧版にあった「入力欄の内容(1つ目・2つ目)」のような番号の差し込みは廃止した (すでに保存済みの {入力1} などは、そのまま動く)。 O-7 「注文への自動書き込み」の基本の設定 (タグ・メモ・メタフィールド) は、配送希望日か配送希望時間が入っている注文で動く。配送希望日・時間がどちらも「指定しない」の注文は、書き込まれない。ただし、メモやメタフィールドに選んだアプリの項目 (配送方法・入力テキストなど) に値がある注文は、日付・時間が無くても、その項目だけが書き込まれる。「メモが付かない」という問い合わせは、まず注文の追加の詳細に、選んだ項目の値があるかを確かめる。 O-8 「注文への自動書き込み」は、入力テキスト・配送方法・最短日の調整(地域)の項目名を、名前の文字で参照している(メモに追記する項目・メタフィールドに保存する項目・条件・追加の詳細の変換の元・反映の本文の {項目名})。アプリの設定でその項目名を変えたり消したりしても、Flow 側は自動では変わらず、その項目だけ注文に書き込まれなくなる(注文や配送そのものは壊れない)。設定画面は、変えた欄の直下に、赤文字「「旧名」は「注文への自動書き込み」の設定に残っています。新しい項目名に直さないと、注文に書き込まれません。」とリンク「オプションを開く」を出す(リンクを押すと、オプションの「注文への自動書き込み」の設定のモーダルまで開く)。出る欄: 入力テキストの入力タイトル・配送方法の表示ラベル・最短日の調整の表示タイトル。配送希望日・配送希望時間の表示ラベルは、基本設定(タグ・メモ・メタフィールド)なら変えても自動で追従する。追従しないのは、条件つきルールの本文に名前の変数(例 {受取希望日})で書いた場合と、追加の詳細の変換の元にした場合だけで、そのときだけ表示ラベルの欄に注記が出る。直し方: オプション > 注文への自動書き込み で、新しい項目名にチェックし直し、条件や本文の項目名も直し、古い名前の「×」を外してから保存する。別の画面に移って戻ったり、保存して開き直したりしたあとは、行ごとの注記ではなく、入力テキスト欄の下にまとめて出ることがある。この機能の公開前に変えた名前は記録が無く、注記は出ない。「項目を変えたらタグ・メモが付かなくなった」という問い合わせは、まずこれを案内する。 ``` ## ESCALATE - 「メールに配送日時が出ない」: テンプレートにコードを貼ったか、ラベル(グループ名を変更した場合は再取得)が一致しているか、通知メールの種類を確認する。 - 「検証でお客様が購入に進めない」: ストアURL、カート内の商品、表示されたメッセージ、設定したグループの最短日・最長日を依頼する。 ## SEE - [注文に配送日時指定のタグを追加](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/090/delivery-datetime-tags-to-order/) - [チェックアウト画面での有効性検証](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/100/checkout-validation/) - [メールに入力された配送日時指定を表示することはできますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/120/mail/) - [サンキューページと注文状況ページに配送希望日時を表示することはできますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/130/thankyou-order/) --- # 商品ページの「最短日の表示」ブロックの仕様と設定 ```yaml screens: オンラインストア → テーマ → カスタマイズ → 商品ページ → アプリブロック「最短日の表示」 verified_from: theme-develop の shortestPorducts.ts / product/getMessage.ts / テーマ拡張の block 定義 (product-cc-dellivery.liquid) / 人間向けマニュアル note: このブロックは「表示するだけ」。カートに入れたあとの日付の選択はカート側のウィジェットで行う。 ``` ## SUMMARY 商品ページに、その商品の **最短お届け日** を表示するアプリブロック「最短日の表示」(英語名 Display Shortest Date)。 表示する日付は、管理画面の最短日の設定 (営業日・カレンダーデイ・カットオフ・営業休業日・地域別の調整) を計算した結果と同じ (020 の S-*)。 ## RULES ```text PP-1 日付は、閲覧中のバリアントを対象に計算する。バリアントを切り替えると再計算する。 PP-2 「商品毎のグループを有効にする」が ON のとき、その商品がどのグループになるか (商品の紐づけ・商品タグ・タグ::SKU・条件) で、 グループごとの最短日を表示する。商品ページでは、ほかにカートへ入っている商品は考慮しない。 (カート側のウィジェットは、カート内の全商品から priority 最小のグループを使う。ここが食い違いの原因になりやすい) PP-3 条件 (重量/合計金額/在庫) のグループは、このバリアントの重量・金額・数量で判定する。カートに同じバリアントが入っていれば、その数量を使う。 PP-4 次の場合はブロックごと表示されない: - 非表示商品として設定された商品 - そのグループ (または配送方法) で「配送希望日を表示しない」設定になっている - 「在庫切れの時は表示しない」が ON で、そのバリアントが在庫切れ PP-5 日付の書式は管理画面「カレンダーの設定」の「入力される日付のフォーマット」と同じ。 PP-6 現在時刻は、配信設定にタイムゾーンがあればその時刻、無ければ閲覧者のブラウザの時刻 (S-6 と同じ)。 PP-7 「配送方法、配送地域などをセレクトボックスで表示する」ON: 商品ページで配送方法/配送地域を選ぶと、その選択肢の分だけ最短日が変わる (S-7)。 配送方法 (スロット) が有効なときは「配送方法名: 日付」を並べて表示する。 PP-8 存在しないバリアントの組み合わせ (選べない組み合わせ) を選ぶと、数秒間は前の表示のままで、そのあと既定のグループの表示になる。 PP-9 このブロックは動的チェックアウトとは無関係に、商品ページに「表示」するだけ。注文に配送日時は付かない。 ``` ## UI_LABELS アプリブロック「最短日の表示」の設定項目 (テーマカスタマイズの右側): | 項目名 | 初期値 | | --- | --- | | 最初の文章 | 最短お届け日は | | 最後の文章 | です。 | | ノート | (テキスト) | | フォントのサイズ / ノートのフォントのサイズ | 16 / 14 | | テキストカラー / テキストカラー(ノート) / テキストカラー(最短日) | #6A6A6A / #737373 / #121212 | | 在庫切れの時は表示しない | OFF | | 配送方法、配送地域などをセレクトボックスで表示する | OFF | | 選択肢(配送地域など)の初期表示のテキスト | - | ## PROC-P1 商品ページに最短日を表示する 場所: Shopify 管理画面の「オンラインストア」 > 「テーマ」 > 「カスタマイズ」 > 商品ページ > 「ブロックを追加」 > アプリの「最短日の表示」 1. Shopify 管理画面の「オンラインストア」→「テーマ」→「カスタマイズ」を開く 2. 上部のページ選択で「商品ページ」(商品テンプレート) を選ぶ 3. 表示したい位置で「ブロックを追加」→ アプリの「最短日の表示」を選ぶ 4. 右側で文章・文字サイズ・色を調整して保存する ## PROC-P2 配送地域や配送方法で日付を切り替えて見せる 場所: アプリの左メニュー「設定」 > カード「配送希望日」 > チェック「選択肢(配送地域など)による最短日の調整を設定する」 (先に設定) → テーマの「カスタマイズ」 > 「最短日の表示」ブロック 1. 設定画面で「選択肢(配送地域など)による最短日の調整を設定する」(または配送方法) を設定しておく 2. 「最短日の表示」ブロックで「配送方法、配送地域などをセレクトボックスで表示する」を ON にする 3. 必要なら「選択肢(配送地域など)の初期表示のテキスト」を変える (初期値は「-」) ## QA - **Q: 商品ページの最短日は、何をもとに決まるか。調整したい。** A: 最短日の設定 (営業日・カレンダーデイ・カットオフ・営業休業日・地域別の加算) の計算結果。調整は設定画面の該当項目を変える (020 の S-1〜S-7)。 - **Q: 商品ごとに最短日を変えたい。** A: 商品のグループ化 (タグ・商品管理・条件) で、グループごとに最短日を設定する。商品ページのブロックにはグループごとの日付が出る (PP-2)。 - **Q: バリアントごとに最短日を変えたい。** A: 「タグ::SKU」でバリアントをグループに紐づける (C-5)。優先順位に注意 (複数タグが付くと priority 最小が使われる)。 - **Q: 商品ページの日付と、カートで選べる最短日が違う。** A: 商品ページは閲覧中のバリアントだけで計算するが、カートはカート内の全商品から priority 最小のグループを使う (PP-2)。複数商品・条件グループ・非表示商品の有無を確認する。地域別の加算は、商品ページではセレクトボックスで選ばないと加算されない (PP-7)。 - **Q: 商品ページに最短日が出ない。** A: PP-4 を順に確認する (非表示商品か / 日付を表示しない設定か / 在庫切れの非表示)。あわせて、ブロックを置いたテンプレートが商品ページか確認する。 - **Q: 日付が表示されるが「今日」になる / 古い。** A: 断定しない。ブラウザ・テーマ・ストアURL を依頼する (ESCALATE)。 - **Q: 商品ページに「配送日時を選ぶカレンダー」を置きたい。** A: 商品ページにも設置できるが、商品ごとのグループ化は反映されない (L-4)。 - **Q: 「発送予定日」と表示したい。** A: 文章は「最初の文章」「最後の文章」で変えられる。計算されるのは最短日で、発送日の計算ではない。別の計算が必要な場合は確認する。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 商品ページの日付が期待とずれる | 商品URL、バリアント、設定画面の最短日の設定、カート内の商品、ブラウザ | | バリアントを切り替えても日付が変わらない / 遅れて変わる | 商品URL、テーマ名、切り替えたバリアント、ブラウザのコンソールのエラー | | ブロックが出ない | 商品URL、テーマ名、テーマカスタマイズでブロックを追加している画面 | ## SEE - [商品ページに最短配送日を表示する](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/068/shortest-date-product/) - [最短日の設定(営業日+カレンダーデイ)](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/030/shortest-date/) - [選択肢(配送地域など)による最短日の調整](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/045/shortest-date-with-selection/) - [商品毎のグループ化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/080/products-groups/) - [商品ページに設置できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/030/products-page/) --- # 日付ルールの特殊な組み合わせ: 発売日前の商品・営業休業日カレンダー・地域別の制限・自社配送 ```yaml screens: 設定 (配送希望日 / 商品のグループ化) / オンラインストア → テーマ → カスタマイズ (アプリブロック「営業休業日カレンダー」) verified_from: テーマウィジェット (theme-develop の getMessage / selectDays / holiday-calendar) / テーマ拡張の block 定義 / 人間向けマニュアル / 実際の問い合わせ対応の返信 note: 「できる」は D-* のルールから導ける範囲だけ。店舗の運用の細部はストアの設定を見ずに断定しない。 ``` ## SUMMARY 日付の制限は、**最短日 (営業日・カレンダーデイ・カットオフ・地域加算)** と **選べる日 (指定不可日・指定不可曜日・指定可能日)** を組み合わせて作る。 商品によって制限が違うときは **商品のグループ化** (グループごとに別設定)。販売の開始日の制御は本アプリの機能ではない。 ## RULES ```text Z-1 「◯月◯日から販売」(販売期間の制御) は本アプリでは設定できない。 代替: Shopify の公開スケジュール、または販売期間を制限する別アプリ。 (同じ開発元の「CC オーダールール」で期間販売ができる。詳細は範囲外のため、開発元への問い合わせを案内する) Z-2 「販売は先だが、配送日は◯月◯日以降にしたい」は、その商品だけのグループを作り、 そのグループの「指定不可日」に◯月◯日の前日までを登録する (または最短日を長くする)。 その他の全商品は、バッジ「標準」のグループ (削除できない) の設定が適用される。 Z-3 営業休業日カレンダー (表示専用のブロック) は、設定した営業休業日・休業曜日をグレーアウト+打ち消し線で見せる。 本日は枠線。日付を選ぶ機能は無い。曜日の言語と開始曜日はアプリの設定に従う。 Z-4 「配送希望日を表示しない」(日付 OFF) のグループでは、そのグループの営業休業日は反映されない。 日付入力を出さずに営業休業日カレンダーだけ使いたいときは、営業休業日を入れた専用のグループを作り、 カレンダーに反映するグループとしてそのグループを選ぶ。 Z-5 営業休業日カレンダーには、グループ・選択肢ごとに「反映する/しない」を選べる。複数選ぶと休業日の和集合を表示する。 Z-6 選択肢 (配送地域など) ごとに変えられるのは、最短日の加算 (営業日数・カレンダーデイ) だけ (S-7)。 選択肢ごとに指定不可日・指定不可曜日・営業休業日を変える設定は無い。 Z-7 「配送準備は営業日 (月〜金)、配送可能日は月〜土」のように、数え方と選べる曜日が違うときは、 営業休業日 (最短日の数えから外す日) と 指定不可曜日 (選べない日) を別々に設定する (S-2 / S-9)。 Z-8 営業休業日は最短日の計算にだけ、指定不可日・指定不可曜日は選べるかどうかだけに効く。 祝日で配送もしないときは、営業休業日と指定不可日の両方に登録する。 ``` ## PROC-Z1 営業休業日カレンダーを商品ページなどに出す 場所: Shopify 管理画面の「オンラインストア」 > 「テーマ」 > 「カスタマイズ」 > 「ブロックを追加」 > アプリの「営業休業日カレンダー」。反映するグループの選択は アプリの左メニュー「オプション」 > 「営業休業日カレンダーの設定」 1. Shopify 管理画面の「オンラインストア」→「テーマ」→「カスタマイズ」を開く 2. カレンダーを出したいページ・セクションで「ブロックを追加」→ アプリの「営業休業日カレンダー」(英語名 Holiday Calendar) を選ぶ 3. ブロックの設定項目: 休業日のラベルテキスト / 休業日の背景色 / 休業日の文字色 / 文字サイズ (px) / 過去に戻れる月数 (既定 0) / 先に進める月数 (既定 3) 4. 反映するグループを選ぶ: アプリの設定画面「オプション」の「営業休業日カレンダーの設定」で、グループ・選択肢ごとにチェックを入れる 補足: 「営業休業日と指定不可日は ◯ 日より前の日付を自動で削除する」を設定していると、過去の休業日はカレンダーに出ない (削除した日付は復元できない)。 ## PROC-Z2 一部の商品だけ、配送日を◯月◯日以降にする 場所: アプリの左メニュー「設定」 > カード「商品のグループ化」 > 対象グループ > 「指定不可日」 (グループの作り方は PROC-G1〜G2) 1. 「商品毎のグループ化」を有効にし、グループを追加する (PROC は 060 を参照) 2. そのグループに対象商品を紐づける (タグまたは商品管理) 3. そのグループの設定で、「指定不可日」のカレンダーに、◯月◯日の前日までの日付を登録する 4. その他の商品は、バッジ「標準」のグループの設定のまま (何もしなくてよい) ## QA - **Q: 7/25 から販売で、配送日は 8/7 以降にしたい。** A: 配送日の制限は Z-2 で可能。販売開始日の制御は本アプリでは不可 (Z-1)。 - **Q: 日時指定は使わず、営業休業日カレンダーだけ使いたい。** A: 営業休業日カレンダーのブロックは単体で置ける (PROC-Z1)。日付を OFF にすると休業日が反映されないので、営業休業日用のグループを作る (Z-4)。 - **Q: 地域ごとに指定不可曜日を変えたい (遠方は金曜着不可など)。** A: 選択肢ごとに指定不可曜日を変える設定は無い (Z-6)。選択肢ごとに変えられるのは最短日の加算だけ。運用の詳細 (対象地域・曜日・締め時間) を依頼して確認する。 - **Q: 土日は営業日に数えないが、土曜は配送したい。** A: 営業休業日に土日、指定不可曜日に日曜、のように別々に設定する (Z-7)。 - **Q: 祝日を一括で入れたい。** A: 日本語の管理画面では「◯年の祝日を反映」ボタンで営業休業日・指定不可日に一括追加できる (040 のカレンダーの設定)。 - **Q: 営業休業日カレンダーに過去の休業日が出ない。** A: 自動削除の日数のため。日数を大きくするか 0 にする。削除済みの日付は戻らない (PROC-Z1)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 地域・曜日・時間帯が複雑に絡む制限 | 対象地域、発送元の締め時間、配送にかかる日数、選べない/選べる曜日の一覧 | | 営業休業日カレンダーが表示されない | ストアURL、ブロックを追加したページ、テーマ名 | | 設定したのに日付が選べてしまう/選べない | 該当グループの設定画面、カート内の商品、注文した日時 | ## SEE - [営業休業日カレンダーの設定](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/105/holiday-calendar/) - [商品毎のグループ化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/080/products-groups/) - [指定不可日 | 指定可能日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/041/blockout/) - [営業休業日](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/040/holiday/) - [選択肢(配送地域など)による最短日の調整](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/045/shortest-date-with-selection/) --- # 症状別の切り分け: ウィジェットが出ない・配送日時が注文に無い・購入に進めない ```yaml screens: テーマエディタ (アプリの埋め込み / セクション) / 左メニュー「オプション」「商品」 verified_from: テーマウィジェット (theme-develop) / チェックアウト検証 Function / テーマ拡張の block 定義 / 人間向けFAQ note: 原因は「候補」。マーチャントのストアを見ずに断定しない。ESCALATE の情報を依頼する。 ``` ## SUMMARY 症状から原因を絞るページ。**原因は断定せず、候補を確認の順番どおりに案内する**。1 つの症状に複数の原因があり、ストアを確認しないと決まらないものが多い。 配送日時は、カートの属性 (注文の「追加の詳細」) としてウィジェットが書き込む。購入の経路がカートの属性を運べない、または書き込む前に JavaScript が動かなかった、のどれかで「注文に無い」が起きる。 ## 前提 (仕組みの事実) ```text TS-1 ウィジェットはカートの属性に次を書き込む: 配送希望日のラベル=日付 / 配送希望時間のラベル=時間 / (配送エリアのラベル=選択値) / 入力テキストのキー=入力値 / 配送方法のラベル=選んだ配送方法。 キー名は管理画面のラベル設定と同じ (ラベルを変えるとキーも変わる)。 TS-2 __ccValid は「チェックアウト時の配送日の有効性検証」が ON のときだけ書き込まれる。 値は選択内容を JSON 配列にした文字列。チェックアウトの検証 (Shopify Function) が読む。 TS-3 __ccSlot は「配送方法のカスタマイズ」(Pro) が ON のときだけ書き込まれる。 値は "<配送方法の番号>::<グループ番号>" の形。 TS-4 日時指定の対象外のカート (非表示商品の設定により対象外になったカート。G-8 / G-9) では、 ウィジェットは出ず、上記の属性は空 (削除) になる。入力済みの値は注文に残らない (G-10)。 TS-5 アプリの埋め込み (App embed) が有効なら、全ページでウィジェットのコードが読み込まれる。 「セクション」として置いた場合は、置いたテンプレートのページだけで読み込まれる。 TS-6 動的チェックアウト (「今すぐ購入」/ Apple Pay などのボタン) は、Shopify の仕様でカートの属性を運べない。 TS-7 チェックアウトの検証は、カートの属性が "inValid" のとき、既定のエラーを出して購入を止める。 ``` ## 症状別: 確認の順番 ### SYM-1 カートにウィジェットが表示されない ```text 確認の順: 1. アプリの埋め込み (App embed) が有効か、または カートのテンプレートにセクションが置かれているか → どちらも無ければ表示されない (TS-5)。 2. カートの商品が全て「非表示商品」か。非表示優先が ON で、非表示商品が1つでも入っていないか → G-8 / G-9。このときは設定した「商品ノート」が代わりに出ることがある (G-11)。 3. 商品ページで見ている場合: 商品ページ用のセクション (ウィジェットモード) が置かれているか。 カートページ用の設定と、商品ページ用の設定は別。 4. 上記に当てはまらないときは ESCALATE へ。テーマ側のカート (ドロワー式など) や、他アプリとの干渉は マーチャントのストアを見ないと断定できない。 ``` - 「購入ボタンが押せない/表示されない」場合: テーマエディタの「アプリの埋め込み」にある「配送日時指定ウィジェットが表示されるまで購入ボタンを隠す」が ON のときは、ウィジェットが出るまで購入ボタンが隠れる。ウィジェットが出ない原因を先に解消するか、この設定を OFF にする。 ### SYM-2 注文の「追加の詳細」に配送日時が無い ```text 原因の候補 (確認の順): 1. 動的チェックアウト (「今すぐ購入」・Apple Pay などのボタン) から購入された (TS-6)。 → ボタンを OFF にしてもらう。配送日時が必須の場合は特に。 2. 非表示商品の設定で、日時指定の対象外のカートだった (TS-4 / G-8 / G-9)。この場合は仕様どおり空。 3. 他アプリとの干渉。配送日時以外の属性は注文に残っていて、配送日時だけ無いときの可能性が高い。 → 干渉しているアプリの提供元への確認が必要。 4. 後払い決済など外部の決済機能が属性を消した。配送日時の属性がすべて無いときの可能性。 5. 端末の不具合や通信の遅延で、アプリの JavaScript が読み込まれなかった。再現性が無い。 ``` - 頻発する場合は「コラボレーションコード」を添えてサポートに連絡してもらう (調査のため)。 - 配送日時が重要な店舗 (冷凍食品・生花など) での対策は SYM-4 の「読み込み時に __ccValid をポスト」。 ### SYM-3 注文の「追加の詳細」に __ccValid / __ccSlot が出る ```text 原因: 機能の動作に必要な値のため。 - __ccValid: 「チェックアウト時の配送日の有効性検証」を ON にしている (TS-2) - __ccSlot : 「配送方法のカスタマイズ」(Pro) を ON にしている (TS-3) 対処: これらの機能を使うなら必須。値を残したくないだけなら、「オプション」の「注文への自動書き込み」を取り込んだうえで、 「注文の追加の詳細から内部の属性を削除する」にチェックして保存する (070 の PROC-O2)。注文が入ったあとに消える。 注意: 機能を OFF にすれば出なくなるが、その機能 (検証・配送方法のカスタマイズ) も働かなくなる。 ``` ### SYM-4 チェックアウトで購入に進めない / エラーが出る ```text 原因の候補: 1. 「有効性検証」が ON で、配送日時の属性が付いていない (ウィジェットが動かなかった・動的チェックアウト等) → 検証用のメッセージ (「配送希望日の有効性検証のメッセージ」で設定) が出る。 2. 選んだ配送日が、設定上選べない日になっている (最短日より前・最長日より後・指定不可日など) → 日付のエラーメッセージが出る。カートに入れて数日放置した場合にも起きる。 3. 必須項目 (配送時間・配送エリア・入力テキスト) が未入力。 4. 「読み込み時に __ccValid をポスト」が ON で、ウィジェットのコードが読み込まれなかった → __ccValid が "inValid" のまま残り、検証が既定のエラーを出して止める (TS-7)。 → お客様はカートに戻ってページを再読み込みする必要がある。 ``` - 「読み込み時に __ccValid をポスト」はテーマエディタの「アプリの埋め込み」(またはセクション) の設定項目。配送日時が必須で、読み込み失敗を検知して購入を止めたい店舗向け。離脱のリスクがある (購入に進めなくなる)。 - 検証はカットオフの時間では行えない (O-3)。 ### SYM-5 最短日より前の配送日で注文された ```text 原因: カートで有効な日付を選んだあと、購入せずに数日置いてからチェックアウトを完了した場合など。 カートでは検証されるが、チェックアウト画面ではアプリ側の検証が行われない。 対策: 「チェックアウト時の配送日の有効性検証」を ON にする (チェックアウトで最短日以降かを検証する)。 例外: 決済が別サイトを経由する方法 (例: KOMOJU) で、決済画面に遷移したあと数日置いて完了した場合は、 有効性検証が働かない。注意書きの文言を案内するか、再指定できる別の方法を検討してもらう。 ``` ### SYM-6 カートで入力した配送日時が注文に反映されない SYM-2 の 1 (動的チェックアウト) と 3 (他アプリ) を最初に確認する。次の点も案内する。 - 他の配送日時指定アプリから乗り換えた直後は、他アプリのコードが残って干渉することがある。非表示にしていても、コードが残っていれば干渉する。アンインストールして確認してもらう。 - 以下のアプリとは同時に使えないことが確認されている: Hulk Products Options。 ### SYM-7 ウィジェットのレイアウトが崩れる ```text 対処: アプリの「CSSの設定」(テーマエディタの「アプリの埋め込み」にある) に CSS を書いて調整する。 - セレクタは .cc-calendar-overall から始める (他のレイアウトへの影響を防ぐため)。 - "%}" の表記は使えない。使うときは "width: 100%;" のようにセミコロンを付ける。 - テーマ別の実績のある CSS が人間向けマニュアルにある。 - 注記 (note) だけが右寄せになる場合の実績: 埋め込みアプリの CSS に `.cc-calendar-overall .note{justify-content:unset}` を追加した。 - 配送方法・店舗受取など、選択によってだけ崩れる場合は、その状態で崩れている要素を特定してもらう (スクリーンショット)。 ``` ### SYM-8 メールに配送日時が出ない 別ページ [設定手順: オプション](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/070/setup-options/) の PROC-O3 と ESCALATE を参照する。アプリが自動でメールを書き換えることはなく、テンプレートにコードを貼る方式 (O-2)。 ### SYM-9 配送希望時間だけが空のまま注文が通る (別アプリが上書きしている疑い) ```text 症状: __ccValid では時間は選択済みなのに、注文の配送希望時間が空 (日付は入っている)。短時間に連続して注文する顧客で起きる。 考え方: - 本アプリは __ccValid と配送希望時間を同じ処理で一括更新する。両者がずれるのは、本アプリ単独では起きにくい。 - 事例: メッセージカード/ギフト系の別アプリのコードが、配送希望日・配送希望時間を遅延してカートへ書き込み、後から上書きしていた。 確認する順番: 1. __ccValid の値 (配列の 5 番目が true = 時間選択済み) と、注文の配送希望時間が食い違っているか 2. ストアに、メッセージ入力・ギフト・カート操作をする他アプリが入っているか (カートの属性を書き換えるもの) 3. 他アプリのコードが「配送希望日」「配送希望時間」の属性を更新していないか 対処: 他アプリ側で、配送希望日・配送希望時間を更新しないようにしてもらう。 本アプリ側で、他アプリの書き込みのタイミングを保証することはできない (後から書いた方が残る)。 ``` ### SYM-10 スマホでカレンダーの × が反応しない・閉じるのが遅い ```text - アプリ側で対応済み (2026-04): × ボタンのタップ領域を 44×44px に拡張し、イベントの重複登録を整理した。 - それでも遅い場合: テーマや他アプリのスクリプトが原因のことがある。 事例: カートページのスクリプトが 0.5 秒ごとに /cart.js を同期 XHR で取得し続け、メインスレッドが止まっていた。 確認: ストアURL、端末と OS (iPhone / Android)、カートページに入っている他のスクリプト・アプリ名。 ``` ### SYM-11 配送日時の表示が遅い・初期表示に時間がかかる ```text - アプリの JavaScript 自体の読み込みは遅延が少ない。ウィジェットはカートページの「購入手続き」ボタンに合わせて表示するため、 テーマや他アプリによってボタンの生成が遅いストアでは、表示も遅れる可能性がある。 - 対策: 表示場所を固定する。表示したい場所に を置く (FAQ「配送日時指定を任意の場所に表示できますか」)。 - 他アプリが /cart.js を常に取得し続けていないか (例: 決済・購入関連の外部アプリ) を確認する。 - HTML に #cc-calendar-overall が 2 つあるのは仕様 (非表示のひな形を複製して表示用を作る)。遅延の原因にはならない。 ``` ### SYM-12 Google の検索結果に、配送日時の選択肢が表示される ```text - 原因: ウィジェットのテキスト (選択肢・日付セル・設定 JSON) が、全ページの DOM に展開されているため、 Googlebot が JavaScript を実行して読み取り、検索スニペットに混ざることがある。 - 対応済み (2026-04): ウィジェットの要素に data-nosnippet 属性を付与した。全ストアに反映済みで、マーチャント側の設定変更は不要。 - 反映時期: 既にインデックス済みのスニペットは、Google の再クロール後に順次消える (数日〜数週間)。 - 消えない/表示環境による: 検索結果はアカウントや時期で見え方が変わる。site: 検索でページ名と症状の出るページを依頼する。 ``` ### SYM-13 店舗受取の下に「明日 18:59」など、見覚えの無い日時が出る ```text - 本アプリの表示ではなく、Shopify の店舗受取の設定の「受取予定日」の表示であることがある。 - 確認: Shopify 管理画面 → 設定 → 発送と配達 → 店舗受取 → 該当の店舗の「受取予定日」の設定。 ``` ### SYM-14 「チェックアウト時の配送日の有効性検証」が保存サイズ超過で ON にできない ```text - Shopify 側の保存サイズの制約で、サイズを増やすことはできない。アプリ側でデータの圧縮は実施済み。 - 対処 (サイズを小さくする): 1. グループを減らす (最も確実) 2. 営業休業日・指定不可日を最小にする (最長日 + 1 か月程度まで) 3. 「営業休業日と指定不可日は ◯ 日より前の日付を自動で削除する」を設定する ``` ### SYM-15 設定の保存ボタンが回り続けて保存できない ```text - 事例: 過去の「追加の詳細な時間」の設定が適切に削除されておらず、保存時のデータでエラーになっていた。 マーチャント側では原因が見えず、データを確認して修正する必要がある。 - 断定せず、ESCALATE の情報を依頼する (コラボレーションコードが必要)。 ``` ### SYM-16 カートの中身が突然空になる ```text - 本アプリにカートの商品を操作する処理は無い。アプリの埋め込みを OFF にしても起きるなら、本アプリが原因ではない。 - 事例: 別のギフトアプリが原因だった。 - 確認: 埋め込みを OFF にしても再現するか、いつ起きるか (操作・ページ)、入っている他アプリ。 ``` ### SYM-17 日本語以外のお客様の注文に古い配送日が載る / 一部の言語で日時指定なしで買えてしまう ```text - 原因の候補: 「言語毎の表示切り替え」で表示する言語を限定している。表示しない言語のページでは、ウィジェットも必須のチェックも無い (070 の PROC-O6)。 - 確認: 左メニュー「オプション」>「言語毎の表示切り替え」の「有効にする言語を選ぶ」が ON か、チェックが入っている言語、注文したお客様のページの言語 (URL が /en-jp/ など)。 - 現在のバージョン: 表示しない言語のページを開くと、このアプリが書いた属性 (配送日時・配送地域・入力テキストなど) を自動で削除する。有効性検証を ON にしていても、その言語のお客様は検証で止まらない。 - 以前のバージョン: 日本語で選んだ属性がカートに残り、表示しない言語から買うと古い日付が注文に載ることがあった (事例: 配送地域が空で、注文当日の配送日の注文)。 - 「有効にする言語を選ぶ」が OFF なら、すべての言語で表示される (070 の PROC-O6)。 - 対処: 日時指定を必須にしたい言語は、「言語毎の設定」でチェックを入れて表示する。その言語のカートで入力できるか、実店舗で確認してもらう。 - 注意: 有効性検証の ON/OFF だけでは、表示しない言語のお客様を止められない。 ``` ## QA - **Q: 英語のページから買った注文に、日本語で選んだ配送日が載った。** A: 「言語毎の表示切り替え」で日本語だけを表示にしている可能性がある (SYM-17)。表示しない言語では入力も必須チェックも無い。現在のバージョンでは、属性が自動で削除される。 - **Q: 注文に配送日時が入っていない。アプリの不具合か。** A: 断定しない。SYM-2 の順に確認してもらう。配送日時以外の属性が残っているか、動的チェックアウト経由か、を最初に聞く。 - **Q: __ccValid を消したい。** A: 機能に必要 (SYM-3)。残したくないだけなら、「オプション」の「注文への自動書き込み」の「注文の追加の詳細から内部の属性を削除する」で消せる (PROC-O2)。 - **Q: 配送日時の入力を確実に必須にしたい。** A: 「必須化」の設定 + 「チェックアウト時の配送日の有効性検証」を ON。さらに、読み込み失敗を検知するなら「読み込み時に __ccValid をポスト」を ON (SYM-4、離脱リスクあり)。動的チェックアウトのボタンは OFF にする。 - **Q: 動的チェックアウトでも配送日時を取れるか。** A: 取れない (TS-6)。ボタンを OFF にする。 - **Q: お客様の端末では出ない、自分の端末では出る。** A: 再現しない場合は断定しない。ブラウザ、端末、通信状況、商品URLを依頼する。再現性が無い読み込み失敗は SYM-2 の 5。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | ウィジェットが出ない (SYM-1 に当てはまらない) | ストアURL、商品URL、カートの商品、テーマ名、ブラウザ、アプリの埋め込みが有効かのスクリーンショット | | 特定の言語で日時指定が無い・古い配送日が載る | ストアURL、注文番号、お客様のページの言語 (URL)、「言語毎の表示切り替え」のチェック状況のスクリーンショット | | 注文に配送日時が無い | 注文番号、「追加の詳細」のスクリーンショット (他の属性が残っているか)、購入経路 (動的チェックアウトか)、使用中の決済・他アプリ | | 頻発する | 上記に加えて「コラボレーションコード」 (ログインして調査するため) | | チェックアウトで止まる | 表示されたメッセージ、ストアURL、カートの商品、有効性検証の設定 (ON/OFF・「読み込み時に __ccValid をポスト」の ON/OFF) | | レイアウトが崩れる | ストアURL、テーマ名、崩れている箇所のスクリーンショット | | 時間だけ空で注文が通る | 注文番号 (複数)、__ccValid の値、注文の追加の詳細、入っている他アプリ (メッセージ・ギフト系) | | 保存できない / 保存ボタンが回り続ける | ストアURL、操作の手順、コラボレーションコード | | 表示が遅い・× が反応しない | ストアURL、端末と OS、ブラウザ、カートページに入っている他アプリ | ## SEE - [動的チェックアウトには対応していますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/010/dynamic-checkout/) - [カートで入力した配送日時が反映されません](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/040/cart/) - [オンラインショップへの設置はできたのですがレイアウトが崩れます](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/060/layout/) - [最短日より前の配送日で注文されてしまうことがあります](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/140/checkout-invalid-date/) - [__ccValidもしくは__ccSlotが注文の「追加の詳細」に含まれるようになりました](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/160/property/) - [配送希望日時が入力されていない注文があるケースがあります](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/170/no-property/) - [チェックアウト画面での有効性検証](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/100/checkout-validation/) - [コラボレーションコードとは何ですか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/110/checkout/) - [配送日時指定を任意の場所に表示できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/020/display-everywhere/) - [営業休業日カレンダーの設定](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/105/holiday-calendar/) --- # できないこと・他アプリとの併用・範囲外の質問 ```yaml screens: 左メニュー「オプション」「連携(プロプラン)」/ 設定 → 入力テキスト verified_from: テーマウィジェット (theme-develop) / チェックアウト拡張 (checkout-ui の shopify.extension.toml) / 人間向けFAQ / 実際の問い合わせ対応の返信 note: 「できません」と答えてよいのは L-* に書いたものだけ。他アプリの設定方法は案内しない (その製品のマニュアルを案内する)。 ``` ## SUMMARY 「CC 配送日時指定」は、**カート画面のウィジェットが、配送日時をカートの属性 (注文の「追加の詳細」) に書き込む**アプリ。チェックアウトの内部・POS・他アプリの動作は制御しない。 他アプリとの連携は「注文の追加の詳細にあるキーと値を、相手が読む」形になる。相手が読めるかは相手のアプリの仕様で決まる。 ## RULES (できないこと) ```text L-1 支払方法 (クレジット / 銀行振込 / コンビニ払い など) によって、配送日時の表示・必須・非表示を切り替える機能は無い。 理由: 配送日時はカート画面で選ぶが、支払方法はその後のチェックアウトで選ぶ (Shopify の仕様)。 代替: 注記欄に「銀行振込・コンビニ払いは入金後の発送となるため、指定した配送希望日は無効です」のように書く。 L-2 チェックアウト画面の中に配送日時の入力欄を出すことはできない (本アプリのウィジェットは未対応)。 L-3 動的チェックアウト (「今すぐ購入」/ Apple Pay などのボタン) 経由の注文には配送日時が付かない (Shopify の仕様)。 日時指定を必須にする場合は、動的チェックアウトのボタンを OFF にする。 L-4 商品ページに置いても、商品ごとのグループ化は反映されない。グループは「カートに入った商品」に対して決まる。 L-5 マイページ (お客様アカウント) の注文履歴の一覧に配送日時を出す機能は無い。 - 新しいお客様アカウント: 「注文状況」ページにアプリブロック (checkout-ui) を置くと、配送希望日時を表示できる。 (サンキューページにも置ける。Shopify のチェックアウト設定画面からブロックを追加する) - 旧アカウントページ: アプリの機能ではなく、テーマの注文一覧の liquid で order.attributes から表示する。 L-6 「定期購入のときだけ日時指定を非表示にする」設定は無い。定期購入の判定はアプリ側に無い。 L-7 選択済みの配送日時を、商品をカートから削除したときに自動でリセットする機能は確認できていない (X-5)。 L-8 TikTok Shop など Shopify 以外のチャネルでは使えない (Shopify 専用)。開発の予定は無い。 L-9 Shopify POS との連携 (POS からの注文で受取日時を必須にする等) は無い。開発の予定は無い。 L-10 置き配などの専用機能は無い。代替は「入力テキスト」(050 の PROC-X1) で項目を足し、注文の追加の詳細に値を載せる。 連携先 (ロジレス・ヤマトB2クラウド など) がその項目を取り込めるかは、連携先の仕様による。 L-11 配送先住所の都道府県から配送日数を自動で決める機能は無い。代替は「選択肢」(都道府県) で加算値を設定し、お客様に選んでもらう (040 の PROC-D の選択肢)。住所とは照合されない。 L-12 B2B 顧客のチェックアウトでの動作は確認できていない。断定せず、開発元への問い合わせを案内する。 L-13 選択した配送日時は、まず注文の属性 (注文の「追加の詳細」) に保存される。注文メモ・メタフィールド・タグにも入れたい場合は、「オプション」の「注文への自動書き込み」を使う (070 の PROC-O2。Shopify Flow が必要)。 L-14 「言語毎の表示切り替え」で表示しない言語には、ウィジェットが出ない。その言語で「必須にして止める」ことはできない (入力欄も必須チェックも無く、有効性検証も通る)。 止めたい場合は、その言語も表示する言語に加える (070 の PROC-O6)。 ``` ## RULES (他アプリとの併用) ```text X-1 All in Gift: カート画面に All in Gift を置いたときだけ、配送日時の情報を取り込める。 商品ページに置いた場合は取り込めない。All in Gift 側の「取り込むkey」に、本アプリの「表示ラベル」の文字列を設定する。 X-2 All in Gift の選択 (e ギフトなど) に合わせて日時指定ウィジェットを隠す連動は、正式な連携ではなくサポート対象外。 コード例が FAQ (「カスタマイズした条件に合わせて…非表示にできますか」) にある。 X-3 定期購入アプリ: 定期の 2 回目以降の注文は、定期購入アプリが最初の注文を元に作る。 そのとき最初に指定した配送日時が引き継がれても、本アプリが制御しているわけではない。定期購入アプリ側の仕様を確認してもらう。 X-4 他アプリと同じ項目名 (例: delivery_date) を使うと衝突する。Pro の「連携用のラベル」を別の名前に変えれば避けられる。 X-5 カートの属性は商品をカートから削除しても残る (/cart/clear.js でも消えない。実機で再現確認済み)。 そのため、商品を入れ直したあとのカートに、前回の配送日時が復元されて注文に載ることがある。 顧客が日付を選び直せば上書きされる。選択可能な範囲外の日付は復元されない。 X-6 範囲外の別アプリ: 「CC オーダールール」(数量制限・予約販売など)・年齢確認・卸売(B2B)アプリなどは、本マニュアルの対象外。 機能・設定を推測で答えず、範囲外であることを伝え、「CC 配送日時指定」の開発元への問い合わせを案内して文面を下書きする。 ``` ## PROC-L1 旧アカウントページの注文一覧に配送日時だけを出す (liquid) テーマの注文一覧を出力している liquid ファイル (Dawn の場合はお客様アカウントの注文テンプレート) に追記する。 実際のマーチャントで動作確認済みの書き方 (`order.attributes` を使う。`attributes` だけでは注文の値にならない): ```liquid {% for attribute in order.attributes %} {% if attribute.first == "配送希望日" %}

{{ attribute | first }}

{{ attribute | last }}

{% endif %} {% endfor %} {% for attribute in order.attributes %} {% if attribute.first == "配送希望時間" %}

{{ attribute | first }}

{{ attribute | last }}

{% endif %} {% endfor %} ``` - `"配送希望日"` `"配送希望時間"` は、管理画面の「表示ラベル」に設定した文字列と一致させる (ラベルを変えているストアはその文字列にする)。 - 絞らずに全て出すと `__ccValid` などの内部の値も表示される。 - テーマのファイルを編集するため、サポート対象外の作業。コード提示は参考として行う。 ## QA - **Q: 銀行振込やコンビニ払いのときだけ日時指定を出さないようにしたい。** A: できない (L-1)。注記欄の文言で案内する方法がある。 - **Q: チェックアウトの画面に日時指定を出せるか。** A: 出せない (L-2)。サンキューページと注文状況ページに「表示」するブロックは置ける (L-5)。 - **Q: マイページの注文履歴に配送希望日時を出したい。** A: 新アカウントは注文状況ページにアプリブロックを置く。旧アカウントはテーマの liquid で `order.attributes` から出す (L-5)。 - **Q: マイページに出したら __ccValid などの余計な値も出る。** A: liquid で `attribute.first` がラベルと一致するものだけ出す。ラベルは管理画面の「表示ラベル」の文字列。 - **Q: 定期購入のときだけ日時指定を隠したい。** A: 設定では隠せない (L-6)。定期購入の有無を検知するコードを自分で書き、FAQ の `window.ccSelectedTag` を使う方法がある (サポート対象外)。 - **Q: 定期の 2 回目以降の注文にも同じ配送日時が入る。** A: 定期購入アプリが注文を複製しているため。定期購入アプリに確認してもらう (X-3)。 - **Q: 定期購入アプリと配送日の項目名が被る (ネクストエンジン連携)。** A: 「連携用のラベル」を別の名前にする (X-4)。 - **Q: All in Gift と連携できるか。** A: カート画面に置いた場合のみ可能 (X-1)。商品ページでは不可。 - **Q: 置き配の選択肢を付けて連携先に渡したい。** A: 入力テキストで項目を足すと注文の追加の詳細に載る。連携先が取り込めるかは連携先に確認する (L-10)。 - **Q: ヤマトB2クラウドで置き配の送り状を出したい。** A: 当アプリでは対応できない。B2クラウド側の仕様の問題。 - **Q: POS から注文するときに受取日時を必須にしたい。** A: 機能は無く、予定も無い (L-9)。 - **Q: TikTok Shop でも使いたい。** A: 使えない (L-8)。 - **Q: 商品を消して選び直したのに、前の配送日時が残っている。** A: カートの属性が残る仕様 (X-5)。顧客が選び直せば上書きされる。リセット用の設定は確認できていないので、断定せず確認する。 - **Q: 商品ページに置いたら、グループの設定が効かない。** A: 仕様 (L-4)。カートに入った商品に対して適用される。 - **Q: 英語のページでは配送日時を必須にせず、日本語のページだけ必須にしたい。** A: 言語ごとに表示の ON/OFF はできる (070 の PROC-O6)。ただし表示しない言語は「必須にしない」状態になる (L-14)。言語ごとに別の必須設定を持つ機能は確認できていない。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 他アプリを入れた後に、日時指定ができない商品でも指定できてしまう | 注文番号、注文の「追加の詳細」の値、カート内の商品、入っている他アプリ名 | | 他アプリとの連携で値が取り込まれない | 連携先アプリ名、注文の「追加の詳細」のキーと値、連携先に設定したキー名 | | 身に覚えのない配送日時が注文に入っている | 注文番号、注文日時、顧客がログインしていたか、前回の注文の有無、ブラウザ | | 範囲外の別アプリの質問 | (答えずに) 範囲外であることを伝え、開発元への問い合わせの文面を下書きする | ## SEE - [動的チェックアウトには対応していますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/010/dynamic-checkout/) - [チェックアウト画面に表示できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/070/checkout/) - [商品ページに設置できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/030/products-page/) - [サンキューページと注文状況ページに配送希望日時を表示することはできますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/130/thankyou-order/) - [カスタマイズした条件に合わせて配送日時指定ウィジェットを非表示にできますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/080/display-settings/) - [All in Giftと連携できますか?](https://capital-castle.eastazy.com/cc-delivery-date-time/questions/050/All-in-Gift/) - [入力テキスト](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/075/input-text/) --- # Pro: 注文CSV出力の基本(対応する運送会社・取り込み範囲・出力の流れ) ```yaml plan: Pro プラン限定 (R6) screens: 画面上部タブ「注文一覧」「設定」「発送(追跡番号)」 / 設定の中のタブ「CSVテンプレート」「振り分けルール」「出荷リードタイム」「取得設定」 verified_from: 管理画面の実装 (CSV 画面・取得 API・初期テンプレート定義) + 人間向けマニュアル ui_verified: 項目名はコードから確認。実画面での目視確認は未実施 scope: 出力の基本のみ。出力値の細かい設定 (コード・正規表現・分割) と追跡番号アップデートは別途 ``` ## SUMMARY Shopify の注文を、運送会社などの指定フォーマットの CSV にして出力する機能 (Pro プラン限定)。出力の形は **CSV テンプレート** (1 つの CSV の書式) で決め、注文を **注文一覧** から選んでテンプレートごとに出力する。出力した CSV を運送会社のシステムに取り込み、運送会社が発番した追跡番号を CSV で戻して注文へ反映する流れ (追跡番号アップデート) も同じ画面で行う。 ## FACTS ```text CS-1 注文CSV出力は Pro プラン限定。Pro でない店舗には機能が出ない。 CS-2 初期テンプレート (運送会社) は4つ: 「ヤマト B2クラウド」「佐川 e飛伝3」「クリックポスト」「ゆうパック」。 最初に既定になるのは「ヤマト B2クラウド」。テンプレートは追加・複製・削除・並び替えができる。 CS-3 4つの初期テンプレートの文字コードは全て Shift_JIS。ゆうパックだけは初期状態でヘッダ行を出力しない。 文字コード・改行コード・ヘッダ行の有無はテンプレートごとに変更できる。 CS-4 注文の取り込みの既定: ステータスがオープンで、未出荷または一部出荷の注文のうち、注文日が約60日以内のもの。 CS-5 取り込み条件を変えるのは「設定」→「取得設定」。変更後は「注文を取得」で再取得するまで注文一覧に反映されない。 CS-6 出力は、注文一覧で注文を選び、右の「テンプレート一覧」パネルで対象テンプレートの「出力」を押す (選択件数が表示される)。 CS-7 出力すると、出力日時が注文ごとに記録され、注文一覧に「出力済」のバッジが付く (記録は「CSV 出力時刻を記録する」が ON の場合)。 CS-8 CSV の項目(列)は、テンプレートごとに自由に追加・編集できる。値は固定値・注文の項目・文字変換・条件分岐・コードで決められる。 CS-9 追跡番号アップデートの初期設定 (注文番号列・追跡番号列・運送会社) は4テンプレートに入っている (別ページ)。 CS-10 件数の上限は設けていないが、ブラウザのメモリで処理するため、一度に 200 件以下を推奨 (人間向けFAQ)。 CS-11 CSV の画面には新しい画面と旧い画面がある。旧い画面は 12 月 19 日までご利用いただける。それまでは画面右下のボタンから、いつでも旧い画面に戻せる。 CS-12 これまでの出力履歴は新しい画面に自動で引き継がれる。ただし新しい画面と旧い画面の出力履歴は別々に保管されるため、新しい画面で出力した内容は旧い画面には表示されない。 CS-13 注文一覧で注文をクリックすると、注文の詳細が右から開く。「商品」の欄に、未発送の発送単位のカードが並ぶ。「配送の発送単位ごとに分割して出力する (分割配送への対応)」を使っているテンプレートがあるとき、既に発送済みの発送単位の商品が、未発送のカードの下に「発送済み」のカードとして読み取り専用で並ぶ (発送済みの商品は割り当ての対象外で、変更できない)。 CS-15 テンプレートには「運送会社」(種別) を持たせられる。選べるのは「ヤマト B2クラウド」「佐川 e飛伝III」「ゆうパック」と「指定なし」。 新しく入れた店舗や、「新規テンプレート」で初期テンプレート (ヤマト・佐川・ゆうパック) から作ったテンプレートは、最初から種別が入っている。空のテンプレートとクリックポストは「指定なし」。 以前から使っている店舗のテンプレートは、種別が入っていないことがある (列名からの提案が出る。CS-16)。 CS-16 種別が「指定なし」のときは、必須項目の補助もギフト設定も出ない。列名から種別が推定できるときだけ「◯◯のようです」と提案が出て、ボタンで確定できる (自動では変えない)。 CS-17 種別を選ぶと、基本情報に「必須 N 項目中 M 項目入力済み」と「必須項目を入力する (残り K)」が出る。押すと、必須の列が (入力済みの列も含めて) すべて順に開き、「保存して次へ」「スキップ」で進める。必須の列には赤い「※」が付く。必須の列と補足 (桁数・形式) は運送会社の公式の取込形式に基づく。出力の中身は、種別を変えても変わらない。 CS-19 初めて CSV 画面を開いたとき (新しく入れた店舗)、「ご依頼主の初期設定」のモーダルが出る。ショップ名・電話番号・郵便番号・都道府県・市区町村・町・番地・建物名が初期値として入っているので、確認・修正して「OK」を押すと、ヤマト・佐川・ゆうパックのテンプレートのご依頼主の列に入る。すでに設定してある列は変更しない。反映後は画面上部の「保存する」で保存する。「あとで」で閉じると反映されない。日本のショップだけ住所・電話番号が入る。新しく入れた店舗には「CSV エクスポートの新 UI へようこそ」のお知らせは出ない。 CS-18 基本情報に「配送業者 (追跡番号の更新)」の欄がある。追跡番号を反映するときの配送業者で、「発送(追跡番号)」画面の「配送業者」と同じ設定 (どちらで変えても同じ値になる)。 CS-14 「テンプレート一覧」で「振り分け」を ON にしているとき、実際に注文が振り分けられたテンプレートの左側に、振り分け先を示す矢印が付く。注文が 1 件も振り分けられないテンプレートには付かない。「1 注文の中で商品ごとに分割する」(商品ごとの振り分け条件) を使っているテンプレートも同じ。 ``` ## 初期テンプレートの対応表 | テンプレート名 | 運送会社(追跡番号アップデート時) | 文字コード | ヘッダ行 | 備考 | | --- | --- | --- | --- | --- | | ヤマト B2クラウド | Yamato (JA) | Shift_JIS | あり | 初期の既定。B2クラウドの「外部データから発行」で取り込む | | 佐川 e飛伝3 | Sagawa (JA) | Shift_JIS | あり | 佐川急便 e飛伝III の取込形式 | | クリックポスト | Japan Post (JA) | Shift_JIS | あり | | | ゆうパック | Japan Post (JA) | Shift_JIS | **なし** | Web ゆうパックプリントの取込形式 | 運送会社の種別は、ヤマト B2クラウド=ヤマト、佐川 e飛伝3=佐川、ゆうパック=ゆうパックが最初から入る。クリックポストは「指定なし」。 - 人間向けマニュアルは日本郵便の2つを「クリックポスト」「Webゆうパックプリント」と表記している。画面上のテンプレート名は「クリックポスト」「ゆうパック」。 - これら以外の運送会社 (福山通運・西濃運輸など) は、初期テンプレートには無い。**項目(列)を自分で組んで追加テンプレートを作る**ことで対応できるかは、運送会社の取込形式 (列数・列順・文字コード) 次第。個別に、開発元への問い合わせを案内して文面を下書きする (運送会社名と取込形式の仕様を入れる)。 ## 取り込み条件 (「設定」→「取得設定」) ```text 取り込み期間: - 「過去60日 (推奨)」 … 既定。オープンかつ未出荷/一部出荷の、約60日以内の注文 - 「全期間」 … 期間を問わず、オープンかつ未出荷/一部出荷の注文 (件数によってブラウザが重くなる) 対象に含める注文: - 「出荷済みの注文も含める」 … ON で期間 (開始日・終了日) を指定し、全ステータスの注文を取り込む。再ダウンロードや訂正出力用。件数が大幅に増える - 「発送単位対象外の注文も含める」 … 自社・外部のカスタム発送連携を使う店舗向け。「出荷済みの注文も含める」を ON にすると連動して ON になる 商品の除外: - 「キャンセル済みの商品は除外する」 - 「除外する商品名(部分一致)」 … 商品名 (バリアント名を含む) に指定した語を含む明細を CSV から除外。カンマ区切りで複数指定。注文自体は取り込まれる メタフィールドの取得: - 「注文のメタフィールドを取得する」 … namespace.key 形式で指定。CSV の列で参照する場合に必要。変更後は再取得が必要 CSV 出力の動作: - 「CSV 出力時刻を記録する」 … OFF にすると、出力しても常に「未出力」表示になる ``` ## PROC-C0 CSV 出力機能を有効にする ```text 場所: アプリの左メニュー「連携(プロプラン)」 > 「CSV出力機能」 > チェック「CSV出力機能をONにする」 手順: 1. 左メニュー「連携(プロプラン)」を開き、Pro プランを有効にする (承認画面に遷移する) 2. 「CSV出力機能」の「CSV出力機能をONにする」にチェックを入れる (ON にすると CSV の画面に移動する) 結果: CSV の画面 (タブ「注文一覧」「設定」「発送(追跡番号)」) が使える 注意: Pro プランを有効にしていない店舗や、「CSV出力機能をONにする」が OFF の店舗には、CSV の画面が出ない ``` ## PROC-C1 注文を CSV で出力する ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「注文一覧」 手順: 1. 画面上部のタブ「注文一覧」を開く (最初は「注文を取得」で注文を取り込む) 2. 出力したい注文にチェックを入れる (右のパネルに「◯ 件 選択中」と出る) 3. 右の「テンプレート一覧」で、出力したいテンプレートの「出力」を押す 4. CSV がダウンロードされる。運送会社のシステムに取り込む 補足: - 「プレビュー」を押すと、出力前に CSV の中身を確認できる。プレビュー画面でも「CSV をダウンロード」で出力できる - 「文字コード」「改行コード」「ヘッダ行を出力する」は、プレビュー画面の「書式をクイック設定」で変更できる - 出力後は、注文一覧の「出力済」バッジで出力の有無を確認・絞り込める ``` ## PROC-C2 テンプレートを追加・複製・並び替え・削除する ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」(一覧の見出しは「テンプレート一覧」) - 追加: 「+ 新規テンプレート」→「新規テンプレートを追加」の画面で、運送会社の初期テンプレートか「空のテンプレート」を選ぶ - 複製: 「複製」。名前に「(コピー)」が付く。複製したテンプレートは既定にならない - 並び替え: 「並び替え」。ドラッグで順番を変える - 編集: 「編集」で項目(列)の追加・編集・並べ替え。テンプレートの名前・書式も同じ画面 - 削除: 「削除」→「テンプレートを削除」で確認。既定を削除したときは、残ったテンプレートの先頭が既定になる - 既定: 「既定」バッジ・「既定に設定」は、「振り分けルール」を使っている (ON の) ときだけ表示される。既定は1つだけ 注意: テンプレートを変更したら、画面上部の「保存する」で保存する ``` ## PROC-C2b 運送会社の種別を設定し、必須項目を入力する ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 右の「基本情報」 手順: 1. 「運送会社」で、ヤマト B2クラウド / 佐川 e飛伝III / ゆうパック を選ぶ (列名から分かるときは「◯◯のようです」の提案のボタンでも決められる) 2. 「必須項目を入力する (残り N)」を押す。必須の列が、入力済みも含めて順に開く 3. 値を入れて「保存して次へ」。入れない列は「スキップ」 4. 画面上部の「保存する」で保存する 注意: 種別を「指定なし」にすると、補助は出なくなる。出力される CSV の中身は変わらない ``` ## PROC-C3 取り込む範囲を広げる ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「取得設定」 A. 出荷済みの注文を出したい (再ダウンロード・訂正出力) 1. 「設定」→「取得設定」を開く 2. 「出荷済みの注文も含める」を ON にし、「開始日」「終了日」で注文日の期間を指定する 3. 「保存する」を押し、「注文を取得」で再取得する 注意: 「取り込み期間」を「全期間」にしても、出荷済みの注文は入らない (「全期間」は未出荷・一部出荷の注文の期間制限を外すだけ) B. 60日より前の未出荷の注文を出したい 1. 「取得設定」の「取り込み期間」を「全期間」にする 2. 「保存する」→「注文を取得」 注意: どちらも件数が増えると画面が重くなる。必要な期間に絞る ``` ## QA - **Q: ヤマト B2 クラウドの形式で出力できるか。** A: できる。初期テンプレート「ヤマト B2クラウド」が B2クラウドの取込形式で、文字コードは Shift_JIS (CS-2, CS-3)。請求先顧客コードなど、運送会社側の固有の値は項目 (列) で設定する。 - **Q: 佐川・日本郵便の形式は。** A: 「佐川 e飛伝3」「クリックポスト」「ゆうパック」が初期テンプレートにある (CS-2)。 - **Q: 文字化けする。** A: テンプレートの文字コードが取込先に合っているか確認する。初期テンプレートは Shift_JIS (CS-3)。「書式をクイック設定」の「文字コード」で変更できる。 - **Q: 出荷済みの注文を再度出力したい。** A: 「取得設定」の「出荷済みの注文も含める」を ON にして期間を指定し、再取得する (PROC-C3 の A)。「全期間」だけでは出荷済みは入らない。 - **Q: 古い注文が出てこない。** A: 既定では約60日以内の未出荷の注文だけが対象 (CS-4)。未出荷の古い注文なら「取り込み期間」を「全期間」に、出荷済みの注文なら「出荷済みの注文も含める」で期間を指定する (PROC-C3)。 - **Q: CSV を毎日決まった時刻に自動で出力 (メール添付など) できるか。** A: できない。CSV はブラウザの画面から、取得して出力する操作で作る。 - **Q: 日本郵便の WMS など、出荷完了データを Shopify に取り込めるか。** A: CSV 出力と追跡番号の取り込み (追跡番号アップデート) の組み合わせで、同様の運用が可能。詳細は追跡番号アップデートのページを参照。 - **Q: ギフトラッピングなど、特定の商品を CSV に出したくない。** A: 「取得設定」の「除外する商品名(部分一致)」に語を入れる。注文自体は取り込まれる。 - **Q: 何件まで出力できるか。** A: 上限は無いが、一度に 200 件以下を推奨 (CS-10)。 - **Q: 出力済みの印が付かない。** A: 「CSV 出力時刻を記録する」が OFF のときは記録されない (CS-7)。 - **Q: 旧い画面に戻したい。いつまで使えるか。** A: 12 月 19 日まで、画面右下のボタンから戻せる (CS-11)。旧い画面で出力した履歴と新しい画面の履歴は別々に保管される (CS-12)。 - **Q: 新しい画面にしたら、これまでの出力履歴が消えた。** A: これまでの履歴は自動で引き継がれる (CS-12)。履歴が非常に多い店舗では、古い履歴から整理されることがある。状況を確認するため、注文番号と、新しい画面で最初に開いた日時を依頼する。 - **Q: 注文の詳細に、発送済みの商品が出ない。** A: 発送済みのカードは、「配送の発送単位ごとに分割して出力する」を使っているテンプレートがあり、その注文に発送済みの発送単位があるときに出る (CS-13)。全ての商品が未発送の注文には出ない。 - **Q: 「振り分け」を ON にしたのに、テンプレートに矢印が付かない。** A: 注文が 1 件も振り分けられていないテンプレートには付かない (CS-14)。「注文を取得」で注文を取り込んでいるか、振り分けルールの条件を確認する。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 出力した CSV が運送会社のシステムに取り込めない | 運送会社名と取込形式 (システム名)、エラーメッセージ、使用しているテンプレート名、CSV の1行目 (個人情報は伏せる) | | 期待した注文が一覧に出ない | 注文番号、注文のステータス (オープン/出荷済み)、注文日、「取得設定」の取り込み期間と「出荷済みの注文も含める」の設定 | | 項目 (列) の値が空・想定と違う | テンプレート名、列の名前、期待する値、注文番号 (別ページの出力値の設定を案内する前に状況を確認) | | 新しい画面にしたら履歴が消えた・出力済みの印が合わない | 注文番号、新しい画面で最初に開いた日時 (分かれば)、出力した日時、使ったテンプレート名 | | 初期テンプレートに無い運送会社に対応したい | 運送会社名と取込形式の仕様書 (列数・列順・文字コード) | ## SEE - [注文CSV出力](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/csv/) - [各運送会社の初期設定](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/010/initial-set-shipping-company/) - [出力値の設定(文字変換、注文内容から判別)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/020/output-value/) - [よくある質問 (CSV出力)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/001/csv-question/) - [CSV出力に必要なアクセス権](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/002/access/) --- # Pro: CSV 出力値の設定(固定値・注文情報・置換・条件分岐・コード) ```yaml plan: Pro プラン限定 (R6) screens: 「設定」→「CSVテンプレート」→ テンプレートの「編集」→「フィールド定義」→ 列の「編集」(値を編集する画面) verified_from: CSV 画面の実装 (値の編集画面・出力エンジン・トークン定義) + 人間向けマニュアル ui_verified: 項目名はコードから確認。実画面での目視確認は未実施 related: 注文CSV出力の基本は [Pro: 注文CSV出力の基本](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/090/csv-basics/) ``` ## SUMMARY CSV の 1 列 (1 つの「フィールド」) の値は、**A デフォルト値 → B 条件分岐 (例外) → C 出力の制約** の 3 層で決まる。注文ごとに B を上から順に評価し、最初に一致した分岐の値を使う。どれにも一致しなければ A を使う。最後に C (文字数制限) をかける。 ## 値の決まり方 ```text V-1 画面の構成: 「値を編集」画面に3つの層がある。 A 「デフォルト値」 … 条件分岐に一致しない全ての注文に使う値 B 「条件分岐 — 例外ルール」 … 上から評価し、最初に一致した分岐の値を採用。どれにも一致しなければ A C 「出力」 … 「フィールド名」(CSV のヘッダ行の列名) と「文字数制限」。A/B どちらの結果にも最後にかかる V-2 A の値の作り方は2種類: 「固定値」 … 全行に同じ文字列を出す (例: 送り状種別 "0")。注文情報としては解釈されない 「組み立て(注文情報、コード)」 … 注文情報・自由入力文字・コードを1つ以上並べ、区切り文字で結合して1セルに出す V-3 「組み立て」の1行の種類は3つ: 注文情報 (トークン) / 自由入力 (入力した文字をそのまま出力) / コード (JavaScript)。 V-4 複数の行を並べると、「区切り文字で結合」(区切り文字 (be)) で結合する。区切り文字の既定はカンマ。 V-5 「注文情報」の行が日付系 (配送希望日・配送希望時間・オーダー作成日・出荷予定日・Today±N・「属性: Key名」) のときだけ、 「日付フォーマット」を指定できる (例: YYYY-MM-DD / YYYY/MM/DD / YYYY年M月D日)。日付に変換できる文字列だけが整形される。 V-6 「置換ルール」は「注文情報」の行にだけ付けられる (自由入力・コードの行には付けられない)。「置換ルールを追加」で複数追加でき、 「正規表現にする」で変換前の文字列に正規表現を使える。不正な正規表現は文字どおりの文字列として扱われる。 V-7 固定値と組み立ての値が両方入っているデータでは、組み立て (selectVal) が優先され、固定値は無視される。 V-8 「文字数制限」は、出力する文字列の最大文字数。空欄は無制限。 V-9 「値は分岐で決定」と表示される列は、A が空で、値を分岐だけで決めている列。 ``` ## 「注文情報」で選べる主な項目 画面では「注文」「顧客 / 配送先」「請求先」「商品」「金額」「日時 / 属性」「注文属性 (customAttributes)」のグループに分かれる。 | グループ | 主な項目 (画面の表示名) | | --- | --- | | 注文 | 注文番号、注文番号-ID、Shopify Order ID、オーダータグ、E-mail、注文のメモ、割引コード、決済ゲートウェイ(支払い方法)の名称、支払いのステータス、フルフィルメント状況、除外商品のタイトル一覧 | | 顧客 / 配送先 | 電話番号、配達方法、配送タイトル、配送先氏名(名前)、配送先氏名(苗字)、配送先会社名、配送先電話番号、配送先郵便番号、配送先住所、配送先アドレス 1 / 2、配送先国名 (英語) | | 請求先 | 請求先の会社名・氏名・電話番号・郵便番号・住所・アドレス 1 / 2・国名 | | 商品 | 商品名、商品のタグ、SKU、商品のバリアントID、商品の単価、商品の個別金額 (割引など適用後)、商品の注文時の個別個数、商品の出荷が必要な個別個数、商品のラインプロパティ | | 金額 | 総重量(g)、合計金額、割引金額、合計送料、合計税額、商品合計金額、ストアクレジット利用額 ほか (各 通貨 の項目あり) | | 日時 / 属性 | **配送希望日(アプリ)、配送希望時間(アプリ)、配送方法(アプリ)、出荷予定日(アプリ)**、オーダー作成日、Today-1 / Today+0 / Today+1 / Today+2 (前日・本日・翌日・明後日) | | 注文属性 | 追加の詳細のKey / Value、および画面で Key 名を指定した「属性: Key名」 | - 「配送希望日(アプリ)」などは、このアプリがウィジェットで書き込んだ配送日時 (注文の「追加の詳細」)。 - 「割引コード」は注文に使われた割引コード。複数あるときは、列の「区切り文字 (be)」で区切って出力する (タグと同じ扱い) (コード記載の変数や判定対象では「, 」区切り)。コードを使っていない注文は空欄。自動割引 (コード無し) の名前は出力できない。 - 「今日から N 日 (自由入力)」で Today+N の任意の日数を指定できる (マイナスで過去)。 - メタフィールドは、「設定」→「取得設定」の「注文のメタフィールドを取得する」に登録したキーが「メタフィールド[namespace.key]」として選択肢に並ぶ。登録していないキーは取得されないので選べない。登録後は再取得が必要。判定対象 (条件分岐) にも同じ形で並ぶ。 ## 条件分岐 (B) の作り方 ```text 形式: 「もし 注文の [判定対象] が [判定方法] とき、[出力する値]」 判定対象: 注文情報と同じ項目 (配送先住所・商品名・商品のタグ・オーダータグ・合計金額・総重量・追加の詳細のKey、取得設定に登録したメタフィールド「メタフィールド[namespace.key]」 など) 判定方法: 文字列 … 「を含む」「を含まない」「のいずれかを含む」「のいずれも含まない」(複数の語はカンマ区切り) 数値 … 「数値範囲 (min〜max)」 (合計金額・総重量・個数など) 日付 … 「日付範囲 (YYYY-MM-DD)」 AND : 「条件を追加 (かつ)」で条件を足すと、全ての条件を満たすときだけ一致する 出力する値: 固定値 / 組み立て (注文情報・コード) / 「条件に一致した値 (判定した項目の値)」 評価順: 上から順。最初に一致した分岐を採用する (並び替えで順番を変える) ``` ## PROC-V1 固定値を出す (例: 送り状種別を常に "0" にする) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 1. 「設定」→「CSVテンプレート」→ 対象テンプレートの「編集」 2. 「フィールド定義」で対象の列の「編集」を押す 3. A「デフォルト値」で「固定値」を選び、「固定文字列」に値を入れる 4. 「保存」→ 画面上部の「保存する」 ``` ## PROC-V2 注文情報を出す・複数の値をつなげる (例: 姓と名を1セルに) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 1. 列の「編集」→ A「組み立て(注文情報、コード)」を選ぶ 2. 1行目で「配送先氏名(苗字)」を選ぶ 3. 「値を追加 (結合)」で2行目を足し、「配送先氏名(名前)」を選ぶ 4. 「区切り文字 (be)」に、つなぐ文字 (半角スペースや空) を入れる 5. 保存 ``` ## PROC-V3 文字を置き換える (例: 電話番号の +81 を 0 に) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 1. 列の「編集」→ A「組み立て」で「電話番号」(など) の行を選ぶ 2. その行の下の「置換ルールを追加」を押す 3. 変換前の文字列に「+81」、変換後に「0」を入れる 4. 正規表現で置き換えたい場合は「正規表現にする」にチェックを入れる 補足: - 空白 (値が無い) 状態のときに文字を入れたいときは、変換前を空のままにして変換後に文字を指定する (人間向けマニュアルの記載) - 置換は「注文情報」の行だけに付けられる。自由入力・コードの行には付けられない (V-6) - 郵便番号の分割 (前3桁・後4桁) や電話番号の分割は、正規表現の置換で行う。具体例は人間向けマニュアル「出力値の文字変換 (正規表現)」 ``` ## PROC-V4 条件によって値を変える (例: 冷凍食品を含む注文はクール区分を変える) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 1. 列の「編集」→ B「条件分岐 — 例外ルール」で「分岐を追加」 2. 「判定対象」に「商品のタグ」(または商品名)、判定方法に「を含む」/「のいずれかを含む」、値に「冷凍」など 3. 出力する値を入れる (例: クール区分の値) 4. A のデフォルト値は、どれにも一致しない注文の値 5. 保存 注意: - 上から順に評価され、最初に一致した分岐が使われる。順番を確認する - 複数条件を全て満たすときだけにしたい場合は「条件を追加 (かつ)」 ``` ## PROC-V4a ご依頼主の列を、まとめてギフト対応にする ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 右の「基本情報」 前提: テンプレートの「運送会社」(種別) が「指定なし」でないこと 手順: 1. 「ご依頼主をギフト対応にする (N 列)」を押す。一覧のモーダルが開く (ご依頼主の各列が、どの請求先の値になるか) 2. 内容を確認して「すべて反映する」を押す (やめるときは「キャンセル」) 3. 画面上部の「保存する」で保存する 注意: - 反映されるのは、ご依頼主の列 (種別のプリセットの列名と同じ列) だけ。すでにギフト分岐がある列は変えない - 全列がギフト対応済みのときは、このボタンは出ない - 列ごとに値を変えたいときは PROC-V4b (列ごとの「テンプレートから追加」) か、列の分岐の編集 ``` ## PROC-V4b 配送先と請求先が違う注文だけ、請求先の値を出す (ギフト注文のご依頼主) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > ご依頼主の列の「編集」 前提: テンプレートの「運送会社」(種別) が「指定なし」でないこと (指定なしだとボタンが出ない) 手順: 1. A のデフォルト値に、自社の情報 (ご依頼主の名前・住所・電話番号など) を入れる 2. B「条件分岐 — 例外ルール」の「テンプレートから追加」を押す。カードが開く 3. 「使う請求先の値」を選ぶ (名前 / 電話番号 / 郵便番号 / 住所 / 住所2)。列名が「ご依頼主名」などプリセットのままなら、最初から選ばれている。改名した列は自分で選ぶ 4. 「追加」を押す。分岐が 1 件増える (「配送先住所と請求先住所が同じか」が「false」を含むとき、請求先の値を出す) 5. 列ごとに繰り返し、「保存」→ 画面上部の「保存する」 注意: - 請求先と配送先が同じ注文は A のデフォルト値のまま。請求先にその項目が無い注文は空欄になる - 追加される分岐はふつうの条件分岐。値の組み合わせや文字変換は、一覧の「編集」で変えられる - すでにギフト分岐がある列は「追加済み」と出て、重ねては足せない ``` ## PROC-V5 配送希望日・配送希望時間を出す ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 1. 列の「編集」→ A「組み立て」→ 注文情報の「配送希望日(アプリ)」(時間なら「配送希望時間(アプリ)」) を選ぶ 2. 日付の書式を指定する (「日付フォーマット」に YYYY-MM-DD など) 3. 保存 補足: 配送日時が注文に無い注文 (動的チェックアウトなど) は空欄になる。 注文後に配送日時を後から入れた場合の補完は、メタフィールドを使う方法がある (人間向けマニュアル「注文のメタフィールドの出力設定」) ``` ## PROC-V6 コード (JavaScript) で値を作る ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「CSVテンプレート」 > 対象テンプレートの「編集」 > 「フィールド定義」 > 対象の列の「編集」 手順: 列の「編集」→ A「組み立て」→ 行の種類を「コード (JavaScript)」にして、JavaScript を書く。 「デバッグしながらコードを編集」でサンプル注文に対する実行結果を確認できる 書き方: - order オブジェクトで注文の情報を参照する。コードは「式」で、その式の結果が出力値になる (例: `order.shippingAddress.formattedArea`) - 1行の式はそのまま書ける。`const` を使うなど複数行のコードは、必ず即時関数 `(() => { ... return 値; })()` で書く (即時関数にしないと正しい値が出力されない。人間向けマニュアルのサンプル) - 日付の計算には `dateCalculate(日付, 日数, "YYYY/MM/DD")` が使える。例: `dateCalculate(order.date, -5, "YYYY/MM/DD")` (配送希望日の5日前)、`dateCalculate(new Date(), 5, "YYYY/MM/DD")` (今日から5日後)。書式は day.js の形式 - `dateCalculate(order.date, …)` の結果は、配送希望日の入り方で変わる。配送希望日が日付の注文は、その日付から計算した日付を出力する。「指定しない」「指定なし」などの文字列の注文は、日付として解釈できないため空文字 (空欄) を出力する。配送希望日が入っていない注文 (値そのものが無い) は、**今日の日付から計算した日付**を出力し、空欄にならない。配送希望日が入っていない注文を別の値にしたいときは、B の条件分岐 (PROC-V4) で、判定対象を「配送希望日(アプリ)」、値を空欄にした分岐を追加する。コードがエラーになったときは空文字を出力する。 - 変数宣言は const / let を使う (var は使わない) - エラーのときは空欄になる (出力は止まらない) 注意 (動作上の落とし穴): - コード内に文字列 "customAttribute" をそのまま書くと、コードが実行されず「追加の詳細」の全項目を連結した文字列が出力される。 回避: 文字列を分割する。例: const ATTR = "custom" + "Attributes"; const attrs = Array.isArray(order[ATTR]) ? order[ATTR] : []; - メタフィールドは、その値を持たない注文では order.metafields 自体が未定義になる。order.metafields?.['namespace.key'] のように ?. で参照する。 (素のアクセスは例外になり、その行は空欄になる) ``` ## QA - **Q: 郵便番号を前3桁と後4桁に分けたい。** A: 「配送先郵便番号」を2列に分け、置換ルールを正規表現で設定する。例は人間向けマニュアル「出力値の文字変換 (正規表現)」 (PROC-V3)。 - **Q: 電話番号の「+81」を「0」にしたい。** A: PROC-V3。 - **Q: 都道府県と市区町村を別の列に出したい。** A: 都道府県は、都道府県ごとの条件分岐 (B) で出す。市区町村は、置換ルールの正規表現で先頭の都道府県を消す (人間向けマニュアルの例: `^(.{2}[都道府県]|.{3}県)` を空に置換)。 - **Q: 条件によって配送業者や値を切り替えたい。** A: 値の切り替えは B の条件分岐 (PROC-V4)。テンプレート自体の切り替えは「振り分けルール」(別ページ)。 - **Q: ギフト注文のとき、ご依頼主を請求先にしたい。** A: 全列を一度に設定するなら PROC-V4a (基本情報の「ご依頼主をギフト対応にする」)、列ごとなら PROC-V4b。B の「テンプレートから追加」で、使う請求先の値を選んで追加する。手順は人間向けマニュアル「配送先住所と請求先住所が違う時にご依頼主の出力を変更する方法」(`/blogs/csv-gift/`) にもある。 - **Q: 合計金額の計算など、数式で出したい。** A: コード (JavaScript) で計算する (PROC-V6)。値が無いとき 0 として扱いたい場合の注意は人間向けマニュアルを案内する。 - **Q: メタフィールドの値を出したい。** A: 「取得設定」でメタフィールドのキーを登録し、再取得してから、注文情報の「メタフィールド」でキーを選ぶ。持たない注文は空欄になる (PROC-V6 の注意)。 - **Q: コードが動かず、属性の長い文字列が出る。** A: コードに "customAttribute" の文字列が含まれていないか確認する (PROC-V6 の落とし穴)。 - **Q: 商品のラインプロパティを出したい。** A: 商品のラインプロパティは商品ごとの情報のため、人間向けマニュアルでは「商品ごとに行を分割する」を ON にしたうえで、ラインプロパティの Key を指定する手順になっている。実際の画面での手順はストアを見て案内する (ESCALATE)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 列の値が期待と違う・空欄になる | テンプレート名、列の名前、期待する値、対象の注文番号、その列の設定のスクリーンショット (A・B・C) | | 正規表現・コードが動かない | コードまたは正規表現そのもの、対象の注文の該当項目の実際の値、エラーの表示 | | ラインプロパティ・メタフィールドが出ない | 設定したキー名、注文の「追加の詳細」/ メタフィールドのスクリーンショット、「取得設定」の画面 | | 運送会社の指定フォーマットに合わせたい | 運送会社名、取込形式の仕様 (列数・列順・必須項目・文字コード)。個別の設計になるため、開発元への問い合わせの文面を下書きする | ## SEE - [ギフト注文: 配送先住所と請求先住所が違う時にご依頼主の出力を変更する](https://capital-castle.eastazy.com/blogs/csv-gift/) - [出力値の設定(文字変換、注文内容から判別)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/020/output-value/) - [出力値の文字変換 (正規表現)](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/020/output-value-reg/) - [コードを記載して出力を設定する](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/025/code-output/) - [商品ごとのLine Item Propertyを出力する](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/026/line-item-property/) - [注文のメタフィールドの出力設定](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/027/metafield/) --- # Pro: 追跡番号のアップデート(CSV アップロードで注文を発送済みにする) ```yaml plan: Pro プラン限定 (R6) screens: 画面上部タブ「発送(追跡番号)」(ページ見出し「発送(追跡番号) の更新」) / 手順バー「ファイル選択」→「内容プレビュー」→「更新を実行」 verified_from: 追跡番号アップデートの実装 (判定の関数・確認画面) と設計メモ。人間向けマニュアルは旧画面 ui_verified: 項目名はコードから確認。実機では開発ストアで主要な経路を確認済みだが、未確認の経路が残る caution: この判定は実際に注文を「発送済み」にする (顧客に通知メールが飛ぶことがある)。断定的に「大丈夫です」と答えない ``` ## SUMMARY 運送会社のシステムが発行した追跡番号の CSV をアップロードすると、Shopify の注文を「発送済み」にして追跡番号を登録する (既に発送済みなら追跡番号を上書きする)。**注文の発送単位 (Shopify の「未発送」カードのまとまり) と CSV の行をどう対応づけるかは、設定とその注文の現在の状態で決まる。迷う場合は実行せず、確認画面で止めて理由を出す。** ## 用語 | 言葉 | 意味 | | --- | --- | | 未発送の発送単位 | Shopify の管理画面の注文詳細にある「未発送」カード 1 枚 (荷物のまとまり)。 | | 発送済みの発送単位 | 管理画面の「発送済み」カード 1 枚。追跡番号が付く。 | | 上書き | 発送済みの発送単位の追跡番号を、CSV の値に置き換えること。 | | 部分発送 | 未発送の発送単位のうち、指定した商品だけを発送すること。残りは未発送のまま。 | | 履歴 | CSV を出力したときに記録される「出力した行の記録」。「どの行がどの商品か」を知るためだけに使う。 | ## FACTS ```text TU-1 判定は Shopify の「現在の状態」で行う。履歴の「更新済み」の記録では判定しない。 (キャンセル後に未発送の発送単位が作り直された注文も、そのまま「未発送だけ」として扱える) TU-2 迷ったら止めて理由を出す。推測や自動の割り当てはしない。 止める例: 商品が決まらない / 発送済みと未発送が混在 / 候補が複数 / 履歴がない / 併用できない設定 TU-3 確認画面に出る「予定アクション」と、実行される処理は同じ判定から決まる。 「反映しない行」は、理由つきで確認画面に出る (黙って飛ばさない)。 TU-4 合わない注文はその注文だけ止まり、他の注文は進む。 TU-5 通知を OFF にすると、顧客へのメールは出ない。 TU-6 追跡番号を CSV から読み取るには、注文ID列と追跡番号列の列番号 (1 から数える) と、文字コードが合っている必要がある。 初期テンプレートには、運送会社ごとの既定の列番号が入っている。 TU-7 注文ID列と追跡番号列に同じ列を指定すると、警告が出て実行できない。 TU-8 取得に失敗した注文を「発送済みが 0 件」と見なして発送することはしない (取得失敗は赤いバナーで実行を止める)。 ``` ## 発送の方式 (テンプレートの分割の設定で決まる) 方式はテンプレートの分割設定から自動で決まる。マーチャントが選ぶものではない。 | 方式 | どんなテンプレートか | やること | | --- | --- | --- | | A まとめて | 注文を分割しないテンプレート (「出荷の発送単位を分割する」が OFF) | 注文の未発送の発送単位を 1 つに統合して、同じ追跡番号で発送する | | B 商品ごと | 「全行を分割」、または特定の商品を別の送り状行にしたテンプレートで「出荷の発送単位を分割する」が ON | CSV の行の商品だけを部分発送する | | C 配送の発送単位ごと | 「配送の発送単位ごとに分割して出力する (分割配送への対応)」を使うテンプレート | 未発送の発送単位ごとに発送する | ## 判定表 (方式 × 注文の Shopify 上の状態) | 方式 | 未発送だけ | 発送済みだけ | 一部発送済み (混在) | | --- | --- | --- | --- | | A まとめて | 全ての未発送の発送単位に同じ追跡番号で発送する | 「既存の追跡番号を上書き」ON: 上書き (複数あれば選ばせる)。OFF: 対象外 | 止めて、確認画面で選ばせる | | B 商品ごと | 行の商品だけを部分発送。合わなければその注文を止める。履歴が無く複数行のときは止めて、先に CSV を出力するよう促す | ON: 行の商品を含む発送済みを上書き。OFF: 対象外 | 未発送側の商品は部分発送。発送済み側の商品の行は、ON なら上書き、OFF なら対象外 | | C 配送の発送単位ごと | 「まとめる」設定なら 1 つに統合し、「各発送単位に同じ番号」設定なら各発送単位に同じ番号で発送 | ON: 上書き。OFF: 対象外 | 止めて、確認画面で選ばせる | - 「未発送だけ」には、発送をキャンセルした後に未発送の発送単位が作り直された状態を含む。 - 全行を分割して注文が複数行に展開されるテンプレートでは、**アップロードが 1 行でも**、未発送だけの注文は止まる (複数の発送単位を誤って発送しないため)。 ## PROC-TU1 CSV をアップロードして追跡番号を反映する ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「発送(追跡番号)」 前提: 運送会社のシステムに、出力した CSV を取り込み、追跡番号を含む CSV をダウンロードしておく 手順: 1. 画面上部のタブ「発送(追跡番号)」を開く 2. 「ファイルを選択」で CSV をアップロードする (「クリック または ドラッグ&ドロップ」) 3. テンプレートと「配送業者」を確認する (配送業者は、テンプレートの編集画面の基本情報「配送業者 (追跡番号の更新)」とも共通。どちらで変えても同じ値になる)。「テンプレート」を切り替えると、下の設定がそのテンプレートの内容に変わる 4. 「CSV の読み方(列番号)」で「注文ID 列」「追跡番号 列」と「文字コード」を確認する。 ヘッダー行がある CSV は「1 行目をヘッダーとする」にチェックを入れる 5. 「反映オプション」を確認する (下記)。すでに追跡番号が入っている (発送済みの) 注文の番号を変えるときは、「反映済みの注文の追跡番号を上書きする」を ON にする (テンプレートには保存されない、毎回の設定。OFF のままだと発送済みの注文は「反映しない」になる) 6. 「内容プレビュー」で、各行の予定アクション (「更新する」「上書き」「反映しない」ほか) と理由を確認する 7. 「追跡番号を更新」→ 確認 (「追跡番号を更新しますか?」) → 「更新を実行」 結果: 「更新が完了しました」の画面に、反映した注文・反映しない行・失敗した行が出る ``` ## 反映オプション ```text 「お客様に通知を送信する」 … ON で、追跡番号付きの発送通知メールが顧客に送信される (OFF が安全な試し方) 「反映時に注文へタグを追加する」 … 「追加するタグ」を入れると、反映した注文にタグが付く (例: 発送済み) 「出荷の発送単位を分割する」 … ON で、1 つの注文を複数行に分割して出力したとき、行ごとの追跡番号を反映できるよう Shopify の発送単位を分割する。全テンプレート共通の 1 つの値。 「数量ごとに分割」「配送の発送単位ごとに分割して出力する」を選んだテンプレートでは使えない (併用不可) 「発送単位の完了だけを記録する (追跡番号は登録しない)」 … 社内発送や宅配ボックス出荷など、追跡番号が不要なとき。追跡番号列は無効になる 「反映済みの注文の追跡番号を上書きする」 … ON で、既に発送済みの注文の追跡番号を CSV の値に置き換える。他アプリでの発送・手動で発送済みの注文も含む。テンプレートには保存されない ``` ## 確認画面の主な表示 | 表示 | 意味 | | --- | --- | | 更新する / 発送済みにする | 未発送の発送単位を発送し、追跡番号を登録する | | 上書き / 追跡番号を上書き | 発送済みの追跡番号を CSV の値に置き換える (「既存の追跡番号を上書き」が ON のとき) | | 反映しない (「反映しない行」) | 理由つきで飛ばす行。理由の例: 履歴がない / 商品が決まらない / 発送済みで上書きが OFF / 注文がない | | 発送単位が特定できません | 行をどの発送単位に対応づけるか決まらない。選択画面で選ぶか、設定 (分割) を見直す | | 要確認 — 再試行が必要な注文 | 取得や更新に一時的に失敗した。再試行する | | 追跡番号が空 — 既存番号を消去 | CSV の追跡番号が空で、上書き ON のとき、既存の追跡番号が消える。意図しない場合は実行しない | | 空欄 / 注文なし / 一致 | 追跡番号が空の行 / CSV の注文番号に該当する注文がない / 注文と対応づけられた行 | ## QA - **Q: アップロードしても「反映しない」になる。** A: 確認画面の「反映しない行」の理由を見てもらう。多い理由は (1) 履歴が無い (先に CSV を出力していない)、(2) 発送済みで「上書き」が OFF、(3) 商品が決まらない、(4) 注文ID列の指定ミス (ESCALATE)。 - **Q: 発送済みの注文の追跡番号を直したい。** A: 「反映済みの注文の追跡番号を上書きする」を ON にしてアップロードする (TU-1。他アプリ・手動で発送した注文も対象)。 - **Q: 一部の商品だけ先に発送して、あとの商品は後日発送したい。** A: 「出荷の発送単位を分割する」を ON にし、行ごとに商品を指定できるテンプレートで出力して、アップロードする (方式 B)。履歴が無い複数行は止まるため、**先に CSV を出力する**。 - **Q: 追跡番号を消してしまった/空で上書きされた。** A: 追跡番号が空の行を上書き ON でアップロードすると、既存の番号が消去される (確認画面に「追跡番号が空 — 既存番号を消去」と出る)。意図しない場合は実行しない。断定せず、注文番号と実行時の画面を確認する (ESCALATE)。 - **Q: 顧客にメールが飛んだ/飛ばしたくない。** A: 「お客様に通知を送信する」の設定に従う (TU-5)。試すときは OFF。 - **Q: 注文ID列と追跡番号列が同じと表示される。** A: 列番号の指定が同じ列になっている (TU-7)。CSV の列を確認して別の列を指定する。 - **Q: 文字化けして注文が見つからない。** A: 「文字コード」が CSV と合っているか確認する。多くの運送会社の CSV は Shift_JIS (TU-6)。 - **Q: 何件までアップロードできるか。** A: 上限は設けていないが、件数が多いと取得に時間がかかる。ブラウザで処理するため 200 件以下を推奨 (人間向けFAQ)。 ## ESCALATE 追跡番号の反映は実際の注文を変更する操作。次の場合は、結論を言わず状況を確認する。 | 状況 | 依頼する情報 | | --- | --- | | 誤った注文が発送済みになった・二重に発送された | 注文番号、実行した日時、使ったテンプレート名、反映オプションの設定 (上書き・分割・通知)、確認画面のスクリーンショット | | 反映されない・飛ばされる | 注文番号、確認画面の「反映しない行」の理由、CSV のその行 (個人情報は伏せる)、テンプレート名 | | 追跡番号が消えた | 注文番号、実行時の画面、「上書き」の設定、CSV の追跡番号列の値 | | 発送単位が特定できない / 要確認になる | 注文番号、Shopify の注文詳細の「未発送」「発送済み」カードの状態、テンプレートの分割の設定 | | 他アプリと併用していて結果が合わない | 併用しているアプリ名、どちらで発送したか | ## SEE - [注文CSV出力](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/csv/) - [一つの注文(フルフィルメント)に対して複数の追跡番号をアップデートする](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/059/update-fulfilments/) - [追跡番号アップデート時の配送フルフィルメントの分割](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/060/split-shipping-profile/) - [注文の分割配送毎に出力行を分割、追跡番号のアップデートをする](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/052/split-fulfillment/) - [Pro: 注文CSV出力の基本](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/090/csv-basics/) --- # Pro: 振り分けルールと出荷リードタイム(注文を運送会社ごとに分ける・出荷予定日を出す) ```yaml plan: Pro プラン限定 (R6) screens: 「設定」→「振り分けルール」 / 「設定」→「出荷リードタイム」 / 「注文一覧」の「今日までに出荷」 verified_from: CSV 画面の実装 (振り分けルール・出荷リードタイムの画面と計算) + 人間向けマニュアル ui_verified: 項目名はコードから確認。実画面での目視確認は未実施 ``` ## SUMMARY - **振り分けルール**: 注文を条件で判定し、運送会社 (= CSV テンプレート) ごとに分ける。分けた結果は注文一覧のテンプレート別の件数に出て、テンプレートごとに出力できる。 - **出荷リードタイム**: 注文の「出荷予定日」を計算する。計算結果は注文一覧の「今日までに出荷」で絞り込める。 どちらも Pro の CSV 画面の「設定」の中のタブ。 --- # 振り分けルール ## FACTS ```text R-1 「設定」→「振り分けルール」で設定する。主スイッチは「テンプレート別に振り分ける」。OFF のときは振り分けは行われず、全注文が各テンプレートに出力される。 R-2 1 つのルール = 1 つのテンプレート (運送会社)。ルールは「条件」を持ち、条件に合う注文がそのテンプレートに振り分けられる。 R-3 1 つのルールに複数の条件を入れた場合は「いずれかを満たせば一致」(OR)。「かつ (AND)」では評価しない。 (複数の条件を全て満たす場合だけにしたい、は条件の工夫では実現できない。ESCALATE) R-4 「振り分けモード」は2種類: 「排他的」 … 注文を上から順に評価し、最初に条件を満たしたルールの運送会社だけに振り分ける (既定) 「条件一致」 … 全ルールで評価し、条件を満たした全てのルールの運送会社に振り分ける (同じ注文が複数テンプレートに入る) R-5 どのルールにも該当しない注文は、「既定」(★ 既定) のテンプレートに振り分けられる。「どのルールにも該当しなかったら」で既定の振り分け先を選ぶ。 R-6 「1注文の中で商品ごとに分割する」は別の機能。1 つの注文に運送会社が異なる商品が混在するとき、各テンプレートの「商品分割条件」に一致した商品だけをそのテンプレートへ分けて出力する。 「条件一致」モードとは併用できない。「配送の発送単位ごとに分割して出力する」を選んだテンプレートがあるときも使えない。 R-7 ルールを編集すると「シミュレータ」が即座に再計算され、現在の注文を振り分けた結果 (テンプレートごとの件数) を出力前に確認できる。 R-8 条件の「判定対象」は注文の項目 (配送先住所・商品名・商品のタグ・オーダータグ・合計金額・総重量など)。数値は範囲、文字列は「を含む」「のいずれかを含む」など。 ``` ## PROC-R1 振り分けを使い始める (例: 佐川とヤマトを住所で分ける) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「振り分けルール」 手順: 1. 「設定」→「CSVテンプレート」で、出力したい運送会社のテンプレート (例: ヤマト B2クラウド・佐川 e飛伝3) を用意する 2. 「設定」→「振り分けルール」を開き、「テンプレート別に振り分ける」を ON にする 3. 振り分け先のテンプレートのルールで「条件を追加」を押し、判定対象 (例: 配送先住所) と値 (例: 北海道, 沖縄県) を指定する 4. 「どのルールにも該当しなかったら」で、既定の振り分け先 (「既定の振り分け先」) を選ぶ 5. 「シミュレータ」でテンプレートごとの件数を確認する 6. 画面上部の「保存する」で保存する 結果: 注文一覧で、テンプレートごとの件数が条件に従って分かれる。各テンプレートの「出力」で CSV を出力する ``` ## PROC-R2 条件の評価順を変える ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「振り分けルール」 手順: 「排他的」モードのとき、ルールを「ドラッグで並び替え」て順番を変える。「上から順に評価」され、最初に一致したルールが採用される 注意: 「条件一致」モードでは順番は影響しない (全ルールで評価する) ``` ## PROC-R3 1つの注文の中の商品ごとに運送会社を分ける (例: 冷凍食品だけ別のテンプレート) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「振り分けルール」 前提: 「テンプレート別に振り分ける」が ON。振り分けモードが「排他的」であること (「条件一致」とは併用できない)。「配送の発送単位ごとに分割して出力する (分割配送への対応)」を選んだテンプレートがあるときも使えない (R-6) 手順: 1. 「1注文の中で商品ごとに分割する」を ON にする 2. 各ルールの行に出る「商品分割」の行の鉛筆アイコン (編集) を押し、「(運送会社名) の商品分割条件」を開く 3. 「OR条件を追加」で、そのテンプレートに入れる商品の条件 (例: 商品のタグが「冷凍食品」を含む) を設定して保存する 4. 「シミュレータ」「プレビュー」で、注文が商品ごとに分かれていることを確認し、画面上部の「保存する」で保存する 結果: 条件に一致した商品だけがそのテンプレートに分けて出力される。どの商品分割条件にも当てはまらない商品は、ルールの条件で該当したテンプレート、なければ「既定」のテンプレートになる ``` ## QA (振り分け) - **Q: 1つの注文が2つのテンプレートに入ってしまう。** A: 振り分けモードが「条件一致」になっていないか確認する (R-4)。1 つにしたい場合は「排他的」にする。 - **Q: 注文がどのテンプレートにも入らない / 全部同じテンプレートに入る。** A: 「テンプレート別に振り分ける」が OFF だと全注文が各テンプレートに出る (R-1)。どのルールにも該当しない注文は既定のテンプレートに入る (R-5)。シミュレータで件数を確認する。 - **Q: 条件を2つとも満たす注文だけ振り分けたい (かつ)。** A: 振り分けルールの 1 つのルールの複数条件は OR で評価される (R-3)。AND は設定できない (出荷リードタイムのルール内の複数条件は「かつ」で評価され、振り分けとは逆なので混同しない — LT-6)ため、具体的な条件を聞き、必要なら開発元への問い合わせの文面を下書きする。 - **Q: 同じ注文の中の商品ごとに別の運送会社にしたい。** A: 「1注文の中で商品ごとに分割する」を使う (R-6、手順は PROC-R3)。各テンプレートの「商品分割条件」で、そのテンプレートに入れる商品を指定する。 --- # 出荷リードタイム ## FACTS ```text LT-1 「設定」→「出荷リードタイム」で設定する。「出荷リードタイムを使う」が ON のときだけ有効になり、注文一覧に「今日までに出荷」のタブが出る。 LT-2 出荷予定日 = 受注日 + リードタイム日数 (「受注日から N 日」)。「希望日があれば希望日優先」が ON のルールでは、配送希望日がある注文は 配送希望日 − リードタイム日数 で逆算する。配送希望日が無い注文は常に受注日加算になる。 LT-3 リードタイムが 0 日のときは「受注日に出荷」(即日出荷)、「希望日があれば希望日優先」で 0 日なら「配送希望日に出荷」と表示される。 LT-4 「営業日」(営業休業日を除外して計算) を ON にすると、営業休業日を除いた日数で数える。営業休業日は「設定」の営業休業日のカレンダー (グループ) を参照する。 LT-5 「受付締め時刻 (任意)」を設定したルールは、受注日加算のとき、締め時刻を過ぎた注文が +1 日になる。 LT-6 ルールは上から順に評価し、最初に条件を満たしたルールを採用する (ルール内の複数条件は「かつ」)。どのルールにも該当しない注文は「★ 既定のリードタイム」に従う。 LT-7 時刻・日付の基準は店舗のタイムゾーン。 LT-8 「今日までに出荷」は、出荷予定日が今日 (店舗のタイムゾーン) 以前の注文を絞り込む (出荷予定日を過ぎている注文も含む)。 ``` ## PROC-LT1 出荷リードタイムを設定する (例: 冷凍食品は配送希望日の4日前に出荷) ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「設定」 > 「出荷リードタイム」 手順: 1. 「設定」→「出荷リードタイム」を開き、「出荷リードタイムを使う」を ON にする 2. 「ルールを追加」(「出荷リードタイムルールを追加」) を押し、「ルール名」を入れる 3. 「適用条件」で判定対象と値を指定する (例: 商品のタグ・冷凍)。複数条件は「AND条件を追加」で「かつ」になる 4. 日数 (リードタイム) を指定し、配送希望日から逆算するなら「希望日があれば希望日優先」を ON にする 5. 営業休業日を数えない場合は「営業休業日を除外して計算」を ON にする 6. 「追加する」→ 画面上部の「保存する」 7. 「★ 既定のリードタイム」で、どのルールにも該当しない注文の日数を設定する 結果: 注文を開く詳細に出荷予定日と適用されたルールが出る。「今日までに出荷」で、出荷予定日が今日以前の注文を絞り込める ``` ## QA (出荷リードタイム) - **Q: 「今日までに出荷」のタブが出ない。** A: 「出荷リードタイムを使う」が ON になっているか確認する (LT-1)。 - **Q: 配送希望日が無い注文の出荷予定日は。** A: 受注日 + リードタイム日数で計算される (LT-2)。希望日優先を ON にしていても、希望日が無い注文は受注日加算になる。 - **Q: 土日を数えたくない。** A: 「営業休業日を除外して計算」を ON にし、営業休業日の設定に土日を入れておく (LT-4)。 - **Q: 出荷予定日がずれる/想定と違う。** A: ルールの順番 (LT-6)、希望日優先の有無 (LT-2)、受付締め時刻 (LT-5)、営業休業日の設定 (LT-4)、店舗のタイムゾーン (LT-7) を順に確認する。注文番号と適用されたルールの表示を聞く (ESCALATE)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 振り分け先が想定と違う | 注文番号、振り分けモード (排他的 / 条件一致)、該当するルールの条件のスクリーンショット、期待した振り分け先 | | 「かつ (AND)」で振り分けたい | 具体的な条件。AND は設定できないため、条件の組み立て方を確認して案内する | | 出荷予定日が想定と違う | 注文番号、適用されたルールの表示、注文日と配送希望日、営業休業日の設定、期待する出荷予定日 | ## SEE - [注文内容から出力するCSVテンプレートを選ぶ](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/030/csv-group-order-change/) - [商品毎にCSVテンプレートを分割する](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/040/split-csv-group/) - [商品毎に出力行を分割する](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/045/split-row-with-product/) - [商品によってCSV出力の行を分ける](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/csv/050/split-with-product/) - [Pro: 注文CSV出力の基本](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/090/csv-basics/) --- # Pro: 配送方法のカスタマイズ(チェックアウトの配送オプションの出し分け)と外部システム連携 ```yaml plan: Pro プラン限定 (R6) screens: 左メニュー「連携(プロプラン)」(「外部システム連携 (ネクストエンジンなど)」「チェックアウトの配送オプションのカスタマイズ」) / 「設定」の配送方法(スロット)ごとの設定 verified_from: 管理画面の実装・チェックアウトの配送オプションを出し分ける Function (delivery-customization)・連携の初期値定義 + 人間向けマニュアル ui_verified: 項目名はコードから確認。実画面での目視確認は未実施 ``` ## SUMMARY - **配送方法のカスタマイズ**: ウィジェットで選んだ「配送方法 (スロット)」に応じて、チェックアウトの Shopify の配送オプション (配送・ローカルデリバリー・店舗受取など) を出し分ける。カートの属性 `__ccSlot` を目印に、チェックアウトで不要な配送オプションを隠す。 - **外部システム連携**: ウィジェットが注文の「追加の詳細」に書き込む配送日・配送時間の「ラベル」と「書式」を、連携先 (ネクストエンジン・オープンロジ・Ship&Co・GoQSystem) の取込形式に合わせる。 --- # 配送方法のカスタマイズ ## FACTS ```text SC-1 Pro プラン限定。前提として、ウィジェットに「配送方法 (スロット)」が設定されている必要がある (別ページの配送方法の手順)。 SC-2 ウィジェットで選んだ配送方法の番号とグループ番号が、カートの属性 __ccSlot に "配送方法番号::グループ番号" の形で入る。 (配送方法を使わない場合の配送方法番号は -1、グループを使わない場合のグループ番号は -1) SC-3 チェックアウトで、__ccSlot に対応する設定がある場合、「チェックを入れた」配送オプションだけを表示し、他を隠す。 配送オプションの照合は、配送方法の種類 (配送 / ローカルデリバリー / 店舗受取) と、配送オプションの名称 (配送プロファイルの料金名) で行う。 SC-4 __ccSlot が無い・対応する設定が無い・設定が空のときは、何も隠さない (通常どおり全て表示)。 SC-5 Shopify の配送設定 (「設定」→「配送と配達」) をアプリから作ることはできない。配送プロファイルと料金名は、Shopify の管理画面で先に作っておく。 SC-6 Shopify の「配達のカスタマイズ」は、店舗あたり 5 件が上限。上限に達すると設定の更新が失敗する。 SC-7 店舗受取を隠すには、Shopify の配送プロファイルに「店頭受取 (無料)」のような配送料金を追加し、「発送」と同じ扱いにする方法がある。 この場合、Shopify の「受取の準備ができました」メールは送れなくなる (人間向けマニュアル)。 SC-8 「配送プロファイルを更新する」は、Shopify から配送プロファイルを取得し直して、設定画面の一覧を最新にする。 ``` ## PROC-SC1 配送方法ごとにチェックアウトの配送オプションを出し分ける ```text 場所: アプリの左メニュー「連携(プロプラン)」 > 「チェックアウトの配送オプションのカスタマイズ」 > 「設定を開始する」 → アプリの左メニュー「設定」 > 配送方法 (スロット) ごとの設定画面 前提: - Pro プランを有効にしている - ウィジェットに配送方法 (スロット) を設定している (例: 「配送」「ストアで受け取る」) - Shopify の「設定」→「配送と配達」で、配送プロファイルと料金名を作成している 手順: 1. 左メニュー「連携(プロプラン)」を開き、「チェックアウトの配送オプションのカスタマイズ」の「設定を開始する」を押す 2. 「設定」の配送方法 (スロット) ごとの設定画面で、配送方法ごとに、チェックアウトに表示したい配送プロファイル (料金名) だけにチェックを入れる (「表示したくない配送プロファイルのチェックを外してください」) 3. 配送プロファイルを Shopify 側で追加・変更した場合は「配送プロファイルを更新する」を押す 4. 画面上部の「保存する」で保存する 結果: チェックアウトで、ウィジェットで選んだ配送方法に対応する配送オプションだけが表示される。注文の「追加の詳細」に __ccSlot が付く ``` ## QA (配送方法のカスタマイズ) - **Q: 注文の追加の詳細に __ccSlot が付く。消せるか。** A: この機能の動作に必要な値 (SC-2)。残したくないだけなら、「オプション」の「注文への自動書き込み」の「注文の追加の詳細から内部の属性を削除する」で、注文後に消せる (症状別ページ SYM-3)。機能を OFF にすれば付かなくなるが、出し分けも働かなくなる。 - **Q: 設定したのにチェックアウトで配送オプションが隠れない。** A: 次を順に確認する。(1) ウィジェットで配送方法を選択して購入したか (SC-4: __ccSlot が無いと隠れない)、(2) 動的チェックアウト (今すぐ購入など) 経由ではないか、(3) 配送オプションの名称が Shopify の配送プロファイルの料金名と一致しているか、「配送プロファイルを更新する」で更新したか、(4) 保存したか。断定せず、ESCALATE の情報を依頼する。 - **Q: 「配送プロファイルを更新する」でエラーになる。** A: Shopify の「配達のカスタマイズ」が 5 件の上限に達している可能性がある (SC-6)。Shopify の管理画面の配達のカスタマイズから、不要なものを削除して再度試す。 - **Q: 店舗受取の選択肢を消したい。** A: 配送方法のカスタマイズで出し分ける (PROC-SC1)。または SC-7 の方法がある。SC-7 の方法では「受取の準備ができました」メールが送れなくなる点を必ず伝える。 - **Q: Shopify の配送料金そのものを設定したい。** A: アプリからは設定できない。Shopify の「設定」→「配送と配達」で設定する (SC-5)。 --- # 外部システム連携 ## FACTS ```text K-1 Pro プランで利用できる。ウィジェットが注文の「追加の詳細」に書き込む配送日・配送時間の「ラベル」と「書式」を、連携先の取込形式に合わせる。 K-2 連携先の選択肢: 「指定なし」「ネクストエンジン」「オープンロジ」「Ship & Co」「GoQSystem|ごくーシステム」。選ぶと下のラベル・書式が自動で入る。 K-3 個別に変更もできる (「連携用のラベル」「連携用のフォーマット」「連携項目を設定しない」)。連携先に無い形式でも、ラベルと書式を自由に設定できる。 K-4 グループ (商品ごとのグループ化) や配送方法を使っている場合は、それぞれに連携項目の設定が必要。グループや配送方法ごとに連携先 (運送会社) を変えることもできる。 K-5 「配送希望日と配送時間を結合する」を有効にすると、日付と時間を 1 つの値にできる (例: 2023-11-22-13:00)。「日付と時間の中間のテキスト」「日付と時間を入れ替える」で形を調整できる。 K-6 「配送時間の詳細化」(10分〜240分の間隔で時間を自動生成) と組み合わせると、正確な時間の書式にできる。 K-7 ウィジェットの表示ラベル (お客様に見える文字) と、連携用のラベル (注文の「追加の詳細」のキー) は別に持てる。 ``` ## 連携先ごとの初期値 | 連携先 | 配送日のラベル | 日付の書式 | 配送時間のラベル | 補足 | | --- | --- | --- | --- | --- | | ネクストエンジン | `delivery_date` | YYYY/MM/DD | `delivery_time` | ネクストエンジン側で「受注伝票への取込設定」(メイン機能 2-3) の設定が必要 | | オープンロジ | `openlogi_delivery_date` | YYYY-MM-DD | `openlogi_delivery_time_slot` | オープンロジ側の設定は不要 | | Ship & Co | `shipandco-配達希望日` | YYYY-MM-DD | `shipandco-配達希望時間帯` | 時間帯は配送業者ごとの値を選ぶ | | GoQSystem|ごくーシステム | `deliveryDate` | YYYY-MM-DD | `deliveryTime` | | - 値は注文の「追加の詳細」のキーと値として書き込まれる。連携先は、このキーを取込設定で参照する。 ## PROC-K1 連携先に合わせて設定する ```text 場所: アプリの左メニュー「連携(プロプラン)」 > 「外部システム連携 (ネクストエンジンなど)」 手順: 1. 左メニュー「連携(プロプラン)」を開き、Pro プランを有効にする (承認画面に遷移する) 2. 「外部システム連携 (ネクストエンジンなど)」で「外部連携するためのカスタムキーワードを設定する」を ON にする 3. 「連携システム向けの設定」(「連携システムの設定」) で連携先を選ぶ。ラベルと書式が自動で入る 4. 必要に応じて、「連携用のラベル」「連携用のフォーマット」を変更する。日付と時間を結合するなら「配送希望日と配送時間を結合する」を有効にする 5. グループや配送方法を使っている場合は、それぞれの設定でも同じ連携先を設定する (K-4) 6. 画面上部の「保存する」で保存し、オンラインストアに反映する 7. 連携先側の設定 (ネクストエンジンなど) を行う ``` ## QA (外部システム連携) - **Q: ネクストエンジンに配送日が取り込まれない。** A: ネクストエンジン側の「受注伝票への取込設定」で、`delivery_date` / `delivery_time` を参照する設定をしているか確認する。アプリ側は連携先として「ネクストエンジン」を選び、保存・反映しているか確認する。注文の「追加の詳細」に `delivery_date` が入っているかも見てもらう。 - **Q: 配送日の書式を変えたい (例: YYYYMMDD)。** A: 「連携用のフォーマット」で変更できる (K-3)。 - **Q: 日付と時間を 1 つにしたい。** A: 「配送希望日と配送時間を結合する」を有効にする (K-5)。 - **Q: グループごとに連携先が違う。** A: グループごとの設定で連携先を選べる (K-4)。 - **Q: ロジレスと連携したい。** A: 連携先の選択肢に「ロジレス」は無い (K-2)。ロジレスの管理画面「注文メモの属性値」に、本アプリが注文の「追加の詳細」に書く項目名 (ラベル) を設定する。手順は人間向けマニュアル「ロジレスとの連携設定」を案内する。 - **Q: Ship & Co と連携したい。** A: 連携システムの設定で「Ship & Co」を選んで保存する (K-2)。Ship & Co 側の設定方法のページは変わることがあるので、リンクが切れていたらこの選択の手順だけを案内する。 - **Q: microLogi に取り込まれる配送日の形式を変えたい (yyyymmdd など)。** A: 「連携用のフォーマット」で変更できる (K-3)。 - **Q: BOSS(ハングリード)・クロスモールと連携できるか。** A: 本アプリは連携していない。BOSS は、注文の「追加の詳細」(order.customAttributes) を取り込まないと確認されている (過去の確認)。クロスモールとは正式な連携をしていない。連携先側で「追加の詳細」を取り込めるかを確認してもらう。 - **Q: ネクストエンジンで配送時間が「配送時間」でなく「備考欄」に入る。** A: 注文の「追加の詳細」に `delivery_time` が入っているなら、ネクストエンジン側の取込設定の問題。ネクストエンジンの「受注伝票への取込設定」を確認してもらう。 - **Q: ネクストエンジンに取り込むと運送会社が自動でゆうパックになる。** A: 運送会社の決まり方はネクストエンジン側の設定による。取り込み後にゆうパックになる条件をネクストエンジン側で確認してもらう。本アプリが書くのは配送日・配送時間などの項目。 - **Q: ネクストエンジンから出荷した情報 (配送キャリア・問い合わせ番号) が Shopify に反映されない。** A: 本アプリの機能の範囲外 (ネクストエンジンから Shopify への出荷連携)。ネクストエンジン側の設定を確認してもらう。 - **Q: 連携先の項目と、定期購入アプリの項目名 (delivery_date) が被る。** A: 「連携用のラベル」を別の名前にする (K-3 / X-4)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 配送オプションが出し分けされない | ストアURL、注文の「追加の詳細」の __ccSlot の値、設定したチェックの画面、Shopify の配送プロファイルの料金名、動的チェックアウトを使っていないか | | 設定の更新でエラーになる | エラー画面の文言、Shopify の「配達のカスタマイズ」の件数 | | 連携先に配送日時が取り込まれない | 連携先名、注文の「追加の詳細」のスクリーンショット、アプリの連携設定の画面、連携先側の取込設定 | | 連携先に無い形式に合わせたい | 連携先の取込仕様 (キーの名前・日付と時間の書式)。個別の設定になるため、開発元への問い合わせの文面を下書きする | ## SEE - [配送方法のカスタマイズ](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/shipping/delivery-method-customize/) - [システム連携用フォーマット](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/connect/system-connect/) - [ネクストエンジン](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/connect/010/next-engine/) - [オープンロジ](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/connect/020/openlogi/) - [Ship&Co](https://capital-castle.eastazy.com/cc-delivery-date-time/pro/connect/030/shipandco/) - [配送時間の詳細化](https://capital-castle.eastazy.com/cc-delivery-date-time/normal/050/detail-time/) --- # Pro: 住所チェック(注文の住所の誤りを出力前に見つけて直す) ```yaml plan: Pro プラン限定 (R6。CSV 画面の機能) screens: アプリの左メニュー「CSV」 > タブ「注文一覧」 > 注文を選ぶと表の上に出る「住所チェック」 / モーダル「住所チェック」 verified_from: 住所チェックの実装 (検知・修正提案・5 つのセクション・操作バー・確認・変更履歴・メタフィールド保存) ui_verified: 2026-10-22 開発ストアで、モーダルの構成・項目名・詳細の開閉・「注文の住所を修正」の確認の表示を実機で確認した (旧構成。確認は押していない)。2026-10-26 に、「CSV 出力用の住所だけ修正」(上書き・暗号化・元に戻す) を撤去し、注文の住所の修正だけにした。このページの内容 (5 つのセクション・確認に変更前 → 変更後・履歴に値を持たない) は、自動テストでのみ確認していて、実機は未確認 (公開前に開発ストアで確認する) status: 公開済み (本番リリース済み。2026-11-02 確認)。「個人情報の保持」(065) に住所チェックの個人情報の扱いを追記済み caution: 「Shopify の注文の住所を修正」は Shopify の注文の配送先住所を書き換える。取り消せない。断定的に「大丈夫です」と答えない ``` ## SUMMARY 注文一覧で選んだ注文の配送先住所に、氏名・電話・住所欄の入力ミスがないかを調べ、見つけた誤りをその場で直せる機能。直すと、**Shopify の注文の配送先住所そのものが書き換わる** (取り消せない)。変更前後の値は、Shopify の注文のタイムラインに残る。操作は 2 ステップ。 1. **対象の行をチェックする**: 「自動修正できる注文」の行は、最初からチェックされている。 2. **操作バーで適用する**: 画面下の「注文の住所を修正 (N)」を押し、確認で「N 件の注文の住所を修正する」を押す。 このアプリが覚えているのは「修正したか」だけ (日時・方式・変更した項目の名前)。氏名・住所・電話の値は、「CC 配送日時指定」のサーバーにも、注文のメタフィールドにも保存しない。 ## FACTS ```text AC-1 Pro プラン限定。CSV 画面 (アプリの左メニュー「CSV」 > タブ「注文一覧」) で使う。注文を選ぶと、表の上の一括操作に「タグを追加」「住所チェック」「一括で出荷済みにする」が並ぶ。何も選んでいないときは出ない。 AC-2 「住所チェック」を押すと、選んだ注文だけが対象。モーダル「住所チェック」は、上から、注意書き「適用すると、Shopify の注文の配送先住所を書き換えます。取り消せません。変更前後の値は、注文のタイムラインに残ります。」/ Shopify が検知した注文があるときの注意 / 「① 対象の行をチェック (自動修正できる行は最初からチェック済み)」と件数「検知あり: N 件 ・ 変更あり: N 件 ・ 適用済み: N 件 ・ 検知なし: N 件」/ 表 / 「② 適用する」(操作バー。表の下に固定される)。フッターの操作は「閉じる」だけ。 AC-3 選んだ注文は、検知の有無にかかわらず 1 注文 1 行で、全件が表に並ぶ。表は、次にすることで最大 5 つのセクションに分かれ、この順に並ぶ (0 件のセクションは出ない。見出しは「名前 (N 件)」で、下に補足が 1 行出る): 1「要確認:Shopify が住所の問題を検知 (N 件)」: Shopify の検知だけの注文。補足「Shopify の検知は問題の項目を特定できないため、自動修正できません。住所全体を見直して、直接編集してください。」 2「要確認:修正案を作れない検知 (N 件)」: このアプリが検知したが、住所を変える修正案を作れない注文 (例: 電話番号の桁数不足)。Shopify の検知と、修正案のない検知の両方がある注文もここ。補足「検知はありましたが、正しい値までは分かりません。住所を見直して、直接編集してください。」 3「自動修正できる注文 (N 件)」: 修正案で住所が実際に変わる注文 (Shopify の検知も一緒にある注文もここ)。補足「修正案を作成済みです。内容を確認して適用してください。」。この行だけ、最初からチェック済み 4「修正済みの注文 (N 件)」: このアプリで直した注文。補足「このアプリで住所を修正した注文です。」 5「問題なし(検知なし) (N 件)」: 補足「問題は検知されていません。必要なら、直せます。」 「修正済み」は、この画面で適用した行と、変更履歴に「Shopify の注文の住所を修正」がある行。修正済みの注文は、あとで再び検知されても「修正済み」のまま (要確認には戻らない)。適用すると、その行は「修正済み」へ移る。検知のない注文も、行を開いて全欄 (姓・名・郵便番号・都道府県・市区町村・住所1・住所2・電話番号) を編集して適用できる。表の先頭の全選択は、セクションごと (「要確認の行をすべて選択」「修正案のない要確認の行をすべて選択」「すべての行を選択」「修正済みの行をすべて選択」「問題なしの行をすべて選択」)。 AC-4 検知はブラウザの中で行う。検知のために氏名・住所・電話を外部へ送ることはない。 AC-5 検知する誤り (バッジの表記。表の「検知」の欄に、検知のあった全部が縦に並ぶ): 氏名: 「氏名: 片方に姓名両方」「氏名: 姓名逆転」 電話: 「電話: 桁数不足・超過」「電話: 国際形式と先頭0の混在」「電話: 全半角混在」「電話: 先頭0の欠落」 住所欄の混入: 「住所: 郵便番号混入」「住所: 都道府県混入」「住所: 市区町村重複」「住所: 国名混入」「住所: 複数項目混入」 欄ズレ: 「欄ズレ: 市区町村欄に建物名」「欄ズレ: 住所と建物名が逆転」「欄ズレ: 建物名欄に住所」「欄ズレ: 市区町村欄が空」 Shopify の判定: 表では「Shopify 検知」と短く出る (詳細を開くと「Shopify: 住所エラーを検知」「Shopify: 住所の問題を検知」) AC-6 郵便番号が実在するか・都道府県や市区町村と合っているかは、このアプリでは確認しない (郵便番号のデータを持っていない)。Shopify の住所の判定も、日本の郵便番号の存在・整合は見ない。 AC-7 「Shopify 検知」は、Shopify が注文時点で付けた住所の判定 (管理画面の「住所の問題を確認」と同じ)。日本では、市区町村欄が壊れている・空のときに出る。この判定は注文時点のもの。Shopify の判定では、問題の項目が分からないので、モーダルの上部に 1 回だけ「Shopify が検知した注文は、問題の項目を特定できません。住所全体を見直してください。」という注意が出る (各行には出ない)。 AC-8 修正の提案が入力欄の初期値に入るもの: 氏名 (姓名の入れ替え・分割)・電話 (半角化・先頭0の補完など) 住所欄の混入: 住所1 に入った郵便番号・都道府県・市区町村・「日本」などの国名を取り除いた形 (取り除くのは、住所の他の欄と一致するものだけ) 市区町村欄が空: 住所1 の先頭にある市区町村を、市区町村欄へ移した形 提案が出ないもの: 「電話: 桁数不足・超過」「欄ズレ: 市区町村欄に建物名」「欄ズレ: 住所と建物名が逆転」「欄ズレ: 建物名欄に住所」と、「Shopify 検知」。これは手で直す (セクション 1・2)。 AC-9 表の列は、チェック / 注文 / 検知 / 変更内容(元 → 変更後) / 編集 (「状態」の列は無い)。列見出しは常に出る。「注文」の番号は、Shopify 管理画面の注文ページへのリンク (別のタブで開く)。「現在の住所」は表に出ず、「編集」で開く詳細の先頭に出る。適用の成否は、行のあるセクションで分かる (適用に成功した行は「修正済みの注文」へ移る)。バッジは、適用に失敗した行の「変更内容」の欄に出る赤い「適用に失敗」だけ。 AC-10 ① 対象の行をチェック と ② 操作バー: 「自動修正できる注文」の行は、最初からチェックされている (要確認・修正済み・問題なしの行はチェックされていない)。見出しのチェックで、そのセクションの全選択 / 全解除を切り替える。操作バーは、「N 件選択中」、赤い「注文の住所を修正 (N)」。適用の対象は、「チェックした行」のうち、未適用で変更のある行。チェックした件数と適用できる件数が違うときは「N 件選択中 (うち適用できる変更 M 件)」と出る。補足として「未適用の変更 N 件は、閉じると破棄されます。」が出る。適用が終わった行はチェックが外れ、失敗した行はチェックが残る。 AC-11 詳細: 行の「編集」で、その行の直下に開く (同時に開くのは 1 行。開いた行のボタンは「閉じる」に変わる。適用済みの行のボタンは「詳細」)。中身は、「現在の住所」/ 検知のバッジと説明 / 入力欄 / 提案の注意「提案値を入力済みです。…」/「変更する項目: N 件」の差分 / ボタン「注文の住所を修正」と「変更履歴 (N 件)」(履歴があるとき)。入力欄は、検知のあった欄と関連する欄だけ (氏名なら「姓」「名」、電話なら「電話番号」、住所系なら「都道府県」「市区町村」「住所1」「住所2」、Shopify の判定なら「郵便番号」も。検知のない注文は全欄)。変えた欄には青い「変更」の印と「元の値: …」が出る。変えた欄だけが適用される。適用した行は、注文そのものが変わるので、編集できない。 AC-12 適用は、必ず確認を挟む。操作バーの「注文の住所を修正 (N)」を押すと、操作バーが確認に置き換わり、「N 件の注文の配送先住所を書き換えます。取り消せません。」/「変更前後の値は、注文のタイムラインに残ります。」/ 対象の注文ごとの「#番号 と 変更 (項目: 元 → 変更後)」/ 赤い「N 件の注文の住所を修正する」/「キャンセル」が出る (件数は、チェックした行の数)。行の詳細の中の適用でも、同じ形の確認 (「Shopify の注文の配送先住所を書き換えます。取り消せません。変更前後の値は、注文のタイムラインに残ります。」「注文の住所を修正する」「キャンセル」) が出る。実行すると、1 件ずつ順に書く。Shopify の注文詳細の配送先が変わり、注文のタイムラインに、アプリが配送先住所を更新した旨と、項目ごとの「変更前 から 変更後 に更新」が残る。更新した注文は、この画面でも一覧・プレビュー・CSV の住所がすぐ新しい値になる (注文を取得し直さなくてよい)。 AC-13 失敗: 一括で 1 件失敗しても、残りは続く。操作バーに「N 件適用 / M 件失敗 — 失敗: #…」と出る。失敗した行は、赤い「適用に失敗」のバッジで、詳細が自動で開き、「この注文は適用されませんでした。」と理由が出る。失敗した行はチェックが残り、もう一度適用すると、その行だけ再実行される。Shopify に更新を拒否されたとき (例: 存在しない都道府県) も、その注文は変わらない。 AC-14 取り消し: 取り消す機能は無い (「元に戻す」ボタンは無い)。間違えて更新したときは、Shopify の注文のタイムラインで変更前の値を見て、Shopify の管理画面で注文の配送先を手で直す。 AC-15 変更履歴 (修正したかの目印): 適用のたびに、日時・方式 (「Shopify の注文の住所を修正」)・変更した項目の名前が、注文のアプリ専用メタフィールド (`$app:cc_delivery_order_profile`) に記録される。氏名・住所・電話の値は記録しない (詳細の「変更履歴 (N 件)」には「変更した項目: 姓、郵便番号」のように出る。値や「→」は出ない)。1 注文につき最大 20 件で、超えると古いものから消える。新しい順に見られる。履歴に「Shopify の注文の住所を修正」がある注文は、「修正済み」のセクションに入り、検知の列に青いバッジ「Shopify の注文を修正済」が出る。履歴は期限で消えない。 AC-16 同じ注文を 2 つの画面で同時に直しても、履歴は取りこぼさない (後から書いた側は、読み直して追記する)。 AC-17 個人情報の扱い: - 「CC 配送日時指定」のサーバーには、氏名・住所・電話を保存しない。住所チェックのために、サーバーが注文ごとに持つデータも無い。 - 住所の検知と修正は、ブラウザから Shopify の Admin API へ直接行う。 - 注文のメタフィールドに残るのは、変更履歴 (日時・方式・変更した項目の名前) だけ。氏名・住所・電話の値は入らない。 - 変更前後の値は、Shopify の注文のタイムラインに残る (Shopify の機能)。 - 顧客の個人データの削除依頼 (Shopify から届く通知) があっても、このアプリが消す個人情報は無い。 - アンインストールすると、アプリ専用のメタフィールドは Shopify により削除される (他のアプリ専用メタフィールドと同じ扱い)。 - メタフィールドの「定義」は宣言していないので、Shopify の管理画面では編集・検証できない。 AC-18 注意: 注文のアプリ専用メタフィールドは、テーマの Liquid から読める可能性がある。履歴には日時・方式・項目名だけで個人情報は入らない。 AC-19 できないこと: 注文の配送先住所を変えずに、CSV だけ直すことはできない (以前の「CSV 出力用の住所だけ修正」は無い)。直すと Shopify の注文の配送先住所が変わるので、別の配送系アプリなどが Shopify の住所を読んでいる店では、そちらにも新しい住所が渡る。 ``` ## PROC-AC1 実際の注文の配送先住所を直す ```text 場所: アプリの左メニュー「CSV」 > 画面上部のタブ「注文一覧」 手順: 1. 住所を確認したい注文を選ぶ 2. 表の上の「住所チェック」を押す 3. モーダル「住所チェック」の「① 対象の行をチェック」で、直したい行にチェックがあることを確認する (「自動修正できる注文」の行は最初からチェック済み)。内容を確認・修正したい行は「編集」を押して詳細を開き、入力欄を直す (提案がある場合は初期値に入っている)。「要確認」の行は、提案が無いので、手で直す 4. 画面下の「② 適用する」の「注文の住所を修正 (N)」を押す。操作バーが確認に置き換わる 5. 「N 件の注文の配送先住所を書き換えます。取り消せません。」と、対象の注文ごとの変更 (元 → 変更後) を確認して、「N 件の注文の住所を修正する」を押す (やめるときは「キャンセル」) 6. 適用した行は、「修正済みの注文」へ移る。「閉じる」でモーダルを閉じ、通常どおりテンプレートの「出力」で CSV を出力する 結果: Shopify の注文の配送先が、1 件ずつ書き換わる。CSV にも新しい住所が入る。注文のタイムラインに、アプリが配送先住所を更新した旨と、項目ごとの変更前後が残る 注意: 取り消せない。間違えて更新した場合は、Shopify の注文のタイムラインで変更前の値を確認して、Shopify の管理画面で注文の配送先を手で直す。顧客への通知メールの有無は確認していない (断定しない) ``` ## PROC-AC2 変更前の住所を確認する ```text 場所: Shopify の管理画面 > 注文 > 対象の注文の詳細 > 「タイムライン」 手順: 「(アプリ名) がこの注文の配送先住所を更新しました。」の行を開く 結果: 項目ごとに「変更前 から 変更後 に更新」が出る (例: 「Address1 / 五色山から五色山22-1に更新」) 注意: このアプリの画面には、変更前後の値は残らない (履歴は日時・方式・項目名だけ) ``` ## QA - **Q: 住所チェックはどこにあるか。** A: アプリの左メニュー「CSV」のタブ「注文一覧」で注文を選ぶと、表の上に「住所チェック」が出る。何も選んでいないと出ない (AC-1)。Pro プランの CSV 画面の機能。 - **Q: 郵便番号が間違っているか調べられるか。** A: 調べられない。郵便番号が実在するか、都道府県・市区町村と合っているかは確認していない (AC-6)。Shopify の住所の判定も日本の郵便番号は見ない。 - **Q: 「Shopify 検知」の行は、どこが問題か分からない。** A: Shopify の判定は、問題の項目を特定しない (AC-7)。「要確認:Shopify が住所の問題を検知」のセクションに出る。詳細を開いて、住所全体を見直す。提案も出ない (AC-8)。 - **Q: 「要確認」のセクションの行は、なぜ自動で直らないのか。** A: 検知はできても、正しい値までは分からないため (例: 電話番号の桁数不足)。手で直して適用する (AC-3, AC-8)。 - **Q: 修正した値は Shopify の注文に反映されるか。** A: 反映される。適用すると Shopify の注文の配送先住所そのものが書き換わる (AC-12)。 - **Q: 注文は変えずに、CSV の住所だけ直したい。** A: できない。以前あった「CSV 出力用の住所だけ修正」は無く、注文の配送先住所を直すだけ (AC-19)。注文を変えたくないときは、このアプリでは直せない。 - **Q: 「注文の住所を修正」を間違えて押した。** A: 取り消せない。Shopify の注文のタイムラインで変更前の値を確認し、Shopify の管理画面で注文の配送先を手で直してもらう (AC-14, PROC-AC2)。 - **Q: 修正前の値を知りたい。** A: Shopify の注文のタイムラインに残っている (PROC-AC2)。このアプリの「変更履歴」には、日時・方式・項目名だけで、値は無い (AC-15)。 - **Q: 元に戻したい。** A: 「元に戻す」は無い。上の「間違えて押した」と同じ (AC-14)。 - **Q: 全部の行にチェックを入れないと適用されないか。** A: 「自動修正できる注文」の行は、最初からチェックされている。そのまま「注文の住所を修正」を押して確認すれば、全件に効く。チェックを外した行は適用されない (AC-10)。 - **Q: 変更のない行にチェックを入れたら、適用の件数が増えない。** A: 適用の対象は、未適用で変更のある行だけ。「N 件選択中 (うち適用できる変更 M 件)」と出る (AC-10)。 - **Q: 一部の注文だけ「適用に失敗」になった。** A: 失敗した行は、詳細が開いて理由が出る。チェックは残っているので、原因 (権限・通信など) を確認して、もう一度適用すると、その行だけ再実行される (AC-13)。理由が分からないときは ESCALATE。 - **Q: 適用した注文が、また「要確認」に出る。** A: 出ない。このアプリで直した注文は「修正済みの注文」に入り、再び検知されても戻らない (AC-3)。ただし Shopify の判定は注文時点のものなので、Shopify の管理画面では検知のままのことがある (AC-7)。 - **Q: 個人情報はどこに保存されるか。** A: 「CC 配送日時指定」のサーバーにも、注文のメタフィールドにも、氏名・住所・電話は保存しない。注文のメタフィールドには、修正した日時・方式・項目名だけが残る。変更前後の値は、Shopify の注文のタイムラインに残る (AC-17)。 - **Q: アンインストールしたらどうなるか。** A: アプリ専用のメタフィールド (履歴) は、Shopify により削除される (AC-17)。あわせて、アプリのサーバーに保存していたその店の設定と CSV の出力履歴も、アンインストールの通知を受けて削除される。再インストールしても元には戻らず、初期状態から設定し直す (065 の B-7)。注文に書き込み済みのタグ・メモ・メタフィールドは注文側に残る。削除されるまでの時間は案内しない。 - **Q: 顧客から個人データの削除依頼があった。** A: 住所チェックは氏名・住所・電話を保存していないので、このアプリが消すものは無い (AC-17)。断定が必要なときは ESCALATE。 - **Q: 提案が出ない。** A: 「電話: 桁数不足・超過」「欄ズレ: …」「Shopify 検知」は提案が出ない。手で直す (AC-8)。 - **Q: 全部の注文を自動でチェックしてほしい。** A: できない。選んだ注文だけが対象 (AC-2)。 ## ESCALATE | 状況 | 依頼する情報 | | --- | --- | | 「注文の住所を修正」で意図しない住所になった | 注文番号、実行した日時、Shopify の注文のタイムライン (変更前後)、「変更履歴」の内容 | | 「適用」でエラーが出る・「修正済みの注文」へ移らない・「適用に失敗」が続く | 注文番号、行の詳細に出たエラーの文言 | | 「修正済み」に入らない・履歴が見えない | 注文番号、注文を再取得したか | | 個人情報の削除依頼・アンインストール後のデータの扱いを聞かれた | 依頼の内容 (顧客・注文番号)。断定せず「CC 配送日時指定」の開発元への問い合わせを案内する | ## SEE - [Pro: 注文CSV出力の基本](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/090/csv-basics/) - [料金・プラン・導入前の質問](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/065/plans-and-pre-sale/) - [できないこと・他アプリとの併用](https://capital-castle.eastazy.com/cc-delivery-date-time/ai/085/limits-and-other-apps/)