クーポン取得

Authorizations

AppAccessToken
pos.transactions:read
UserAccessToken
pos.transactions:read

Path Parameters

coupon_id

required

string

クーポンID
※ ユーザーアクセストークンを利用する場合、ユーザーの所属する店舗で販売している商品のみをクーポン商品として持つクーポンのIDを指定してください。

Query Parameters

fields

array

検索パラメータ（カンマ区切りで指定可）
Response項目を指定可能
※一部項目(withで指定する項目、2階層目以降の項目)については指定不可

with_items

string

default: none

Allowed values: all none

クーポンアイテム情報を付加するか(付加する場合はall, しない場合はnone)

200

取得成功

Array<object>

object

couponId

クーポンID

string

couponName

クーポン名

string

couponDivision

クーポン区分：クーポン区分（0：通常、1：giftee）

string

serialNumber

シリアル番号：端末側でのクーポンの入力に用いられます。

string

summary

概要

string

awardType

特典タイプ：そのクーポンのタイプ。（1：値引、2：割引、3：商品付与、P1：0ポイント、P2：ポイント指定（上書き）、P3：ポイント追加（加算）、P4：ポイントN倍、M1：0マイル、M2：マイル指定（上書き）、M3：マイル追加（加算）、M4：マイルN倍）

string

awardValue

特典値：特典タイプに応じた値を設定。

特典タイプ	設定値
1：値引	値引き額[円]
2：割引	割引率[%]
3：商品付与	0固定
P1：0ポイント	0固定
P2：ポイント指定（上書き）	ポイント数
P3：ポイント追加（加算）	差分ポイント数
P4：ポイントN倍	ポイントへ乗算する値
M1：0マイル	0固定
M2：マイル指定（上書き）	マイル数
M3：マイル追加（加算）	差分マイル数
M4：マイルN倍	マイルへ乗算する値

string

applyConditionDivision

適用条件区分：クーポンの使用条件のうち、対象商品が含まれている必要があるか指定します。（0：全適用、1：対象商品が含まれる場合のみ適用）

string

minTargetPrice

最低対象金額

string

maxTargetPrice

最高対象金額

string

startDate

利用可能開始日：クーポンの有効期限（開始日）。[YYYY-MM-DD]

string

endDate

利用可能終了日：クーポンの有効期限（終了日）。[YYYY-MM-DD]

string

combineDivision

併用区分：クーポン利用時に他クーポンとの併用が可能か否かを指定します。（1：併用不可、2：一部のクーポン(3:併用可能)と併用可能、3：併用可能）

string

insDateTime

作成日時：登録時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string

updDateTime

更新日時：登録時・更新時の日時。[YYYY-MM-DDThh:mm:ssTZD]

string

items

クーポンアイテム

object

couponItemId

クーポンに紐づくアイテムID

string

couponId

クーポンID

string

division

クーポンアイテム区分：itemId の値が何を示すものか表します。(1：部門ID、2：商品ID、3：商品グループコード)

string

itemId

アイテムID：クーポンに紐づくアイテムを特定するための、その区分におけるID。

string

type

クーポンアイテムタイプ(1: 適用条件、2:商品付与)

string

salesPrice

販売価格

string

Example

[
  {
    "couponId": "string",
    "couponName": "string",
    "couponDivision": "string",
    "serialNumber": "string",
    "summary": "string",
    "awardType": "string",
    "awardValue": "string",
    "applyConditionDivision": "string",
    "minTargetPrice": "string",
    "maxTargetPrice": "string",
    "startDate": "string",
    "endDate": "string",
    "combineDivision": "string",
    "insDateTime": "string",
    "updDateTime": "string",
    "items": {
      "couponItemId": "string",
      "couponId": "string",
      "division": "string",
      "itemId": "string",
      "type": "string",
      "salesPrice": "string"
    }
  }
]

404

指定されたIDが存在しない場合

object

type

required

string

title

required

string

detail

string

status

integer

Examples

{
  "type": "about:blank",
  "title": "NotFound",
  "detail": "指定されたIDのリソースが見つかりません",
  "status": 404
}

クーポン取得

対象プラン

Authorizations

Parameters

Path Parameters

Query Parameters

Responses

200

Example

404

Examples