一括登録

POST /v1/imports は、マスタと品番を1回のリクエストで登録します。マスタを先に書き、そのあと品番を書きます。途中で失敗すると、そのリクエストの変更はすべて取り消されます。

ヘッダ Idempotency-Key が必須です。同じキーと同じ本文をもう一度送ると、保存済みの結果が返ります。同じキーで本文が違うと 409 です。

マスタを1件でも含むときは kikan_masters_write、品番を1件でも含むときは kikan_products_write が必要です。マスタは合計 200 件まで、品番は 100 件までです。

本文見出しのリンクをコピー

キーは、マスタ のパス名（brands など）と products です。各配列の要素は、単体の PUT と同じ項目です。コードは要素の中に書きます。

{
  "brands": [{ "brand_code": "BR01", "name": "ブランドA" }],
  "colors": [{ "color_code": "BK", "name": "黒" }],
  "products": [
    {
      "product_code": "SH001",
      "name": "シャツ",
      "brand_code": "BR01",
      "skus": [{ "color_code": "BK", "size_code": "M" }]
    }
  ]
}

結果見出しのリンクをコピー

ステータスは 200 です。created は、新しく作ったマスタの件数です。更新は数えません。products は、送った品番ごとに、新規かどうかが入ります。

{
  "ok": true,
  "created": { "brands": 1, "colors": 1 },
  "products": [{ "id": "SH001", "created": true }]
}