---
title: オーダーの作成
description: ここでは、Skyplannerに注文を作成する方法と、関連するすべてのデータにつ…
url: "https://skyplanner.ai/ja/docs/%e6%b3%a8%e6%96%87%e3%81%ae%e4%bd%9c%e6%88%90/"
updated: "2025-10-07"
category: 統合
tags:
  - API
  - 統合
---

# オーダーの作成

ここでは、Skyplannerに注文を作成する方法と、関連するすべてのデータについて、包括的なガイドをご覧いただけます。その一部は統合[チュートリアルで](https://skyplanner.ai/no/docs/opplaering-i-integrering/)説明していますが、ここではSkyplannerのデータ構造と統合プロセスについて詳しく説明します。

#### データ構造

まず、Skyplannerの注文がどのような構造になっているかを説明します。ここで説明するデータエンティティの[APIエンドポイントは](https://integration.skyplanner.app/api/swagger)、次のようにハイライトされています：/phaser-orders

トップレベルには**オーダー**（/phaser-orders）がある。

**各注文には** **顧客**（/customers）が*必要です*。

**各注文は**複数の**注文項目**（/phaser-order-rows）を持つことができます。

**各注文項目には** **商品**(/products)を付ける*ことが*できますが、必須ではありません。**各商品は**1つの**在庫**（/saldos）を持ちます。在庫エンティティは、商品がAPIで作成されるときに自動的に作成されることに注意してください。

**各注文項目は**複数の**ジョブ**（別名プロセスステップ）を持つことができます（/phaser-jobs）。

**各ジョブには** **ワークステージ**（/workstages）が*必要です*。

![](https://skyplanner.ai/wp-content/uploads/2025/02/phaser-order.drawio-1-655x1024.png)
**図1**オーダーと関連データの構造

#### 統合ワークフロー

ERPシステムとSkyplannerをどのように連携させるか、ステップ・バイ・ステップでご紹介します。

1. ERPから売上/作業指示を取得
2. **顧客の**作成（レスポンスで顧客IDを取得）
3. 顧客IDで**注文を**作成する（レスポンスで注文IDを取得する）
4. ERPから販売/受注オーダーのアイテムデータを取得する
5. **商品を**作成する（レスポンスで商品IDを取得）
6. 注文IDとその他のデータで**注文アイテムを**作成する（レスポンスで注文アイテムのIDを取得する）
7. ERPからプロセス・ステップ・データを取得
8. **ワークステージを**作成する（レスポンスでワークステージIDを取得する）
9. ワークステージ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でオーダーアイテムにデフォルトをもたらすようにシステムに指示することができます。

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-158.png)
**図2.** デフォルトのプロセスステップで新しいオーダーアイテムを作成する

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

生産された製品に材料を添付した場合、それらは自動的に注文行に添付されます。

しかし、商品に添付されている素材を使用したくない場合（例えば、商品が特別注文で、異なる素材などを使用したい場合）、**use_custom_materials**属性を使用することができます。

![](https://skyplanner.ai/wp-content/uploads/2025/02/image-159.png)
**図3.** デフォルトの材料を使用せずに注文項目を作成する