MerchandAise 開発者プラットフォーム
1つの製品ワークフロー。4つの接続方法。
ウェブサイト、コミュニティ、サプライヤー業務、またはエンタープライズのワークスペースを、同一のバージョン管理されたデザイン、見積もり、承認、および注文ステータスに接続します。まずは公開されたコントラクトから開始し、アクセス権と本番環境への展開計画を当社と共同で策定してください。
単一の信頼できる情報源（Source of Truth）の維持
システム連携はMerchandAiseのワークフローを拡張するものであり、分岐（フォーク）させるものではありません。ウェブサイト、埋め込み、サプライヤー、エンタープライズ、そして将来のアシスタント向けインターフェースは、すべて同一のバージョン管理されたデザイン、取引意図、見積もり、承認、および注文ステータスを参照・更新する必要があります。
Where MerchandAise processes the buyer transaction, Hutter Products GmbH is the contracting seller and Merchant of Record under the MerchandAise brand. Supplier identity and contact details stay private except where disclosure is required, and production still requires digital-proof approval, confirmed producibility, mandatory technical checks, and the sample approvals applicable to the exact accepted order.
01 — コントラクト
APIおよび統合インターフェース
01
アシスタントツールAPIドキュメント
デザインセッションや統合レビュー向けのアシスタントおよびツール用エンドポイントをご確認いただけます。この公開リファレンスは、匿名のユーザーに見積もりや注文の権限を付与するものではありません。
実装ガイド
アシスタントツール用ドキュメントを開くマシンコントラクト
アシスタントツール OpenAPI JSON/api/docs/openapi.jsonアシスタントおよびツールAPI用の公開リファレンスです。本番環境へのアクセスおよび注文に影響を与える操作には、引き続き適切な認可が必要です。
02
コミュニティ埋め込みAPI
基盤となるワークフローを再構築することなく、ローカライズされたクラブ、コミュニティ、またはストアフロントの体験を、MerchandAiseが管理するデザインおよび取引のハンドオフに接続します。
マシンコントラクト
コミュニティ OpenAPI JSON/api/v1/community/public/openapi/v1ストアフロントの埋め込み、コミュニティのディスカバリー、およびロケール対応のハンドオフ向けの、公開されたバージョン管理済みコントラクトです。
03
サプライヤーAPI
サプライヤーとの提携関係およびアクセスモデルの適格性が確認された後、承認されたサプライヤーをオンボーディング、カタログ、見積もり、およびフルフィルメント業務に接続します。
マシンコントラクト
サプライヤー OpenAPI JSON/api/v1/supplier/openapi/v1計画およびクライアント生成用の公開コントラクトです。実際のサプライヤー業務へのアクセスには、引き続き権限付与が必要です。
04
エンタープライズID API
承認された企業向けグッズプログラムや統制された展開に向けて、SSO、SCIMプロビジョニング、および監査対応のIDフローを計画します。
マシンコントラクト
エンタープライズID OpenAPI JSON/api/v1/enterprise/identity/openapi/v1承認されたエンタープライズワークスペース向けの保護されたコントラクトです。このエンドポイントを使用する前にアクセス権を申請してください。
02 — 実装ガイド
コードを書く前にコントラクトを選択する
- 01
ユーザージャーニーのマッピング
埋め込みストアフロントの購入者、承認されたサプライヤー、エンタープライズユーザー、または明示的な認可を得て動作するアシスタントなど、誰がどこからワークフローに入るかを決定します。
- 02
アクセス境界の確認
評価やクライアント生成には公開コントラクトを使用し、実装前に資格情報、スコープ、環境、コールバック、および保護されたエンドポイントを確認します。
- 03
ステータス継続性の検証
リトライやロールバック経路を含め、デザイン、見積もり、承認、エラー、および注文のハンドオフが、統合全体で常に最新バージョンに維持されていることをテストします。
03 — すべての統合において維持すべき必須要件
すべての統合において維持すべき必須要件
単一のバージョン管理されたステータス
デザイン、取引意図、サプライヤー裏付けの見積もり、承認、および注文ステータスは常に連携されます。古い変更が発生した場合は、明示的な再見積もりまたは確認ステータスをトリガーする必要があります。
取引およびサプライヤーのプライバシー保護
MerchandAiseは引き続き購入者向けの販売者およびサポートの責任者となります。サプライヤーの身元、連絡先、および内部データが公開統合を通じて公開されることはありません。
生産開始前の承認
A 3D view is not physical evidence. The confirmed quote explains any available customer-sample choices, costs, limitations, and timing. Approve the exact digital proof and complete mandatory technical checks and any required or selected sample approval before mass production. Existing accepted-order requirements remain binding.
04
本番トラフィックの開始前に
公開されたOpenAPIファイルは計画用のインターフェースであり、匿名の本番アクセスを保証するものではありません。サービス開始前に、環境、資格情報、エラー処理、および運用の責任体制をレビューします。
アクセス権と環境
コントラクトのバージョン、承認されたワークスペース、認証スコープ、サンドボックス、本番環境の資格情報、およびコールバック先を確認します。
障害とリカバリー
リリース前に、リトライ、べき等性、タイムアウト、顧客に表示されるエラー、オブザーバビリティ、サポートの責任体制、およびロールバックを定義します。
エンドツーエンドの検証
ステージング環境において、開始からステータスの変更、見積もり、承認、ハンドオフ、およびリカバリー動作に至るまで、想定されたジャーニーを検証します。
よくある質問
どの統合インターフェースから始めるべきですか？
対象となるユーザーとステータスの遷移から開始してください。購入者向けのクラブやコミュニティのジャーニーにはコミュニティ埋め込みを、承認された供給側のワークフローにはサプライヤー業務を、SSOやSCIMにはエンタープライズIDを、そして明示的に認可されたAI主導のフローにはアシスタントツールを使用します。
公開コントラクトは、本番環境への公開アクセスを意味しますか？
いいえ。公開されているOpenAPIコントラクトは、ディスカバリー、アーキテクチャのレビュー、およびクライアント生成をサポートするためのものです。本番環境の資格情報、書き込み操作、サプライヤーのワークフロー、エンタープライズID、およびアシスタントの実行には、引き続き承認されたワークスペースとスコープが設定された認可が必要です。
統合によってサプライヤー情報が公開されたり、承認プロセスをバイパスしたりすることはありますか？
No. Supplier identity and contact details remain private except where disclosure is required, MerchandAise owns the buyer relationship, and order-affecting actions must preserve the configured digital-proof, technical, and order-specific sample approval requirements.
完成されたアーキテクチャではなく、ワークフローをご提示ください。
誰が統合を利用するのか、どのステータスを読み取りまたは変更する必要があるのか、そしてその体験がどこで提供されるのかをお知らせください。最適なコントラクト、アクセスモデル、および最も安全な展開経路を共同で設計いたします。