In breve
Tiki Open API per venditori nel marketplace vietnamita: ordini, magazzino e conferma dropship, etichette di spedizione e risultati di consegna del venditore, prodotti con prezzo e magazzino per magazzino, magazzini e inventari dei venditori, categorie, marchi e richieste di prodotto. ID e segreto dell'app interna.
Configurazione guidata
Collega Tiki a Claude, ChatGPT o Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega Tiki 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 Tiki
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 → Tiki, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
Tiki
Tiki Open API per venditori nel marketplace vietnamita: ordini, magazzino e conferma dropship, etichette di spedizione e risultati di consegna del venditore, prodotti con prezzo e magazzino per magazzino, magazzini e inventari dei venditori, categorie, marchi e richieste di prodotto. ID e segreto dell'app interna.
Configurazione
La configurazione richiede circa 10 minuti.
- Accedi alla console della Tiki Open Platform su
https://open.tiki.vncon il tuo account Tiki e apri Applicazione, Crea (https://open.tiki.vn/web/console/apps/create). - Compila il nome, il riepilogo, la descrizione, la homepage e l'icona. Come Metodo di autenticazione dell'endpoint del token scegli basic header (non può essere cambiato in seguito), e come tipo di applicazione In-house.
- Inserisci il tuo ID negozio (il numero senza il prefisso S) e il nome del negozio, e invia. Copia l'App ID in
TIKI_CLIENT_IDe il App Secret inTIKI_CLIENT_SECRET. - Approva la connessione nel Tiki Seller Center: Informazioni venditore, Dettagli, Impostazioni negozio e Informazioni di contatto, Gestisci, Applicazioni integrate. Fino ad allora ogni chiamata restituisce 401.
Il connettore ottiene un token su https://api.tiki.vn/sc/oauth2/token (credenziali client, HTTP Basic) e lo rinnova quando scade. Un'app interna ha tutti i permessi del negozio, quindi non ci sono scope da scegliere. Tiki ha solo un ambiente di produzione.
Da dove iniziare: tiki_list_orders con item_confirmation_status in attesa (ordini da confermare) e stato nin|processing,waiting_payment, poi tiki_get_order.
Conferma ordini: un ordine evaso dal tuo magazzino (tiki_delivery, seller_delivery, cross_border) è confermato con tiki_confirm_available, elencando gli ID degli articoli che puoi fornire e un inventario venditore da tiki_list_seller_inventories (passa il codice magazzino Tiki dell'ordine). Gli articoli esclusi vengono annullati. Un ordine dropship è confermato con tiki_confirm_dropship; tiki_cancel_dropship rifiuta uno ed è installato spento. tiki_get_shipping_label restituisce il link dell'etichetta per il modello di consegna dell'ordine. Gli ordini che consegni tu stesso ottengono il loro risultato con tiki_update_seller_delivery. Non esiste un'API di restituzione o cancellazione: le restituzioni appaiono come ordini is_rma e lo stato restituito.
Prodotti e magazzino: tiki_list_products (includi inventario per magazzino), tiki_get_product, tiki_find_product_by_sku (il tuo original_sku), tiki_update_product (prezzo in VND e magazzino per magazzino venditore da tiki_list_seller_warehouses; non per prodotti in magazzino conservati presso Tiki). tiki_set_product_active è spento, perché 0 toglie il prodotto dalla vendita. tiki_list_product_requests e tiki_get_tracking seguono le richieste di prodotto; tiki_list_categories, tiki_get_category_attributes, tiki_list_brands e tiki_list_tiki_warehouses forniscono i dati di riferimento. tiki_get_seller mostra il negozio e i suoi modelli operativi. La creazione di prodotti non è inclusa.
Formati: le date sono yyyy-MM-dd HH:mm:ss in ora vietnamita (UTC+7); i prezzi sono in VND. I filtri impostati sugli ordini sono scritti in|a,b o nin|a,b. Le liste prendono page da 1 e limit; la risposta ha paging (totale, current_page, last_page). Gli errori sono errors (un elenco di messaggi) con 400, 401 (token mancante, scaduto o l'app non connessa al negozio), 403, 422 o 429.
Limite di richiesta: 200 richieste al secondo per venditore; un 429 dovrebbe essere riprovato più tardi, altre risposte 4xx no.
Prerequisiti: TIKI_CLIENT_ID, TIKI_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 Tiki e incolla le variabili d'ambiente elencate sotto Prerequisiti.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
tiki_get_seller | Il venditore dietro il token: id, nome, attivo, logo, operation_models (dropship, instock, backorder, seller_backorder, cross_border)… |
tiki_list_seller_warehouses | Magazzini dei venditori (indirizzi di ritiro e restituzione): id, nome, is_primary, stato, tipo, strada, quartiere, distretto, regione, paese e contatto… |
tiki_list_orders | Elenca ordini, i più recenti per primi: codice, fulfillment_type, stato, is_rma, created_at, updated_at, fattura (subtotale, grand_total… |
tiki_get_order | Leggi un ordine: codice, relation_code, fulfillment_type, stato, fattura, magazzino Tiki, articoli con prodotto, prezzo, quantità, reddito venditore… |
tiki_list_seller_inventories | Inventari dei venditori (locali di magazzino) da cui puoi confermare ordini, con i magazzini Tiki che servono: seller_inventories e mappings… |
tiki_get_shipping_label | Link all'etichetta stampabile di un ordine (HTML): shipping_label_url (tiki-delivery), shipping_label_url e shipping_stamp_url (dropship)… |
tiki_list_products | Elenca prodotti, i più recenti per primi: product_id, sku, original_sku (il tuo SKU), nome, prezzo, market_price, entity_type, master_id, super_id… |
tiki_get_product | Leggi un prodotto: nome, sku, original_sku, prezzo, market_price, stato, attributi, immagini, categorie e magazzino per magazzino. Solo lettura |
tiki_find_product_by_sku | Trova un prodotto con il tuo SKU (original_sku): product_id, sku, nome, prezzo, market_price, categorie e immagini. Solo lettura |
tiki_list_categories | Categorie Tiki: id, nome, parent, is_primary e se i prodotti possono essere creati in essa. Filtra per parent per navigare l'albero. Solo lettura |
tiki_get_category_attributes | Attributi di una categoria per richieste di prodotto: codice, nome visualizzato, tipo di dato, is_required e valori consentiti. Solo lettura |
tiki_list_brands | Cerca marchi Tiki per nome: id e nome, come utilizzati nelle richieste di prodotto. Solo lettura |
tiki_list_tiki_warehouses | Magazzini Tiki (centri di evasione): id, codice e nome, come appaiono negli ordini e nei mapping degli inventari dei venditori. Solo lettura |
tiki_list_product_requests | Richieste di creazione e aggiornamento prodotto: id, track_id, stato (drafted, processing, waiting, approved, rejected, deleted), motivo e il… |
tiki_get_tracking | Stato di una richiesta di prodotto asincrona tramite il suo track id: stato, motivo e l'id della richiesta una volta accettata. Solo lettura |
tiki_confirm_available | Conferma il magazzino per un ordine evaso dal tuo inventario (tiki_delivery, seller_delivery o cross_border): elenca gli ID degli articoli che puoi fornire… |
tiki_confirm_dropship | Conferma un ordine dropship (seller_confirmed) da un inventario venditore; Tiki poi organizza il ritiro |
tiki_update_seller_delivery | Riporta il risultato della consegna di un ordine che consegni tu stesso (seller_delivery): successful_delivery, o failed_delivery con la causa e… |
tiki_update_product | Cambia il prezzo e il magazzino per magazzino venditore di un prodotto, identificato dal tuo original_sku o dal Tiki product_id. Il magazzino non può essere… |
tiki_set_product_active | Attiva (1) o disattiva (0) un prodotto per la vendita. 0 lo toglie dalla vendita su Tiki |
tiki_cancel_dropship | Rifiuta un ordine dropship (seller_canceled). Non può essere annullato; il cliente viene rimborsato e conta contro il negozio |
Esempi di richieste
- "Quali ordini Tiki necessitano ancora di conferma del magazzino?"
- "Conferma dropship per l'ordine 821034567 e ottieni l'etichetta di spedizione."
- "Qual è il magazzino dello SKU TK-KETTLE-17 in ciascuno dei miei magazzini?"
- "Quali richieste di prodotto sono ancora in attesa di approvazione da parte di Tiki?"
- "Traccia la consegna dell'ordine 821034567."
Prossimi passi
Questa guida ti è stata utile?