ここでは、Skyplannerに注文を作成する方法と、関連するすべてのデータについて、包括的なガイドをご覧いただけます。その一部は統合チュートリアルで説明していますが、ここではSkyplannerのデータ構造と統合プロセスについて詳しく説明します。
データ構造 #
まず、Skyplannerの注文がどのような構造になっているかを説明します。ここで説明するデータエンティティのAPIエンドポイントは、次のようにハイライトされています：/phaser-orders
トップレベルにはオーダー（/phaser-orders）がある。
各注文には 顧客（/customers）が必要です 。
各注文は複数の注文項目（/phaser-order-rows）を持つことができます。
各注文項目には 商品(/products)を付けることができますが、必須ではありません。各商品は1つの在庫（/saldos）を持ちます。在庫エンティティは、商品がAPIで作成されるときに自動的に作成されることに注意してください。
各注文項目は複数のジョブ（別名プロセスステップ）を持つことができます（/phaser-jobs）。
各ジョブには ワークステージ（/workstages）が必要です 。
統合ワークフロー #
ERPシステムとSkyplannerをどのように連携させるか、ステップ・バイ・ステップでご紹介します。
- ERPから売上/作業指示を取得
- 顧客の 作成（レスポンスで顧客IDを取得）
- 顧客IDで注文を作成する（レスポンスで注文IDを取得する）
- ERPから販売/受注オーダーのアイテムデータを取得する
- 商品を作成する（レスポンスで商品IDを取得）
- 注文IDとその他のデータで注文アイテムを作成する（レスポンスで注文アイテムのIDを取得する）
- ERPからプロセス・ステップ・データを取得
- ワークステージを作成する（レスポンスでワークステージIDを取得する）
- ワークステージIDとその他のデータでジョブを作成する
その他のヒント #
削除について #
APIを通じて（およびUIから）phaser-orders、phaser-order-items、またはphaser-jobsを削除することは、ソフト削除の方法で行われます。これは、データが実際にデータベースから削除されるのではなく、アーカイブとしてマークされることを意味します。事実上、削除されるとエンティティのis_archive属性はtrueに設定されます。アーカイブされた/削除されたエンティティは、include_archivedパラメータを使用してAPIでアクセスすることができます。include_archived=trueの場合、GET-requestはそのエンティティがアーカイブされていても取得します。
ソフト削除はすべてのAPIエンドポイントで利用できるわけではないことに注意してください！そのため、例えば顧客や人などの削除は永久に続くので注意が必要です！
ご注文商品のデフォルト・プロセス・ステップを使用する #
オーダーアイテムが生産している製品のデフォルトのプロセスステップを作成した場合、get_default_steps属性を使用して、APIでオーダーアイテムにデフォルトをもたらすようにシステムに指示することができます。
注文商品に材料を追加する #
生産された製品に材料を添付した場合、それらは自動的に注文行に添付されます。
しかし、商品に添付されている素材を使用したくない場合（例えば、商品が特別注文で、異なる素材などを使用したい場合）、use_custom_materials属性を使用することができます。
