1. ホーム
  2. 私たちについて
  3. Shopify app
  4. Shopifyブログ
  5. サービス
  6. お問い合わせ
About
Blog
Services
Contact
サムネイル

Shopify Order Discount API とは？実装方法まで徹底解説！

目次

はじめに

今回の記事では Shopify Functions の概要から具体的な Order Discount API の実装方法まで丁寧に解説していきます。

今回の記事でわかること

  • Shopify Functions の概要
  • Order Discount API の概要
  • Order Discount API の実装方法

今回の記事を読んで、柔軟なディスカウントを可能にする Order Discount API についてマスターしていきましょう！

Order Discount API とは

Order Discount API とは、Shopify Functions の機能の中の一つです。

Shopify Functions は、Shopify のバックエンドでカスタム処理を追加できる便利な機能です。これを使えば、配送や決済のカスタマイズ、さらにはディスカウント設定の調整も手軽に実施できます。

さらに、Shopify Functions はアプリの機能拡張としてストアに組み込まれます。そのため、 Shopify Functions を含むアプリをストアで見つけてインストールするか、あるいはオリジナルのカスタムアプリを作成し、直接ストアに追加することができます。

Shopify Functions の API の種類

Shopify Functions は、Order Discount API 以外にもさまざまな API が用意されており、各 API でカスタマイズできる処理が異なります。現在公開されている API の種類と概要の一覧を表にまとめてみました。

Function APIDescription
Delivery Customization API顧客に表示される配送オプションの名前変更、順序変更、並び替えが可能
Order Discount APIカート内の全ての商品に適用される割引を作成可能
Product Discount APIカート内の特定の商品または商品バリアントに適用される割引を作成可能
Shipping Discount API配送料に対して送料無料や割引などのロジックを作成可能
Payment Customization API決済方法の名前変更、順序変更、並び替えが可能
Cart TransForm APIカート内の商品を拡張し、カート内の商品の表示を更新可能
Cart and checkout validation APIカートとチェックアウトの独自のバリデーションを作成可能
Fulfillment ConstraintsShopify での注文処理のためのロジックを独自でカスタマイズ可能

Order Discount API アプリの作り方

ここからは実際に Order Discount API を使用したアプリの作成方法を解説していきます。

今回は合計の商品注文数が 10 個を超える場合に注文金額を 20%引きにするというディスカウントを作成していきます。

事前準備

アプリ開発を行う前の事前準備をしていきます。

開発ストアの作成

今回作成するアプリをインストールするストアを作成します。
開発ストアの作成画面

アプリ作成に必要なツールをインストール

Shopify Functions が組み込まれているアプリを開発するために以下のものが必要になるのでローカル PC にインストールしてください。

  • Node.js
  • Node.js のパッケージマネージャ（npm, yarn)
  • ShopifyCLI

以上で事前準備は終了です。

アプリ作成

ここからは実際に Order Discount API が搭載されたアプリを作成していきます。

アプリの本体を作成

Order Discount API はアプリの拡張機能になるので、まずはアプリ本体を作成していきます。

  1. ターミナルを立ち上げて、アプリを作成したいディレクトリで以下のコマンドを実行します。
npm init @shopify/app@latest
  1. コマンド実行後、プロジェクト名や使用する言語などを聞かれるのでそれぞれ以下のように答えてください。
Your project name?（アプリのディレクトリ名）
 -> order-discount-api-app

Get Started building your app?（Remix を使用するかどうか）
 -> Start with Remix

For your Remix template, which language do you want?（使用する言語）
 -> Typescript
  1. アプリのディレクトリに移動します。
 cd order-discount-api-app/
  1. アプリに必要なライブラリをインストールします。
npm install
  1. 以下のコマンドを実行して、アプリのローカルサーバーを起動します。
npm run dev

コマンド実行後、いくつか質問されるので以下のように答えてください。

Create this project as a new app on Shopify
（パートナーダッシュボードに新規でアプリを作成するかどうか）
  -> Yes, create it as a new app

App name（アプリ名）
  -> order-discount-api-app

Which store would you like to use to view your project?
（どのストアでアプリの動作を確認したいか）
  -> order-discount-api-demo（事前準備で作成した開発ストアを入力してください）

Have Shopify automatically update your app's URL in order to create a preview experience?
（アプリをプレビューするための URL を Shopify が自動で生成してくれる）
  -> Yes, automatically update

ここまででアプリ本体の作成は完了です。

アプリに Order Discount API の機能を追加

