---
title: 주문 항목
description: "여기에서는 주문 품목 가져오기, 생성, 업데이트 및 삭제에 대해 자세히 설명합니다. 주문 항목은 /phaser-order-rows 엔드포인트에서 액세스할 수 있습니다. #### 주문 품목 가져오기 phaser-order-rows 엔드포인트로 GET 요청을 전송하여 주문 항목을 가져옵니다: ![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png) **그림 1.** 주문 품목 가져오기 다양한 매개변수로 주문 항목을…"
url: "https://skyplanner.ai/ko/docs/%ec%a3%bc%eb%ac%b8-%ed%95%ad%eb%aa%a9/"
updated: "2025-10-08"
category: 통합
tags:
  - API
  - 통합
---

# 주문 항목

여기에서는 주문 품목 가져오기, 생성, 업데이트 및 삭제에 대해 자세히 설명합니다.

주문 항목은 /phaser-order-rows 엔드포인트에서 액세스할 수 있습니다.

#### 주문 품목 가져오기

phaser-order-rows 엔드포인트로 GET 요청을 전송하여 주문 항목을 가져옵니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-5.png)
**그림 1.** 주문 품목 가져오기

다양한 매개변수로 주문 항목을 검색할 수 있습니다:

- **페이저_주문_ID**
  - 스카이플래너 내부 **주문**ID는 /phaser-orders-endpoint에서 찾을 수 있습니다.
- **external_id**
  - 주문 품목의 외부 식별자
  - 예를 들어 외부 시스템(ERP 등)의 고유 식별자
- **프로덕션_계획_제품_ID**
  - 내부 스카이플래너 제품 ID
  - products-endpoint에서 찾을 수 있습니다.
- **parent_id**
  - 주문 품목에 하위 품목(예: 하위 제품)이 있는 경우 하위 품목은 parent_id 필드에 상위 주문 품목의 ID가 있습니다.
- **행_인덱스**
  - 주문 품목의 색인 번호

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-6-1024x278.png)
**그림 2.** 주문 항목 행 인덱스

- **작업 번호**
  - 주문 항목의 작업 번호 값
- **상태**
  - 주문 품목 상태
  - 허용된 값: **신규**, **시작** 또는 **완료**
- **위치**
  - 주문 항목의 포지션 값

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-7-1024x252.png)
그림 3. 주문 항목 위치 값

- **delivery_date**
  - 주문 품목의 배송 날짜
  - 형식 **2025-06-05T22:00:00+00:00**
- **배송_날짜_조건**
  - 배송 날짜 검색의 선택적 조건
  - 옵션: >, =, <=, =, !=
  - 값을 지정하지 않으면 **>= 조건이 사용됩니다.**
- **is_prospect**
  - 잠재 고객인 주문 품목만 반품
- **포함_아카이브**
  - 보관된(소프트 삭제된) 주문 품목을 가져오기에 포함하기
  - **is_archive** 값으로 표시
- **수정됨**
  - 지정된 날짜 이후에 수정된 주문 품목 반품하기
  - 형식 **2025-06-05T22:00:00+00:00**
- **수정된 조건**
  - 수정된 값 검색의 선택적 조건
  - 옵션: >, =, <=, =, !=
  - 값을 지정하지 않으면 **>= 조건이 사용됩니다.**

검색 매개변수를 다음과 같이 혼합하여 사용할 수도 있습니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-8.png)
**그림 4.** **phaser_order_id**및 **row_index로** 주문 항목 가져오기

내부 스카이플래너 ID가 있는 특정 주문 항목을 가져오려면 다음과 같이 요청하면 됩니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-32.png)
**그림 5.** 스카이플래너 ID 4로 주문 항목 가져오기

#### 주문 항목 생성

주문 항목을 생성하기 전에 **주문을** 생성해야 한다는 점에 유의하세요!

주문 항목을 생성하려면 /phaser-order-rows 엔드포인트에 POST 요청을 보냅니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-10-669x1024.png)
**그림** **6.** 주문 항목 생성

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-13-1024x536.png)
**그림 7.** 주문 항목 생성

다음은 주문 품목을 생성할 때 사용할 수 있는 필드에 대한 개요입니다:

- **페이저_주문_ID**
  - 주문 항목이 첨부된 **주문의** 내부 스카이플래너 ID
  - **필수 필드**
