JinbaでShopifyの注文と商品を同期する方法

概要

• 手作業の注文管理では、出荷、会計、顧客対応の担当者が古いデータを使うことになります。Shopifyのorders/createWebhookは、新しい注文のデータをほぼリアルタイムで届けます。
• ワークフローは、トリガー、条件、アクションの順で構成されます。whenによる分岐とforEachによるループで、支払い済みの注文や明細を振り分けます。
• 管理のためには、ShopifyのHMAC署名を検証し、X-Shopify-Webhook-Idの重複配信を冪等に処理し、実行履歴とバージョン履歴を保持する必要があります。
• 設定では、読み取り・書き込みスコープを持つShopifyのカスタムアプリを作成し、認証情報をワークスペースのシークレットに保存して、ワークフローのWebhook URLをorders/createに登録します。
• Jinba Flowの無料プランは、メンバー2人、ワークフロー10件、APIクレジット1,000件に対応しています。クイックスタートでorders/createトリガーを約10分で検証できます。

手作業の注文管理は、規模が大きくなると対応できません。紙で注文を追跡し、タブ間でデータをコピーし、定期的にCSVを書き出す運用には直接的なコストがあります。出荷チームは古い情報で作業し、会計記録は実際の取引から遅れ、顧客対応では出荷状況を確実に把握できません。チーム間の分断は構造的な問題であり、人員を増やしても解決しません。

ShopifyのWebhookは、APIのポーリングでは追いつかないために用意されています。注文が入ると、Shopifyは登録されたエンドポイントにイベントのデータをほぼリアルタイムで送ります。運用担当者が考えるべきなのは、何がそのデータを受け取り、次に何をするかです。

Jinba Flowは、その問いに応える企業向け自動化プラットフォームです。SOC 2 Type II認証、HIPAA準拠、GDPR EU 2016/679への対応を備え、SSO、RBAC、エンドツーエンド暗号化、組み込みの監査ログを提供します。これらの認証は、注文データを扱うプラットフォームが、コンプライアンス部門がベンダーに求める基準を満たすことを示します。

このガイドでは、ShopifyとJinba Flowを接続し、新しい注文でワークフローを開始して、出荷と会計のステップへデータを振り分ける方法を説明します。

前提条件 ShopifyとJinbaの接続

ワークフローを構築する前に、API認証情報を発行するShopifyのカスタムアプリと、その情報を安全に保存するJinba Flowのシークレットの2つを設定します。

パート1 Shopifyカスタムアプリの作成

カスタムアプリは、Jinbaに必要なAPIキーとアクセストークンを取得する標準的な方法です。Shopifyの管理画面でSettings -> Apps and sales channels -> Develop appsを開き、新しいアプリを作成してAdmin APIのアクセススコープを設定します。

ワークフローの処理に応じて、以下のJinbaのドキュメントに記載されたスコープを付与します。

読み取りスコープ

• read_products
• read_orders
• read_customers
• read_inventory
• read_analytics

書き込みスコープ

• write_products
• write_orders
• write_customers
• write_inventory
• write_fulfillments

アプリをインストールしたら、API Key、API Secret Key、Access Tokenをコピーします。これらは機密性のある認証情報として扱います。Jinbaのドキュメントでも、公開リポジトリには決してコミットしないよう明確に注意しています。

パート2 Jinba FlowでShopify認証情報を設定

1. 次の画面を開きます：Jinba Flowのワークスペース。
2. 設定画面のWorkspace Settingsを開きます。
3. 設定項目のSecretセクションを選択します。
4. 連携先のShopifyを探し、ConfigureまたはAdd Newをクリックします。
5. パート1のアプリから取得したAPI Key、API Secret Key、Store URL、Access Tokenを入力します。

保存後は、ワークフロー定義自体に認証情報を露出せず、ワークスペース内のワークフローで利用できます。

Shopify注文同期ワークフローの構築

Jinba Flowはトリガーから条件、アクションへ進むモデルを採用しています。トリガーイベントから始まり、一連のステップを実行します。任意のロジックとして、forEachによるループ、whenによる条件、needsによる依存関係を、Step Module Optionsで利用できます。

ステップ1 Shopify Webhookをトリガーに設定

注文同期に使う主なWebhookトピックはorders/createです。顧客が購入手続きを完了すると、Shopifyが注文の全データとともにこのイベントを発行します。

Jinbaで受信するには、Advanced Input Toolsを使います。Webhookのほか、SlackイベントやTwilio SMSなどの入力も受け付けます。Jinbaが発行する固有のHTTPSエンドポイントURLを、Shopify管理画面のSettings -> Notifications -> WebhooksでWebhookの送信先として登録し、orders/createをイベントトピックに選択します。

