できないこと・他アプリとの併用・範囲外の質問

screens: 左メニュー「オプション」「連携(プロプラン)」/ 設定 → 入力テキスト
verified_from: テーマウィジェット (theme-develop) / チェックアウト拡張 (checkout-ui の shopify.extension.toml) / 人間向けFAQ / 実際の問い合わせ対応の返信
note: 「できません」と答えてよいのは L-* に書いたものだけ。他アプリの設定方法は案内しない (その製品のマニュアルを案内する)。

SUMMARY

「CC 配送日時指定」は、カート画面のウィジェットが、配送日時をカートの属性 (注文の「追加の詳細」) に書き込むアプリ。チェックアウトの内部・POS・他アプリの動作は制御しない。 他アプリとの連携は「注文の追加の詳細にあるキーと値を、相手が読む」形になる。相手が読めるかは相手のアプリの仕様で決まる。

RULES (できないこと)

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クラウド など) がその項目を取り込めるかは、連携先の仕様による。

RULES (他アプリとの併用)

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 だけでは注文の値にならない):

{% for attribute in order.attributes %}
  {% if attribute.first == "配送希望日" %}
    <p>{{ attribute | first }}</p>
    <p>{{ attribute | last }}</p>
  {% endif %}
{% endfor %}
{% for attribute in order.attributes %}
  {% if attribute.first == "配送希望時間" %}
    <p>{{ attribute | first }}</p>
    <p>{{ attribute | last }}</p>
  {% 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)。カートに入った商品に対して適用される。

ESCALATE

状況依頼する情報
他アプリを入れた後に、日時指定ができない商品でも指定できてしまう注文番号、注文の「追加の詳細」の値、カート内の商品、入っている他アプリ名
他アプリとの連携で値が取り込まれない連携先アプリ名、注文の「追加の詳細」のキーと値、連携先に設定したキー名
身に覚えのない配送日時が注文に入っている注文番号、注文日時、顧客がログインしていたか、前回の注文の有無、ブラウザ
範囲外の別アプリの質問(答えずに) 範囲外であることを伝え、開発元への問い合わせの文面を下書きする

SEE

インストール
テックブログ