【重要】PHPの脆弱性(CVE-2026-109618、CVE-2026-109619)について:当社のアプリへの影響はありません【重要】PHP脆弱性について、当社アプリへの影響はありません
アプリを探す
EC運営

Shopifyの明細表(明細書)をカスタマイズする方法。テンプレート編集と使える変数

公開 更新 文: RUFFLOG APPS編集部

Shopifyの明細表テンプレートを編集する手順と、公式リファレンスに載っている変数の一覧、ロゴ・住所・日付・メモのコード例をまとめました。既定の明細表には金額がありませんが、書類を足せば金額も出せます。その出し方も載せています。

Shopifyの明細表(packing slip。「明細書」「納品書」と呼ばれることもあります)は、管理画面の「設定」>「配送と配達」>「書類」にある「明細表」から編集できます。中身はHTMLとLiquidで書かれたテンプレートで、ロゴの追加、住所の書き換え、日付の書式、注文メモの表示まではここで完結します。

ただし、既定の明細表には、金額の変数がありません。既定の明細表が使うループ line_items_in_shipment に商品価格がないためです。商品価格・合計金額を印字したい場合は、注文全体の商品を並べる order.line_items を使う書類を足します。この記事では、明細表テンプレートの編集手順、使える変数、そのまま貼れるコード例、金額を出す方法の順に書きます。

明細表の印刷のしかたや、そもそも納品書を同梱するかどうかの判断はShopifyで納品書を作成・同梱する方法にまとめてあります。ここではテンプレートの書き換えだけを扱います。

明細表テンプレートの開き方と、元に戻す方法

テンプレートの編集画面は、公式ヘルプでは次の場所と説明されています。

  1. 「設定」>「配送と配達」に移動する — Shopify管理画面から開きます
  2. 「明細表」をクリックする — 「書類」セクションにあります

以降は編集したい内容によって手順が分かれます(次の節以降で、公式ヘルプの手順のとおりに書きます)。どの手順も最後は「テンプレートをプレビュー」で確認して「保存」する流れです。

書き換えに失敗した場合は、同じ画面の「デフォルトに戻す」をクリックすると標準のテンプレートに戻せます。ただし自分の変更もすべて消えるので、編集を始める前にテンプレートのコードを全部コピーしてテキストファイルに保存しておくと安心です(これは公式手順ではなく、当サイトの運用上のおすすめです)。

明細表のテンプレートで使える変数一覧

明細表で使える変数は、公式の「明細表の変数リファレンス」に載っているものだけです。テーマ(オンラインストア)のLiquidで使えるオブジェクトがすべて使えるわけではありません。リファレンスに載っている変数を分類すると次のとおりです。