ここからは、作成したアプリの本体に Order Discount API の拡張機能を追加していきます。

  1. アプリのディレクトリに移動します。
 cd order-discount-api-app/
  1. 以下の拡張機能を作成するコマンドを実行して、アプリに拡張機能を追加します。
npx shopify app generate extension

コマンド実行後の質問には以下のように答えてください。

Type of extension?（作成する拡張機能の種類）
  ->  Discount orders - Function

Name your extension?（作成される拡張機能の名前）
  -> 何も入力しない

What would you like to work in?（使用する言語）
  -> TypeScript
  1. インストールした拡張機能のディレクトリに移動します。
cd extensions/product-discount/
  1. run.graphql を以下のコードに書き換えます。
query RunInput {
  cart {
    lines {
      quantity
    }
  }
}

run.graphql にはディスカウントで必要な情報を取得してくる GraphQL クエリを作成しています。 どのような情報が取得できるかはこちらのドキュメントで詳しく確認できます。

今回のバリデーションの実行に必要な情報と run.graphql の内容の対応関係は以下のようになっています。

ディスカウントに必要な情報run.graphql
商品の注文数quantity
  1. run.graphql を元に型 RunInput を生成します。
    以下のコマンドを実行して型を生成します。この型は、次に編集するrun.ts ファイルで使用されます。run.ts は実際にバリデーション処理を書いていくファイルです。
npm run typegen
  1. run.ts を以下のコードに書き換えます。
import type { RunInput, FunctionRunResult } from '../generated/api';
import { DiscountApplicationStrategy } from '../generated/api';

const EMPTY_DISCOUNT: FunctionRunResult = {
  discountApplicationStrategy: DiscountApplicationStrategy.First,
  discounts: [],
};

export function run(input: RunInput): FunctionRunResult {
  // 合計注文数
  const totalOrders = input.cart.lines.reduce((acc, lineItem) => acc + lineItem.quantity, 0);

  // 合計注文数が 20 を超える場合にディスカウントを実行する
  if (totalOrders > 10) {
    return {
      discountApplicationStrategy: DiscountApplicationStrategy.First,
      discounts: [
        {
          targets: [
            {
              orderSubtotal: {
                excludedVariantIds: [],
              },
            },
          ],
          value: {
            percentage: {
              value: '20',
            },
          },
          message: '合計注文数が10を超えたので20%OFF!',
        },
      ],
    };
  }

  return EMPTY_DISCOUNT;
}
  1. アクセススコープの更新
    shopify.app.toml の scopes を以下のように更新してください。
scopes = "write_products,write_discounts"
  1. アプリのディレクトリに移動してアプリをデプロイします。
cd ../.. && npm run deploy

コマンド実行後の質問には以下のように答えてください。

Include `shopify.app.toml` configuration on `deploy`?
  -> Yes, always

Release a new version of cart-chekout-validation-demo?
  -> Yes, release this new version

ここまででアプリに Shopify Functions の中の Order Discount API を搭載することができました。

作成したアプリを開発ストアにインストール

次に、作成したアプリを開発ストアにインストールします。
パートナーダッシュボードの「アプリ管理」から今回作成したアプリを選択します。
パートナーダッシュボードで作成したアプリを選択する

アプリ詳細画面に遷移したら「ストアを選択する」をクリックしてください。
アプリ詳細画面でストアを選択する

アプリの機能を試すストアを選択します。最初に作成した開発ストアを選択してください。
作成した開発ストアを選択する

「インストール」をクリックしてアプリをストアにインストールします。
アプリをインストールする

ここまでで、Order Discount API を搭載したアプリを開発ストアにインストールすることができました。

ストアで Order Discount API を有効化

次に、開発ストアで Order Discount API を有効化します。

Order Discount API を有効化させるためには、GraphQL Admin API を叩く必要があります。今回は Shopify が提供している「Shopify GraphiQL App」というアプリを使用して Admin GraphQL を叩いていきます。「Shopify GraphiQL App」についてはこちらの記事で詳しく解説しているのでよければ読んでみてください。

こちらから「Shopify GraphiQL App」をインストールできます。

▼ 「Shopify GraphiQL App」インストール画面
Shopify GraphiQL Appのインストール画面

「Shop URL」の項目にはアプリをインストールストアのドメインを入力します。最初に作成した開発ストアのドメインを入力してください。
Shop URL の設定

「Admin API」の項目では、「Shopify GraphiQL App」に許可するアクセススコープを選択します。「Select all」をクリックしてください。
アクセススコープの設定

