Платформа для розробників MerchandAise

Один робочий процес продукту. Чотири способи підключення.

Підключіть вебсайт, спільноту, операції постачальника або корпоративний робочий простір до єдиного та версіонованого стану дизайну, розрахунку ціни, затвердження та замовлення. Почніть із опублікованого контракту, а потім сплануйте доступ і розгортання виробництва разом із нами.

Зберігайте єдине джерело правди

Інтеграція має розширювати робочий процес MerchandAise , а не дублювати його. Вебсайт, вбудований компонент, постачальник, корпоративна система та майбутні інтерфейси асистентів повинні зчитувати й оновлювати однаковий версіонований стан дизайну, комерційного наміру, розрахунку ціни, затвердження та замовлення.

Там, де MerchandAise обробляє транзакцію покупця, Hutter Products GmbH виступає продавцем за контрактом і торговим посередником (Merchant of Record) під брендом MerchandAise . Ідентифікаційні дані та контакти постачальників залишаються конфіденційними, окрім випадків, коли вимагається їх розкриття, а для виробництва все одно потрібне схвалення цифрового макета й справжнього зразка.

01 — Контракти

Інтерфейси API та інтеграції

Документація інструментів асистентів API

Ознайомтеся з поточними кінцевими точками (endpoints) асистентів та інструментів для сесій дизайну й перевірки інтеграції. Ця публічна довідкова інформація не надає анонімних прав на розрахунок ціни чи оформлення замовлення.

Доступ: public

Посібник з впровадження

Відкрити документацію інструментів асистентів

Машинний контракт

Інструменти асистентів OpenAPI JSON

/api/docs/openapi.json

Публічна довідка для асистентів та інструментів API . Доступ до виробничого середовища та операції, що впливають на замовлення, все одно вимагають відповідної авторизації.

Вбудовування для спільнот API

Підключайте локалізовані клуби, спільноти чи вітрини до процесів дизайну та комерційної передачі від MerchandAise без необхідності перебудови базового робочого процесу.

Доступ: public

Машинний контракт

Спільнота OpenAPI JSON

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

Публічний версіонований контракт для вбудовування вітрин, пошуку спільнот та передачі даних із урахуванням локалі.

API постачальника

Підключайте затверджених постачальників до процесів адаптації (onboarding), каталогів, розрахунку ціни та виконання замовлень після узгодження відносин із постачальником та моделі доступу.

Доступ: public

Машинний контракт

OpenAPI JSON постачальника

/api/v1/supplier/openapi/v1

Публічний контракт для планування та генерації клієнтського коду. Операційний доступ постачальника залишається обмеженим за дозволами.

Корпоративна ідентифікація API

Плануйте SSO , процеси надання прав SCIM та готові до аудитів процедури ідентифікації для затверджених програм корпоративного мерчандайзу й контрольованих запусків.

Доступ: protected

Машинний контракт

Корпоративна ідентифікація OpenAPI JSON

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

Захищений контракт для затверджених корпоративних робочих просторів; надішліть запит на доступ перед використанням цієї кінцевої точки.

02 — Посібник з впровадження

Оберіть контракт перед написанням коду

01
Спроєктуйте шлях користувача
Визначте, хто і де входить у робочий процес: покупець у вбудованій вітрині, затверджений постачальник, корпоративний користувач або асистент, що діє з явним дозволом.
02
Підтвердьте межі доступу
Використовуйте публічні контракти для оцінки та генерації клієнтського коду, а перед впровадженням підтвердьте облікові дані, області дії (scopes), середовища, зворотні виклики (callbacks) і захищені кінцеві точки.
03
Доведіть неперервність стану
Перевірте, чи дизайн, цінові пропозиції, затвердження, помилки та етапи передачі замовлень залишаються актуальних версій в інтеграції, враховуючи повторні спроби (retries) та шляхи відкату (rollback).

03 — Що має зберігати кожна інтеграція

Що має зберігати кожна інтеграція

Єдиний версіонований стан

Дизайн, комерційний намір, цінова пропозиція від постачальника, статус затвердження та замовлення залишаються пов'язаними. Застарілі зміни повинні активувати видимий стан повторного розрахунку ціни або перевірки.

