여기에서 모든 관련 데이터와 함께 스카이플래너에 주문을 생성하는 방법에 대한 포괄적인 가이드를 찾을 수 있습니다. 이 중 일부는 통합 튜토리얼에서 다루었지만 여기서는 Skyplanner 데이터 구조와 통합 프로세스를 더 자세히 살펴봅니다.
데이터 구조 #
먼저 스카이플래너 주문이 어떻게 구조화되는지 살펴보겠습니다. 여기에 언급된 데이터 엔티티에 대한 API 엔드포인트는 다음과 같이 강조 표시되어 있습니다: /phaser-orders
최상위 레벨에는 주문(/phaser-orders)이 있습니다.
각 주문에는 고객(/고객)이 있어야 합니다.
각 주문에는 여러 주문 항목(/단계별 주문 항목)이 있을 수 있습니다.
각 주문 항목에는 제품(/제품)을 첨부할 수 있지만 필수는 아닙니다. 각 제품에는 하나의 재고(/살도)가 있습니다. 재고 엔티티는 API로 제품을 생성할 때 자동으로 생성됩니다.
각 주문 항목에는 여러 작업 (일명 프로세스 단계)이 있을 수 있습니다(/phaser-jobs).
각 작업에는 작업 단계(/작업 단계)가 있어야 합니다.
통합 워크플로 #
다음은 ERP 시스템에서 Skyplanner로의 통합을 구성하는 방법에 대한 단계별 예시입니다.
- ERP에서 판매/작업 주문 가져오기
- 고객 생성(응답으로 고객 ID 가져오기)
- 고객 ID로 주문 생성(응답으로 주문 ID 가져오기)
- ERP에서 판매/작업지시 주문 항목 데이터 가져오기
- 제품 생성(응답으로 제품 ID 가져오기)
- 주문 ID 및 기타 데이터로 주문 항목 생성(응답으로 주문 항목 ID 가져오기)
- ERP에서 프로세스 단계 데이터 가져오기
- 워크스테이지 만들기(응답으로 워크스테이지 ID 가져오기)
- 워크스테이지 ID 및 기타 데이터로 작업 만들기
추가 팁 #
삭제 시 #
페이저 주문, 페이저 주문 항목 또는 페이저 작업을 API를 통해(그리고 UI에서) 삭제하는 것은 소프트 삭제 방식으로 수행됩니다. 즉, 데이터가 실제로 데이터베이스에서 삭제되지는 않지만 보관된 것으로 표시됩니다. 실제로 엔티티가 삭제되면 엔티티의 is_archive 속성이 true로 설정됩니다. 보관/삭제된 엔티티는 include_archived 매개변수를 사용하여 API로 계속 액세스할 수 있습니다. include_archived=true인 경우, 엔티티가 보관되어 있더라도 GET 요청은 엔티티를 검색합니다.
모든 API 엔드포인트에서 소프트 삭제를 사용할 수 있는 것은 아닙니다! 예를 들어 고객, 사람 등을 삭제하면 영구 삭제되므로 주의해야 합니다!
주문 품목에 대한 기본 프로세스 단계 사용 #
주문 품목이 생산하는 제품에 대한 기본 프로세스 단계를 생성한 경우 get_default_steps 속성을 사용하여 API를 통해 주문 품목에 기본값을 가져오도록 시스템에 지시할 수 있습니다.
주문 품목에 재료 추가 #
생산된 제품에 자료를 첨부한 경우 해당 자료는 주문 행에 자동으로 첨부됩니다.
그러나 제품에 첨부된 소재를 사용하지 않으려는 경우(예: 특별 주문 상품이고 다른 소재를 사용하려는 경우 등) use_custom_materials 속성을 사용할 수 있습니다.
