Comarch ERP XL連携ガイド SkyPlanner APSで生産スケジューリング

ComarchはERP XLとの通信方法として三つを挙げています。”DCOM, direct database connection (SQL Client), REST API”（DCOM、データベースへの直接接続（SQL Client）、REST API）（Comarch、翻訳）。生産スケジューラとの連携で中心となるのは、次の二つです。

1. XL API (CDN_API.DLL). “These functions are collected in the CDN_API.DLL library, installed together with the whole Comarch ERP XL system.”（これらの関数はCDN_API.DLLライブラリにまとめられており、Comarch ERP XLシステム全体とともにインストールされます。）（Comarchヘルプ、翻訳）外部プログラムはXLLoginでログオンし、同じセッションを共有する関数を呼び出した後、XLLogoutでログオフします。各構造体のWersjaフィールドで、使用するERP XLリリースに対応したパラメータセットのバージョンを選択します。
2. ERP XL Web REST API. Comarch ERP XL Web 2026.0はRESTマイクロサービスを公開しています。”Each RestAPI microservice exposes its own interactive documentation at the /swagger endpoint.”（各RestAPIマイクロサービスは、/swaggerエンドポイントで専用の対話型ドキュメントを公開しています。）（Comarchヘルプ、翻訳）

SQL Clientによる直接接続では、IT部門およびComarchパートナーとの合意に基づき、ERP XLデータベースからマスタデータや指図・発注データを読み取ります。

生産向けXL API関数

Comarchは、次の生産向け関数をドキュメントで説明しています（XL128）。

確認したドキュメントでは、Comarch ERP XLの外部送信用Webhookは公開されていません。Comarch自社のAPSは、計画担当者が「Aktualizuj dane z ERP」（ERPからデータを更新）を押すとデータを取得します（Comarch APSヘルプ）。

そのため、ERP XL側のデータはポーリングで取得します。未完了の製造指図と直近の変更に絞って読み取り、新たな作業を取り込みます。頻度は工場ごとに設定し、製造指図は数分おき、在庫は毎時といった間隔で取得します。

SkyPlannerは状態やスケジュールが変わるとWebhookを送信するため、書き戻し側はイベント駆動で動作します。

1. マスタデータの初回取り込み。 品目、製造技術情報、作業区、リソース、カレンダーを読み取ります。作業区とSkyPlannerの対応付けは、運用を考慮して決めます。四台の機械を持つ作業区は、一つのリソースグループ、または四つのリソースに対応付けます。ERP XLのリソースに登録された工具は、SkyPlannerで数量制約のある工具として扱い、従業員はシフトを持つ要員として登録します。

2. 指図・発注の同期。 工程と材料を含む製造指図、および未完了の購買発注を読み取ります。SkyPlannerは発注済みの材料を購買発注の納入日に使用可能とみなし、購買発注のステータスがDeliveredになると在庫を更新します。

3. スケジュールの書き戻し。エンジンが工程を配置または移動すると、SkyPlannerのWebhookが書き戻しサービスを起動します。このサービスは工程のTerminOdとTerminDoを指定してXLDodajTerminDoProcesuProdを呼び出し、各ZP工程にSkyPlannerの計画開始日時と終了日時を反映します。

4. 製造現場の実績報告。作業者はSkyPlanner Mobile ConfirmationsまたはProduction Timerで作業を記録し、その時間記録によってスケジュールが最新に保たれます。実績時間を書き戻すかどうかは選択できます。書き戻す場合、サービスはXLDodajRealizacjeOperacjiProdで実績を追加します。RWとPWの伝票は、お客様のERP XLのルールに従います。一部の作業場所でComarch MESを使用している場合は、工程ごとに報告元を一つに統一してください。

5. データの管理主体と競合時のルール。本稼働前に、次の内容を明文化してください。

工程日時を書き込むシステムは一つに統一してください。ERP XLの自動再計画やComarch APSが同じ製造指図に日時を書き込んでいる場合は、SkyPlannerでスケジューリングする指図について、その機能を無効にしてください。

• 数値で設定する能力。ERP XLでは、作業区の能力をユーザー定義の数値と許容負荷率（%）で設定します。一方、SkyPlannerは実際のシフトとリソースから能力を算出します。負荷率は引き継がず、シフトを正確に設定してください。
• 能力無制限のリソース。ERP XLでは、能力無制限に設定されたリソースの占有状況をチェックしません。SkyPlannerで能力に上限のあるリソースとして扱うかどうかを、リソースごとに決めてください。
• 製造へリリース済みの指図。ERP XLでは、「Przesuń na zwolnionych」にチェックを入れない限り、製造へリリース済みの工程は再計画の対象になりません。リリース済みの指図にSkyPlannerの日時をどう適用するかを合意し、Running Time Lockで直近の数時間の作業を固定してください。
• 構造体のバージョン。XL APIの構造体にはWersjaフィールドがあります。使用中のERP XLのリリースに合わせて設定し、毎年のアップグレード後に再テストしてください。
• ポーランドの単位と時間。工程時間とカレンダーの単位は、取り込み時に正確に変換する必要があります。変換を誤ると、すべての所要時間が不正確になります。