Platform developer MerchandAise

Satu alur kerja produk. Empat cara terhubung.

Hubungkan situs web, komunitas, operasional pemasok, atau ruang kerja perusahaan ke desain, penawaran, persetujuan, dan status pesanan versi yang sama. Mulailah dengan kontrak yang dipublikasikan, lalu rencanakan akses dan peluncuran produksi bersama kami.

Pertahankan satu sumber kebenaran data

Integrasi harus memperluas alur kerja MerchandAise, bukan mencabangkannya. Situs web, sematan, pemasok, perusahaan, dan antarmuka asisten di masa mendatang harus membaca dan memperbarui desain, intensi perdagangan, penawaran, persetujuan, dan status pesanan versi yang sama.

Dalam hal MerchandAise memproses transaksi pembeli, Hutter Products GmbH bertindak sebagai penjual kontrak dan Merchant of Record di bawah merek MerchandAise. Identitas dan detail kontak pemasok tetap bersifat pribadi kecuali jika pengungkapan diwajibkan, dan produksi tetap memerlukan persetujuan bukti digital (digital proof) serta sampel fisik asli (genuine sample).

01 — Kontrak

Antarmuka integrasi dan API

Dokumentasi API alat asisten

Jelajahi endpoint asisten dan alat bantu saat ini untuk sesi desain dan tinjauan integrasi. Referensi publik ini tidak memberikan wewenang anonim untuk membuat penawaran atau melakukan pemesanan.

Akses: public

Panduan implementasi

Buka dokumentasi alat asisten

Kontrak mesin

JSON OpenAPI alat asisten

/api/docs/openapi.json

Referensi publik untuk API asisten dan alat bantu. Akses produksi dan operasi yang memengaruhi pesanan tetap memerlukan otorisasi yang berlaku.

API sematan komunitas

Hubungkan pengalaman klub, komunitas, atau etalase lokal ke serah terima desain dan perdagangan milik MerchandAise tanpa membangun kembali alur kerja dasarnya.

Akses: public

Kontrak mesin

JSON OpenAPI komunitas

/api/v1/community/public/openapi/v1

Kontrak terversi publik untuk sematan etalase, penemuan komunitas, dan serah terima yang menyesuaikan lokalitas.

API Pemasok

Hubungkan pemasok yang disetujui ke operasional orientasi (onboarding), katalog, penawaran, dan pemenuhan pesanan setelah hubungan pemasok dan model akses memenuhi syarat.

Akses: public

Kontrak mesin

JSON OpenAPI pemasok

/api/v1/supplier/openapi/v1

Kontrak publik untuk perencanaan dan pembuatan klien. Akses operasional pemasok tetap memerlukan izin khusus.

API identitas perusahaan

Rencanakan SSO, penyediaan SCIM, dan alur identitas yang siap diaudit untuk program merchandise perusahaan yang disetujui serta peluncuran yang terkelola.

Akses: protected

Kontrak mesin

JSON OpenAPI identitas perusahaan

/api/v1/enterprise/identity/openapi/v1

Kontrak terproteksi untuk ruang kerja perusahaan yang disetujui; ajukan permintaan akses sebelum menggunakan endpoint ini.

02 — Panduan implementasi

Pilih kontrak sebelum menulis kode

01
Petakan perjalanan pengguna
Tentukan siapa yang masuk ke alur kerja dan di mana: pembeli di etalase tersemat, pemasok yang disetujui, pengguna perusahaan, atau asisten yang beroperasi dengan otorisasi eksplisit.
02
Konfirmasikan batasan akses
Gunakan kontrak publik untuk evaluasi dan pembuatan klien, lalu konfirmasikan kredensial, cakupan (scope), lingkungan (environment), callback, dan endpoint terproteksi sebelum implementasi.
03
Buktikan kontinuitas status
Uji apakah desain, penawaran, persetujuan, kesalahan, dan serah terima pesanan tetap menggunakan versi terbaru di seluruh integrasi, termasuk jalur percobaan ulang (retry) dan pembatalan (rollback).

03 — Hal yang wajib dipertahankan oleh setiap integrasi

Hal yang wajib dipertahankan oleh setiap integrasi

Satu status terversi

Desain, intensi perdagangan, penawaran yang didukung pemasok, persetujuan, dan status pesanan tetap terhubung. Perubahan yang usang harus memicu penawaran ulang yang terlihat atau status peninjauan.

Privasi komersial dan pemasok

MerchandAise tetap menjadi merchant yang berhadapan dengan pembeli dan pemilik dukungan. Identitas, kontak, dan data internal pemasok tidak akan diekspos melalui integrasi publik.

Persetujuan sebelum produksi

