結論:熨斗を商品行にしない
- 送り状CSVが崩れる原因は、熨斗が「商品行」として注文に入っていることです。
- 熨斗は「注文の属性」であって「商品」ではありません。属性として持てば、品名にも個数にも出ません。
- 無料の熨斗は行を作らず、有料の熨斗は配送不要の料金商品をタグで分けて、CSVを出す前に除外します。
以下、症状・原因・送り状ソフトへの波及・設計・実装の順に説明します。
症状:送り状CSVで実際に起きること
要約:熨斗の行が、品名と個数の両方に混ざります。
テーマで熨斗を自作した場合も、一般的な熨斗アプリを入れた場合も、熨斗が商品行になっていると次の4つが起きます。
- 品名に熨斗が並ぶ:送り状の品名欄に「熨斗(御歳暮)」が商品と同じ顔で出る。
- 出荷個数が増える:熨斗の数量が足され、箱は1つなのに個数や個口が増える。
- 倉庫で伝票と中身が合わない:ピッキングリストに実在しない「商品」があり、突き合わせが1件ずつ発生する。
- CSVを毎回手で編集している:取込前に熨斗の行を消す作業が定着し、消し忘れがそのまま伝票に載る。
図解1:CSVのビフォーアフター
注文内容:焼菓子詰合せ 3個(1箱にまとめる)+熨斗(御歳暮)
| 行 | 品名 | 数量 | 送り状に出る内容 | |
|---|---|---|---|---|
| 崩れる設計 | 1 | 焼菓子詰合せ | 3 | 品名:焼菓子詰合せ/熨斗(御歳暮) |
| 2 | 熨斗(御歳暮) | 3 | 個数:熨斗の分だけ増える | |
| 正しい設計 | 1 | 焼菓子詰合せ | 3 | 品名:焼菓子詰合せ |
| — | (熨斗は行にしない) | — | 個数:商品の分だけ |
正しい設計でも熨斗の情報は消えません。置き場所が商品行から属性に変わるだけです。
原因:Shopifyの構造が「ダミー商品」を誘う
要約:propertiesは価格を持てないので、有料にした瞬間に商品行が増えます。
- テーマの
properties(line item properties)で、熨斗の選択欄は作れます。 - ただし properties は価格を持てません。「熨斗1枚200円」を取りたくなった時点で詰まります。
- そこで「熨斗」というダミー商品を作り、カートに一緒に入れる実装になります。
- ダミー商品は注文上は普通の商品行なので、注文CSVにも送り状CSVにも1行として載ります。
悪いのは運用ではなく、熨斗を商品として表現したデータ設計です。手作業で行を消し続けても、原因は残ります。
送り状ソフト別:どの列に波及するか
要約:ソフトは違っても、汚れるのは「品名」と「個数」の列です。
| 送り状ソフト | 運営 | 品名の列 | 熨斗の行が混ざると |
|---|---|---|---|
| B2クラウド | ヤマト運輸 | 品名1 | 品名に熨斗が入り、中身とずれる。出荷個数が増える |
| e飛伝(Ⅱ/Ⅲ) | 佐川急便 | 品名 | 同上。個口が増える |
| ゆうパックプリントR | 日本郵便 | 品名(明細) | 明細に熨斗が1行として並ぶ |
いずれのCSVも、品名のほかに出荷個数や記事名などの列を持ちます。取込レイアウトは各社で設定しているはずなので、自社のマッピングで「品名」「個数」に何を流しているかを最初に確認してください。熨斗の有無を伝票に残したい場合は、品名ではなく記事名の列に送るほうが、中身とのずれが起きません。
正しい設計:4つの原則とデータの置き場所
要約:熨斗の中身は属性に、料金だけを分離可能な行にします。
無料の熨斗は商品行を作らない。 選択内容は properties だけで持つ。
有料の熨斗は「配送不要の料金商品」にする。
requires_shipping: falseの商品に専用タグ(noshi-fee)を付け、通常商品と機械的に見分けられるようにする。熨斗の中身は line item properties に、要約は注文メタフィールドに置く。 どの商品に掛けるかは行に、注文全体の一覧はメタフィールドに。
cart attributes は使わない。 Shop Pay などの高速チェックアウトを妨げるためです。
| 置き場所 | 何を置くか | 例 |
|---|---|---|
| line item properties | 商品行ごとの熨斗の中身 | _noshi_type(用途)、_noshi_name(名入れ)、_noshi_qty(枚数) |
| order metafields | 注文単位の熨斗サマリ | 熨斗の合計枚数、印刷済みフラグ |
| product metafields | 商品ごとの前提 | 1箱あたりの最大個数(枚数計算の元) |
| 料金商品とタグ | 有料熨斗の料金だけ | 配送不要の商品+タグ noshi-fee |
図解2:処理フロー
商品ページ(用途・名入れ・枚数を選ぶ)
↓ properties[_noshi_*] をフォームに付ける
カート(熨斗は商品行の属性。有料なら料金商品が1行)
↓
チェックアウト(_始まりの項目は表示されない)
↓
注文Webhook(propertiesを読み、注文メタフィールドに要約を書く)
↓
熨斗一覧(管理画面)
├→ 熨斗紙PDF(propertiesの名入れをそのまま印刷)
└→ 送り状CSV(noshi-fee の行を除外して出力)
実装手順:明日から直す3か所
要約:付け方・見分け方・除外の3か所を直します。
1. 商品フォームに properties を付ける
商品フォームの中に入力欄を置きます。キーを _ で始めるのが要点です。
<select name="properties[_noshi_type]">
<option value="">熨斗なし</option>
<option value="御歳暮">御歳暮</option>
</select>
<input type="text" name="properties[_noshi_name]" maxlength="20">
<input type="hidden" name="properties[_noshi_qty]" value="1">
_ 始まりの properties は、チェックアウトには表示されず、管理画面の注文には表示されます。お客様に内部用のキーを見せずに、店舗側は行ごとに内容を確認できます。カート画面での表示はテーマの実装によるので、テーマ変更時に確認してください。
2. 料金商品をタグで見分ける
有料熨斗の料金商品には noshi-fee タグを付け、納品書やピッキングリストのテンプレートで読み飛ばします。
{% for line_item in order.line_items %}
{% if line_item.product.tags contains 'noshi-fee' %}{% continue %}{% endif %}
{{ line_item.title }} × {{ line_item.quantity }}
{% endfor %}
商品名で判定しないでください。「熨斗」を含む商品名は、のし付きセットなど通常商品にもあり得ます。
3. CSVを出す前にフィルタする
送り状CSVを自前で組み立てている場合は、行を書き出す直前に同じ判定を入れます。
const isNoshiFee = (li) => li.product?.tags?.includes('noshi-fee');
const rows = order.lineItems
.filter((li) => !isNoshiFee(li))
.map((li) => ({ 品名: li.title, 個数: li.quantity }));
出荷連携アプリでCSVを出している場合は、そのアプリに「タグによる除外」か「配送不要商品の除外」の設定があるかを確認します。設定がない場合に備えて、料金商品を配送不要にしておく意味があります。
チェックリスト(7項目)
要約:テスト注文を1件作り、CSVを開いて確かめます。
- 無料の熨斗を選んだ注文で、商品行が増えていない
- 有料熨斗の料金商品が「配送不要」になっている
- 料金商品に
noshi-feeタグが付いている - 熨斗の properties のキーがすべて
_で始まっている - cart attributes に熨斗の情報を書いていない
- 送り状CSVの品名・個数の列に、熨斗が入っていない
- 納品書・ピッキングリストに、熨斗が商品として出ていない
熨斗あり・熨斗なし・両方が混ざった注文の3パターンで確認すると、漏れが見つかりやすくなります。
まとめ
送り状CSVが崩れるのは、熨斗を商品として注文に入れているからです。熨斗の中身は _ 始まりの line item properties に、要約は注文メタフィールドに置き、料金だけを配送不要の料金商品として分ければ、品名にも個数にも熨斗は出ません。
のし帖(https://noshicho.jp)は、熨斗を商品行に混ぜず、無料は行を作らず、有料は配送不要の料金商品をタグで分離してCSVから除外します。月10件まで無料。