---
title: 주문 생성
description: "여기에서 모든 관련 데이터와 함께 스카이플래너에 주문을 생성하는 방법에 대한 포괄적인 가이드를 찾을 수 있습니다. 이 중 일부는 통합 [튜토리얼에서](https://skyplanner.ai/no/docs/opplaering-i-integrering/) 다루었지만 여기서는 Skyplanner 데이터 구조와 통합 프로세스에 대해 더 자세히 설명합니다. #### 데이터 구조 먼저 스카이플래너 주문이 어떻게 구조화되는지 살펴보겠습니다.…"
url: "https://skyplanner.ai/ko/docs/%ec%a3%bc%eb%ac%b8-%ec%83%9d%ec%84%b1/"
updated: "2025-10-07"
category: 통합
tags:
  - API
  - 통합
---

# 주문 생성

여기에서 모든 관련 데이터와 함께 스카이플래너에 주문을 생성하는 방법에 대한 포괄적인 가이드를 찾을 수 있습니다. 이 중 일부는 통합 [튜토리얼에서](https://skyplanner.ai/no/docs/opplaering-i-integrering/) 다루었지만 여기서는 Skyplanner 데이터 구조와 통합 프로세스에 대해 더 자세히 설명합니다.

#### 데이터 구조

먼저 스카이플래너 주문이 어떻게 구조화되는지 살펴보겠습니다. 여기에 언급된 데이터 엔티티에 대한 [API 엔드포인트는](https://integration.skyplanner.app/api/swagger) 다음과 같이 강조 표시되어 있습니다: /phaser-orders

최상위 레벨에는 **주문**(/phaser-orders)이 있습니다.

각 **주문에는** **고객**(/고객)이 *있어야*합니다.

각 **주문에는** 여러 **주문 항목**(/phaser-order-rows)이 있을 수 있습니다.

각 **주문 항목에는** **제품**(/제품)을 첨부할 *수* 있지만 필수는 아닙니다. 각 제품에는 하나의 재고(/살도)가 있습니다. 재고 엔티티는 API로 제품을 생성할 때 자동으로 생성됩니다.

각 **주문 항목에는** 여러 **작업** (일명 프로세스 단계)이 있을 수 있습니다(/phaser-jobs).

각 **작업에는** **작업 단계**(/작업 단계)가 *있어야*합니다.

![](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에서) 삭제하는 것은 *소프트 삭제* 방식으로 수행됩니다. 즉, 데이터가 실제로 데이터베이스에서 삭제되지는 않지만 *보관된* 것으로 표시됩니다. 실제로 엔티티가 삭제되면 엔티티의 is_archive 속성이 true로 설정됩니다. 보관/삭제된 엔티티는 **include_archived** 매개변수를 사용하여 API로 계속 액세스할 수 있습니다. include_archived=true인 경우, 엔티티가 보관되어 있더라도 GET 요청은 엔티티를 검색합니다.

**모든 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.** 기본 재료를 사용하지 않고 주문 항목 생성하기