Documentation v1.3

Core Cart Forms 利用ガイド

フリガナ強制・住所補完・インボイス照合・配送日時指定・ギフト設定などをカート画面で一括管理し、配送エラーと CS 工数を最小化します。Thank you ページや注文履歴画面への App Block 拡張、スタッフ向け注文編集フォームも含めた完全ガイドです。

クイックスタート

1. インストール & 有効化

Shopify App Store からアプリを追加し、テーマエディタの App Embeds でトグルを ON にします。

2. バリデーション設定

フリガナ、住所補完、インボイス判定、配送日時など必要な機能をダッシュボードで有効化。

3. チェックアウト保護開始

不備がある入力はチェックアウトボタンを自動ロック。完全な注文データのみ受け付けます。

Theme App Extension (App Embeds) による埋め込み

テーマの Liquid ファイルを直接編集することなく動作します。テーマを切り替えても設定は維持され、アプリ削除時のゴミコードも残りません。

有効化手順: Shopify 管理画面 → オンラインストア → テーマ → カスタマイズ → アプリの埋め込み(App Embeds) → 「Core Cart Forms」トグルを ON にして保存。

データの保存先(note_attributes)

カートで収集した全ての入力値(フリガナ・配送日時・インボイス番号・ギフト設定など)は、Shopify の order.note_attributes に保存されます。order.note(スタッフメモ欄)とは完全に別のフィールドで互いに干渉しません。

// order.note_attributes の例
"フリガナ": "ヤマダ タロウ"
"配送希望日": "2026-07-01"
"配送希望時間帯": "午前中"
"インボイス番号": "T1234567890123"
"ギフト贈り主": "山田 花子"
"tos_agreed_at": "2026-06-10T12:34:56.789Z"
Shopify 標準の管理画面では note_attributes は閲覧のみで直接編集できません。編集はアプリ内の「スタッフ向け注文編集フォーム」を使用してください。

フリガナ強制 & 住所自動補完

ヤマト B2 クラウド・佐川 e-飛伝・日本郵便 Web 管理などの配送管理ソフトは全角カタカナを必須とします。カート画面で検証し、配送伝票エラーをゼロにします。

フリガナ全角カタカナ強制

入力中にひらがなを全角カタカナへリアルタイム変換。不正文字が残る場合はチェックアウトをブロック。

郵便番号で住所自動入力

zipcloud API 連携で7桁入力時に都道府県・市区町村を即時補完。モバイルでの入力ミスを大幅削減。

番地・部屋番号抜け検知

住所文字列に数字が含まれない場合にインライン警告を表示してチェックアウトをブロック。

国税庁 API 連携によるインボイス番号照合

適格請求書発行事業者公表システムの公式 API とリアルタイムで通信し、入力された登録番号(T + 13桁)が実在・有効かをカート段階で検証します。架空・廃止番号での注文をその場でブロックします。

Growth プラン以上で利用可能。 バックオフィスでの手動照合作業がゼロになり、B2B 取引の仕入税額控除に必要なエビデンスを注文時点で自動確保します。

利用規約同意 & 年齢確認ゲート

特商法・電子契約法への対応として、規約への明示的同意チェックボックスをカート内で必須化できます。また酒類・タバコなど年齢制限商品の販売時に年齢確認チェックを強制することも可能です。

同意タイムスタンプの保存

利用規約・年齢確認への同意日時(ISO 8601 形式)を tos_agreed_at / age_agreed_at キーで note_attributes に自動保存。法的エビデンスとして機能します。

リンク・カスタムテキスト対応

「利用規約」テキストに規約ページへのリンクを設定可能。同意文言もダッシュボードから自由に編集できます。

配送日時指定・置き配オプション

ヤマト運輸・佐川急便・日本郵便の公式時間帯区分に対応した日時指定 UI を表示。倉庫リードタイム・休業日カレンダー・最長受付日数を設定して表示日程を動的に制御します。

リードタイム制御

deliveryLeadDays / deliveryMaxDays / deliveryExcludeDays の3パラメータで表示可能な最短〜最長日を動的計算。

休業日カレンダー

年末年始・お盆・特定休業日(YYYY-MM-DD 形式)を1行ずつ登録するとカレンダーから自動除外。

置き配希望の収集

玄関前・宅配ボックス・ガレージなど配送業者へ伝える置き配場所を選択させ note_attributes に保存。

配送業者プリセット

ヤマト / 佐川 / 日本郵便 / カスタムの4プリセットを切替可能。時間帯の表示テキストが自動適用されます。

緊急カートブロック

台風・大雪などの災害時や棚卸し期間中に、ストアの閲覧は維持したままカートの注文受付だけを一時的に停止できます。ストアを非公開(パスワード保護)にする必要がなくなります。

管理画面でワンクリック

ダッシュボードの「緊急停止」スイッチを ON にするだけで即時反映。

カスタム通知バナー

バナーのタイトルと本文を自由に設定。「大雪の影響で配送停止中」など状況に合わせたメッセージを表示。

チェックアウトボタンを強制ロック

カートフォーム全体を非表示にしてチェックアウトへの進行を完全にブロックします。

App BlockFree〜

Thank you ページ — 入力値サマリー App Block

注文完了(Thank you / Order Status)ページに、カートで入力した配送日時・フリガナ・ギフト設定などを確認サマリーとして表示します。「ちゃんと入力できていたか不安」による問い合わせを大幅に削減します。

