---
title: 제품 및 자료
description: "여기에서는 제품 및 자료를 생성하는 방법과 Skyplanner-API를 사용하여 주문에 첨부하는 방법을 살펴봅니다. 또한 제품에 대한 기본 프로세스 단계를 생성하는 방법과 이러한 기본값을 사용하여 주문 항목을 생성하는 방법도 보여드립니다. #### 제품/자료 만들기 제품과 자료의 생성 및 업데이트는 모두 동일한 API 엔드포인트를…"
url: "https://skyplanner.ai/ko/docs/%ec%a0%9c%ed%92%88-%eb%b0%8f-%ec%9e%90%eb%a3%8c/"
updated: "2025-10-07"
category: 통합
tags:
  - API
  - 통합
---

# 제품 및 자료

여기에서는 제품 및 자료를 생성하는 방법과 Skyplanner-API를 사용하여 주문에 첨부하는 방법을 살펴봅니다. 또한 제품에 대한 기본 프로세스 단계를 생성하는 방법과 이러한 기본값을 사용하여 주문 항목을 생성하는 방법도 보여드립니다.

#### 제품/자료 만들기

제품과 자료의 생성 및 업데이트는 모두 동일한 API 엔드포인트를 통해 이루어집니다: /products. 제품의 유형은 **type-속성으로** 설정됩니다: '제품' 또는 '소재'

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-14.png)
**그림 1.** 제품 만들기

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-11.png)
**그림 2.** 자료 만들기

제품 및 소재를 생성할 때 제품 목록에 제품/소재가 활성 상태인 것으로 표시하려면 **is_active** 값을 true로 설정해야 합니다. 또한 **free_amount** 속성을 사용하여 사용 가능한 재고 수량을 설정할 수 있습니다.

#### 제품에 대한 기본 프로세스 단계 만들기

제품에 대한 기본 프로세스 단계를 추가하기 전에 적절한 워크스테이지가 있어야 합니다. 워크단계는 Skyplanner UI 또는 /workstages-endpoint를 통해 만들 수 있습니다.

기본 프로세스 단계를 추가하는 작업은 /products/jobs/{productId}-엔드포인트에서 수행합니다.

예를 들어 ID가 22220인 제품에 기본 단계를 추가하려면 다음과 같이 POST 요청을 수행합니다:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-16.png)
**그림 3.** 기본 프로세스 단계 추가하기

몇 가지 주목할 만한 필드입니다:

- 주문 번호
  - 스카이플래너가 프로세스 단계를 완료해야 하는 순서를 알려주는 인덱스 번호입니다.
  - 예를 들어, 첫 번째 단계는 값 1, 두 번째 단계는 값 3, 세 번째 단계는 값 3을 가져오는 식으로...
- 워크스테이션
  - 다음은 이 프로세스 단계를 예약할 수 있는 워크스테이션 목록입니다.
  - 여기에 워크스테이션 ID를 쉼표로 구분된 목록으로 입력합니다(예: 다음과 같이): "61,62,63"
- time_variation
  - 가능한 값: 시간당_개수, 시간당_개수, 고정 시간
- 기간, 설정 시간, 결제 시간
  - 다음 값을 *초* 단위로 제공하세요 *.*

#### 기본 프로세스 단계 업데이트하기

기본 프로세스 단계를 업데이트할 때는 **order_number** 속성을 사용하여 업데이트할 단계를 지정해야 합니다.

예를 들어, 이 제품의 첫 번째 프로세스 단계**(주문 번호 1)**는 다음과 같은 PUT 요청으로 수행됩니다:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-19.png)
**그림 4.** 기본 프로세스 단계 업데이트하기

#### 기본 프로세스 단계 삭제하기

기본 프로세스 단계를 삭제하는 것도 **주문 번호** 값을 사용하여 수행됩니다.

Order_numbers는 다음과 같은 배열로 제공됩니다:

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-21.png)
**그림 5.** 기본 프로세스 단계 삭제하기

##### 제품에 재료/부자재 추가하기

자료 또는 하위 제품을 첨부하려면 /sub-products 엔드포인트를 사용해야 합니다.

재료 또는 하위 제품의 ID를 **production_planning_product_id** 속성에, 재료/하위 제품을 첨부하려는 제품의 ID를 **production_planning_product_parent_id** 속성에 입력하면 됩니다.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-22.png)
**그림 6.** 제품에 자료 첨부하기

##### 주문 품목에 재료 추가

row-materials 엔드포인트를 사용하여 주문 항목에 직접 자료를 첨부할 수도 있습니다. 이렇게 하면 주문 항목에 추가 재료를 첨부하거나 제품에 설정된 기본 재료와 완전히 다른 재료 목록을 주문 항목에 사용할 수 있습니다. 각 재료에 대해 주문 항목에 대해 하나의 행 재료 엔티티만 가질 수 있습니다. 따라서 실제로는 동일한 **phaser_order_row_id에** 동일한 **production_planning_product_id를**가진 두 개의 엔티티를 생성할 수 없습니다.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-24.png)
**그림 7.** 주문 품목에 재료 추가하기

#### 재고 수준 업데이트하기

**free_amount** 속성을 사용하여 PUT 요청을 전송하여 제품 또는 재료 재고 수준을 업데이트할 수 있습니다.

![](https://skyplanner.ai/wp-content/uploads/2025/03/image-40.png)
**그림 8.** 재고 수준 업데이트하기