- **프로덕션_계획_주문_행_ID**
  - 주문이 Skyplanner의 생산 스케줄링 모듈로 내보내지면 **생산 계획 주문 행이라는** 별도의 엔티티가 생성되고 해당 ID가 이 필드에 설정됩니다.
  - **사용하지 않는 것이 좋습니다**(요청 필드에서 이 필드를 아예 보내지 않거나 null로 남겨두세요).
- **프로덕션_계획_제품_ID**
  - 주문 품목이 생산 중인 제품의 스카이플래너 제품 ID
  - 제품의 기본 프로세스 단계를 가져오려는 경우 필수입니다.
- **external_id**
  - 주문 품목의 고유 식별자
  - 이를 사용하여 외부 시스템(ERP 등)의 주문 항목에 스카이플래너 주문 항목을 연결할 수 있습니다.
  - **고유해야 합니다.**
- **parent_id**
  - 주문 품목이 다른 주문 품목의 하위 품목인 경우 여기에 상위 품목의 ID 값을 입력합니다.
- **행_인덱스**
  - 주문 항목 목록에서 이 항목의 위치는 다음과 같습니다.
- **작업 번호**
  - 주문 항목에 대한 정보용 작업 번호 값으로만 사용됩니다.
  - 스카이플래너 UI에 표시되지 않음
- **상태**
  - 주문 항목의 상태
  - 허용된 값: **신규, 시작, 준비, 단계적**
- **is_archive**
  - 주문 항목이 보관(소프트 삭제)되나요?
- **위치**
  - 주문 품목 식별자 값(그림 3 참조)
- **금액**
  - 총 제품 제조 수량
- **주문_금액**
  - 주문한 제품 수량
- **가격**
  - 제품 단가
- **사용_사용자 지정 재료**
  - 제품 데이터의 기본 머티리얼 설정을 사용하지 않으려면 이 값을 true로 설정합니다.
  - 기본값: **false**
- **사용_사용자_재료_계산됨**
  - 맞춤형 자재 수량은 제품 제조 수량을 기준으로 계산됩니다.
  - false로 설정하면 재료 수량이 고정됩니다.
  - 기본값: **false**
- **GET_기본_단계**
  - 제품의 기본 프로세스 단계에 따라 품목을 주문하는 프로세스 단계를 생성합니다.
  - 기본값: **false**
- **사용_계산된_작업_기간**
  - 과거 타임로그 데이터를 기반으로 프로세스 단계 기간 계산하기
  - 계산할 수 있는 데이터가 충분하지 않은 경우 기본 기간이 사용됩니다.
  - 기본값: **false**
- **sub_items**
  - 가능한 경우 제품의 하위 항목도 생성합니다.
  - 기본값: **false**
- **delivery_date**
  - 형식 2022-01-01 10:30:11
- **시작_자격_날짜**
  - 형식 2022-01-01 10:30:11
- **드로잉_식별자**
  - 도면/청사진/지침 식별자
- **설명**
  - 주문 항목 설명
- **추가_설명**
  - 주문 항목에 대한 추가 설명
- **is_prospect**
  - 주문 항목이 잠재 고객인가요?
  - 기본값: **false**

#### 주문 품목 업데이트

주문 항목 데이터를 업데이트하려면 /phaser-order-rows 엔드포인트로 PUT 요청을 보내면 됩니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-17.png)
**그림 8.**주문 품목 업데이트

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-15-1024x536.png)
**그림 9.**업데이트된 주문 항목

#### 주문 품목 삭제하기

주문 항목 삭제는 "소프트 삭제" 방법으로 수행됩니다. 실제로 주문 항목을 삭제하면 해당 주문 항목의 is_archive 값이 true로 변경됩니다. 즉, is_archive 값을 false로 업데이트하여 삭제된 주문 항목을 복원할 수 있습니다.

주문 품목을 삭제하면 시스템에서 관련 프로세스 단계도 삭제합니다.

phaser-order-rows 엔드포인트에 DELETE 요청을 보내 주문 항목을 삭제합니다:

![](https://skyplanner.ai/wp-content/uploads/2025/05/image-19.png)
**그림 10.**주문 품목 삭제하기

주문 항목은 **"ids** " 배열에 내부 Skyplanner 아이디를, **"external_ids** " 배열에 외부 아이디를 지정하여 삭제할 수 있습니다.