「Install」をクリックしてアプリをストアにインストールしていきます。
アプリをストアにインストールする

「インストール」をクリックしてください。
アプリのインストール画面

ここからは、Admin GraphQL を叩いて Order Discount API を有効化していきます。

下記のクエリを使用して Order Discount API を有効化します。YOUR_FUNCTION_ID_HERE の部分は、アプリを作成してきたディレクトリの .env ファイルに SHOPIFY_ORDER_DISCOUNT_ID=xxxxxxxxxxxxxxxxxx という行があると思うので、そこの xxxxxxxxxxxxxxxxxx に該当する部分に書き換えてください。

mutation {
  discountAutomaticAppCreate(
    automaticAppDiscount: {
      title: "Volume discount"
      # .env ファイルの「SHOPIFY_PRODUCT_DISCOUNT_ID」を設定する
      functionId: "YOUR_FUNCTION_ID_HERE"
      startsAt: "2022-06-22T00:00:00"
    }
  ) {
    automaticAppDiscount {
      discountId
    }
    userErrors {
      field
      message
    }
  }
}

以上で、Order Discount API を有効化することができました。

有効化できているか確認してみましょう。

ストア管理画面左側のサイドバーから「ディスカウント」をクリックしてください。
管理画面のディスカウントへのリンク

「Volume discount」が作成されていれば有効化されています。
有効化されたディスカウントの表示

以上で、Order Discount API の有効化は完了です。

Order Discount API の動作確認

Order Discount API の動作確認を行なっていきます。

合計注文数が 10 個を超える注文が 20% OFF になっていて正常に動作していますね。
実際の動作例

Order Discount API を使って実装されたおすすめアプリ

実際に Order Discount API を使って実装されているアプリを紹介します。

シンプル VIP 注文割引｜お手軽 VIP 会員セール設定

「シンプル VIP 注文割引｜お手軽 VIP 会員セール設定」は、顧客の注文回数・注文金額の合計に応じて注文を割引したり、無料にしたりできるアプリです。こちらからアプリをインストールできます。

詳しい使い方については、以下のご利用ガイドをご覧ください。
Shopify に注文回数や注文金額に応じた自動 VIP 注文割引機能を実現できるアプリについて徹底解説｜ご利用ガイド

シンプル VIP 注文割引｜お手軽 VIP 会員セール設定

シンプル顧客タグ注文割引｜顧客タグ BtoB 割引

「シンプル顧客タグ注文割引｜顧客タグ BtoB 割引」は、顧客タグに応じて注文を割引したり、無料にしたりできるアプリです。こちらからアプリをインストールできます。

詳しい使い方については、以下のご利用ガイドをご覧ください。
Shopify で顧客タグに応じて自動注文割引ができるアプリについて徹底解説｜ご利用ガイド

シンプル顧客タグ注文割引｜顧客タグ BtoB 割引

シンプル会員注文割引｜お手軽ログインセール設定

「シンプル会員注文割引｜お手軽ログインセール設定」は、ログイン状態に応じて注文を割引したり、無料にしたりできるアプリです。こちらからアプリをインストールできます。

詳しい使い方については、以下のご利用ガイドをご覧ください。
Shopify でログイン状態に応じた会員注文割引ができるアプリについて徹底解説｜ご利用ガイド

シンプル会員注文割引｜お手軽ログインセール設定

シンプル会員初回注文割引｜お手軽初回ログインセール設定

「シンプル会員初回注文割引｜お手軽初回ログインセール設定」は、ログインしている顧客に対して、初回購入時に注文割引を実現するアプリです。こちらからアプリをインストールできます。

詳しい使い方については、以下のご利用ガイドをご覧ください。
Shopify でアカウント作成後の初回購入時に注文割引ができるアプリについて徹底解説｜ご利用ガイド

シンプル会員初回注文割引｜お手軽初回ログインセール設定

まとめ

今回は Shopify Functions の概要から Order Discount API を使用して、Shopify Functions の具体的な実装方法まで解説しました。

今回紹介したカート内の商品の合計注文数に基づくディスカウントは非常にシンプルな例ですが、商品のメタフィールドを活用したディスカウントや、顧客情報をもとにしたより複雑なディスカウント設定も可能です。

Shopify Functions は、今回取り上げた Order Discount API だけでなく、さまざまな種類が存在します。ディスカウントや配送、決済方法のカスタマイズが可能で、これらをマスターすることで開発の可能性が格段に広がります。ぜひこの機会に深く学んでみてください！

最後まで読んでいただきありがとうございました！

