商品登録

POST

/products

const url = 'https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-b2b/products';
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: '{"productGroupId":"12345678-1234-1234-1234-1234567890ab","referenceIdentifier":"product-001","name":"テスト商品A","publishCode":1,"publishStartAt":null,"publishEndAt":null,"sellingPriceNoTax":"100.00","taxRate":10,"orderAcceptanceFormatCode":1,"packageType":null,"quantityPerPackage":null,"unit":"個","purchaseUnitType":1,"unitCode":null,"baseUnit":null,"isOrderUnit":false,"orderUnit":null,"isMinimumOrderQuantity":false,"minimumOrderQuantity":null,"weight":null,"size":null,"shippingFeeFormatCode":1,"isInventory":true,"isBackOrder":false,"productTags":[{"id":"11111111-1111-1111-1111-111111111111"}],"productImages":[{"id":"33333333-3333-3333-3333-333333333333"}],"inventory":{"actual":100,"required":0,"pending":0,"isInventoryNotification":false,"inventoryLowLimit":10}}'
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request POST \
  --url https://api.smaregi.dev/TARGET-CONTRACT-ID/ec-b2b/products \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "productGroupId": "12345678-1234-1234-1234-1234567890ab", "referenceIdentifier": "product-001", "name": "テスト商品A", "publishCode": 1, "publishStartAt": null, "publishEndAt": null, "sellingPriceNoTax": "100.00", "taxRate": 10, "orderAcceptanceFormatCode": 1, "packageType": null, "quantityPerPackage": null, "unit": "個", "purchaseUnitType": 1, "unitCode": null, "baseUnit": null, "isOrderUnit": false, "orderUnit": null, "isMinimumOrderQuantity": false, "minimumOrderQuantity": null, "weight": null, "size": null, "shippingFeeFormatCode": 1, "isInventory": true, "isBackOrder": false, "productTags": [ { "id": "11111111-1111-1111-1111-111111111111" } ], "productImages": [ { "id": "33333333-3333-3333-3333-333333333333" } ], "inventory": { "actual": 100, "required": 0, "pending": 0, "isInventoryNotification": false, "inventoryLowLimit": 10 } }'

商品情報を登録します。

Authorizations

AppAccessToken
ec-b2b.products:write

Request Body^required

application/json

ProductRequest

object

productGroupId

商品グループID

string format: uuid

referenceIdentifier

管理番号

使用可能文字: 半角英数字および - _ . #

string