Комерційна конфіденційність і конфіденційність постачальників

MerchandAise залишається продавцем, що взаємодіє з покупцем, і відповідає за підтримку. Ідентифікаційні дані постачальників, їхні контакти та внутрішні дані не розголошуються через публічні інтеграції.

Затвердження перед виробництвом

Вбудований у продукт перегляд 3D та цифрові макети підтримують прийняття рішення, але вони не замінюють справжній виробничий зразок, який є обов'язковим перед початком масового виробництва.

Перед запуском виробничого трафіку

Опублікований файл OpenAPI є планом для опрацювання, а не гарантією анонімного виробничого доступу. Перед виходом у продакшн ми перевіряємо середовища, облікові дані, обробку помилок та операційну відповідальність.

Доступ і середовища

Підтвердьте версію контракту, затверджений робочий простір, області автентифікації, пісочницю (sandbox), виробничі облікові дані та адреси для зворотних викликів.

Збої та відновлення

Визначте логіку повторних спроб, ідемпотентність, таймаути, видимі для клієнта помилки, спостережуваність (observability), відповідальність за підтримку та процедури відкату перед випуском.

Сквозні перевірки (end-to-end)

Перевірте запланований шлях у тестовому середовищі (staging) — від входу та зміни стану до розрахунку ціни, затвердження, передачі та поведінки системи під час відновлення.

Часті питання

З якого інтеграційного інтерфейсу варто починати?

Починайте з користувача та переходу стану. Використовуйте вбудовані компоненти спільнот для клубів або спільнот покупців, операції постачальників для затверджених робочих процесів постачання, корпоративну ідентифікацію для SSO та SCIM , а інструменти асистентів — виключно для процесів під керівництвом AI з явними повноваженнями.

Чи означає публічний контракт публічний доступ до виробництва?

Ні. Публічний контракт OpenAPI підтримує пошук, перегляд архітектури та генерацію клієнтського коду. Виробничі облікові дані, операції запису, робочі процеси постачальників, корпоративна ідентифікація та виконання асистентів все одно можуть вимагати затвердженого робочого простору та авторизації з обмеженою областю дії.

Чи може інтеграція розкривати дані постачальників або обходити затвердження?

Ні. Ідентифікаційні дані та контакти постачальників залишаються конфіденційними, окрім випадків, коли вимагається їх розкриття, MerchandAise володіє відносинами з покупцем, а дії, що впливають на замовлення, повинні дотримуватися налаштованих шлюзів затвердження та перевірки справжнього зразка.

Надайте нам робочий процес, а не готову архітектуру.

Розкажіть нам, хто використовуватиме інтеграцію, який стан їм потрібно зчитувати чи змінювати та де розміщуватиметься інтерфейс. Ми допоможемо вам розробити контракт, модель доступу та найбезпечніший шлях розгортання.

Спланувати інтеграцію Дослідити агентів AI та MCP

Один робочий процес продукту. Чотири способи підключення.

Зберігайте єдине джерело правди

Оберіть контракт перед написанням коду

Спроєктуйте шлях користувача

Визначте, хто і де входить у робочий процес: покупець у вбудованій вітрині, затверджений постачальник, корпоративний користувач або асистент, що діє з явним дозволом.

Підтвердьте межі доступу

Використовуйте публічні контракти для оцінки та генерації клієнтського коду, а перед впровадженням підтвердьте облікові дані, області дії (scopes), середовища, зворотні виклики (callbacks) і захищені кінцеві точки.

Доведіть неперервність стану

Перевірте, чи дизайн, цінові пропозиції, затвердження, помилки та етапи передачі замовлень залишаються актуальних версій в інтеграції, враховуючи повторні спроби (retries) та шляхи відкату (rollback).

Що має зберігати кожна інтеграція

Єдиний версіонований стан

Комерційна конфіденційність і конфіденційність постачальників

Затвердження перед виробництвом

Перед запуском виробничого трафіку

Часті питання

З якого інтеграційного інтерфейсу варто починати?

Чи означає публічний контракт публічний доступ до виробництва?

Чи може інтеграція розкривати дані постачальників або обходити затвердження?

Надайте нам робочий процес, а не готову архітектуру.