QuickBooks Online連携ガイド SkyPlanner APSで生産スケジューリング

QuickBooks Onlineはマルチテナント型の単一のクラウド製品で、すべての会社が同じAccounting APIを使用します。APIはバージョンv3のREST APIです。各呼び出しでは、realm IDで対象の会社を指定します：https://quickbooks.api.intuit.com/v3/company/{realmId}/{entity}。テスト用には別のサンドボックスホストが用意されています。リクエストとレスポンスはJSON形式で、minorversionパラメータでスキーマのバージョンを選択します。（出典）

生産スケジューリングに必要なエンティティは次のとおりです。

• マスタデータ： Customer、Item（Inventory、NonInventory、Service）、Employee、Vendor。
• 需要： Estimate（TxnStatusがAccepted、明細行、ShipDate）。先に請求する製造現場では、InvoiceまたはSalesReceiptも使用します。
• 供給： PurchaseOrder（POStatusがOpen、品目と数量を含む明細行）、Bill。
• 書き戻し： Estimate、Invoice、TimeActivity、InventoryAdjustment。

読み取りにはクエリエンドポイントを使います。例えば、select * from Estimate where MetaData.LastUpdatedTime > '2026-10-01'です。部分更新が可能なため、SkyPlannerは変更するフィールドだけを送信します。Accounting APIには、受注、工順、作業区、製造オーダーのエンティティはありません。

QuickBooksのWebhookは、接続先の会社でデータが変更されるとアプリに通知します。”Webhooks automatically notify you whenever data changes in your end-user’s QuickBooks Online company files.”（エンドユーザーのQuickBooks Online会社ファイルでデータが変更されるたびに、Webhookが自動的に通知します。）（出典）スケジューリングに関係するエンティティは次のとおりです。

• Customer, Item, Employee
• Estimate, Invoice, SalesReceipt
• PurchaseOrder, Bill
• TimeActivity

操作にはCreate、Update、Delete、Merge、Voidがあります。通知に含まれるのはエンティティ名、ID、操作、最終更新日時で、レコード全体ではありません。受信側は通知を受け取った後にレコードを読み取ります。

変更データキャプチャ（GET /cdc?entities=...&changedSince=...）は、直近の取得可能期間内で、指定した日時以降の変更をすべて返します。SkyPlannerはこれを毎晩のデータ照合に使うため、Webhookを取り逃してもオーダーが古い状態のまま残ることはありません。TimeActivityは変更データキャプチャの対象外なので、クエリで照合します。（出典）

1. マスタデータの初回取り込み。 クエリエンドポイントでページを順に取得し、顧客、品目、従業員、未完了の発注書を読み取ります。QuickBooks IDをexternal_identifierに設定してSkyPlannerの顧客を作成し、品目IDをキーとして製品と材料を作成します。続いて、QuickBooksが保持しないリソース、製品ごとの工程、シフト、休暇、段取り時間を設定します。工程はCSVまたはExcelでインポートするのが最も速い方法です。

2. オーダーの同期。 Estimate、Invoice、Item、PurchaseOrderのWebhookを購読します。見積書がAcceptedになると、SkyPlannerが読み取り、見積番号をexternal_order_number、出荷日をdelivery_dateに設定してオーダーを作成します。各明細行から、製品の工程に沿って作業が作成されます。未完了の発注書の明細行は入荷予定の材料となり、作業はその入荷を待ちます。毎晩の変更データキャプチャで、取り逃したイベントをすべて捕捉します。

3. スケジュールと完了実績の書き戻し。 四つの呼び出しで結果をQuickBooksに反映します。

• Estimateの部分更新でShipDateを書き込み、QuickBooks上で約束した出荷日を計画に合わせます。
• オーダーが完了すると、POST /invoiceで見積書の明細行を含む請求書を作成し、LinkedTxnで見積書に紐づけます。Intuitでは一つの見積書に紐づけられる請求書は一つだけなので、分納の扱いは要件定義で合意します。
• POST /timeactivityで、各作業者が記録した作業時間を従業員、顧客、サービス品目に紐づけて登録します。その後、請求対象の作業時間をQuickBooksの請求書に追加できます。
• POST /inventoryadjustmentで完成品の在庫を増やし、使用した材料の在庫を減らします。Intuitは米国のQuickBooks Online PlusおよびAdvancedでこのエンティティを提供しています。（出典）

4. 製造現場での実績報告。 作業者はSkyPlanner Mobile Confirmations、Production Timer、Quick Log Modeで作業を記録します。進捗はすぐにスケジュールに反映され、Autopilotが残りの作業を再計画します。作業時間は時間実績としてQuickBooksに送信されます。給与計算にQuickBooks Timeを引き続き使う場合は、要件定義の段階で作業時間の記録経路を一つに決めます。

5. データの管理主体と競合時のルール。 稼働開始前に、次の内容を文書化します。

• 受注書はQuickBooksの画面内で管理します。PlusとAdvancedのアプリには受注書機能がありますが、この連携で読み取るのは承認済みの見積書、または先に請求する工場では請求書です。すべての受注を同じ方法で取り込めるよう、起点を一つに決めます。
• QuickBooksには工順がありません。製品ごとの工程はSkyPlannerで管理し、QuickBooksの品目に紐づけます。
• 一つの見積書に紐づける請求書は一つです。分納する場合は、納品ごとに見積書を作成するなどのルールが必要です。
• 在庫調整への対応はプランと地域で異なります。米国のPlusとAdvancedは在庫調整に対応しています。それ以外の場合は、完成品をQuickBooksに反映する方法を会計担当者と決めてください。
• Intuit Enterprise Suiteの製造指図。この機能を利用する場合は、製造と構成部品の引当をどちらのシステムで管理するかを決めます。
• バンドルはAPIでは読み取り専用です。Group品目はAPI経由で作成できないため、バンドルはQuickBooksで管理してください。
• リフレッシュトークンのローテーション。更新のたびに最新のリフレッシュトークンを保存してください。保存しないと接続が切れます。