分類変数中身
ストアshop.name / shop.email / shop.domainストア名、メールアドレス、ドメイン
ストアの住所shop_address.zip / province / city / address1 / address2 / company / country / summary など「配送と配達」の発送元の住所。summary は住所全体
注文order.name / order.order_number / order.note / order.created_at接頭辞付きの注文番号(例 #1004)、数字だけの注文番号、注文メモ、注文日時
お客様customer.name / first_name / last_name / emailお客様の氏名とメールアドレス
配送先・請求先shipping_address.* / billing_address.*郵便番号・都道府県・市区町村・住所1/2・氏名・電話番号・会社名・国・summary
荷物の商品line_items_in_shipmentこの荷物に入る商品のリスト。line_item としてループで回す
商品ごとline_item.title / variant_title / sku / vendor / image / quantity / shipping_quantity / properties / groups商品名、バリエーション名、SKU、販売元、画像、注文全体の数量、この荷物での数量、商品のプロパティ、バンドルやアドオンのグループ
荷物の範囲includes_all_line_items_in_order注文の全商品がこの荷物に入っていれば true

日付は order.created_at に date フィルターをかけて書式を変えます。印刷した日時は、リファレンスの例にあるとおり "now" に date フィルターをかけて出せます。

既定の明細表には、価格・小計・送料・合計・税額・決済方法・支払い状況の変数がありません。ループ(line_items_in_shipment)の中に商品価格がないためです。「明細書に金額を表示したい」は、既定の明細表のままでは実現できません。金額を出す方法は後の節で説明します。

よくあるカスタマイズのコード例

使っている変数はすべて上の公式リストにあるものです。貼る場所はテンプレートによって違うので、既存のコードで似た情報を出している箇所の近くに置き、「テンプレートをプレビュー」で確認してから保存します。

日付を日本式にする。 date フィルターはRubyのstrftimeと同じ書式を受け付けます。%-m と %-d は先頭のゼロを付けない指定です。

注文日:{{ order.created_at | date: "%Y年%-m月%-d日" }}
発行日:{{ "now" | date: "%Y年%-m月%-d日" }}

お届け先を日本の住所の順に並べる。 summary は1行にまとめた住所なので、郵便番号から始まる日本の並びにしたい場合は個別の変数で組みます。都道府県などが実際にどう表記されるかは、自店の注文でプレビューして確かめてください。

〒{{ shipping_address.zip }}<br>
{{ shipping_address.province }}{{ shipping_address.city }}{{ shipping_address.address1 }}<br>
{% if shipping_address.address2 != blank %}{{ shipping_address.address2 }}<br>{% endif %}
{{ shipping_address.last_name }} {{ shipping_address.first_name }} 様

注文メモを載せる。 メモがない注文で空の見出しだけが出ないよう、!= blank で囲みます。注文メモにスタッフ向けの連絡を書く運用の店では、同梱書類に出してよいかを先に決めておいてください。

{% if order.note != blank %}
  <p>備考:{{ order.note }}</p>
{% endif %}

分割発送であることを知らせる。 1つの注文を複数の荷物に分けて送るとき、明細表は荷物ごとに印刷できます。残りが後から届くことを書いておくと、「1点足りない」という問い合わせを減らせます。

{% unless includes_all_line_items_in_order %}
  <p>ご注文の商品の一部は、別便でお届けします。</p>
{% endunless %}

あわせて、商品の行で {{ line_item.shipping_quantity }} / {{ line_item.quantity }} と書けば「今回の数量 / 注文数量」の形で出せます。

見出しを「納品書」にする。 テンプレート内で見出しを出している文字列を探して、「納品書」に書き換えます。変数ではなくただの文字なので、書き換えるだけで反映されます。

ロゴの追加と店舗住所の書き換え(公式手順)

ロゴと住所は、公式ヘルプに手順があります。手順の数もそのまま載せます。

ロゴは、先に管理画面にアップロードしておきます。

  1. 「コンテンツ」>「ファイル」に移動する
  2. 「ファイルをアップロード」をクリックする
  3. ロゴを選んでアップロードする
  4. ファイル名を控える — .png や .jpg などの拡張子まで含めて控えます

ストア名をロゴに置き換える場合は、続けて次の7手順です。

  1. 「設定」>「配送と配達」に移動する
  2. 「書類」セクションで「明細表」をクリックする
  3. ストア名を出しているコードを探す — <p class="to-uppercase"> の中に {{ shop.name }} がある箇所です
  4. そのコードを選択して削除する
  5. 空いた場所にロゴのコードを書く — {{ 'shop_logo.png' | file_img_url: 'small' | img_tag: 'Logo' }} の shop_logo.png を控えたファイル名に置き換えます
  6. 「テンプレートをプレビュー」で確認する
  7. 「保存」をクリックする

公式ヘルプには、ストア名を残したままその上にロゴを置く方法(6手順)と、ストア名の横に並べる方法(9手順。CSSの追記を含む)も載っています。

明細表の住所だけを変える場合(たとえば発送元と別の返品先を載せたい場合)は次の7手順です。ストアの住所そのものを変えたいなら、明細表ではなく「設定」>「一般」でストア情報を編集します。

  1. 「設定」>「配送と配達」に移動する
  2. 「書類」セクションで「明細表」をクリックする
  3. {{ shop_address.summary }} を探す — 見つからない場合は {{ shop_address.address1 }} などの個別の住所変数を探します
  4. そのコードを選択して削除する
  5. 空いた場所に、明細表に載せたい住所を直接入力する
  6. 「テンプレートをプレビュー」で確認する
  7. 「保存」をクリックする

商品画像を消したい場合も同じ流れ(6手順)で、{% if line_item.image != blank %} から {% endif %} までのブロックを削除します。

画像とCSSには制限があります。生成されるPDFに表示される画像は、cdn.shopify.com で配信されているもの(Shopifyの「ファイル」にアップロードした画像や商品画像)だけで、ほかのサイトの画像やdata URIの画像は表示されません。日本語は明朝体を指定してもゴシック体で表示されます。自前のCSSファイルを読み込みたい場合も、「コンテンツ」>「ファイル」にアップロードしてそのURLを <link> で読み込みます。Shopifyの外に置いたCSSは正しく表示されません。

金額を出したいときは、別の書類を足す

既定の明細表は、その出荷に含まれる商品を並べる line_items_in_shipment で作られており、このループの中には商品価格の変数がありません。ただし、金額が出せないわけではありません。「設定」>「配送と配達」>「書類」の「ドキュメントを作成」から請求書や空白のテンプレートを元に新しい書類を足し、注文全体の商品を並べる order.line_items でループすれば、商品の単価と行の金額を出せます。アプリのインストールも費用も要りません。「書類」は早期アクセス機能として順次提供されているため、自店の管理画面にまだ「書類」が表示されないことがあります。その場合は、Shopify Order Printerを入れられるストアなら入れる方法(テンプレートのLiquid変数は「書類」と共通です)か、領収書・請求書アプリを使う方法があります(比較はShopify領収書・納品書アプリ比較10選)。

ただし、order.line_items は注文全体の商品を並べるため、分割発送では、その荷物に入っていない商品も出ます。荷物ごとの明細表には価格のない line_items_in_shipment を使い、金額入りの書類は請求書・領収書のように注文全体を示す書類として使ってください。

出したいもの変数
商品の単価・行の金額(割引後)line_item.final_price / line_item.final_line_price
小計・送料・合計order.subtotal_price / order.shipping_price / order.total_price
消費税order.tax_price / order.tax_lines

金額には money フィルターをかけます。final_line_price に反映されるのは商品ごとの割引だけで、注文全体にかかる割引は含まれません。注文全体の割引は別の行で示す必要があり、行の金額を足しても小計と合わない場合があります(割引額の合計は order.total_discounts、商品ごとの割引は line_item.line_level_discount_allocations で確認できます)。

{% for line_item in order.line_items %}
  {{ line_item.title }} × {{ line_item.quantity }}:{{ line_item.final_line_price | money }}<br>
{% endfor %}
小計:{{ order.subtotal_price | money }}<br>
送料:{{ order.shipping_price | money }}<br>
消費税:{{ order.tax_price | money }}<br>
合計:{{ order.total_price | money }}

支払い方法の変数は、この記事では確認できていません。支払い方法まで印字したい場合は、自店の注文でプレビューして出力を確かめてから使ってください。

日本の体裁(登録番号、税率ごとの内訳、ロゴ)の書類を作るなら、無料のShopify書類メーカーで作ったコードを「ドキュメントを作成」>「空白のテンプレート」に貼る方法もあります。

印刷は、注文画面の「その他の操作」>「複数のドキュメントを印刷」で書類にチェックを入れ、「印刷に進む」を押すと、ShopifyがPDFを生成します。金額入りの書類を常用すると、ギフトの荷物に金額が入る事故が起こりえます。そのあたりの判断は納品書の同梱の判断軸に書いています。

領収書・請求書が欲しい場合

金額入りの書類が要る理由が「領収書を求められた」なら、明細表の改造より先に、誰にどの書類を出すかを決めたほうが早く済みます。発行手段の選び方はShopifyで領収書を発行する方法まとめ、有料の帳票アプリとの違いはOrder Printer Proと領収書(UnByte製)の比較にあります。

あわせて読みたい

参照元

手順と変数は、次のShopify公式ヘルプ(英語版・日本語版)と開発者ドキュメントを2026年10月8日に確認したものです。

RUFFLOG APPS編集部

株式会社RUFFLOG ECアプリ事業部

自社でアパレルECを運営する株式会社RUFFLOGのShopifyアプリ開発チームです。自社ストアの運用で実際に困ったことを、そのままアプリと記事にしています。