Resumen
API Abierta de Tiki para vendedores en el mercado vietnamita: pedidos, stock y confirmación de dropship, etiquetas de envío y resultados de entrega del vendedor, productos con precio y stock por almacén, almacenes e inventarios del vendedor, categorías, marcas y solicitudes de productos. ID y secreto de la aplicación interna.
Configuración guiada
Conecta Tiki a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Tiki con la configuración guiada y añade tu URL MCP a tu asistente de IA. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para Tiki
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, haz clic en Conectores → Tiki, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Tiki
API Abierta de Tiki para vendedores en el mercado vietnamita: pedidos, stock y confirmación de dropship, etiquetas de envío y resultados de entrega del vendedor, productos con precio y stock por almacén, almacenes e inventarios del vendedor, categorías, marcas y solicitudes de productos. ID y secreto de la aplicación interna.
Configuración
Configurar toma aproximadamente 10 minutos.
- Inicia sesión en la consola de la Plataforma Abierta de Tiki en
https://open.tiki.vncon tu cuenta de Tiki y abre Aplicación, Crear (https://open.tiki.vn/web/console/apps/create). - Completa el nombre, resumen, descripción, página de inicio e ícono. Como Método de autenticación del endpoint de token elige cabecera básica (no se puede cambiar más tarde), y como tipo de aplicación Interna.
- Ingresa tu id de tienda (el número sin el prefijo S) y el nombre de la tienda, y envía. Copia el ID de la App en
TIKI_CLIENT_IDy el Secreto de la App enTIKI_CLIENT_SECRET. - Aprueba la conexión en el Centro de Vendedores de Tiki: Información del vendedor, Detalle, Configuración de la tienda e Información de contacto, Administrar, Aplicaciones integradas. Hasta entonces, cada llamada responde 401.
El conector obtiene un token en https://api.tiki.vn/sc/oauth2/token (credenciales del cliente, HTTP Básico) y lo renueva cuando expira. Una aplicación interna tiene todos los permisos de la tienda, por lo que no hay ámbitos que seleccionar. Tiki solo tiene un entorno de producción.
Dónde empezar: tiki_list_orders con item_confirmation_status en espera (pedidos por confirmar) y estado nin|processing,waiting_payment, luego tiki_get_order.
Confirmando pedidos: un pedido cumplido desde tu stock (tiki_delivery, seller_delivery, cross_border) se confirma con tiki_confirm_available, listando los ítems que puedes suministrar y un inventario del vendedor desde tiki_list_seller_inventories (pasa el código de almacén de Tiki del pedido). Los ítems omitidos se cancelan. Un pedido de dropship se confirma con tiki_confirm_dropship; tiki_cancel_dropship rechaza uno y está instalado apagado. tiki_get_shipping_label devuelve el enlace de la etiqueta para el modelo de entrega del pedido. Los pedidos que entregas tú mismo obtienen su resultado con tiki_update_seller_delivery. No hay API de devolución o cancelación: las devoluciones aparecen como pedidos is_rma y el estado devuelto.
Productos y stock: tiki_list_products (incluye inventario para stock por almacén), tiki_get_product, tiki_find_product_by_sku (tu original_sku), tiki_update_product (precio en VND y stock por almacén del vendedor desde tiki_list_seller_warehouses; no para productos en stock almacenados en Tiki). tiki_set_product_active está apagado, porque 0 retira el producto de la venta. tiki_list_product_requests y tiki_get_tracking siguen las solicitudes de productos; tiki_list_categories, tiki_get_category_attributes, tiki_list_brands y tiki_list_tiki_warehouses proporcionan los datos de referencia. tiki_get_seller muestra la tienda y sus modelos de operación. La creación de productos no está incluida.
Formatos: las fechas son yyyy-MM-dd HH:mm:ss en hora de Vietnam (UTC+7); los precios son en VND. Los filtros establecidos en los pedidos se escriben in|a,b o nin|a,b. Las listas toman page desde 1 y limit; la respuesta tiene paging (total, current_page, last_page). Los errores son errors (una lista de mensajes) con 400, 401 (token faltante, expirado o la app no conectada a la tienda), 403, 422 o 429.
Límite de tasa: 200 solicitudes por segundo por vendedor; un 429 debe ser reintentado más tarde, otras respuestas 4xx no.
Requisitos previos: TIKI_CLIENT_ID, TIKI_CLIENT_SECRET
Instalar el conector 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
Abre http://localhost:3000/connectors/store, elige Tiki y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
tiki_get_seller | El vendedor detrás del token: id, nombre, activo, logo, operation_models (dropship, instock, backorder, seller_backorder, cross_border)… |
tiki_list_seller_warehouses | Almacenes del vendedor (direcciones de recogida y devolución): id, nombre, is_primary, estado, tipo, calle, barrio, distrito, región, país y contacto… |
tiki_list_orders | Listar pedidos, los más nuevos primero: código, fulfillment_type, estado, is_rma, created_at, updated_at, factura (subtotal, grand_total… |
tiki_get_order | Leer un pedido: código, relation_code, fulfillment_type, estado, factura, almacén de Tiki, ítems con producto, precio, cantidad, ingreso del vendedor… |
tiki_list_seller_inventories | Inventarios del vendedor (ubicaciones de stock) desde los que puedes confirmar pedidos, con los almacenes de Tiki que sirven: seller_inventories y mappings… |
tiki_get_shipping_label | Enlace a la etiqueta imprimible de un pedido (HTML): shipping_label_url (tiki-delivery), shipping_label_url y shipping_stamp_url (dropship)… |
tiki_list_products | Listar productos, los más nuevos primero: product_id, sku, original_sku (tu SKU), nombre, precio, market_price, entity_type, master_id, super_id… |
tiki_get_product | Leer un producto: nombre, sku, original_sku, precio, market_price, estado, atributos, imágenes, categorías y stock por almacén. Solo lectura |
tiki_find_product_by_sku | Encontrar un producto por tu propio SKU (original_sku): product_id, sku, nombre, precio, market_price, categorías e imágenes. Solo lectura |
tiki_list_categories | Categorías de Tiki: id, nombre, padre, is_primary y si se pueden crear productos en ella. Filtra por padre para recorrer el árbol. Solo lectura |
tiki_get_category_attributes | Atributos de una categoría para solicitudes de productos: código, nombre para mostrar, tipo de dato, is_required y valores permitidos. Solo lectura |
tiki_list_brands | Buscar marcas de Tiki por nombre: id y nombre, como se utilizan en solicitudes de productos. Solo lectura |
tiki_list_tiki_warehouses | Almacenes de Tiki (centros de cumplimiento): id, código y nombre, como aparecen en pedidos y mappings de inventario del vendedor. Solo lectura |
tiki_list_product_requests | Solicitudes de creación y actualización de productos: id, track_id, estado (borrador, procesando, esperando, aprobado, rechazado, eliminado), razón y el… |
tiki_get_tracking | Estado de una solicitud de producto asincrónica por su id de seguimiento: estado, razón y el id de la solicitud una vez aceptada. Solo lectura |
tiki_confirm_available | Confirmar stock para un pedido cumplido desde tu inventario (tiki_delivery, seller_delivery o cross_border): lista los ids de los ítems que puedes suministrar… |
tiki_confirm_dropship | Confirmar un pedido de dropship (seller_confirmed) desde un inventario de vendedor; Tiki luego organiza la recogida |
tiki_update_seller_delivery | Reportar el resultado de entrega de un pedido que entregas tú mismo (seller_delivery): successful_delivery, o failed_delivery con la causa y… |
tiki_update_product | Cambiar el precio y el stock por almacén del vendedor de un producto, identificado por tu original_sku o el product_id de Tiki. El stock no puede ser… |
tiki_set_product_active | Activar un producto (1) o desactivarlo (0) para la venta. 0 lo retira de la venta en Tiki |
tiki_cancel_dropship | Rechazar un pedido de dropship (seller_canceled). No se puede deshacer; el cliente es reembolsado y cuenta contra la tienda |
Ejemplos de solicitudes
- "¿Qué pedidos de Tiki aún necesitan confirmación de stock?"
- "Confirma dropship para el pedido 821034567 y obtén la etiqueta de envío."
- "¿Cuál es el stock del SKU TK-KETTLE-17 en cada uno de mis almacenes?"
- "¿Qué solicitudes de productos aún están esperando la aprobación de Tiki?"
- "Rastrea la entrega del pedido 821034567."
Próximos pasos
¿Te ha sido útil esta guía?