Tampilan 3D bawaan produk dan bukti digital mendukung keputusan tersebut, tetapi tidak menggantikan sampel produksi asli yang wajib ada sebelum produksi massal.

Sebelum lalu lintas produksi aktif

File OpenAPI yang dipublikasikan adalah sarana perencanaan, bukan jaminan akses produksi anonim. Kami meninjau lingkungan, kredensial, penanganan kegagalan, dan kepemilikan operasional sebelum peluncuran langsung (go-live).

Akses dan lingkungan

Konfirmasikan versi kontrak, ruang kerja yang disetujui, cakupan autentikasi, sandbox, kredensial produksi, dan tujuan callback.

Kegagalan dan pemulihan

Tentukan percobaan ulang (retry), idempotensi, batas waktu (timeout), kesalahan yang terlihat oleh pelanggan, observabilitas, kepemilikan dukungan, dan pembatalan (rollback) sebelum rilis.

Bukti ujung-ke-ujung

Verifikasi perjalanan yang dimaksud di lingkungan staging mulai dari entri dan mutasi status hingga penawaran, persetujuan, serah terima, dan perilaku pemulihan.

FAQ

Antarmuka integrasi mana yang sebaiknya saya gunakan terlebih dahulu?

Mulailah dengan transisi status dan pengguna. Gunakan sematan komunitas untuk perjalanan klub atau komunitas yang berhadapan dengan pembeli, operasional pemasok untuk alur kerja sisi penawaran yang disetujui, identitas perusahaan untuk SSO dan SCIM, dan alat asisten hanya untuk alur kerja berbasis AI yang diotorisasi secara eksplisit.

Apakah kontrak publik berarti akses produksi publik?

Tidak. Kontrak OpenAPI publik mendukung penemuan, tinjauan arsitektur, dan pembuatan klien. Kredensial produksi, operasi tulis, alur kerja pemasok, identitas perusahaan, dan eksekusi asisten tetap memerlukan ruang kerja yang disetujui dan otorisasi dengan cakupan tertentu.

Apakah integrasi dapat mengekspos pemasok atau melewati persetujuan?

Tidak. Identitas dan detail kontak pemasok tetap bersifat pribadi kecuali jika pengungkapan diwajibkan, MerchandAise memiliki hubungan dengan pembeli, dan tindakan yang memengaruhi pesanan harus mempertahankan alur persetujuan yang dikonfigurasi serta gerbang sampel fisik asli.

Bawa alur kerjanya kepada kami, bukan arsitektur yang sudah jadi.

Beri tahu kami siapa yang akan menggunakan integrasi ini, status mana yang perlu mereka baca atau ubah, dan di mana pengalaman tersebut akan berjalan. Kami akan memetakan kontrak, model akses, dan jalur peluncuran teraman bersama Anda.

Rencanakan integrasi Jelajahi agen AI dan MCP

Pertahankan satu sumber kebenaran data

Pilih kontrak sebelum menulis kode

Petakan perjalanan pengguna

Tentukan siapa yang masuk ke alur kerja dan di mana: pembeli di etalase tersemat, pemasok yang disetujui, pengguna perusahaan, atau asisten yang beroperasi dengan otorisasi eksplisit.

Konfirmasikan batasan akses

Gunakan kontrak publik untuk evaluasi dan pembuatan klien, lalu konfirmasikan kredensial, cakupan (scope), lingkungan (environment), callback, dan endpoint terproteksi sebelum implementasi.

Buktikan kontinuitas status

Uji apakah desain, penawaran, persetujuan, kesalahan, dan serah terima pesanan tetap menggunakan versi terbaru di seluruh integrasi, termasuk jalur percobaan ulang (retry) dan pembatalan (rollback).

Hal yang wajib dipertahankan oleh setiap integrasi

Satu status terversi

Desain, intensi perdagangan, penawaran yang didukung pemasok, persetujuan, dan status pesanan tetap terhubung. Perubahan yang usang harus memicu penawaran ulang yang terlihat atau status peninjauan.

Privasi komersial dan pemasok

MerchandAise tetap menjadi merchant yang berhadapan dengan pembeli dan pemilik dukungan. Identitas, kontak, dan data internal pemasok tidak akan diekspos melalui integrasi publik.

Persetujuan sebelum produksi

Tampilan 3D bawaan produk dan bukti digital mendukung keputusan tersebut, tetapi tidak menggantikan sampel produksi asli yang wajib ada sebelum produksi massal.

FAQ

Antarmuka integrasi mana yang sebaiknya saya gunakan terlebih dahulu?

Apakah kontrak publik berarti akses produksi publik?

Apakah integrasi dapat mengekspos pemasok atau melewati persetujuan?