そのほかの API に関しての記事もありますので、ぜひご覧ください。

ブログTOPお問い合わせ

おすすめ Shopify アプリ

シンプル関連商品レコメンド｜よく一緒に購入されている商品のアイコン

シンプル関連商品レコメンド｜よく一緒に購入されている商品

詳しい使い方インストール

関連商品を一覧からまとめて設定。買い手はセットをワンクリックでカートに入れられます。

シンプル税込税抜併記｜消費税込み・税別表示・軽減税率にも対応のアイコン

シンプル税込税抜併記｜消費税込み・税別表示・軽減税率にも対応

詳しい使い方インストール

商品価格に、税込と税抜のもう一方を並べて表示できます。軽減税率が混ざるお店でも、商品ごとに正しく計算します。

シンプル原産国表示｜お手軽製造国・原産地ラベルのアイコン

シンプル原産国表示｜お手軽製造国・原産地ラベル

詳しい使い方インストール

商品ごとの原産国を、国旗つきのバッジで商品ページに表示できます。国はリストから選ぶだけなので表記ゆれもありません。

シンプル商品単価表示｜お手軽単位価格表示のアイコン

シンプル商品単価表示｜お手軽単位価格表示

詳しい使い方インストール

「100gあたりいくら？」を、販売する国ごとに見慣れた単位で表示できます。商品ページ・商品カード・カートで、お客様が価格を比べやすくなります。

シンプル追従電話ボタン｜お手軽お問い合わせ・電話サポートのアイコン

シンプル追従電話ボタン｜お手軽お問い合わせ・電話サポート

詳しい使い方インストール

電話・LINE・WhatsAppのボタンをストアの全ページに置けます。「買う前にちょっと聞きたい」お客様をそのまま逃しません。

シンプルメガメニュー｜お手軽ヘッダー階層ナビゲーションのアイコン

シンプルメガメニュー｜お手軽ヘッダー階層ナビゲーション

詳しい使い方インストール

画像つきの複数カラムのドロップダウンナビゲーションを、コードに触れずに作成・編集できます。

シンプル商品画像透かし｜お手軽ウォーターマークのアイコン

シンプル商品画像透かし｜お手軽ウォーターマーク

詳しい使い方インストール

商品画像にロゴやテキストの透かしを焼き込み、どこに転載されても出どころが分かるようにします。

シンプルマイページバナー｜お手軽顧客アカウント画像のアイコン

シンプルマイページバナー｜お手軽顧客アカウント画像

詳しい使い方インストール

顧客アカウントページにバナーを表示。画像をアップロードして URL を貼るだけで表示されます。

全177個の日本製 Shopify アプリを見る

関連記事

画像

Shopify Ajax API を用いてコレクションページで商品をカートに入れる方法を徹底解説

Shopify Ajax API を用いるとコレクションページで所品をカートに追加することができます。Shopify Ajax API について理解し、幅広い Shopify ストア開発ができるようになりましょう！

画像

Shopify Shipping Discount API とは？実装方法まで徹底解説！

今回の記事では、Shopify Shipping Discount API の説明から実際の実装方法まで解説しています。配送料のディスカウントを柔軟にカスタマイズできる Shipping Discount API の実装方法をしっかり学んでいきましょう！

画像

Shopify Product Discount API とは？実装方法まで徹底解説！

今回の記事では、Shopify Product Discount API の説明から実際の実装方法まで解説しています。チェックアウトページを柔軟にカスタマイズできる Product Discount API の実装方法をしっかり学んでいきましょう！

画像

Shopify CSV注文作成アプリを5つの基準で比較｜一括注文インポート18選

Shopify CSV注文作成・一括注文インポートアプリ18選を、注文作成対応・日本語/文字コード・検証機能・料金など5つの基準で採点比較。注文を取り込みたいストア向けに、用途別の選び方とCSV作成の実務手順まで解説します。

画像

【2026年】Shopifyの不正注文を自動キャンセルできるアプリ12選を紹介！

Shopifyで不正注文やチャージバックに悩んでいる方へ。不正注文の自動検知・自動キャンセルに対応するShopifyアプリ12選を徹底比較。メリット・デメリット・選び方・導入方法をわかりやすく解説します。

画像

Shopifyのディスカウント組み合わせアプリ16選を紹介！

Shopifyでディスカウントを組み合わせたい方に向けて、標準機能の限界とそれを補うアプリ16選を徹底比較。割引の併用ルールからアプリの選び方、料金プランまで詳しく解説します。

Menu
Social