In breve
API ZALORA Seller Center v2 per i venditori nel marketplace della moda di Singapore, Malesia, Indonesia, Filippine e Hong Kong: ordini e articoli degli ordini, imballaggio, tracciamento e documenti di spedizione, prodotti e set di prodotti, stock, prezzi per paese, marchi e categorie. ID e segreto dell'applicazione OAuth.
Configurazione guidata
Collega ZALORA a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega ZALORA con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per ZALORA
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connettori → ZALORA, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
ZALORA + Microsoft Copilot
API ZALORA Seller Center v2 per i venditori nel marketplace della moda di Singapore, Malesia, Indonesia, Filippine e Hong Kong: ordini e articoli degli ordini, imballaggio, tracciamento e documenti di spedizione, prodotti e set di prodotti, stock, prezzi per paese, marchi e categorie. ID e segreto dell'applicazione OAuth.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_CLIENT_SECRET
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 5 minuti.
- Accedi a ZALORA Seller Center con un utente che ha il ruolo di Accesso Completo Venditore.
- Apri Impostazioni, Gestione Integrazione, Applicazioni OAuth e crea un'applicazione. Copia l'ID Applicazione in
ZALORA_CLIENT_IDe il Segreto Applicazione inZALORA_CLIENT_SECRET. Il segreto viene mostrato solo una volta. - Scegli il tuo paese di Seller Center in
ZALORA_DOMAIN: Singaporezalora.sg, Malesiazalora.com.my, Indonesiazalora.co.id, Filippinezalora.com.ph, Hong Kongzalora.com.hk.
Il connettore scambia i due valori a https://sellercenter.<country domain>/oauth/client-credentials (credenziali client, HTTP Basic) per un token bearer che dura un'ora e lo rinnova quando scade. Non ci sono scope: l'applicazione può fare ciò che il ruolo del suo creatore consente.
Dove iniziare: zalora_get_order_counters per una panoramica, poi zalora_list_orders con stato status_pending (ordini da imballare) e zalora_get_order per gli articoli, indirizzi e prezzi.
Ordini: zalora_list_orders, zalora_get_order, zalora_list_order_items, zalora_get_order_history, zalora_get_order_item_returns. L'id dell'ordine è numerico ed è ciò che gli strumenti utilizzano; number è ciò che il cliente vede. Gli stati si trovano sugli articoli: pending, ready_to_ship, shipped, delivered, failed, canceled, returned e gli stati di reso.
Imballaggio e spedizione: controlla prima zalora_list_shipment_providers. zalora_set_ready_to_ship imballa gli articoli in attesa di un ordine in un pacco con un numero di tracciamento (opzionale solo per i fornitori con apiIntegrationAvailable true); zalora_set_packed_by_marketplace consegna la spedizione alla logistica di ZALORA. I venditori dropship utilizzano poi zalora_set_shipped e zalora_set_delivered. zalora_update_tracking_code e zalora_update_shipping_provider correggono un pacco pronto per la spedizione. zalora_print_document restituisce l'etichetta di spedizione, la fattura o la lista di prelievo come PDF base64 (202 mentre l'etichetta è ancora in fase di creazione). Nota la chiave dell'articolo: id in set_ready_to_ship, orderItemId in set_packed_by_marketplace.
Disattivato all'installazione: zalora_cancel_order_items (non può essere annullato, il cliente viene rimborsato), zalora_set_delivery_failed, zalora_approve_return (porta a un rimborso) e zalora_set_price_status (inattivo toglie un prodotto dalla vendita). Le ragioni per le cancellazioni e le consegne fallite provengono da zalora_list_failure_reasons. Attiva uno strumento nel connettore solo quando il workspace desidera che l'IA lo faccia.
Catalogo: un set di prodotti è l'elemento del catalogo; i suoi prodotti sono le variazioni (taglie, colori), ognuno con il proprio ID prodotto numerico utilizzato per stock e prezzi. zalora_list_products (cerca per SKU venditore), zalora_list_product_sets, zalora_list_product_set_products, zalora_list_brands, zalora_get_category_tree (grande: recupera una sola volta), zalora_get_category_attributes, zalora_get_seller.
Stock e prezzi: zalora_get_product_stock, zalora_get_product_set_stock e zalora_update_stock (quantità assolute, fino a 100 prodotti per chiamata, solo quando lo stock è realmente cambiato; non per prodotti gestiti da ZALORA). zalora_get_product_set_prices mostra i prezzi per paese; zalora_update_price cambia il prezzo, il prezzo di vendita e le date di vendita di un prodotto in un paese (solo i campi che invii). Creare prodotti, importazioni in massa e feed non sono inclusi.
Paging: le liste prendono limit e offset; la risposta ha pagination con hasNext (ordini, articoli degli ordini) o totalCount (prodotti, marchi). I set di prodotti e i marchi restituiscono al massimo 100 righe.
Limite di richiesta: 30 richieste al secondo per venditore, condivise da ogni applicazione e token; oltre a ciò ZALORA risponde 429. Gli errori portano uno stato HTTP reale con title e detail (422 è un errore di validazione che nomina il campo, 503 modalità di manutenzione).
Passo 2 — Installa l'adattatore
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Passo 3 — Aggiungi il connettore in Microsoft Copilot
L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (
https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostraYOUR_SERVER_ID.
Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
ZALORA. - Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.
Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.
Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
zalora_list_orders | Elenca gli ordini, dal più vecchio in poi a meno che non sia ordinato: id (numerico, utilizzato da ogni altro strumento d'ordine), numero (numero d'ordine che il cliente vede) e stato… |
zalora_get_order | Leggi un ordine: numero, stato, date, cliente e indirizzo di spedizione e fatturazione, metodo di pagamento, totali e valuta, e i suoi articoli (id… |
zalora_get_order_counters | Numero approssimativo di ordini per stato (in attesa, pronto per la spedizione, spedito, consegnato, annullato e così via), e di resi su richiesta.… |
zalora_list_order_items | Elenca gli articoli degli ordini attraverso gli ordini: id, orderId, stato, shopSku, sellerSku, nome, prezzo unitario, prezzo pagato, fornitore di spedizione e codice di tracciamento… |
zalora_get_order_history | Cronologia degli stati degli articoli di un ordine: orderItemId, shopSku, stato, nota, createdAt e chi ha effettuato la modifica. Solo lettura |
zalora_get_order_item_returns | Dettagli di reso degli articoli degli ordini: pacco di reso, motivo, commento e fornitore di spedizione per il reso. Solo lettura |
zalora_list_shipment_providers | Fornitori di spedizione con cui il venditore può spedire: id, nome, predefinito, apiIntegrationAvailable (true: il numero di tracciamento può essere omesso)… |
zalora_list_failure_reasons | Motivi accettati quando si cancella un articolo o si segna una consegna come fallita: id, tipo, nome, descrizione e outOfStock. Solo lettura |
zalora_print_document | Genera un documento d'ordine come PDF base64: etichetta di spedizione, fattura, lista di prelievo, checklist, manifesto del corriere e altri, a seconda dell'ordine… |
zalora_list_products | Elenca i prodotti (variazioni): id, uuid, shopSku, sellerSku, productSetId, stato e variazione, ordinati per id, con pagination (limit… |
zalora_list_product_sets | Elenca i set di prodotti (l'elemento del catalogo che raggruppa le taglie o i colori): id, nome, SKU genitore, marchio, categoria, stato e controllo qualità… |
zalora_list_product_set_products | I prodotti (variazioni) di un set di prodotti: id (l'ID prodotto utilizzato per stock e prezzi), sellerSku, shopSku, variazione, stato… |
zalora_get_product_stock | Stock di un prodotto (variazione): quantità (vendibile nel tuo magazzino), reservedStock, disponibile, stock in consignazione presso ZALORA quando… |
zalora_get_product_set_stock | Stock di ogni prodotto (variazione) di un set di prodotti: shopSku, sellerSku, quantità, reservedStock, disponibile, consignazioni e magazzini.… |
zalora_get_product_set_prices | Prezzi di ogni prodotto di un set di prodotti per paese: prezzo, salePrice, saleStartDate, saleEndDate e stato, per i paesi in cui un… |
zalora_list_brands | Marchi: id, uuid, nome, isRestricted e isAccessible (se puoi venderlo), con pagination (totalCount). Solo lettura |
zalora_get_category_tree | L'intero albero delle categorie: id, parentId, nome, attributeSetId, percorso e figli. Risposta grande: recuperala una volta e conserva gli id. Solo lettura |
zalora_get_category_attributes | Attributi di una categoria: id, nome, etichetta, isMandatory, inputType, attributeType e le opzioni consentite. Solo lettura |
zalora_get_seller | L'account venditore dietro le credenziali: id, nome, codice breve, stato, motivi di disattivazione (modalità vacanza, limiti di ordine) e dettagli di contatto.… |
zalora_set_ready_to_ship | Imballa gli articoli in attesa di un ordine in un pacco e impostali come pronti per la spedizione, con il numero di tracciamento e il fornitore di spedizione. Ogni… |
zalora_set_packed_by_marketplace | Contrassegna gli articoli in attesa come imballati affinché ZALORA organizzi la spedizione (logistica del marketplace). Ogni articolo deve provenire dallo stesso ordine. Risponde… |
zalora_set_shipped | Imposta gli articoli pronti per la spedizione di un ordine come spediti (solo dropship; non possibile per cross-docking o dove sono richiesti i manifesti). Risponde… |
zalora_set_delivered | Imposta gli articoli spediti di un ordine come consegnati (solo dropship). Risponde gli ID degli articoli dell'ordine cambiati |
zalora_update_tracking_code | Cambia il numero di tracciamento di un articolo pronto per la spedizione; si applica a ogni articolo nello stesso pacco. Invia una stringa vuota per far sì che ZALORA… |
zalora_update_shipping_provider | Cambia il fornitore di spedizione (e opzionalmente il numero di tracciamento) di un articolo pronto per la spedizione; si applica a ogni articolo nello stesso pacco |
zalora_update_stock | Imposta la quantità di stock di fino a 100 prodotti (variazioni) in una chiamata, come numeri assoluti. Non possibile per prodotti gestiti da ZALORA.… |
zalora_update_price | Cambia il prezzo di un prodotto (variazione) in un paese. Solo i campi che invii cambiano: prezzo (prezzo di listino), salePrice con… |
zalora_set_price_status | Cambia la riga del prezzo di un prodotto in un paese in attivo o inattivo. inattivo toglie il prodotto dalla vendita in quel paese |
zalora_cancel_order_items | Annulla articoli di un ordine con un motivo da zalora_list_failure_reasons. Non può essere annullato; il cliente viene rimborsato e l'annullamento… |
zalora_set_delivery_failed | Contrassegna articoli di un ordine come consegna fallita con un motivo da zalora_list_failure_reasons (solo dropship) |
zalora_approve_return | Approva il reso di articoli in attesa di approvazione (solo dove il venditore gestisce i resi). L'approvazione porta al rimborso del cliente |
Esempi di prompt
- "Quali ordini ZALORA sono in attesa e devono essere imballati oggi?"
- "Imposta l'articolo d'ordine 81234567 come pronto per la spedizione e ottieni l'etichetta di spedizione."
- "Quali set di prodotti hanno meno di 5 unità in stock?"
- "Imposta il prezzo dello SKU ZL-DRESS-NVY-M a 59,90 SGD."
- "Mostra i resi dell'ordine 260112345 e i loro motivi."
FAQ
Da dove provengono le credenziali? ZALORA Seller Center, Impostazioni, Gestione Integrazione, Applicazioni OAuth: crea un'applicazione come utente con Accesso Completo Venditore e copia il suo ID Applicazione e segreto. Scegli anche il tuo paese di Seller Center.
Quali paesi copre? Singapore, Malesia, Indonesia, Filippine e Hong Kong. Ogni paese ha il proprio Seller Center, quindi installa un connettore per paese.
Quali strumenti vengono installati disattivati? zalora_cancel_order_items, zalora_set_delivery_failed, zalora_approve_return e zalora_set_price_status. Attivali nella pagina del connettore solo se l'IA deve usarli.
Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.
Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.
L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.
Prossimi passi
Questa guida ti è stata utile?