Business Central 연동 가이드 SkyPlanner APS로 생산 스케줄링하기

연동에는 Business Central이 기본으로 제공하는 두 가지 인터페이스를 사용합니다.

1. API v2.0은 영업·구매 및 재고 데이터에 사용합니다. items, itemVariants, itemLedgerEntries, locations, unitsOfMeasure, salesOrders, salesOrderLines, purchaseOrders, purchaseOrderLines, vendors, customers, employees를 제공합니다. 제조 엔터티는 제공하지 않으므로 생산 데이터는 두 번째 인터페이스를 통해 가져옵니다.
2. OData v4 웹 서비스는 제조 데이터에 사용합니다. Web Services 페이지에서 어떤 Business Central 페이지든 OData v4 웹 서비스로 게시할 수 있습니다. 개체 유형으로 Page를 선택하고 페이지 ID와 서비스 이름을 지정한 뒤 Published를 선택하면 됩니다. AL 코드를 작성하거나 확장 기능을 배포하지 않아도 엔드포인트가 활성화됩니다. 이 연동에서는 릴리스된 생산 오더, Prod. Order Routing Lines, 작업 센터, 기계 센터, 공정 순서의 표준 페이지를 게시하며, /ODataV4/Company('{name}')/{ServiceName} 경로로 제공합니다.

게시된 페이지에서는 읽기와 쓰기가 모두 가능합니다. Microsoft는 “If an editable page is exposed as a web service, the data in the underlying table can be accessed and modified by an OData call,”(편집 가능한 페이지를 웹 서비스로 노출하면 OData 호출로 해당 테이블의 데이터에 접근하고 수정할 수 있습니다)라고 설명하며, 업데이트에는 PATCH를 사용합니다. 이 방식으로 계획 일정을 Business Central에 다시 기록합니다. 계획 담당자가 사용하는 것과 동일한 페이지와 유효성 검사를 거칩니다.

SOAP는 사용하지 마세요. Microsoft는 SOAP 웹 서비스를 사용 중단 예정으로 지정했으며, Microsoft UI 페이지를 SOAP로 게시하는 기능은 2026 릴리스 웨이브 2(v29)에서 제거됩니다.

Business Central은 POST /api/v2.0/subscriptions를 통해 items, salesOrders 같은 API v2.0 엔터티의 웹훅 구독을 지원합니다. 적용 규칙은 다음과 같습니다.

• 구독을 생성하려면 핸드셰이크가 필요합니다. 엔드포인트는 200 OK 응답과 함께 validationToken을 반환해야 합니다.
• 구독은 사흘 후 만료됩니다. PATCH로 갱신하면 핸드셰이크가 다시 실행됩니다.
• 알림에는 전체 레코드가 아니라 리소스 경로, changeType, 구독 시 지정한 clientState가 포함됩니다. 레코드는 알림을 받은 뒤 별도로 조회합니다.
• 알림은 지연 전송됩니다. Business Central 온라인은 첫 변경 후 30초를 기다리며, 이 시간 동안 변경된 레코드가 1,000개를 초과하면 하나의 collection 알림으로 전달합니다.
• 온라인에서는 환경당 웹훅 구독을 최대 200개까지 등록할 수 있습니다.

생산 오더, 공정 순서 라인, 구매 오더는 게시된 페이지와 purchaseOrders에서 몇 분마다 폴링합니다. 미완료 오더만 필터링하고 페이지 단위로 조회하면 요청 수를 Business Central의 제한보다 충분히 낮게 유지할 수 있습니다.

SkyPlanner는 상태나 일정이 바뀌면 웹훅을 전송하므로, Business Central에 다시 기록하는 작업은 이벤트 기반으로 이루어집니다.

1. 기준정보 초기 로드. 게시된 페이지에서 Certified 상태의 공정 순서와 생산 BOM, 작업 센터와 기계 센터를 가져오고, API v2.0에서 품목과 측정 단위를 가져옵니다. 각 작업 센터 또는 기계 센터를 SkyPlanner 작업장에 어떻게 매핑할지 명확히 정해야 합니다. 기계 센터 세 곳이 속한 작업 센터를 하나의 작업장 그룹으로 구성할지, 세 개의 작업장으로 구성할지 결정합니다.

2. 오더 동기화. 게시된 페이지에서 Released 상태의 생산 오더와 해당 공정 순서 라인, 구성품을 읽어옵니다. Firm Planned 상태의 오더도 스케줄링한다면 함께 가져옵니다. API v2.0에서는 미결 구매 오더 라인을 읽어옵니다. SkyPlanner는 발주한 자재를 구매 오더의 납품일에 사용 가능한 것으로 간주하고, 구매 오더가 Delivered로 표시되면 재고를 갱신합니다. 따라서 스케줄링 시 현재 재고와 입고 예정 구매분을 모두 확인합니다.

Planned 상태의 생산 오더는 절대 스케줄링하지 마세요. Microsoft에 따르면 Business Central은 “deletes them the next time you run planning.”(다음에 계획을 실행할 때 해당 오더를 삭제합니다.) Planning Worksheet는 계속 공급을 제안하고, SkyPlanner는 확정된 오더를 실제 생산 능력에 맞춰 스케줄링합니다.

