Piattaforma sviluppatori MerchandAise
Collega il tuo processo a MerchandAise.
Trova documentazione API e specifiche OpenAPI per il merchandising personalizzato. Collega siti, community, operazioni dei fornitori o account aziendali alle informazioni condivise su design, preventivi e ordini.
Scegli la connessione adatta al progetto
Usa i riferimenti qui sotto per valutare endpoint, formati delle richieste e requisiti di autorizzazione. Le specifiche pubbliche servono alla pianificazione e alla generazione di client; l’accesso operativo dipende da API, account e ambiente.
Quando MerchandAise gestisce la transazione dell’acquirente, Hutter Products GmbH è il venditore contraente e Merchant of Record sotto il marchio MerchandAise. Identità e contatti dei fornitori restano privati salvo gli obblighi di comunicazione. La produzione richiede comunque l’approvazione della prova digitale, la conferma della producibilità, i controlli tecnici obbligatori e le approvazioni dei campioni applicabili all’ordine esatto accettato.
01 — Contratti
API e superfici di integrazione
01
Documentazione API e OpenAPI
Trova il riferimento API per gli strumenti degli assistenti e le sessioni di design, poi scegli il contratto per community, fornitori o aziende adatto al tuo processo.
Guida all’implementazione
Apri la documentazione degli strumenti dell'assistenteContratto per i sistemi
OpenAPI JSON degli strumenti per assistenti/api/docs/openapi.jsonRiferimento pubblico per le API degli assistenti e degli strumenti. L’accesso in produzione e le operazioni che influiscono sugli ordini richiedono comunque l’autorizzazione applicabile.
02
API Community
Collega il sito di un club o di una community alle informazioni pubbliche della community, all’invio dei design, ai voti e ai passaggi per l’approvazione degli ordini.
- Cosa comprende il contratto
- Informazioni pubbliche della community, pubblicazioni di design e voti, pubblicazione delle inserzioni, ordini in attesa e approvazione o rifiuto da parte del responsabile della community.
- Un punto di partenza pratico
- Leggi le informazioni pubbliche della community per il sito di un club. Individua poi le azioni che richiedono l’accesso di un membro o i permessi del responsabile prima di aggiungere l’invio dei design o passaggi al checkout.
- Accesso
- La specifica è pubblica. Letture pubbliche, azioni dei membri e operazioni riservate al responsabile hanno requisiti di autorizzazione diversi; segui le regole di sicurezza di ciascun endpoint.
Contratto per i sistemi
OpenAPI JSON della Community/api/v1/community/public/openapi/v1Contratto pubblico con versione per negozi incorporati, ricerca di community e passaggi tra pagine che rispettano la lingua scelta.
03
API Fornitori
Collega i sistemi dei fornitori approvati ai pacchetti di produzione rilasciati, allo stato di onboarding e ai processi con webhook ERP o PLM.
- Cosa comprende il contratto
- Stato di onboarding dei fornitori, pacchetti di produzione rilasciati, download tracciati dei file, analisi, iscrizioni ai webhook e punti di sincronizzazione.
- Un punto di partenza pratico
- Pianifica una connessione tra il tuo ERP o sistema di gestione del ciclo di vita del prodotto e il Centro fornitori. Verifica payload dei webhook, nuovi tentativi e stato di sincronizzazione prima di gestire un ordine assegnato.
- Accesso
- Leggi la specifica OpenAPI senza accedere. Le richieste operative richiedono l’account fornitore e i permessi appropriati; la documentazione pubblica non iscrive un fornitore e non concede accesso ai dati di altri fornitori.
Contratto per i sistemi
OpenAPI JSON dei fornitori/api/v1/supplier/openapi/v1Contratto pubblico per la pianificazione e la generazione di client. L’accesso operativo dei fornitori resta soggetto ad autorizzazione.
04
API Identità aziendale
Collega gli spazi di lavoro aziendali approvati all’accesso unico, alla gestione di utenti e gruppi e ai registri di controllo dell’identità.
- Cosa comprende il contratto
- Accesso unico OpenID Connect (OIDC), gestione del ciclo di vita di utenti e gruppi SCIM, rotazione dei token SCIM ed eventi di controllo del provisioning.
- Un punto di partenza pratico
- Collega il tuo provider di identità allo spazio di lavoro approvato. Pianifica accesso, attivazione e disattivazione degli utenti, poi verifica associazioni dei gruppi e registri di controllo nell’ambiente di test concordato.
- Accesso
- La specifica dell’identità aziendale è protetta. Contatta il team delle integrazioni per verificare spazio di lavoro e requisiti di accesso prima dell’implementazione. L’identità aziendale è facoltativa per i normali acquisti di prodotti.
Contratto per i sistemi
OpenAPI JSON dell’identità aziendale/api/v1/enterprise/identity/openapi/v1Contratto protetto per spazi di lavoro aziendali approvati. Richiedi l’accesso prima di usare questo endpoint.
Pianifica un’integrazione02 — Guida all’implementazione
Scegli il contratto prima del codice
- 01
Mappa il journey dell’utente
Decidi chi entra nel processo e dove: un acquirente in uno storefront embedded, un fornitore approvato, un utente enterprise o un assistente che opera con autorizzazione esplicita.
- 02
Conferma il confine di accesso
Usa i contratti pubblici per valutazione e generazione client, quindi conferma credenziali, scope, ambienti, callback ed endpoint protetti prima dell’implementazione.
- 03
Dimostra la continuità di stato
Verifica che design, preventivi, approvazioni, errori e passaggi d’ordine rimangano aggiornati alla versione corrente attraverso l’integrazione, inclusi nuovi tentativi e percorsi di rollback.
03 — Cosa ogni integrazione deve preservare
Cosa ogni integrazione deve preservare
Uno stato versionato
Design, intento commerciale, preventivo supportato dal fornitore, approvazione e stato ordine restano connessi. Modifiche obsolete devono attivare un re-quote visibile o uno stato di revisione.
Riservatezza commerciale e del fornitore
MerchandAise resta il referente commerciale verso l’acquirente e il referente supporto. Identità, contatti e dati interni del fornitore non sono esposti tramite integrazioni pubbliche.
Approvazione prima della produzione
Una vista 3D non costituisce una prova fisica. Il preventivo confermato spiega le opzioni di campionatura disponibili, i costi, i limiti e i tempi. Prima della produzione in serie, approva la prova digitale esatta e completa i controlli tecnici obbligatori e le approvazioni dei campioni richiesti o scelti. I requisiti degli ordini già accettati restano vincolanti.
04
Prima del traffico di produzione
Un file OpenAPI pubblicato è una base di pianificazione, non una promessa di accesso di produzione anonimo. Revisioniamo ambienti, credenziali, gestione dei guasti e responsabileship operativa prima del go-live.
Accesso e ambienti
Conferma la versione del contratto, lo spazio di lavoro approvato, gli scope di autenticazione, sandbox, credenziali di produzione e le destinazioni di callback.
Guasto e ripristino
Definisci nuovi tentativi, idempotenza, timeout, errori visibili al cliente, osservabilità, responsabileship del supporto e rollback prima del rilascio.
Evidenza end-to-end
Verifica il percorso previsto in staging dall’entry e la mutazione dello stato fino a preventivo, approvazione, handoff e comportamento di recovery.
Domande frequenti
Da quale API per il merchandising dovrei iniziare?
Parti dalla persona e dal cambiamento di stato. Usa le community incorporate per i percorsi di acquisto di club e community, le operazioni dei fornitori per i processi dei fornitori approvati, l’identità aziendale per SSO e SCIM e gli strumenti per assistenti solo per processi IA esplicitamente autorizzati.
Un contratto pubblico concede accesso pubblico alla produzione?
No. Un contratto OpenAPI pubblico serve alla ricerca, alla verifica dell’architettura e alla generazione di client. Credenziali di produzione, operazioni di scrittura, processi dei fornitori, identità aziendale ed esecuzione degli assistenti possono richiedere uno spazio di lavoro approvato e autorizzazioni limitate all’ambito previsto.
Un’integrazione può esporre i fornitori o saltare le approvazioni?
No. Identità e contatti dei fornitori restano privati salvo gli obblighi di comunicazione. MerchandAise gestisce la relazione con l’acquirente; le azioni che influiscono sugli ordini devono mantenere i requisiti configurati di approvazione della prova digitale, dei controlli tecnici e dei campioni specifici dell’ordine.
Portaci il processo, non un’architettura finita.
Dicci chi userà l’integrazione, quale stato deve leggere o modificare e dove vivrà l’esperienza. Mappiamo insieme contratto, modello di accesso e percorso di rollout più sicuro.