---
title: 製品と素材
description: "ここでは、Skyplanner-APIを使って商品や資材を作成し、注文に添付する…"
url: "https://skyplanner.ai/ja/docs/%e8%a3%bd%e5%93%81%e3%81%a8%e7%b4%a0%e6%9d%90/"
updated: "2025-10-07"
category: 統合
tags:
  - API
  - 統合
---

# 製品と素材

ここでは、Skyplanner-APIを使って商品や資材を作成し、注文に添付する方法を説明します。また、商品にデフォルトのプロセスステップを作成し、そのデフォルトを使用して注文アイテムを作成する方法もご紹介します。

#### 製品/素材の作成

商品と素材の両方の作成と更新は、同じAPIエンドポイントを通じて行われます：/products。製品のタイプは**type属性で**設定します：product'または'material'

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**図1.** 製品を作る

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**図2.** 素材の作成

製品や素材を作成する際、その製品/素材が製品リストでアクティブであると表示したい場合は、**is_active**値をtrueに設定してください。また、**free_amount**属性で利用可能な在庫量を設定できることに注意してください。

#### 製品のデフォルト・プロセス・ステップの作成

製品にデフォルトのプロセスステップを追加する前に、適切なワークステージを用意する必要があります。ワークステージは、Skyplanner UIまたは/workstages-endpointから作成できます。

デフォルトのプロセス・ステップの追加は、/products/jobs/{productId}-エンドポイントから行います。

例えば、id22220の製品にデフォルトのステップを追加したい場合、次のようなPOSTリクエストを行います：

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**図3.** デフォルトのプロセスステップを追加する

注目すべき分野もある：

- 注文番号
  - これは、Skyplannerがどの順番でプロセスを完了させるかを示すインデックス番号です。
  - 例えば、第1ステップでは値1、第2ステップでは値3、第3ステップでは値3...といった具合だ。
- ワークステーション
  - これは、このプロセス・ステップをスケジュールできるワークステーションのリストである。
  - ワークステーションのIDをカンマ区切りのリストで指定する："61,62,63"
- 時間変動
  - 取り得る値：time_per_pcs、pcs_per_time、fixed_time
- 継続時間、設定時間、設定時間
  - これらの値を*秒*単位で指定する

#### デフォルトのプロセスステップを更新する

デフォルトのプロセス・ステップを更新する場合、**order_number**属性を使用して、更新するステップを指定する必要があります。

例えば、この商品の最初のプロセス・ステップ**（order_number 1**）は、次のようなPUTリクエストで実行される：

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**図4.** デフォルトのプロセスステップを更新する

#### デフォルトのプロセスステップを削除する

デフォルトのプロセス・ステップの削除も、**order_number**値を使用して行われる。

Order_numbersはこのように配列で与えられる：

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**図5.** デフォルトのプロセスステップを削除する

##### 製品に素材/サブ製品を追加する

素材やサブ製品を添付するには、/sub-productsエンドポイントを使用する必要があります。

**production_planning_product_id**属性に素材やサブ製品のidを、**production_planning_product_parent_id**属性に素材やサブ製品を取り付けたい製品のidを指定します。

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**図6.** 製品に素材を取り付ける

##### 注文品に材料を追加する

また、/row-materialsエンドポイントを使用して、注文アイテムに直接素材を添付することもできます。このようにすることで、追加の材料を添付したり、商品に設定されているデフォルトの材料とは全く異なる材料のリストを注文アイテムに使用することができます。各素材について、1つのオーダーアイテムに1つの行素材エンティティしか持つことができないことに注意してください。つまり、同じ**phaser_order_row_id** に同じ**production_planning_product_id を**持つ 2 つのエンティティを作成することはできません。

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**図7.** 注文商品に材料を追加する

#### 在庫レベルの更新

製品または材料の在庫レベルを更新するには、**free_amount**属性を指定して PUT リクエストを送信します。

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**図8.** 在庫レベルの更新