Platforma deweloperska MerchandAise

Jeden proces produktowy. Cztery sposoby na integrację.

Połącz stronę internetową, społeczność, operacje dostawców lub przestrzeń roboczą przedsiębiorstwa z tym samym wersjonowanym stanem projektu, wyceny, zatwierdzenia i zamówienia. Zacznij od opublikowanego kontraktu, a następnie zaplanuj z nami dostęp i wdrożenie produkcyjne.

Zachowaj jedno źródło prawdy

Integracja powinna rozszerzać proces MerchandAise, a nie tworzyć jego rozgałęzienia. Strony internetowe, elementy osadzone, systemy dostawców, przedsiębiorstw oraz przyszłe interfejsy asystentów muszą odczytywać i aktualizować ten sam wersjonowany stan projektu, intencji handlowej, wyceny, zatwierdzenia i zamówienia.

W przypadkach, gdy MerchandAise przetwarza transakcję kupującego, Hutter Products GmbH jest sprzedawcą kontraktowym i podmiotem odpowiedzialnym za sprzedaż (Merchant of Record) pod marką MerchandAise. Tożsamość i dane kontaktowe dostawców pozostają poufne, z wyjątkiem sytuacji, gdy wymagane jest ich ujawnienie, a produkcja nadal wymaga zatwierdzenia cyfrowej próby oraz rzeczywistej próbki produkcyjnej.

01 — Kontrakty

Obszary integracji i API

Dokumentacja API narzędzi asystenckich

Poznaj aktualne punkty końcowe dla asystentów i narzędzi do obsługi sesji projektowych oraz przeglądu integracji. To publiczne źródło referencyjne nie uprawnia do anonimowego wnioskowania o wycenę ani składania zamówień.

Dostęp: public

Podręcznik wdrożenia

Otwórz dokumentację narzędzi asystenckich

Kontrakt maszynowy

Plik JSON OpenAPI narzędzi asystenckich

/api/docs/openapi.json

Publiczne źródło referencyjne dla API asystentów i narzędzi. Dostęp produkcyjny oraz operacje wpływające na zamówienia nadal wymagają odpowiedniej autoryzacji.

API do osadzania społeczności

Połącz lokalne kluby, społeczności lub witryny sklepowe z procesami projektowania i transakcji obsługiwanymi przez MerchandAise, bez konieczności przebudowywania bazowego przepływu pracy.

Dostęp: public

Kontrakt maszynowy

Plik JSON OpenAPI dla społeczności

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

Publiczny, wersjonowany kontrakt dla osadzonych witryn sklepowych, wyszukiwania społeczności i przekazywania danych z uwzględnieniem lokalizacji.

API dostawcy

Połącz zatwierdzonych dostawców z procesami wdrożenia, katalogu, wyceny i realizacji zamówień po zweryfikowaniu relacji z dostawcą i modelu dostępu.

Dostęp: public

Kontrakt maszynowy

Plik JSON OpenAPI dostawcy

/api/v1/supplier/openapi/v1

Publiczny kontrakt do planowania i generowania klientów. Operacyjny dostęp dostawcy wymaga posiadania odpowiednich uprawnień.

API tożsamości przedsiębiorstwa

Zaplanuj SSO, aprowizację SCIM oraz zgodne z wymogami audytu przepływy tożsamości dla zatwierdzonych programów artykułów reklamowych i kontrolowanych wdrożeń.

Dostęp: protected

Kontrakt maszynowy

Plik JSON OpenAPI tożsamości przedsiębiorstwa

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

Chroniony kontrakt dla zatwierdzonych przestrzeni roboczych przedsiębiorstw; poproś o dostęp przed użyciem tego punktu końcowego.

02 — Podręcznik wdrożenia

Wybierz kontrakt przed napisaniem kodu

01
Odwzoruj ścieżkę użytkownika
Zdecyduj, kto i w którym miejscu dołącza do procesu: kupujący w osadzonej witrynie sklepowej, zatwierdzony dostawca, użytkownik korporacyjny czy asystent działający na podstawie wyraźnego upoważnienia.
02
Potwierdź granice dostępu
Użyj publicznych kontraktów do oceny i generowania klientów, a następnie przed wdrożeniem potwierdź dane uwierzytelniające, zakresy, środowiska, adresy zwrotne (callbacks) i chronione punkty końcowe.
03
Zweryfikuj ciągłość stanu
Przetestuj, czy projekty, wyceny, zatwierdzenia, błędy i przekazywanie zamówień zachowują aktualność wersji w ramach integracji, w tym w przypadku ponownych prób i ścieżek wycofywania zmian (rollback).

03 — Co musi zachować każda integracja

Co musi zachować każda integracja

Jeden wersjonowany stan

Projekt, intencja handlowa, wycena oparta na ofercie dostawcy, zatwierdzenie i status zamówienia pozostają połączone. Nieaktualne zmiany muszą wywołać widoczny stan ponownej wyceny lub weryfikacji.