以降は、新しい注文のデータが直接ワークフローへ届きます。

ステップ2 ワークフローのロジックを構築

イベントのorders/createデータが届くと、後続ステップで解析して処理できます。注文オブジェクトには明細、顧客情報、配送先住所、支払い状態が含まれます。後続ステップはこれらのフィールドを読み、次のシステムへ渡せます。

ここに振り分けルールを設定します。when条件で分岐し、支払い済みの注文は出荷へ、支払い待ちの注文は確認ステップへ送ります。forEachループでは、商品ごとに処理が必要な場合、明細を順に扱えます。

ステップ3 構築用の画面を選択

Jinba Flowには3つの作成方法があり、構築する人に応じて選びます。

• Chat Panel（Jinba Copilot）：コード不要の方法を好む運用担当者向けの、自然言語による入力。
• Graph Editor：ドラッグとドロップで、ステップごとにフローを描く視覚的な画面。
• YAMLマニフェスト：バージョン管理と再現可能なデプロイを求める開発者向けの、コード形式。

いずれも同じ内部のワークフロー定義を生成します。技術的な経験が異なるメンバーも、同じワークフローを別の画面から扱えます。

注文データの振り分け 出荷と会計

出荷への振り分け

物流委託先、倉庫、ERPを使う場合、orders/createのデータ受信後に、出荷を担当する相手のAPIへリクエストを送ります。配送先住所、明細、数量などのフィールドをリクエスト本文として渡します。

アプリ設定時に付与したwrite_fulfillmentsとwrite_ordersのスコープは書き戻しにも使えます。物流委託先が出荷を確認したら、後続のアクションで同じ認証情報を使い、Shopifyの注文に追跡情報を更新できます。

これにより、顧客対応と出荷チームの分断を直接解消できます。別々のシステムを手で更新するのではなく、両者がイベントに基づく同じ記録を参照します。

会計ソフトへの注文同期

ShopifyのWebhookドキュメントでは、注文データと会計ソフトの連携を主な用途に挙げています。処理は明確です。会計システムが求めるスキーマに注文データを整形し、そのAPIエンドポイントへPOSTします。

QuickBooks、Xero、NetSuiteに対応するA2Xを使う場合、JinbaのステップでA2X APIに注文データを送ります。A2XはSubledgerを、大量の取引を扱うブランド向けの受注から入金までの照合製品と位置付けており、この振り分け先として実用的です。

その結果、Shopifyの各注文が、手動入力なしで対応する会計記録を作成し、Jinbaの監査ログがすべての実行を記録します。

JinbaによるShopify商品の同期

注文同期が主な用途ですが、Jinba Flowには商品管理向けのツールも記載されています。

JinbaのShopifyツールドキュメントは、2つの組み込みツールを説明しています。

• SHOPIFY_LIST_PRODUCTS：商品一覧を取得します。入力としてshop_domainとlimitを受け取ります。
• SHOPIFY_CREATE_PRODUCT：新しい商品を作成します。title、description、vendor、product_type、status（例：DRAFT）を受け取ります。

これらもSecretセクションで設定した同じShopify認証情報を使います。外部のPIMから商品を作成したり、仕入先のフィードから新しい掲載情報を送ったりするワークフローは、SHOPIFY_CREATE_PRODUCTを、設定済みのwrite_productsスコープとともに使います。

Jinbaのドキュメントから直接引用した、Shopifyツールを呼び出すYAML設定の例です。

config:
token: "{{secrets.SHOPIFY_API_TOKEN}}"
api_version: "2025-01"
input:
shop_domain: "jinbaflow.myshopify.com"
limit: 10

{{secrets.SHOPIFY_API_TOKEN}}の参照は、先ほど設定したワークスペースのSecretから取得し、認証情報をワークフロー定義に含めないようにします。

ガバナンス ワークフロー内の注文データを追跡

Jinbaに組み込まれた監査機能

Jinbaのプラットフォームはコンプライアンスへの対応を重視しています。ホームページには、認証イベント、ロールの割り当て、設定変更を記録するライブのaudit_stream.logが表示されます。このログは追加の報告機能ではなく、製品の中核の一部です。

Shopifyの自動化では、特に2つの機能が重要です。

• 実行履歴：どのバージョンを実行し、入力データに何が含まれ、各ステップが何を返したかを含む、すべてのワークフロー実行の記録。
• バージョン履歴：ワークフロー定義の完全な変更履歴。特定の注文を処理した時点の設定を正確に追跡できます。

