# API di merchandising e contratti di integrazione | MerchandAise

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

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.

## Mantieni un’unica fonte di verità
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.
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 e superfici di integrazione
- **Documentazione API per gli strumenti dell'assistente:** 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). Accesso: Pubblico. 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.
- **API di incorporamento della community:** 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). Accesso: Pubblico. 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.
- **API fornitori:** 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). Accesso: Pubblico. 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.
- **API di identità aziendale:** 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). Accesso: Protetto. 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.

## Scegli il contratto prima del codice
- **Step 1: Mappa il journey dell’utente:** 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.
- **Step 2: 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.
- **Step 3: Dimostra la continuità di stato:** Verifica che design, preventivi, approvazioni, errori e passaggi d’ordine rimangano aggiornati alla versione corrente attraverso l’integrazione, inclusi retry e percorsi di rollback.

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

## 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 ownership operativa prima del go-live.
- **Accesso e ambienti:** Conferma la versione del contratto, lo workspace approvato, gli scope di autenticazione, sandbox, credenziali di produzione e le destinazioni di callback.
- **Guasto e ripristino:** Definisci retry, idempotenza, timeout, errori visibili al cliente, osservabilità, ownership 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.

## FAQ
- **Con quale superficie d’integrazione dovrei iniziare?:** 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.
- **Un contratto pubblico significa accesso di produzione pubblico?:** 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.
- **Un’integrazione può esporre i fornitori o bypassare le approvazioni?:** 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.

## Portaci il workflow, 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.
- **Pianifica un’integrazione:** /it/contact?intent=api-integration-review
- **Scopri AI agents e MCP:** /it/developers/ai-agents-mcp