MerchandAise fejlesztői platform

Egyetlen termék-munkafolyamat. Négyféle kapcsolódási mód.

Csatlakoztasson weboldalt, közösséget, beszállítói rendszert vagy vállalati munkaterületet ugyanahhoz a verziózott tervezési, árajánlati, jóváhagyási és rendelési állapothoz. Kezdjen a közzétett szerződéssel, majd tervezze meg velünk a hozzáférést és az éles üzemi bevezetést.

Őrizze meg az egyetlen hiteles forrást

Az integrációnak ki kell terjesztenie a MerchandAise munkafolyamatot, nem pedig elágaztatnia azt. A weboldalaknak, beágyazásoknak, beszállítói, vállalati és jövőbeli asszisztens-felületeknek ugyanazt a verziózott tervezési, kereskedelmi szándék-, árajánlati, jóváhagyási és rendelési állapotot kell olvasniuk és frissíteniük.

Ahol a MerchandAise dolgozza fel a vevői tranzakciót, ott a Hutter Products GmbH a szerződéses eladó és a bejegyzett kereskedő (Merchant of Record) a MerchandAise márkanév alatt. A beszállítói identitás és a kapcsolattartási adatok magánjellegűek maradnak, kivéve ha a közzététel kötelező, és a gyártáshoz továbbra is szükség van a digitális látványterv és a valódi gyártási minta jóváhagyására.

01 — Szerződések

API és integrációs felületek

Asszisztens-eszközök API dokumentáció

Fedezze fel a tervezési munkamenetekhez és az integráció felülvizsgálatához használható aktuális asszisztens- és eszköz-végpontokat. Ez a nyilvános hivatkozás nem biztosít névtelen jogosultságot árajánlatkérésre vagy rendelés leadására.

Hozzáférés: public

Implementációs útmutató

Asszisztens-eszközök dokumentációjának megnyitása

Gépi szerződés

Asszisztens-eszközök OpenAPI JSON

/api/docs/openapi.json

Nyilvános hivatkozás az asszisztens- és eszköz-API-khoz. Az éles hozzáféréshez és a rendelést érintő műveletekhez továbbra is a megfelelő felhatalmazás szükséges.

Közösségi beágyazás API

Csatlakoztasson lokalizált klub-, közösségi vagy áruházi élményeket a MerchandAise tulajdonában lévő tervezési és kereskedelmi átadási pontokhoz anélkül, hogy újra kellene építenie a mögöttes munkafolyamatot.

Hozzáférés: public

Gépi szerződés

Közösségi OpenAPI JSON

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

Nyilvános, verziózott szerződés áruházi beágyazásokhoz, közösségi felfedezéshez és lokalizáció-érzékeny átadásokhoz.

Beszállítói API

Csatlakozza a jóváhagyott beszállítókat a regisztrációs, katalógus-, árajánlat- és teljesítési folyamatokhoz, miután a beszállítói kapcsolat és a hozzáférési modell minősítése megtörtént.

Hozzáférés: public

Gépi szerződés

Beszállítói OpenAPI JSON

/api/v1/supplier/openapi/v1

Nyilvános szerződés tervezéshez és kliensgeneráláshoz. Az operatív beszállítói hozzáférés továbbra is engedélyhez kötött.

Vállalati azonosítás API

Tervezzen SSO-t, SCIM-kiépítést és auditálható azonosítási folyamatokat a jóváhagyott vállalati merchandise-programokhoz és a szabályozott bevezetésekhez.

Hozzáférés: protected

Gépi szerződés

Vállalati azonosítás OpenAPI JSON

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

Védett szerződés jóváhagyott vállalati munkaterületekhez; a végpont használata előtt kérjen hozzáférést.

02 — Implementációs útmutató

Válassza ki a szerződést a kód megírása előtt

01
Térképezze fel a felhasználói utat
Döntse el, ki és hol lép be a munkafolyamatba: egy vevő egy beágyazott áruházban, egy jóváhagyott beszállító, egy vállalati felhasználó vagy egy kifejezett felhatalmazással működő asszisztens.
02
Ellenőrizze a hozzáférési határokat
Használja a nyilvános szerződéseket az értékeléshez és a kliensgeneráláshoz, majd az implementáció előtt ellenőrizze a hitelesítő adatokat, a hatóköröket (scopes), a környezeteket, a visszahívásokat (callbacks) és a védett végpontokat.
03
Biztosítsa az állapot folytonosságát
Tesztelje, hogy a tervek, árajánlatok, jóváhagyások, hibák és rendelésátadások verziója naprakész marad-e az integráció során, beleértve az újrapróbálkozási és a visszagörgetési (rollback) útvonalakat is.