SOC 2 Type II認証、HIPAA準拠、GDPR対応により、これらの記録は企業のコンプライアンス・財務チームが求める証拠の基準を満たします。

Shopify Webhookの検証

完全な監査証跡には、ワークフローに入るデータがShopifyから来たことの検証が必要です。Shopifyのドキュメントは、2つの運用を示しています。

1. HMAC署名を検証：各Webhook配信には署名ヘッダーが含まれます。検証により、データがShopifyから届き、転送中に変更されていないことを確認します。
2. 重複配信に対応：Shopifyは同じイベントを複数回配信することがあります。X-Shopify-Webhook-Idヘッダーで固有のイベントを冪等に処理し、出荷処理や会計記録の重複を防ぎます。

この2つの手順により、各注文に対してワークフローが何を、いつ行ったかを正確に検証するための情報が得られます。

はじめに

Jinba FlowによるShopify自動化は、壊れやすい手作業を、イベントに基づく管理されたプロセスに置き換えます。新しい注文が即座にワークフローを開始し、人の介入なしで出荷と会計システムへデータが届きます。すべての実行が記録され、監査できます。

運用上の効果は具体的です。出荷チームは最新データで作業し、会計記録は注文時に作成され、コンプライアンス部門は全ステップの検証可能な記録を得られます。

Jinbaの無料プランは、メンバー2人、ワークフロー10件、APIクレジット1,000件に無料で対応します。ドキュメントのクイックスタートでは10分で最初のワークフローを実行できます。まずクイックスタートから始め、Shopifyストアを接続して、orders/createトリガーを検証してから、全体の振り分けルールを構築します。

よくある質問

ShopifyをJinba Flowに接続するにはどうすればよいですか

Shopifyのカスタムアプリを作成してAPI認証情報を取得し、Jinba FlowのWorkspace SettingsにShopifyのシークレットとして保存します。保存すると、ワークフロー定義にAPIキーを露出せずにShopifyへアクセスできます。

新しい注文の自動化にはどのWebhookイベントを使いますか

注文作成を通知するorders/createWebhookイベントを使います。顧客が購入手続きを完了すると、Shopifyが注文の全データとともに発行するため、Jinba Flowはほぼリアルタイムで出荷と会計へ注文データを送れます。

注文の出荷にJinba Flowが必要とするShopify APIスコープは何ですか

注文同期と出荷には、read_orders、write_orders、read_products、write_fulfillments、read_inventoryと、Jinbaが記載する関連の読み取り・書き込みスコープを付与します。正確な範囲は、注文を読むだけか、追跡情報も書き戻すかで異なります。

Jinba Flowは注文だけでなくShopifyの商品も同期できますか

はい。Jinba FlowにはSHOPIFY_LIST_PRODUCTSやSHOPIFY_CREATE_PRODUCTなどの組み込みツールがあり、ワークスペースのシークレットに保存した同じ認証情報を使います。独自のAPIコードを書かずに、商品作成や一覧取得のワークフローを構築できます。

Shopify Webhookによる出荷や会計記録の重複をどう防ぎますか

Jinba FlowはShopifyのX-Shopify-Webhook-Idヘッダーを使った冪等なWebhook処理に対応します。固有のWebhook IDを1回だけ処理することで、Shopifyが配信を再試行した場合の出荷や会計記録の重複を避けられます。

Shopifyの会計でQuickBooksやXeroと連携できますか

はい。Jinba FlowでShopify注文データを整形し、QuickBooks、Xero、NetSuiteなどへPOSTできます。大量の取引を扱うShopifyブランドの受注から入金までの照合にSubledgerが対応しているため、A2Xは実用的な送信先です。

Jinba FlowはShopifyの注文データを安全に扱えますか

はい。Jinba FlowはSOC 2 Type II認証、HIPAA準拠、GDPR EU 2016/679への対応を備えます。SSO、RBAC、エンドツーエンド暗号化、組み込みの監査ログも提供し、Shopifyから出荷・会計システムへ注文データを送る際に役立ちます。

Jinba Flowで注文同期を構築するにはプログラミングが必要ですか

いいえ。自然言語のChat Panel、視覚的なGraph Editor、開発者向けのYAMLマニフェストという3つの作成方法があります。チームは技術レベルに合う方法で、同じ内部のワークフローを作成できます。

Shopifyの自動化にJinba Flowはいくらかかりますか

無料プランは、メンバー2人、ワークフロー10件、APIクレジット1,000件に無料で対応します。Shopifyストアを接続し、orders/createトリガーを検証して、最初のワークフローを実行するのに十分です。その後に有料プランへ移れます。