ここでは、Skyplanner-APIを使って商品や資材を作成し、注文に添付する方法を説明します。また、商品にデフォルトのプロセスステップを作成し、そのデフォルトを使用して注文アイテムを作成する方法もご紹介します。
製品/素材の作成 #
商品と素材の両方の作成と更新は、同じAPIエンドポイントを通じて行われます：/products。製品のタイプはtype属性で設定します：Product’または’Material’
製品や素材を作成する際、その製品/素材が製品リストでアクティブであると表示させたい場合は、is_active値をtrueに設定してください。また、free_amount属性で利用可能な在庫量を設定できることに注意してください。
製品のデフォルト・プロセス・ステップの作成 #
製品にデフォルトのプロセスステップを追加する前に、適切なワークステージを用意する必要があります。ワークステージは、Skyplanner UIまたは/workstages-endpointから作成できます。
デフォルトのプロセス・ステップの追加は、/products/jobs/{productId}-エンドポイントから行います。
例えば、id22220の製品にデフォルトのステップを追加したい場合、次のようなPOSTリクエストを行います：
注目すべき分野もある：
- 注文番号
- これは、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リクエストで実行される：
デフォルトのプロセスステップを削除する #
デフォルトのプロセス・ステップの削除も、order_number値を使用して行われる。
Order_numbersはこのように配列で与えられる：
製品に素材/サブ製品を追加する #
素材やサブ製品を添付するには、/sub-productsエンドポイントを使用する必要があります。
production_planning_product_id属性に素材やサブ製品のidを、production_planning_product_parent_id属性に素材やサブ製品を取り付けたい製品のidを指定します。
注文品に材料を追加する #
また、/row-materialsエンドポイントを使用して、注文アイテムに直接素材を添付することもできます。このようにすることで、追加の材料を添付したり、商品に設定されているデフォルトの材料とは全く異なる材料のリストを注文アイテムに使用することができます。各素材について、1つのオーダーアイテムに1つの行素材エンティティしか持つことができないことに注意してください。つまり、同じphaser_order_row_id に同じproduction_planning_product_id を 持つ 2 つのエンティティを作成することはできません。
在庫レベルの更新 #
free_amount属性を指定してPUT-requestを送信することで、製品または材料の在庫レベルを更新することができます。
