POST /v1/items

Scope

write_items

Request parameters

Name	In	Type	Required	Description
Idempotency-Key	header	string	required	冪等キー（必須・ADR-010）。UUID v4 推奨。同一キー再送は保存レスポンスを再生
kind	body	enum(normal	gift	ticket
sku	body	string	required
inventory	body	integer	required	初期在庫（登録時のみ）。null=無制限。set は null 固定（構成品から自動計算）
name	body	string	required
category_id	body	string	required
description	body	string	required
detail_url	body	string	optional
price	body	object	required
tax_rate	body	object	required
discount_rate	body	integer	optional
discount_title	body	string	optional
status	body	enum(active	inactive)	optional
main_image_orientation	body	enum(landscape	square)	optional
sell_from	body	string	optional
sell_by	body	string	optional
selling_limits	body	integer	optional
shipping_date_estimate	body	string	optional
is_shipping	body	boolean	optional
shipping_cost	body	object	optional
share_button_enabled	body	boolean	optional
delivery_datetime_possibility	body	enum(nullable	required	not_available)
restock_notification	body	boolean	optional
number_of_sets	body	integer	optional
cancellation	body	object	required
ticket	body	object	optional
bundle	body	object	optional

Response example

{
  "data": {
    "id": "1",
    "sku": "string",
    "name": "string",
    "status": "active",
    "kind": "normal",
    "price": {
      "amount": 3200,
      "currency": "JPY"
    },
    "inventory": 0,
    "category_id": "string",
    "main_image": "string",
    "created_at": "string",
    "updated_at": "string",
    "description": "string",
    "shipping_cost": {
      "amount": 3200,
      "currency": "JPY"
    },
    "detail_url": "string",
    "main_image_orientation": "landscape",
    "restock_notification": true,
    "cancellation": {
      "enabled": true,
      "cancel_by": "string"
    },
    "ticket": {
      "event_group": "string",
      "venue_name": "string",
      "venue_address": "string",
      "doors_open_at": "string",
      "entry_start_at": "string",
      "valid_from": "string",
      "valid_by": "string",
      "term_and_condition": "string",
      "allow_continuous_use": true,
      "default_seat_label": "string",
      "background_color": "string",
      "lottery": {
        "date": "string",
        "capacity": 0
      }
    },
    "bundle": {
      "components": [
        {
          "item_id": "string",
          "quantity": 0,
          "selection_type": "fixed"
        }
      ]
    },
    "tax_rate": 10,
    "discount_rate": 0,
    "delivery_datetime_possibility": "nullable",
    "sell_from": "string",
    "sell_by": "string",
    "shipping_date_estimate": "ご注文から3〜5営業日で発送",
    "selling_limits": 10,
    "discount_title": "夏の大感謝祭",
    "is_shipping": true,
    "share_button_enabled": true,
    "number_of_sets": 1,
    "category_name": "スキンケア",
    "images": [
      {
        "id": "1",
        "url": "https://cdn.example/img/abc.jpg",
        "sort": 0
      }
    ],
    "variation_axes": [
      {
        "id": "string",
        "name": "色",
        "values": [
          {
            "id": "string",
            "name": "M"
          }
        ]
      }
    ],
    "variants": [
      {
        "id": "1",
        "sku": "string",
        "name": "白 / M",
        "price": {
          "amount": 3200,
          "currency": "JPY"
        },
        "inventory": 0,
        "discount_rate": 0,
        "status": "active",
        "axis_values": [
          {
            "axis": "string",
            "value": "string"
          }
        ]
      }
    ],
    "options": [
      {
        "id": "string",
        "type": "choice",
        "label": "ラッピング",
        "description": "string",
        "required": true,
        "price": {
          "amount": 3200,
          "currency": "JPY"
        },
        "choices": [
          {
            "id": "string",
            "text": "化粧箱",
            "price": {
              "amount": 3200,
              "currency": "JPY"
            }
          }
        ]
      }
    ]
  }
}

Description

商品を新規登録する（全 kind・同期直行・作成は履歴なし）(write_items)

Error response example

{
  "error": {
    "code": "insufficient_scope",
    "message": "requires scope 'read_orders'",
    "request_id": "req_01H..."
  }
}

Possible errors: 400 / 401 / 403 / 409 / 422 / 503