Vývojárska platforma MerchandAise

Jeden produktový proces. Štyri spôsoby prepojenia.

Prepojte webovú lokalitu, komunitu, dodávateľské operácie alebo podnikový pracovný priestor s rovnakým verziovaným dizajnom, cenovou ponukou, schválením a stavom objednávky. Začnite s publikovaným kontraktom a potom s nami naplánujte prístup a nasadenie do produkcie.

Udržujte jediný zdroj pravdy

Integrácia by mala proces MerchandAise rozširovať, nie ho vetviť. Webové stránky, vložené prvky, dodávateľské, podnikové a budúce rozhrania asistentov musia čítať a aktualizovať rovnaký verziovaný dizajn, obchodný zámer, cenovú ponuku, schválenie a stav objednávky.

Tam, kde MerchandAise spracováva transakciu kupujúceho, je zmluvným predajcom a zodpovedným obchodníkom (Merchant of Record) spoločnosť Hutter Products GmbH pod značkou MerchandAise. Identita a kontaktné údaje dodávateľa zostávajú súkromné, s výnimkou prípadov, kedy sa vyžaduje ich zverejnenie, a produkcia naďalej vyžaduje schválenie digitálneho náhľadu a fyzickej vzorky z výroby.

01 — Kontrakty

API a integračné rozhrania

Dokumentácia API pre nástroje asistentov

Preskúmajte aktuálne koncové body pre asistentov a nástroje na účely dizajnových relácií a kontroly integrácie. Tento verejný referenčný zdroj neudeľuje anonymné oprávnenie na vytváranie cenových ponúk ani zadávanie objednávok.

Prístup: public

Implementačná príručka

Otvoriť dokumentáciu k nástrojom asistentov

Strojový kontrakt

OpenAPI JSON pre nástroje asistentov

/api/docs/openapi.json

Verejná referencia pre API asistentov a nástrojov. Prístup do produkcie a operácie ovplyvňujúce objednávky naďalej vyžadujú príslušnú autorizáciu.

API pre komunitné integrácie

Prepojte lokalizované klubové, komunitné alebo obchodné prostredia s dizajnovými a obchodnými procesmi MerchandAise bez nutnosti prestavby základného workflow.

Prístup: public

Strojový kontrakt

Komunitné OpenAPI JSON

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

Verejný verziovaný kontrakt pre vložené obchody, komunitné vyhľadávanie a odovzdávanie údajov s ohľadom na lokalizáciu.

Dodávateľské API

Prepojte schválených dodávateľov s procesmi registrácie, katalógu, cenových ponúk a vybavovania objednávok po overení dodávateľského vzťahu a prístupového modelu.

Prístup: public

Strojový kontrakt

Dodávateľské OpenAPI JSON

/api/v1/supplier/openapi/v1

Verejný kontrakt na plánovanie a generovanie klientov. Prevádzkový prístup dodávateľov zostáva podmienený oprávneniami.

API pre podnikovú identitu

Naplánujte SSO, poskytovanie používateľov cez SCIM a toky identít pripravené na audit pre schválené firemné programy reklamných predmetov a riadené nasadenia.

Prístup: protected

Strojový kontrakt

OpenAPI JSON pre podnikovú identitu

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

Chránený kontrakt pre schválené podnikové pracovné priestory; pred použitím tohto koncového bodu požiadajte o prístup.

02 — Implementačná príručka

Vyberte si kontrakt ešte pred písaním kódu

01
Zmapujte cestu používateľa
Rozhodnite, kto a kde vstupuje do procesu: kupujúci vo vloženom obchode, schválený dodávateľ, podnikový používateľ alebo asistent pracujúci s výslovným oprávnením.
02
Potvrďte hranice prístupu
Na vyhodnotenie a generovanie klientov použite verejné kontrakty, potom pred implementáciou potvrďte prihlasovacie údaje, rozsahy (scopes), prostredia, spätné volania (callbacks) a chránené koncové body.
03
Preukážte kontinuitu stavu
Otestujte, či si dizajny, cenové ponuky, schválenia, chyby a odovzdania objednávok zachovávajú aktuálnu verziu v rámci celej integrácie, vrátane opakovaných pokusov a ciest pre návrat do pôvodného stavu (rollback).

03 — Čo musí každá integrácia zachovať

Čo musí každá integrácia zachovať

Jeden verziovaný stav

Dizajn, obchodný zámer, cenová ponuka krytá dodávateľom, schválenie a stav objednávky zostávajú prepojené. Neaktuálne zmeny musia vyvolať viditeľné prepočítanie ceny alebo stav kontroly.

Obchodné súkromie a súkromie dodávateľov

