{"pageKey":"Developers","slug":"developers-api-integrations","locale":"it","localeResolved":"it","fallbackApplied":false,"version":"developers-api-integrations@2026-07-21T09:39:17.914Z","lastModified":"2026-07-21T09:39:17.914Z","canonicalUrl":"https://www.merchandaise.com/it/developers/api-integrations","payload":{"slug":"developers-api-integrations","purpose":"llm-developers-api-integrations","title":"API di merchandising e contratti di integrazione | MerchandAise","description":"Scopri i contratti MerchandAise per strumenti di assistenza, integrazioni per community, operazioni dei fornitori e identità aziendale, con chiari limiti di accesso pubblico e protetto.","sections":[{"heading":"Mantieni un’unica fonte di verità","paragraphs":["Un’integrazione deve estendere il workflow di MerchandAise, non crearne una copia. Siti web, embed, fornitori, ambienti enterprise e future superfici assistant devono leggere e aggiornare lo stesso design versionato, intento commerciale, preventivo, stato di approvazione e ordine.","Quando MerchandAise gestisce la transazione d’acquisto, Hutter Products GmbH è il venditore contraente e Merchant of Record sotto il marchio MerchandAise. L’identità e i contatti del fornitore restano riservati salvo obblighi di divulgazione, e la produzione richiede comunque l’approvazione del digital proof e del campione reale."]},{"heading":"API e superfici di integrazione","items":[{"title":"Documentazione API per gli strumenti dell'assistente","description":"Esplora gli endpoint attuali per l'assistente e gli strumenti per le sessioni di progettazione e la revisione dell'integrazione. Questo riferimento pubblico non concede l'autorizzazione anonima per richiedere preventivi o effettuare ordini. Human guide: Apri la documentazione degli strumenti dell'assistente (/it/developers/api-integrations). Machine-readable contract: OpenAPI JSON per gli strumenti dell'assistente (/api/docs/openapi.json). Access: public. Riferimento pubblico per i API dell'assistente e degli strumenti. L'accesso di produzione e le operazioni che influiscono sugli ordini richiedono comunque l'autorizzazione applicabile. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#api-docs."},{"title":"API di incorporamento della community","description":"Collega le esperienze localizzate di club, community o vetrine ai passaggi di consegne commerciali e di design di proprietà di MerchandAise, senza dover ricostruire il flusso di lavoro sottostante. Human guide: Esamina la guida all'integrazione della community (/it/developers/api-integrations#community-integrations). Machine-readable contract: OpenAPI JSON della community (/api/v1/community/public/openapi/v1). Access: public. Contratto pubblico con controllo di versione per incorporamenti di vetrine, scoperta della community e passaggi di consegne sensibili alla localizzazione. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#community-integrations."},{"title":"API fornitori","description":"Collega i fornitori approvati alle operazioni di onboarding, catalogo, preventivo ed evasione degli ordini, previa qualificazione della relazione con il fornitore e del modello di accesso. Human guide: Esamina la guida all'integrazione dei fornitori (/it/developers/api-integrations#supplier-integrations). Machine-readable contract: OpenAPI JSON fornitori (/api/v1/supplier/openapi/v1). Access: public. Contratto pubblico per la pianificazione e la generazione di client. L'accesso operativo per i fornitori rimane soggetto ad autorizzazione. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#supplier-integrations."},{"title":"API di identità aziendale","description":"Pianifica SSO, il provisioning SCIM e flussi di identità pronti per l'audit per i programmi di merchandising aziendali approvati e i rilasci controllati. Human guide: Esamina la guida all'integrazione aziendale (/it/developers/api-integrations#enterprise-integrations). Machine-readable contract: OpenAPI JSON di identità aziendale (/api/v1/enterprise/identity/openapi/v1). Access: protected. Contratto protetto per aree di lavoro aziendali approvate; richiedi l'accesso prima di utilizzare questo endpoint. Canonical page: /developers/api-integrations. Canonical section: /developers/api-integrations#enterprise-integrations."}]},{"heading":"Scegli il contratto prima del codice","items":[{"title":"Step 1: Mappa il journey dell’utente","description":"Decidi chi entra nel workflow e dove: un acquirente in uno storefront embedded, un fornitore approvato, un utente enterprise o un assistant che opera con autorizzazione esplicita."},{"title":"Step 2: Conferma il confine di accesso","description":"Usa i contratti pubblici per valutazione e generazione client, quindi conferma credenziali, scope, ambienti, callback ed endpoint protetti prima dell’implementazione."},{"title":"Step 3: Dimostra la continuità di stato","description":"Verifica che design, preventivi, approvazioni, errori e passaggi d’ordine rimangano aggiornati alla versione corrente attraverso l’integrazione, inclusi retry e percorsi di rollback."}]},{"heading":"Cosa ogni integrazione deve preservare","items":[{"title":"Uno stato versionato","description":"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."},{"title":"Riservatezza commerciale e del fornitore","description":"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."},{"title":"Approvazione prima della produzione","description":"La visualizzazione 3D nativa del prodotto e il digital proof supportano la decisione, ma non sostituiscono il campione reale richiesto prima della produzione di massa."}]},{"heading":"Prima del traffico di produzione","paragraphs":["Un file OpenAPI pubblicato è una base di pianificazione, non una promessa di accesso di produzione anonimo. Revisioniamo ambienti, credenziali, gestione dei guasti e ownership operativa prima del go-live."],"items":[{"title":"Accesso e ambienti","description":"Conferma la versione del contratto, lo workspace approvato, gli scope di autenticazione, sandbox, credenziali di produzione e le destinazioni di callback."},{"title":"Guasto e ripristino","description":"Definisci retry, idempotenza, timeout, errori visibili al cliente, osservabilità, ownership del supporto e rollback prima del rilascio."},{"title":"Evidenza end-to-end","description":"Verifica il percorso previsto in staging dall’entry e la mutazione dello stato fino a preventivo, approvazione, handoff e comportamento di recovery."}]},{"heading":"FAQ","items":[{"title":"Con quale superficie d’integrazione dovrei iniziare?","description":"Inizia dalla persona e dalla transizione di stato. Usa gli embed community per percorsi buyer-facing di club o community, le integrazioni fornitore per workflow lato supply approvati, enterprise identity per SSO e SCIM, e assistant tooling solo per flussi AI esplicitamente autorizzati."},{"title":"Un contratto pubblico significa accesso di produzione pubblico?","description":"No. Un contratto OpenAPI pubblico serve per discovery, revisione architetturale e generazione client. Credenziali di produzione, operazioni in scrittura, workflow fornitore, identità enterprise e l’esecuzione assistant possono comunque richiedere uno workspace approvato e autorizzazioni con scope."},{"title":"Un’integrazione può esporre i fornitori o bypassare le approvazioni?","description":"No. L’identità e i contatti dei fornitori restano privati salvo obblighi di divulgazione, MerchandAise detiene la relazione verso l’acquirente e le azioni che incidono sugli ordini devono preservare le regole di approvazione e il requisito del campione reale."}]},{"heading":"Portaci il workflow, non un’architettura finita.","paragraphs":["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."],"items":[{"title":"Pianifica un’integrazione","description":"/it/contact?intent=api-integration-review"},{"title":"Scopri AI agents e MCP","description":"/it/developers/ai-agents-mcp"}]}],"source":{"type":"page-copy","id":"Developers"}},"metadata":{"source":"page-content","schema":"2025-11-05"}}