Thank you ページ表示イメージ
📋 ご注文内容の確認
お名前(フリガナ)ヤマダ タロウ
配送希望日2026年7月1日(水)
配送希望時間帯午前中
ギフト贈り主山田 花子
のしメッセージお誕生日おめでとう!

有効化手順

  1. テーマカスタマイザーを開く
  2. 「注文ステータスページ」を選択
  3. 「セクションを追加」→「Core Cart Forms — Order Summary」
  4. 保存して完了

表示される項目

アプリが収集したすべての note_attributes キーを自動検出し、見やすいテーブル形式で表示します。設定していない機能の行は自動で非表示になります。

App BlockStarter〜

注文履歴ページ App Block(カスタマーアカウント)

顧客のアカウントページ(注文履歴)にアプリが収集した情報を表示します。顧客が過去の注文の配送日指定やギフト設定などを確認できるようになります。

旧 Customer Account(Liquid テーマ)

テーマカスタマイザーの「注文詳細」テンプレートに App Block を追加します。

  1. テーマカスタマイザー → 注文詳細ページ
  2. 「セクションを追加」→ Core Cart Forms — Cart Data
  3. 保存

新 Customer Account(Headless)

新しいカスタマーアカウント(Customer Accounts Extensibility)では、アプリが customer-account.order-status.block.render ターゲットで注文詳細に App Block を追加します。

設定不要で自動表示されます

表示される情報の例

フリガナ配送希望日・時間帯置き配希望ギフト設定のしメッセージインボイス番号(末尾マスク)流入経路アンケート
管理画面Growth〜

スタッフ向け注文編集フォーム

Shopify 標準の管理画面では note_attributes を直接編集できません。本機能はアプリ管理画面に専用の編集 UI を提供し、Admin API 経由でリアルタイムに注文データへ反映します。

配送日の変更対応

「翌日に変更したい」という電話受付をスタッフが即座に修正。発送処理前の注文なら1分で完了。

フリガナの誤入力修正

確認メール送付前にスタッフが直接正しいフリガナに修正できます。

インボイス番号の訂正

経理担当者からの修正依頼をスタッフが代理で対応。注文をキャンセルせずに修正可能。

ギフトメッセージ修正

誤字やカスタマイズ依頼をスタッフが対応。顧客への印象が改善します。

アクセス方法

  1. Shopify 管理画面 → アプリ → Core Cart Forms を開く
  2. 左メニュー「注文管理」→ 対象の注文を検索・選択
  3. アプリが収集した note_attributes キーが編集フォームとして表示される
  4. 修正内容を入力して「保存」→ Admin API で即時反映

送料無料プログレスバー

「あと ¥1,500 で送料無料!」のように送料無料ラインまでの残金をプログレスバーで可視化し、まとめ買い(AOV 向上)を促します。カート金額変更のたびにリアルタイム更新されます。

設定項目
✓ 送料無料ライン金額(例: ¥5,000)
✓ 未達成時のメッセージ(変数: {{remaining}})
✓ 達成時のメッセージ
✓ バーのカラー

カゴ落ち防止ポップアップ(Exit Intent)

カートページからの離脱を検知した瞬間(PC: カーソルがビューポート上端へ移動 / SP: 50px 以上の上スクロール)にクーポンやメッセージを表示して最後の購入を後押しします。

PC・スマホ両対応

マウス離脱検知(PC)と上スクロール検知(SP)を自動切替。

1セッション1回のみ表示

sessionStorage フラグで同一セッション内での重複表示を防止。

クーポンコード表示

管理画面でクーポンコードを設定するとポップアップ内に自動表示。

クーポンコード早期適用

Shopify 標準ではクーポン入力はチェックアウト画面のみですが、本機能でカート段階でクーポンを適用した後の価格を確認させます。「クーポンが使えないかも」という不安によるカゴ落ちを防ぎます。

Growth〜

ギフト・のし・贈答オプション

百貨店や食品 EC など贈答需要が高い店舗向けに、のし・ラッピング・メッセージカードの設定をカートで収集します。のし名入れのリアルタイムプレビュー機能も搭載しています。

のし表書きの選択

「お誕生日」「御結婚御祝」「粗品」など表書き種類をプリセットから選択。カスタム追加も可能。

名入れリアルタイムプレビュー

贈り主名を入力するとのし紙(SVG)に名前がリアルタイム描画され、仕上がりを確認できます。

ラッピング希望の収集

袋・箱・リボンなどラッピング種別を選択させ、note_attributes に保存します。

メッセージカード

最大文字数の設定付きテキストエリアで贈り先へのメッセージを収集します。

Growth〜

B2B 専用フィールド & インボイス対応

法人購買では発注番号・部署名・担当者名など Shopify 標準フィールドでは不足する情報が必要になります。インボイス照合と組み合わせることで B2B 取引の受注フローを完結させます。

会社名フィールド

Shopify 標準のフィールドと連動し、配送先に法人名を明記。

部署名・担当者名

法人請求書・配送ラベルに部署名や担当者名を記載するための専用フィールド。

発注番号(PO番号)

経理処理・請求書突き合わせに必要な発注書番号を注文時に取得。

利用目的選択

研究用・業務用など税務・輸出規制対応が必要な商材での目的記録。

解決しない場合は?

テクニカルチームがあなたのストアのカート最適化をサポートします。