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 de vendedores, categorías, marcas y solicitudes de productos. ID de aplicación y secreto internos.
Configuración guiada
Conecta Tiki a Microsoft 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 Microsoft Copilot. 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.
💡 ¿No tienes 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 + Microsoft Copilot
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 de vendedores, categorías, marcas y solicitudes de productos. ID de aplicación y secreto internos.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
TIKI_CLIENT_ID, TIKI_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración tarda 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 aplicación en
TIKI_CLIENT_IDy el Secreto de la aplicación 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 esperando (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 de vendedor de 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 se muestran 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 de vendedor de tiki_list_seller_warehouses; no para productos en stock almacenados en Tiki). tiki_set_product_active está apagado, porque 0 quita 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 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 aplicación no conectada a la tienda), 403, 422 o 429.
Límite de tasa: 200 solicitudes por segundo por vendedor; un 429 debe reintentarse más tarde, otras respuestas 4xx no.
Paso 2 — Instalar el adaptador
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
Paso 3 — Agregar el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
Tiki. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
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 de vendedores (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, ingresos del vendedor… |
tiki_list_seller_inventories | Inventarios de vendedores (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 mapeos de inventario de vendedores. 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 | Informar el resultado de la 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 de 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 quita 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 en contra de la tienda |
Ejemplos de indicaciones
- "¿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."
Preguntas frecuentes
¿De dónde vienen las credenciales? De una aplicación interna en la consola de la Plataforma Abierta de Tiki, con el método de autenticación del endpoint de token cabecera básica. Aprueba la conexión en el Centro de Vendedores de Tiki bajo Aplicaciones Integradas, o cada llamada responde 401.
¿Qué cubre? Pedidos con confirmación de stock y dropship, etiquetas de envío y resultados de entrega del vendedor, productos con precio y stock por almacén, almacenes e inventarios de vendedores, categorías, marcas y solicitudes de productos.
¿Qué herramientas se instalan apagadas? tiki_cancel_dropship y tiki_set_product_active. Actívalas en la página del conector solo si la IA debe usarlas.
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Próximos pasos
¿Te ha sido útil esta guía?