結論:熨斗を商品行にしない

  • 送り状CSVが崩れる原因は、熨斗が「商品行」として注文に入っていることです。
  • 熨斗は「注文の属性」であって「商品」ではありません。属性として持てば、品名にも個数にも出ません。
  • 無料の熨斗は行を作らず、有料の熨斗は配送不要の料金商品をタグで分けて、CSVを出す前に除外します。

以下、症状・原因・送り状ソフトへの波及・設計・実装の順に説明します。

症状:送り状CSVで実際に起きること

要約:熨斗の行が、品名と個数の両方に混ざります。

テーマで熨斗を自作した場合も、一般的な熨斗アプリを入れた場合も、熨斗が商品行になっていると次の4つが起きます。

  • 品名に熨斗が並ぶ:送り状の品名欄に「熨斗(御歳暮)」が商品と同じ顔で出る。
  • 出荷個数が増える:熨斗の数量が足され、箱は1つなのに個数や個口が増える。
  • 倉庫で伝票と中身が合わない:ピッキングリストに実在しない「商品」があり、突き合わせが1件ずつ発生する。
  • CSVを毎回手で編集している:取込前に熨斗の行を消す作業が定着し、消し忘れがそのまま伝票に載る。

図解1:CSVのビフォーアフター

注文内容:焼菓子詰合せ 3個(1箱にまとめる)+熨斗(御歳暮)

行 品名 数量 送り状に出る内容
崩れる設計 1 焼菓子詰合せ 3 品名:焼菓子詰合せ/熨斗(御歳暮)
2 熨斗(御歳暮) 3 個数:熨斗の分だけ増える
正しい設計 1 焼菓子詰合せ 3 品名:焼菓子詰合せ
— (熨斗は行にしない) — 個数:商品の分だけ

正しい設計でも熨斗の情報は消えません。置き場所が商品行から属性に変わるだけです。

原因:Shopifyの構造が「ダミー商品」を誘う

要約:propertiesは価格を持てないので、有料にした瞬間に商品行が増えます。

  1. テーマの properties(line item properties)で、熨斗の選択欄は作れます。
  2. ただし properties は価格を持てません。「熨斗1枚200円」を取りたくなった時点で詰まります。
  3. そこで「熨斗」というダミー商品を作り、カートに一緒に入れる実装になります。
  4. ダミー商品は注文上は普通の商品行なので、注文CSVにも送り状CSVにも1行として載ります。

悪いのは運用ではなく、熨斗を商品として表現したデータ設計です。手作業で行を消し続けても、原因は残ります。

送り状ソフト別:どの列に波及するか

要約:ソフトは違っても、汚れるのは「品名」と「個数」の列です。

送り状ソフト 運営 品名の列 熨斗の行が混ざると
B2クラウド ヤマト運輸 品名1 品名に熨斗が入り、中身とずれる。出荷個数が増える
e飛伝(Ⅱ/Ⅲ) 佐川急便 品名 同上。個口が増える
ゆうパックプリントR 日本郵便 品名(明細) 明細に熨斗が1行として並ぶ

いずれのCSVも、品名のほかに出荷個数や記事名などの列を持ちます。取込レイアウトは各社で設定しているはずなので、自社のマッピングで「品名」「個数」に何を流しているかを最初に確認してください。熨斗の有無を伝票に残したい場合は、品名ではなく記事名の列に送るほうが、中身とのずれが起きません。

正しい設計:4つの原則とデータの置き場所

要約:熨斗の中身は属性に、料金だけを分離可能な行にします。

  1. 無料の熨斗は商品行を作らない。 選択内容は properties だけで持つ。

  2. 有料の熨斗は「配送不要の料金商品」にする。 requires_shipping: false の商品に専用タグ(noshi-fee)を付け、通常商品と機械的に見分けられるようにする。

  3. 熨斗の中身は line item properties に、要約は注文メタフィールドに置く。 どの商品に掛けるかは行に、注文全体の一覧はメタフィールドに。

  4. 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件まで無料。