여기에서는 주문 품목 가져오기, 생성, 업데이트 및 삭제에 대해 자세히 설명합니다.
주문 항목은 /phaser-order-rows 엔드포인트에서 액세스할 수 있습니다.
주문 품목 가져오기 #
phaser-order-rows 엔드포인트로 GET 요청을 전송하여 주문 항목을 가져옵니다:
다양한 매개변수로 주문 항목을 검색할 수 있습니다:
- 페이저_주문_ID
- 스카이플래너 내부 주문 ID는 /phaser-orders-endpoint에서 찾을 수 있습니다.
- external_id
- 주문 품목의 외부 식별자
- 예를 들어 외부 시스템(ERP 등)의 고유 식별자
- 프로덕션_계획_제품_ID
- 내부 스카이플래너 제품 ID
- products-endpoint에서 찾을 수 있습니다.
- parent_id
- 주문 품목에 하위 품목(예: 하위 제품)이 있는 경우 하위 품목은 parent_id 필드에 상위 주문 품목의 ID가 있습니다.
- 행_인덱스
- 주문 품목의 색인 번호
- 작업 번호
- 주문 항목의 작업 번호 값
- 상태
- 주문 품목 상태
- 허용된 값: 신규, 시작 또는 완료
- 위치
- 주문 항목의 포지션 값
- delivery_date
- 주문 품목의 배송 날짜
- 형식 2025-06-05T22:00:00+00:00
- 배송_날짜_조건
- 배송 날짜 검색의 선택적 조건
- 옵션: >, =, <=, =, !=
- 값을 지정하지 않으면 >= 조건이 사용됩니다.
- is_prospect
- 잠재 고객인 주문 품목만 반품
- 포함_아카이브
- 보관된(소프트 삭제된) 주문 품목을 가져오기에 포함하기
- is_archive 값으로 표시
- 수정됨
- 지정된 날짜 이후에 수정된 주문 품목 반품하기
- 형식 2025-06-05T22:00:00+00:00
- 수정된 조건
- 수정된 값 검색의 선택적 조건
- 옵션: >, =, <=, =, !=
- 값을 지정하지 않으면 >= 조건이 사용됩니다.
검색 매개변수를 다음과 같이 혼합하여 사용할 수도 있습니다:
내부 스카이플래너 ID가 있는 특정 주문 항목을 가져오려면 다음과 같이 요청하면 됩니다:
주문 항목 생성 #
주문 항목을 생성하기 전에 주문을 생성해야 한다는 점에 유의하세요!
주문 항목을 생성하려면 /phaser-order-rows 엔드포인트에 POST 요청을 보냅니다:
다음은 주문 품목을 생성할 때 사용할 수 있는 필드에 대한 개요입니다:
- 페이저_주문_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 요청을 보내면 됩니다:
주문 품목 삭제하기 #
주문 항목 삭제는 “소프트 삭제” 방법으로 수행됩니다. 실제로 주문 항목을 삭제하면 해당 주문 항목의
주문 품목을 삭제하면 시스템에서 관련 프로세스 단계도 삭제합니다.
phaser-order-rows 엔드포인트에 DELETE 요청을 보내 주문 항목을 삭제합니다:
주문 항목은 “ids ” 배열에 내부 Skyplanner 아이디를, “external_ids ” 배열에 외부 아이디를 지정하여 삭제할 수 있습니다.