商品取得
GET /products/{product_id}
商品情報を取得します。
対象プラン
- スタンダード
- プレミアム
- プレミアムプラス
- フードビジネス
- リテールビジネス
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”商品ID
※ ユーザーアクセストークンを利用する場合、ユーザーの所属する店舗で販売している商品IDを指定してください。
Query Parameters
Section titled “Query Parameters ”検索パラメータ（カンマ区切りで指定可）
Response項目を指定可能
※一部項目(withで指定する項目、2階層目以降の項目)については指定不可
商品価格情報を付加するか(付加する場合はall, しない場合はnone)
商品自由項目情報を付加するか(付加する場合はall, しない場合はnone)
店舗情報を付加するか(付加する場合はall, しない場合はnone)
在庫引当情報を付加するか(付加する場合はall, しない場合はnone)
商品属性項目情報を付加するか(付加する場合はall, しない場合はnone)
発注設定情報を付加するか(付加する場合はall, しない場合はnone)
Responses
Section titled “ Responses ”取得成功
object
商品ID：数字15桁以内。
部門ID：数字9桁以内。
商品コード：半角英数記号20文字以内。
商品名：85文字以内。
商品カナ：全角カナ85文字以内。
税区分：商品価格の消費税の扱いに関する設定。 （0:内税、1:外税、2:非課税）
商品価格区分：商品をオープン価格販売するかどうか設定。未設定の場合1を設定。 （1:通常価格、2:オープン価格）
商品単価：数字8桁以内。販売価格を設定。
会員価格：数字8桁以内。会員価格を設定。
原価：数字8桁以内(少数5桁まで)。未設定の場合0を設定。
規格：1000文字以内。商品のカラー・サイズなどを設定。
説明：1000文字以内。商品説明などを設定。
キャッチコピー：1000文字以内。商品のキャッチコピーなどを設定。
サイズ：85文字以内。
カラー：85文字以内。
タグ：85文字以内。複数ある場合は、カンマで区切り。
グループコード：関連商品として紐付ける為のグループコードを設定。 例えば、AとBの商品に同じグループコード001を設定すると、AとBは関連商品となります。サイズ、カラーが異なる場合などに使用してください。
URL：255文字以内。 スマレジ端末でWEBページを表示したい場合設定。
レシート印字商品名：レシートに印字する商品名。64文字以内。
表示順：数字9桁以内。
売上区分：取引時に売上計上するか否かの設定。 （0:売上対象、1:売上対象外）
在庫管理区分：棚卸対象商品とするか否かの設定。 （0:在庫管理対象、1:在庫管理対象外）
端末表示：スマレジ端末に表示するか否かの判定。未設定の場合1を設定。 (0：表示しない、1：表示する)
商品区分：商品の種類を設定。未設定の場合0を設定。 (0：通常商品、1：回数券(*1)、2：オプション商品)
オプショングループID：オプショングループの設定方法が「全店舗共通」の場合、適用可能なオプショングループがあればそのIDがこちらに設定されます。無ければnullが設定されます。
ポイント対象：ポイント対象にするか否かの設定（0:ポイント対象、1:ポイント対象外）
免税区分：免税区分の設定。未設定の場合0を設定。 (0：対象外、1：一般品、2：消耗品)
免税機能を利用しない場合は「対象外」としてください
「対象外」免税対象ではない商品
「一般品」電化製品、服、着物、カバンなど
「消耗品」酒、食品類、薬品類、化粧品類など
※部門の免税区分よりも、商品の免税区分を優先します。
(部門売りで適用されます。)
品番：85文字以内。
値引割引計算対象：小計値引／割引(クーポン値引、ポイント値引き含む)の対象かどうかを設定 （0:対象外、1:対象）未設定の場合、1:対象 を設定。
社員販売割引率：数字3桁以内。社員販売時の割引率を設定。
部門の税設定を使用：商品に設定した税設定を使用するか、その商品に設定した部門の税設定を使用するかを選択。
（0:商品の税設定を使用、1:部門の税設定を使用）
「軽減税率ID（税設定）」に値が設定されている場合「0:商品の税設定を使用」。
「軽減税率ID（税設定）」の値が未設定（null）の場合「1:部門の税設定を使用」を設定
軽減税率ID（税設定）：軽減税率ID。 軽減税率設定画面で設定した軽減税率ID、または、下記の軽減税率ID。標準税率の場合はnull。
軽減：10000001 (特定商品の軽減税率適用）
選択[標準]：10000002（状態による適用[適用しない]）
選択[軽減]：10000003（状態による適用[適用する]）
選択[選択]：10000004（状態による適用[都度選択する]）
※部門の税設定を使用する場合、所属部門の軽減税率ID。
軽減税率用商品単価：軽減税率用商品単価を設定。 当項目は、レジ端末で販売時に、軽減税率を選択した時の価格になります。
未設定の場合は、「商品単価」が軽減税率を選択した時の価格になります。
税込の場合設定可能。税抜価格の場合計算して算出できるため税込の場合のみ設定できます。
軽減税率用商品会員単価：軽減税率用会員単価を設定。 設定内容については、「軽減税率用商品単価」と同様となります。
発注点：発注をかけるべき在庫数。
仕入原価：商品の仕入原価。
適用開始日時：商品が端末に適用される日時を設定。 未設定の場合は未使用。[YYYY-MM-DD]
作成日時：登録時の日時。[YYYY-MM-DDThh:mm:ssTZD]
更新日時：登録時・更新時の日時。[YYYY-MM-DDThh:mm:ssTZD]
商品自由項目
object
商品ID：数字15桁以内
商品自由項目番号：1-99 の商品自由項目に付与されている連番。
値：85文字以内。自由項目の値。
商品価格
object
商品ID：数字15桁以内。
店舗ID：数字9桁以内。全店の場合「-1」を設定
価格区分：1：商品単価、2：会員価格
適用開始日：適用開始日。[YYYY-MM-DD]
適用終了日：適用終了日。[YYYY-MM-DD]
※未設定の場合、有効期限なしとして適用されます。
商品単価：商品単価。数字8桁以内。
商品取扱店舗
object
商品ID：数字15桁以内。
店舗ID：数字9桁以内。
オプショングループID：オプショングループの設定方法が「店舗ごと」の場合、適用可能なオプショングループのIDがあればこちらに設定されます。無ければnullが設定されます。
取扱区分：0:販売する／1:販売しない
在庫引当商品
object
商品ID：数字15桁以内。
引当商品商品ID：数字15桁以内。
引当数：数字3桁以内。
商品属性項目
object
商品ID：数字15桁以内。
コード：数字9桁以内。
項目番号：商品属性に付与されている連番。
名称：30文字以内
発注設定
object
商品ID
[管理画面->設定->在庫設定->発注設定->継続区分]から確認できる継続区分のコード。
(0:発注不可、1:発注可)
[管理画面->設定->在庫設定->発注設定->発注不可理由]から確認できる発注不可理由のコード。
(null:発注制限なし、0~99999999:発注制限)
(0:編集不可、1:編集可能)
PB区分(1:プロパー、2:バーゲン)
(0:表示しない、1:表示する)
object
(0:単位なし、1:単位あり)
object
(null:発注制限なし、-1:全店舗設定、0~99999999:発注制限)
(-1:全店舗設定、0:表示しない、1:表示する)
Example
{ "productId": "string", "categoryId": "string", "productCode": "string", "productName": "string", "productKana": "string", "taxDivision": "string", "productPriceDivision": "string", "price": "string", "customerPrice": "string", "cost": "string", "attribute": "string", "description": "string", "catchCopy": "string", "size": "string", "color": "string", "tag": "string", "groupCode": "string", "url": "string", "printReceiptProductName": "string", "displaySequence": "string", "salesDivision": "string", "stockControlDivision": "string", "displayFlag": "string", "division": "string", "productOptionGroupId": "string", "pointNotApplicable": "string", "taxFreeDivision": "string", "supplierProductNo": "string", "calcDiscount": "string", "staffDiscountRate": "string", "useCategoryReduceTax": "string", "reduceTaxId": "10000001", "reduceTaxPrice": "string", "reduceTaxCustomerPrice": "string", "orderPoint": "string", "purchaseCost": "string", "appStartDateTime": "string", "insDateTime": "string", "updDateTime": "string", "reserveItems": [ { "productId": "string", "no": "string", "value": "string" } ], "prices": [ { "productId": "string", "storeId": "string", "priceDivision": "string", "startDate": "string", "endDate": "string", "price": "string" } ], "stores": [ { "productId": "string", "storeId": "string", "productOptionGroupId": "string", "assignDivision": "string" } ], "inventoryReservations": [ { "productId": "string", "reservationProductId": "string", "reservationAmount": "string" } ], "attributeItems": [ { "productId": "string", "code": "string", "no": "string", "name": "string" } ], "orderSetting": { "productId": "string", "continuationDivision": "1", "orderStatusDivision": "0", "orderNoReasonDivision": "1", "orderLimitAmount": "12345678", "orderSupplierEditable": "0", "pbDivision": "1", "displayFlag": "0", "orderUnit": { "division": "0", "num": "12345678", "name": "string" }, "stores": [ { "storeId": "123456789", "orderLimitAmount": "12345678", "displayFlag": "-1" } ] }}