In breve
ZALORA Seller Center API v2 per venditori nel marketplace della moda di Singapore, Malesia, Indonesia, Filippine e Hong Kong: ordini e articoli dell'ordine, imballaggio, tracciamento e documenti di spedizione, prodotti e set di prodotti, magazzino, prezzi per paese, marchi e categorie. ID e segreto dell'applicazione OAuth.
Configurazione guidata
Collega ZALORA a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega ZALORA con la configurazione guidata e aggiungi il tuo URL MCP al tuo assistente AI. 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
ZALORA Seller Center API v2 per venditori nel marketplace della moda di Singapore, Malesia, Indonesia, Filippine e Hong Kong: ordini e articoli dell'ordine, imballaggio, tracciamento e documenti di spedizione, prodotti e set di prodotti, magazzino, prezzi per paese, marchi e categorie. ID e segreto dell'applicazione OAuth.
Configurazione
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 del 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.
Da 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 restituzione.
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 quindi 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 (inactive rimuove 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 vuole che l'AI lo faccia.
Catalogo: un set di prodotti è l'elemento del catalogo; i suoi prodotti sono le variazioni (taglie, colori), ciascuno con il proprio id prodotto numerico utilizzato per magazzino 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.
Magazzino 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 il magazzino è realmente cambiato; non per prodotti evasi 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 blocco e feed non sono inclusi.
Paging: le liste prendono limit e offset; la risposta ha pagination con hasNext (ordini, articoli dell'ordine) 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).
Prerequisiti: ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_CLIENT_SECRET
Installa il connettore localmente
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
Apri http://localhost:3000/connectors/store, scegli ZALORA e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
zalora_list_orders | Elenca gli ordini, il più vecchio per primo 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 restituzioni su richiesta.… |
zalora_list_order_items | Elenca gli articoli dell'ordine attraverso gli ordini: id, orderId, stato, shopSku, sellerSku, nome, prezzoUnitario, prezzoPagato, fornitore di spedizione e codice di tracciamento… |
zalora_get_order_history | Storico 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 restituzione degli articoli dell'ordine: pacco di restituzione, motivo, commento e fornitore di spedizione di restituzione. 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 annulla 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, lista di controllo, 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 magazzino e prezzi), sellerSku, shopSku, variazione, stato… |
zalora_get_product_stock | Magazzino di un prodotto (variazione): quantità (vendibile nel tuo magazzino), riservaStock, disponibile, magazzino in conto presso ZALORA quando… |
zalora_get_product_set_stock | Magazzino di ogni prodotto (variazione) di un set di prodotti: shopSku, sellerSku, quantità, riservaStock, disponibile, spedizioni e magazzini.… |
zalora_get_product_set_prices | Prezzi di ogni prodotto di un set di prodotti per paese: prezzo, prezzoDiVendita, dataInizioVendita, dataFineVendita 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 rimozione (modalità vacanza, limiti d'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 | Segna gli articoli in attesa come imballati in modo che 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 lasciare 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 magazzino di fino a 100 prodotti (variazioni) in una chiamata, come numeri assoluti. Non possibile per prodotti evasi 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), prezzoDiVendita con… |
zalora_set_price_status | Attiva o disattiva la riga di prezzo di un prodotto in un paese. inactive rimuove 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 | Segna gli articoli di un ordine come consegna fallita con un motivo da zalora_list_failure_reasons (solo dropship) |
zalora_approve_return | Approva la restituzione di articoli in attesa di approvazione (solo dove il venditore gestisce le restituzioni). L'approvazione porta al rimborso del cliente |
Esempi di richieste
- "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 magazzino?"
- "Imposta il prezzo dello SKU ZL-DRESS-NVY-M a 59,90 SGD."
- "Mostra le restituzioni dell'ordine 260112345 e i loro motivi."
Prossimi passi
Questa guida ti è stata utile?