>= 1 characters <= 200 characters /^[0-9A-Za-z\-_.#]+$/

name

商品名

string

<= 255 characters

publishCode

公開ステータス

1: 公開
2: 下書き
3: 公開期間あり

integer

Allowed values: 1 2 3

publishStartAt

公開開始日時

string format: date-time

nullable

publishEndAt

公開終了日時

string format: date-time

nullable

sellingPriceNoTax

販売価格（税抜）

string

taxRate

税率

integer

orderAcceptanceFormatCode

受注受付形式

1: 自由入力

integer

Allowed values: 1

packageType

荷姿

string

nullable <= 30 characters

quantityPerPackage

入数

integer

nullable

unit

単位

string

nullable <= 10 characters

purchaseUnitType

購入単位区分

1: 個数
2: 容量指定

2（容量指定）の場合は unitCode・baseUnit が必須です。 1（個数）の場合、unitCode・baseUnit・isOrderUnit・orderUnit・isMinimumOrderQuantity・minimumOrderQuantity は指定しても無視されます（保存されません）。

integer

Allowed values: 1 2

unitCode

容量単位

1: g
2: kg
3: cm
4: m
5: km
6: mL
7: L

purchaseUnitType が 2（容量指定）の場合は必須です。

integer

nullable

Allowed values: 1 2 3 4 5 6 7

baseUnit

基準容量

この容量（unitCode の単位）あたりの価格を sellingPriceNoTax で指定します。 purchaseUnitType が 2（容量指定）の場合は必須です。0 より大きく 9999999999.99 以下の小数2桁で指定してください。

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

isOrderUnit

注文単位設定フラグ

true: 注文単位を設定する
false: 設定しない

boolean

orderUnit

注文単位

isOrderUnit が true の場合は必須です。0 より大きく 9999999999.99 以下の小数2桁で指定してください。

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

isMinimumOrderQuantity

最低注文容量設定フラグ

true: 最低注文容量を設定する
false: 設定しない

boolean

minimumOrderQuantity

最低注文容量

isMinimumOrderQuantity が true の場合は必須です。0 より大きく 9999999999.99 以下の小数2桁で指定してください。

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

weight

重量

integer

nullable

size

サイズ

0 以上 9999999999.99 以下の小数2桁で指定します。

string

nullable /^[0-9]{1,10}(\.[0-9]{1,2})?$/

shippingFeeFormatCode

送料形式

1: 送料別
2: 送料込

integer

Allowed values: 1 2

isInventory

在庫管理フラグ

boolean

isBackOrder

在庫無し注文受付フラグ

boolean

productImages

商品画像

Array<object>

object

商品画像ID

string format: uuid

inventory

在庫情報

object

actual

実在庫数

integer

required

確保必要在庫

integer

pending

未発送在庫

integer

isInventoryNotification

在庫通知フラグ

boolean

inventoryLowLimit

在庫通知下限値

integer

productTags

商品タグ

登録時のみ指定できます。登録後の紐付けの追加・解除は商品タグ更新の attachProducts/detachProducts を使用してください。

Array<object>

object

商品タグID

string format: uuid

One of:

個数
容量指定

個数

object

purchaseUnitType

Allowed values: 1

Examples

default

{
  "productGroupId": "12345678-1234-1234-1234-1234567890ab",
  "referenceIdentifier": "product-001",
  "name": "テスト商品A",
  "publishCode": 1,
  "publishStartAt": null,
  "publishEndAt": null,
  "sellingPriceNoTax": "100.00",
  "taxRate": 10,
  "orderAcceptanceFormatCode": 1,
  "packageType": null,
  "quantityPerPackage": null,
  "unit": "個",
  "purchaseUnitType": 1,
  "unitCode": null,
  "baseUnit": null,
  "isOrderUnit": false,
  "orderUnit": null,
  "isMinimumOrderQuantity": false,
  "minimumOrderQuantity": null,
  "weight": null,
  "size": null,
  "shippingFeeFormatCode": 1,
  "isInventory": true,
  "isBackOrder": false,
  "productTags": [
    {
      "id": "11111111-1111-1111-1111-111111111111"
    }
  ],
  "productImages": [
    {
      "id": "33333333-3333-3333-3333-333333333333"
    }
  ],
  "inventory": {
    "actual": 100,
    "required": 0,
    "pending": 0,
    "isInventoryNotification": false,
    "inventoryLowLimit": 10
  }
}

Responses

201

登録成功

application/json

ProductResponse

object

商品ID

string format: uuid

productGroupId

商品グループID

string format: uuid

referenceIdentifier

管理番号

使用可能文字: 半角英数字および - _ . #

string

>= 1 characters <= 200 characters /^[0-9A-Za-z\-_.#]+$/

name

商品名

string

<= 255 characters

publishCode

公開ステータス

1: 公開
2: 下書き
3: 公開期間あり

integer

Allowed values: 1 2 3

publishStartAt

公開開始日時

string format: date-time

nullable

publishEndAt

公開終了日時

string format: date-time

nullable

sellingPriceNoTax

販売価格（税抜）

string

taxRate

税率

integer

orderAcceptanceFormatCode

受注受付形式

1: 自由入力

integer

Allowed values: 1

packageType

荷姿

string

nullable <= 30 characters

quantityPerPackage

入数

integer

nullable

unit

単位

string

nullable <= 10 characters

purchaseUnitType

購入単位区分

1: 個数
2: 容量指定

integer

Allowed values: 1 2

unitCode

容量単位

1: g
2: kg
3: cm
4: m
5: km
6: mL
7: L

purchaseUnitType が 2（容量指定）の場合は必須です。

integer

nullable

Allowed values: 1 2 3 4 5 6 7

baseUnit

基準容量

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

isOrderUnit

注文単位設定フラグ

true: 注文単位を設定する
false: 設定しない

boolean

orderUnit

注文単位

isOrderUnit が true の場合は必須です。0 より大きく 9999999999.99 以下の小数2桁で指定してください。

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

isMinimumOrderQuantity

最低注文容量設定フラグ

true: 最低注文容量を設定する
false: 設定しない

boolean

minimumOrderQuantity

最低注文容量

isMinimumOrderQuantity が true の場合は必須です。0 より大きく 9999999999.99 以下の小数2桁で指定してください。

string

nullable /^(([1-9][0-9]{0,9})(\.[0-9]{1,2})?|0\.([1-9][0-9]?|0[1-9]))$/

weight

重量

integer

nullable

size

サイズ

0 以上 9999999999.99 以下の小数2桁で指定します。

string

nullable /^[0-9]{1,10}(\.[0-9]{1,2})?$/

shippingFeeFormatCode

送料形式

1: 送料別
2: 送料込

integer

Allowed values: 1 2

isInventory

在庫管理フラグ

boolean

isBackOrder

在庫無し注文受付フラグ

boolean

createdAt

作成日時。[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

updatedAt

更新日時。[YYYY-MM-DDThh:mm:ssTZD]

string format: date-time

productGroup

商品グループ

object

商品グループID

string format: uuid

name

グループ名

string

detailPageText

詳細ページテキスト

string

nullable

productTags

商品タグ一覧

Array<object>

object

商品タグID

string format: uuid

name

タグ名

string

productImages

商品画像一覧

Array<object>

object

商品画像ID

string format: uuid

url

画像URL

完全なURLを推奨します。ただし現行システムからの移行データではファイル名（相対パス）が格納・返却される場合があるため、URL形式の検証は行わず素の文字列として扱います。

string

alt

代替テキスト

string

nullable

inventory

在庫情報

object

在庫ID

string format: uuid

productId

商品ID

string format: uuid

actual

実在庫数

integer

pending

未発送在庫

integer

isInventoryNotification

在庫通知フラグ

boolean

inventoryLowLimit

在庫通知下限値

integer

required

確保必要在庫

integer

available

有効在庫

integer

frontend

フロント在庫

integer

Examples

default

{
  "id": "55555555-5555-5555-5555-555555555555",
  "productGroupId": "12345678-1234-1234-1234-1234567890ab",
  "referenceIdentifier": "product-001",
  "name": "テスト商品A",
  "publishCode": 1,
  "publishStartAt": null,
  "publishEndAt": null,
  "sellingPriceNoTax": "100.00",
  "taxRate": 10,
  "orderAcceptanceFormatCode": 1,
  "packageType": null,
  "quantityPerPackage": null,
  "unit": "個",
  "purchaseUnitType": 1,
  "unitCode": null,
  "baseUnit": null,
  "isOrderUnit": false,
  "orderUnit": null,
  "isMinimumOrderQuantity": false,
  "minimumOrderQuantity": null,
  "weight": null,
  "size": null,
  "shippingFeeFormatCode": 1,
  "isInventory": true,
  "isBackOrder": false,
  "createdAt": "2025-06-01T10:00:00+09:00",
  "updatedAt": "2025-06-09T14:15:40+09:00",
  "productGroup": {
    "id": "12345678-1234-1234-1234-1234567890ab",
    "name": "商品グループ1700",
    "detailPageText": null
  },
  "productTags": [
    {
      "id": "11111111-1111-1111-1111-111111111111",
      "name": "特売品"
    }
  ],
  "productImages": [
    {
      "id": "33333333-3333-3333-3333-333333333333",
      "url": "https://example.com/images/product01.jpg",
      "alt": "商品画像01"
    }
  ],
  "inventory": {
    "id": "66666666-6666-6666-6666-666666666666",
    "productId": "55555555-5555-5555-5555-555555555555",
    "actual": 100,
    "pending": 0,
    "isInventoryNotification": false,
    "inventoryLowLimit": 10,
    "required": 0,
    "available": 100,
    "frontend": 100
  }
}

400

入力チェックエラーの場合

application/json

object

type

required

string

title

required

string

detail

string

status

integer

Examples

入力チェックエラーの場合

{
  "type": "about:blank",
  "title": "Bad Request",
  "detail": "request_json:[name]は255文字以下で指定してください。",
  "status": 400
}

商品登録

Authorizations

Request Bodyrequired

Examples

Responses

201

Examples

400

Examples

Request Body^required