MerchandAise zostáva obchodníkom komunikujúcim s kupujúcim a vlastníkom podpory. Identity dodávateľov, kontakty a interné údaje nie sú prostredníctvom verejných integrácií odhalené.

Schválenie pred výrobou

Natívne 3D zobrazenie produktu a digitálny náhľad podporujú rozhodovanie, ale nenahrádzajú skutočnú fyzickú vzorku z výroby, ktorá sa vyžaduje pred spustením sériovej výroby.

Pred spustením produkčnej prevádzky

Publikovaný súbor OpenAPI slúži na plánovanie, nie je prísľubom anonymného prístupu do produkcie. Pred spustením do prevádzky kontrolujeme prostredia, prihlasovacie údaje, spracovanie chýb a prevádzkovú zodpovednosť.

Prístup a prostredia

Potvrďte verziu kontraktu, schválený pracovný priestor, rozsahy overenia (scopes), sandbox, produkčné prihlasovacie údaje a cieľové adresy pre spätné volania.

Chyby a obnova

Pred vydaním definujte opakované pokusy, idempotenciu, časové limity, chyby viditeľné pre zákazníka, monitorovanie (observability), vlastníctvo podpory a návrat do pôvodného stavu (rollback).

Kompletné overenie (End-to-end)

Overte zamýšľanú cestu v testovacom prostredí (staging) od vstupu a zmeny stavu až po cenovú ponuku, schválenie, odovzdanie a správanie pri obnove.

Často kladené otázky

S ktorým integračným rozhraním by som mal začať?

Začnite s osobou a zmenou stavu. Pre klubové alebo komunitné cesty zamerané na kupujúcich použite komunitné integrácie, pre schválené dodávateľské procesy použite dodávateľské operácie, pre SSO a SCIM použite podnikovú identitu a nástroje asistentov používajte len pre výslovne autorizované toky riadené AI.

Znamená verejný kontrakt aj verejný prístup do produkcie?

Nie. Verejný OpenAPI kontrakt slúži na oboznámenie sa s rozhraním, kontrolu architektúry a generovanie klientov. Produkčné prihlasovacie údaje, zápisové operácie, dodávateľské procesy, podniková identita a spúšťanie asistentov môžu naďalej vyžadovať schválený pracovný priestor a špecificky vymedzenú autorizáciu.

Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?

Nie. Identita a kontaktné údaje dodávateľa zostávajú súkromné, s výnimkou prípadov, kedy sa vyžaduje ich zverejnenie. MerchandAise vlastní vzťah s kupujúcim a akcie ovplyvňujúce objednávky musia zachovať nakonfigurované schvaľovacie kroky a podmienku fyzickej vzorky.

Predstavte nám svoj proces, nie hotovú architektúru.

Povedzte nám, kto bude integráciu používať, ktorý stav potrebuje čítať alebo meniť a kde bude toto prostredie fungovať. Spoločne s vami naplánujeme kontrakt, prístupový model a najbezpečnejšiu cestu nasadenia.

Naplánovať integráciu Preskúmať AI agentov a MCP

Udržujte jediný zdroj pravdy

Vyberte si kontrakt ešte pred písaním kódu

Zmapujte cestu používateľa

Rozhodnite, kto a kde vstupuje do procesu: kupujúci vo vloženom obchode, schválený dodávateľ, podnikový používateľ alebo asistent pracujúci s výslovným oprávnením.

Potvrďte hranice prístupu

Na vyhodnotenie a generovanie klientov použite verejné kontrakty, potom pred implementáciou potvrďte prihlasovacie údaje, rozsahy (scopes), prostredia, spätné volania (callbacks) a chránené koncové body.

Preukážte kontinuitu stavu

Otestujte, či si dizajny, cenové ponuky, schválenia, chyby a odovzdania objednávok zachovávajú aktuálnu verziu v rámci celej integrácie, vrátane opakovaných pokusov a ciest pre návrat do pôvodného stavu (rollback).

Čo musí každá integrácia zachovať

Jeden verziovaný stav

Obchodné súkromie a súkromie dodávateľov

MerchandAise zostáva obchodníkom komunikujúcim s kupujúcim a vlastníkom podpory. Identity dodávateľov, kontakty a interné údaje nie sú prostredníctvom verejných integrácií odhalené.

Schválenie pred výrobou

Natívne 3D zobrazenie produktu a digitálny náhľad podporujú rozhodovanie, ale nenahrádzajú skutočnú fyzickú vzorku z výroby, ktorá sa vyžaduje pred spustením sériovej výroby.

Často kladené otázky

S ktorým integračným rozhraním by som mal začať?

Znamená verejný kontrakt aj verejný prístup do produkcie?

Môže integrácia odhaliť dodávateľov alebo obísť schvaľovanie?