3. 일정 변경 사항 반영. 표준 Prod. Order Routing 페이지를 OData v4 웹 서비스로 게시합니다. 엔진이 배치하거나 이동한 모든 공정에 대해 SkyPlanner는 If-Match ETag를 포함한 PATCH 요청을 해당 공정 순서 라인으로 보냅니다. Starting Date-Time과 Ending Date-Time을 설정하며, 공정을 대체 기계로 이동한 경우에는 Type과 No.도 설정합니다.

PATCH는 페이지와 테이블의 트리거를 실행합니다. 따라서 계획 담당자가 Prod. Order Routing 페이지를 편집할 때와 똑같이 Business Central 자체 로직으로 필드의 유효성을 검사합니다. 생산 오더 라인의 Starting 및 Ending Date-Time도 이에 따라 갱신됩니다. 수량, 상태, 원가는 Business Central에서 계속 관리합니다.

4. 현장 작업 실적 등록. 작업자는 SkyPlanner Mobile Confirmations 또는 Production Timer로 작업을 기록하며, 이 시간 기록을 통해 일정이 최신 상태로 유지됩니다. 생산 실적은 기존처럼 Business Central의 Production Journal 또는 Output Journal에서 보고할 수 있습니다.

생산 실적과 자재 소비량을 완전 자동으로 전기하려면 생산 실적 분개장 전기용 표준 Business Central API 페이지를 추가합니다. 그러면 SkyPlanner가 공정별 셋업 시간, 가동 시간, 생산 수량을 전기합니다. 전기 시 Capacity Ledger Entries가 갱신되며, 공정 순서의 마지막 공정에서 생산 실적을 전기하면 해당 품목이 재고에 추가됩니다.

생산 실적 전기 경로는 하나만 선택하세요. SkyPlanner와 Business Central의 Production Journal 양쪽에서 전기하면 항목이 중복으로 기록됩니다.

5. 관리 주체와 충돌 처리 규칙. 운영을 시작하기 전에 다음 사항을 문서화하세요.

충돌의 주된 원인은 생산 오더의 Refresh 및 Replan 기능입니다. Microsoft는 “If you use the Refresh action to recalculate production order lines, Business Central deletes the existing production order lines and calculates new lines.”(Refresh 작업으로 생산 오더 라인을 다시 계산하면 Business Central은 기존 라인을 삭제하고 새 라인을 계산합니다)라고 설명합니다. Replan도 소요 생산 능력을 바꿀 수 있으며, 구성품을 다시 계산하면 “deletes previous changes in the components.”(구성품에 적용한 이전 변경 사항이 삭제됩니다.)

Refresh를 실행한 오더는 새 버전으로 취급해 다시 동기화하고, SkyPlanner에서 재스케줄링하세요. Autopilot을 사용하면 생산에 변경이 생길 때 SkyPlanner가 자동으로 재스케줄링합니다.

• 공정 순서의 단위. Setup Time은 생산 오더당 시간이고, Run Time은 생산 수량 한 단위당 시간이며, 각각 별도의 Unit of Measure Code가 있습니다. Wait Time과 Move Time은 작업 센터의 생산 능력을 소모하지 않습니다. 작업 센터의 단위가 Days이면 하루는 여덟 시간 교대 근무가 아니라 24시간입니다. 가져올 때 단위를 변환하지 않으면 모든 소요 시간이 잘못 계산됩니다.
• 갱신되지 않은 캘린더. 해당 계획 기간에 대해 Calculate Work Center Calendar를 실행해야만 생산 능력 데이터가 생성됩니다. 초기 로드 전에 Calendar Entries Available Until 필드를 확인하세요.
• 누락된 기계 센터 생산 능력. Consolidated Calendar가 꺼져 있으면 작업 센터 자체의 생산 능력만 계획에 반영됩니다. “The machine center capacity is excluded.”(기계 센터의 생산 능력은 제외됩니다.) 작업 센터의 합계에 의존하지 말고 기계 센터의 생산 능력을 직접 읽어오세요.
• Capacity와 Efficiency. Business Central은 소요 시간을 Run Time / Efficiency / Capacity로 계산하며, 계산된 캘린더 항목에는 이미 두 값이 모두 반영되어 있습니다. Efficiency를 SkyPlanner 작업장 효율에 매핑할 때는 두 번이 아니라 한 번만 반영하세요.
• Alternate Work Center는 참고용 정보입니다. Microsoft에 따르면 이 정보는 “isn’t automatically included in planning processes.”(계획 프로세스에 자동으로 포함되지 않습니다.) 대체 자원은 SkyPlanner의 대체 작업장으로 명시적으로 설정하세요.
• 요청 제한. 온라인 환경의 제한은 사용자별로 적용되며 서비스 주체도 사용자 한 명으로 계산됩니다. 5분 이동 시간창 내 OData 요청은 6,000건, 동시 요청은 5건으로 제한됩니다. 페이지 크기는 최대 20,000건, $batch는 최대 100개 작업이며, 작업은 8분 후 시간 초과로 처리됩니다. 요청 한도를 초과하면 429가 반환됩니다. 전체 데이터를 다시 적재하는 대신 변경분을 배치 처리하고 페이지 단위로 조회하며 폴링하세요.
• 라이선스. 제조 기능은 Premium 환경에서만 제공됩니다. Essentials 사용자는 Premium으로 설정된 회사에 로그인할 수 없습니다.