定期購入に関するAPIとは

目次

定期購入検索に関するAPI

API名 機能概要
定期購入親注文一覧取得API 定期購入の検索条件に一致する定期購入申し込み情報をレスポンスします。
定期購入子注文一覧取得API 指定した定期購入申し込みの各お届け回の子注文情報をレスポンスします。
定期購入親注文詳細取得API 指定した定期購入申し込みの詳細情報をレスポンスします。

定期購入情報変更に関するAPI

API名 機能概要
定期購入次回注文スキップAPI 定期購入の次回お届けをスキップします。
定期購入親注文一括解約API 定期購入の申し込みを一括で解約します。
定期購入親注文解約API 定期購入の申し込みを解約します。
定期購入お届け予定日変更API 定期購入のお届け予定日を変更します。
定期購入情報変更API 定期購入の申し込み情報を変更します。
定期購入情報変更履歴一覧API 定期購入情報を変更した履歴一覧を取得します。
定期購入情報変更履歴詳細API 定期購入情報を変更した履歴の詳細を取得します。

定期購入の親注文、子注文、お届け回毎の注文情報生成の流れ

定期購入の親注文、子注文、お届け回毎の注文情報生成の流れ

利用パターン

▼子注文の詳細情報を取得する。

 1.親注文一覧を取得する。
  利用するAPI:定期購入親注文一覧取得API

 2.1で取得した親注文IDをキーに子注文の情報を取得する。
  利用するAPI:定期購入子注文一覧取得API

 3.2で取得した子注文に紐づく注文IDをキーに「注文詳細API」にリクエストする。
  利用するAPI:注文詳細API
子注文の詳細情報を取得する

▼次回注文の内容を変更する。

 1.親注文一覧を取得する。
  利用するAPI:定期購入親注文一覧取得API

 2.1で取得した定期購入番号をキーに親注文の詳細情報を取得する。
  利用するAPI:定期購入親注文詳細取得API

 ※現在の親注文の詳細を取得したい場合のみ1,2を実施してください。

 3.親注文の情報を変更する。 ※1
  利用するAPI:定期購入情報変更API

※1 次回配送予定の子注文の子注文フェーズ(phase)が0または1以外の場合はエラーを返します。 (エラーコード:SUBSCRIPTION-ORDER-API-0201
次回注文の内容を変更する      

▼次回注文をスキップする。

 1.親注文一覧を取得する。
  利用するAPI:定期購入親注文一覧取得API

 2.1で取得した親注文IDをキーにスキップ対象の「子注文ID」を取得する。
  利用するAPI:定期購入子注文一覧取得API

 3.2で取得した子注文IDをキーに「定期購入次回注文スキップAPI」にリクエストする。 ※1
  利用するAPI:定期購入次回注文スキップAPI
※1 次回配送予定の子注文の子注文フェーズ(phase)が0または1以外の場合はエラーを返します。 (エラーコード:SUBSCRIPTION-ORDER-API-0201
次回注文をスキップする

▼親注文を解約する。(1件)

 1.親注文一覧を取得する。
  利用するAPI:定期購入親注文一覧取得API

 2.1で取得した親注文IDをキーに次回配送予定の「子注文ID」を取得する。
  利用するAPI:定期購入子注文一覧取得API

 3.2で取得した子注文IDをキーに「定期購入親注文解約API」にリクエストする。 ※1
  利用するAPI:定期購入親注文解約API

※1 すでに次回配送予定の子注文に紐づく注文情報が生成されていた場合はエラーを返します。 (エラーコード:SUBSCRIPTION-ORDER-API-0201
親注文を解約する(1件)

▼親注文を解約する。(複数件)

 1.親注文一覧を取得する。
  利用するAPI:定期購入親注文一覧取得API

 2.1で取得した親注文IDをキーに「定期購入親注文一括解約API」にリクエストする。 ※1
  利用するAPI:定期購入親注文一括解約API

※1 子注文に紐づく注文情報の生成状況に関わらず親注文の解約を実施することが可能です。
※1 次回配送予定の子注文に紐づく注文情報が生成された後にリクエストをして成功した場合でも、子注文情報自体は解約されません。
親注文を解約する(複数件)

アプリケーションの管理

目次

利用のルール

開発のヒント