# Merchandise API a integračné kontrakty | MerchandAise

- slug: developers-api-integrations
- locale: sk
- localeResolved: sk
- canonical: https://www.merchandaise.com/sk/developers/api-integrations

Preskúmajte kontrakty MerchandAise pre nástroje asistentov, komunitné integrácie, dodávateľské operácie a podnikovú identitu s jasne vymedzenými verejnými a chránenými prístupmi.

## 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.
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.

## 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. Human guide: Otvoriť dokumentáciu k nástrojom asistentov (/sk/developers/api-integrations). Machine-readable contract: OpenAPI JSON pre nástroje asistentov (/api/docs/openapi.json). Prístup: Verejný. 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. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs.
- **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. Human guide: Prezrieť si príručku pre komunitnú integráciu (/sk/developers/api-integrations#community-integrations). Machine-readable contract: Komunitné OpenAPI JSON (/api/v1/community/public/openapi/v1). Prístup: Verejný. Verejný verziovaný kontrakt pre vložené obchody, komunitné vyhľadávanie a odovzdávanie údajov s ohľadom na lokalizáciu. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations.
- **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. Human guide: Prezrieť si príručku pre integráciu dodávateľov (/sk/developers/api-integrations#supplier-integrations). Machine-readable contract: Dodávateľské OpenAPI JSON (/api/v1/supplier/openapi/v1). Prístup: Verejný. Verejný kontrakt na plánovanie a generovanie klientov. Prevádzkový prístup dodávateľov zostáva podmienený oprávneniami. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations.
- **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. Human guide: Prezrieť si príručku pre podnikovú integráciu (/sk/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON pre podnikovú identitu (/api/v1/enterprise/identity/openapi/v1). Prístup: Chránený. Chránený kontrakt pre schválené podnikové pracovné priestory; pred použitím tohto koncového bodu požiadajte o prístup. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations.

## Vyberte si kontrakt ešte pred písaním kódu
- **Step 1: 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.
- **Step 2: 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.
- **Step 3: 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:** 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:** 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.

## 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?:** 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.

## 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:** /sk/contact?intent=api-integration-review
- **Preskúmať AI agentov a MCP:** /sk/developers/ai-agents-mcp