Poufność handlowa i dane dostawców

MerchandAise pozostaje sprzedawcą obsługującym kupującego i właścicielem wsparcia. Tożsamość dostawców, kontakty i dane wewnętrzne nie są ujawniane za pośrednictwem publicznych integracji.

Zatwierdzenie przed produkcją

Natywny widok 3D produktu i cyfrowa próba wspierają podjęcie decyzji, ale nie zastępują rzeczywistej próbki produkcyjnej wymaganej przed rozpoczęciem produkcji masowej.

Przed uruchomieniem ruchu produkcyjnego

Opublikowany plik OpenAPI służy do planowania, a nie stanowi obietnicy anonimowego dostępu produkcyjnego. Przed uruchomieniem produkcyjnym weryfikujemy środowiska, dane uwierzytelniające, obsługę błędów i odpowiedzialność operacyjną.

Dostęp i środowiska

Potwierdź wersję kontraktu, zatwierdzoną przestrzeń roboczą, zakresy uwierzytelniania, środowisko testowe (sandbox), dane uwierzytelniające do środowiska produkcyjnego oraz docelowe adresy zwrotne (callbacks).

Obsługa błędów i przywracanie działania

Przed wydaniem zdefiniuj ponowne próby, idempotentność, limity czasu (timeouts), błędy widoczne dla klientów, monitorowanie (observability), odpowiedzialność za wsparcie oraz wycofywanie zmian (rollback).

Weryfikacja end-to-end

Zweryfikuj zaplanowaną ścieżkę w środowisku testowym (staging) – od wejścia i zmiany stanu, przez wycenę, zatwierdzenie, przekazanie, aż po zachowanie w przypadku przywracania działania.

FAQ

Od którego obszaru integracji powinienem zacząć?

Zacznij od użytkownika i przejścia stanu. Użyj osadzania społeczności dla ścieżek klubowych lub społecznościowych skierowanych do kupujących, operacji dostawców dla zatwierdzonych procesów po stronie dostaw, tożsamości przedsiębiorstwa dla SSO i SCIM, a narzędzi asystenckich wyłącznie dla wyraźnie autoryzowanych procesów kierowanych przez AI.

Czy publiczny kontrakt oznacza publiczny dostęp produkcyjny?

Nie. Publiczny kontrakt OpenAPI służy do analizy, przeglądu architektury i generowania klientów. Dane uwierzytelniające do środowiska produkcyjnego, operacje zapisu, procesy dostawców, tożsamość przedsiębiorstwa oraz uruchamianie asystentów mogą nadal wymagać zatwierdzonej przestrzeni roboczej i autoryzacji o określonym zakresie.

Czy integracja może ujawnić dostawców lub pominąć zatwierdzenia?

Nie. Tożsamość i dane kontaktowe dostawców pozostają poufne, z wyjątkiem sytuacji, gdy wymagane jest ich ujawnienie. MerchandAise odpowiada za relacje z kupującym, a działania wpływające na zamówienie muszą zachować skonfigurowane etapy zatwierdzania oraz wymóg rzeczywistej próbki.

Przedstaw nam proces, a nie gotową architekturę.

Powiedz nam, kto będzie korzystał z integracji, jaki stan musi odczytywać lub zmieniać i gdzie będzie osadzona ta usługa. Wspólnie dopasujemy kontrakt, model dostępu i najbezpieczniejszą ścieżkę wdrożenia.

Zaplanuj integrację Poznaj agentów AI i MCP

Zachowaj jedno źródło prawdy

Wybierz kontrakt przed napisaniem kodu

Odwzoruj ścieżkę użytkownika

Zdecyduj, kto i w którym miejscu dołącza do procesu: kupujący w osadzonej witrynie sklepowej, zatwierdzony dostawca, użytkownik korporacyjny czy asystent działający na podstawie wyraźnego upoważnienia.

Potwierdź granice dostępu

Użyj publicznych kontraktów do oceny i generowania klientów, a następnie przed wdrożeniem potwierdź dane uwierzytelniające, zakresy, środowiska, adresy zwrotne (callbacks) i chronione punkty końcowe.

Zweryfikuj ciągłość stanu

Przetestuj, czy projekty, wyceny, zatwierdzenia, błędy i przekazywanie zamówień zachowują aktualność wersji w ramach integracji, w tym w przypadku ponownych prób i ścieżek wycofywania zmian (rollback).

Co musi zachować każda integracja

Jeden wersjonowany stan

Poufność handlowa i dane dostawców

Zatwierdzenie przed produkcją

Natywny widok 3D produktu i cyfrowa próba wspierają podjęcie decyzji, ale nie zastępują rzeczywistej próbki produkcyjnej wymaganej przed rozpoczęciem produkcji masowej.

FAQ

Od którego obszaru integracji powinienem zacząć?

Czy publiczny kontrakt oznacza publiczny dostęp produkcyjny?

Czy integracja może ujawnić dostawców lub pominąć zatwierdzenia?