03 — Amit minden integrációnak meg kell őriznie

Amit minden integrációnak meg kell őriznie

Egyetlen verziózott állapot

A tervezés, a kereskedelmi szándék, a beszállítói hátterű árajánlat, a jóváhagyás és a rendelési állapot összekapcsolva maradnak. Az elavult módosításoknak látható újbóli árajánlatkérést vagy felülvizsgálati állapotot kell kiváltaniuk.

Kereskedelmi és beszállítói adatvédelem

A MerchandAise marad a vevő felé néző kereskedő és az ügyfélszolgálat tulajdonosa. A beszállítói identitások, kapcsolatok és belső adatok nem kerülnek nyilvánosságra a nyilvános integrációkon keresztül.

Gyártás előtti jóváhagyás

A termék saját 3D nézete és a digitális látványterv támogatja a döntést, de nem helyettesíti a tömeggyártás előtt kötelezően előírt valódi gyártási mintát.

Az éles forgalom elindítása előtt

A közzétett OpenAPI fájl egy tervezési felület, nem pedig az éles környezethez való névtelen hozzáférés ígérete. Az élesítés előtt áttekintjük a környezeteket, a hitelesítő adatokat, a hibakezelést és az üzemeltetési felelősséget.

Hozzáférés és környezetek

Ellenőrizze a szerződés verzióját, a jóváhagyott munkaterületet, a hitelesítési hatóköröket (scopes), a sandboxot, az éles hitelesítő adatokat és a visszahívási célhelyeket.

Hibakezelés és helyreállítás

A kiadás előtt határozza meg az újrapróbálkozásokat, az idempotenciát, az időtúllépéseket, az ügyfelek számára látható hibákat, a megfigyelhetőséget (observability), az ügyfélszolgálati felelősséget és a visszagörgetést (rollback).

Végpontok közötti igazolás

Ellenőrizze a tervezett utat a staging környezetben a belépéstől és az állapotváltozástól kezdve az árajánlaton, jóváhagyáson és átadáson át egészen a helyreállítási folyamatokig.

GYIK

Melyik integrációs felülettel érdemes kezdenem?

Kezdje a felhasználóval és az állapotátmenettel. Használjon közösségi beágyazásokat a vevőoldali klub- vagy közösségi utakhoz, beszállítói folyamatokat a jóváhagyott kínálati oldali munkafolyamatokhoz, vállalati azonosítást az SSO és SCIM folyamatokhoz, és asszisztens-eszközöket kizárólag a kifejezetten engedélyezett, AI által vezérelt folyamatokhoz.

A nyilvános szerződés nyilvános éles hozzáférést is jelent?

Nem. A nyilvános OpenAPI szerződés a felfedezést, az architektúra felülvizsgálatát és a kliensgenerálást támogatja. Az éles hitelesítő adatok, az írási műveletek, a beszállítói munkafolyamatok, a vállalati azonosítás és az asszisztens-futtatás továbbra is jóváhagyott munkaterületet és meghatározott hatókörű felhatalmazást igényelhetnek.

Kiszivárogtathatja-e az integráció a beszállítókat, vagy megkerülheti-e a jóváhagyásokat?

Nem. A beszállítói identitás és a kapcsolattartási adatok magánjellegűek maradnak, kivéve ha a közzététel kötelező; a vevői kapcsolat a MerchandAise tulajdonában van, és a rendelést érintő műveleteknek meg kell őrizniük a beállított jóváhagyási és valódi gyártási minta ellenőrzési pontokat.

A munkafolyamatot mutassa be nekünk, ne a kész architektúrát.

Mondja el, ki fogja használni az integrációt, melyik állapotot kell olvasnia vagy módosítania, és hol fog működni a felhasználói élmény. Közösen feltérképezzük a szerződést, a hozzáférési modellt és a legbiztonságosabb bevezetési útvonalat.

Integráció tervezése AI-ágensek és MCP felfedezése

Őrizze meg az egyetlen hiteles forrást

API és integrációs felületek

Asszisztens-eszközök API dokumentáció

Közösségi beágyazás API

Beszállítói API

Vállalati azonosítás API

Válassza ki a szerződést a kód megírása előtt

Térképezze fel a felhasználói utat

Ellenőrizze a hozzáférési határokat

Biztosítsa az állapot folytonosságát

Amit minden integrációnak meg kell őriznie

Egyetlen verziózott állapot

Kereskedelmi és beszállítói adatvédelem

Gyártás előtti jóváhagyás

Az éles forgalom elindítása előtt

Hozzáférés és környezetek

Hibakezelés és helyreállítás

Végpontok közötti igazolás

GYIK

A munkafolyamatot mutassa be nekünk, ne a kész architektúrát.