Resumen
API v2 del ZALORA Seller Center para vendedores en el mercado de moda de Singapur, Malasia, Indonesia, Filipinas y Hong Kong: pedidos y artículos de pedido, embalaje, seguimiento y documentos de envío, productos y conjuntos de productos, stock, precios por país, marcas y categorías. ID de aplicación y secreto de OAuth.
Configuración guiada
Conecta ZALORA a Cursor en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta ZALORA con la configuración guiada y añade tu URL MCP a Cursor. 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 ZALORA
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 → ZALORA, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
ZALORA + Cursor
API v2 del ZALORA Seller Center para vendedores en el mercado de moda de Singapur, Malasia, Indonesia, Filipinas y Hong Kong: pedidos y artículos de pedido, embalaje, seguimiento y documentos de envío, productos y conjuntos de productos, stock, precios por país, marcas y categorías. ID de aplicación y secreto de OAuth.
Requisitos previos
Consulta las instrucciones completas de configuración incluidas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_CLIENT_SECRET
Paso 1 — Obtener credenciales
La configuración tarda aproximadamente 5 minutos.
- Inicia sesión en ZALORA Seller Center con un usuario que tenga el rol de Acceso Completo de Vendedor.
- Abre Configuración, Gestión de Integración, Aplicaciones OAuth y crea una aplicación. Copia el ID de Aplicación en
ZALORA_CLIENT_IDy el Secreto de Aplicación enZALORA_CLIENT_SECRET. El secreto se muestra solo una vez. - Elige tu país del Seller Center en
ZALORA_DOMAIN: Singapurzalora.sg, Malasiazalora.com.my, Indonesiazalora.co.id, Filipinaszalora.com.ph, Hong Kongzalora.com.hk.
El conector intercambia los dos valores en https://sellercenter.<country domain>/oauth/client-credentials (credenciales de cliente, HTTP Basic) por un token de portador que dura una hora, y lo renueva cuando expira. No hay ámbitos: la aplicación puede hacer lo que permite el rol de su creador.
Dónde empezar: zalora_get_order_counters para una visión general, luego zalora_list_orders con el estado status_pending (pedidos para empaquetar) y zalora_get_order para los artículos, direcciones y precios.
Pedidos: zalora_list_orders, zalora_get_order, zalora_list_order_items, zalora_get_order_history, zalora_get_order_item_returns. El id del pedido es numérico y es lo que utilizan las herramientas; number es lo que ve el cliente. Los estados se encuentran en los artículos: pendiente, listo_para_enviar, enviado, entregado, fallido, cancelado, devuelto y los estados de devolución.
Embalaje y envío: primero verifica zalora_list_shipment_providers. zalora_set_ready_to_ship empaqueta los artículos pendientes de un pedido en un paquete con un número de seguimiento (opcional solo para proveedores con apiIntegrationAvailable verdadero); zalora_set_packed_by_marketplace entrega el envío a la logística de ZALORA. Los vendedores dropship luego utilizan zalora_set_shipped y zalora_set_delivered. zalora_update_tracking_code y zalora_update_shipping_provider corrigen un paquete listo para enviar. zalora_print_document devuelve la etiqueta de envío, factura o lista de picking como PDF en base64 (202 mientras la etiqueta aún se está generando). Nota la clave del artículo: id en set_ready_to_ship, orderItemId en set_packed_by_marketplace.
Desactivado en la instalación: zalora_cancel_order_items (no se puede deshacer, el cliente es reembolsado), zalora_set_delivery_failed, zalora_approve_return (conduce a un reembolso) y zalora_set_price_status (inactivo quita un producto de la venta). Las razones para cancelaciones y entregas fallidas provienen de zalora_list_failure_reasons. Activa una herramienta en el conector solo cuando el espacio de trabajo quiere que la IA lo haga.
Catálogo: un conjunto de productos es el artículo del catálogo; sus productos son las variaciones (tamaños, colores), cada uno con su propio id de producto numérico utilizado para stock y precios. zalora_list_products (buscar por SKU de vendedor), zalora_list_product_sets, zalora_list_product_set_products, zalora_list_brands, zalora_get_category_tree (grande: obtener una vez), zalora_get_category_attributes, zalora_get_seller.
Stock y precios: zalora_get_product_stock, zalora_get_product_set_stock y zalora_update_stock (cantidades absolutas, hasta 100 productos por llamada, solo cuando el stock realmente cambió; no para productos cumplidos por ZALORA). zalora_get_product_set_prices muestra precios por país; zalora_update_price cambia el precio, precio de venta y fechas de venta de un producto en un país (solo los campos que envíes). La creación de productos, importaciones masivas y feeds no están incluidos.
Paginación: las listas toman limit y offset; la respuesta tiene pagination con hasNext (pedidos, artículos de pedido) o totalCount (productos, marcas). Los conjuntos de productos y marcas devuelven como máximo 100 filas.
Límite de tasa: 30 solicitudes por segundo por vendedor, compartidas por cada aplicación y token; por encima de eso, ZALORA responde 429. Los errores llevan un estado HTTP real con title y detail (422 es un error de validación que nombra el campo, 503 modo de mantenimiento).
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 Cursor
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.
Cursor lee los servidores MCP de ~/.cursor/mcp.json. Añade esta entrada:
{
"mcpServers": {
"anythingmcp": {
"url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Crea una clave de API MCP en AnythingMCP en MCP Servers → tu servidor → API keys y pégala en lugar de
YOUR_MCP_API_KEY. - Guarda el archivo y reinicia Cursor.
- Abre Cursor → Settings → MCP y comprueba que
anythingmcpaparece en la lista y está conectado. - Empieza a chatear: el agente ya puede usar las herramientas de
ZALORA.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
zalora_list_orders | Lista pedidos, el más antiguo primero a menos que se ordene: id (numérico, utilizado por cada otra herramienta de pedidos), número (número de pedido que ve el cliente) y estado… |
zalora_get_order | Lee un pedido: número, estado, fechas, cliente y dirección de envío y facturación, método de pago, totales y moneda, y sus artículos (id… |
zalora_get_order_counters | Número aproximado de pedidos por estado (pendiente, listo para enviar, enviado, entregado, cancelado, etc.), y de devoluciones a solicitud.… |
zalora_list_order_items | Lista artículos de pedidos a través de pedidos: id, orderId, estado, shopSku, sellerSku, nombre, precioUnitario, precioPagado, proveedor de envío y código de seguimiento… |
zalora_get_order_history | Historial de estado de los artículos de un pedido: orderItemId, shopSku, estado, nota, createdAt y quién hizo el cambio. Solo lectura |
zalora_get_order_item_returns | Detalles de devolución de artículos de pedidos: paquete de devolución, razón, comentario y proveedor de envío de devolución. Solo lectura |
zalora_list_shipment_providers | Proveedores de envío con los que el vendedor puede enviar: id, nombre, predeterminado, apiIntegrationAvailable (verdadero: el número de seguimiento puede omitirse)… |
zalora_list_failure_reasons | Razones aceptadas al cancelar un artículo o marcar una entrega como fallida: id, tipo, nombre, descripción y fuera de stock. Solo lectura |
zalora_print_document | Genera un documento de pedido como PDF en base64: etiqueta de envío, factura, lista de picking, lista de verificación, manifiesto del transportista y otros, dependiendo del pedido… |
zalora_list_products | Lista productos (variaciones): id, uuid, shopSku, sellerSku, productSetId, estado y variación, ordenados por id, con pagination (limit… |
zalora_list_product_sets | Lista conjuntos de productos (el artículo del catálogo que agrupa los tamaños o colores): id, nombre, SKU padre, marca, categoría, estado y control de calidad… |
zalora_list_product_set_products | Los productos (variaciones) de un conjunto de productos: id (el id del producto utilizado para stock y precios), sellerSku, shopSku, variación, estado… |
zalora_get_product_stock | Stock de un producto (variación): cantidad (vendible en tu almacén), reservedStock, disponible, stock en consignación en ZALORA cuando… |
zalora_get_product_set_stock | Stock de cada producto (variación) de un conjunto de productos: shopSku, sellerSku, cantidad, reservedStock, disponible, consignaciones y almacenes.… |
zalora_get_product_set_prices | Precios de cada producto de un conjunto de productos por país: precio, precioDeVenta, fechaInicioVenta, fechaFinVenta y estado, para los países donde un… |
zalora_list_brands | Marcas: id, uuid, nombre, isRestricted y isAccessible (si puedes venderlo), con pagination (totalCount). Solo lectura |
zalora_get_category_tree | Todo el árbol de categorías: id, parentId, nombre, attributeSetId, ruta e hijos. Respuesta grande: obtén una vez y guarda los ids. Solo lectura |
zalora_get_category_attributes | Atributos de una categoría: id, nombre, etiqueta, isMandatory, inputType, attributeType y las opciones permitidas. Solo lectura |
zalora_get_seller | La cuenta de vendedor detrás de las credenciales: id, nombre, código corto, estado, razones de deslistado (modo de vacaciones, límites de pedidos) y detalles de contacto.… |
zalora_set_ready_to_ship | Empaqueta artículos pendientes de un pedido en un paquete y configúralos como listos para enviar, con el número de seguimiento y el proveedor de envío. Cada… |
zalora_set_packed_by_marketplace | Marca artículos pendientes como empaquetados para que ZALORA organice el envío (logística del marketplace). Cada artículo debe ser del mismo pedido. Responde… |
zalora_set_shipped | Marca artículos listos para enviar de un pedido como enviados (solo dropship; no es posible para cross-docking o donde se requieren manifiestos). Responde… |
zalora_set_delivered | Marca artículos enviados de un pedido como entregados (solo dropship). Responde los ids de los artículos de pedido cambiados |
zalora_update_tracking_code | Cambia el número de seguimiento de un artículo listo para enviar; se aplica a cada artículo en el mismo paquete. Envía una cadena vacía para permitir que ZALORA… |
zalora_update_shipping_provider | Cambia el proveedor de envío (y opcionalmente el número de seguimiento) de un artículo listo para enviar; se aplica a cada artículo en el mismo paquete |
zalora_update_stock | Establece la cantidad de stock de hasta 100 productos (variaciones) en una llamada, como números absolutos. No es posible para productos cumplidos por ZALORA.… |
zalora_update_price | Cambia el precio de un producto (variación) en un país. Solo los campos que envíes cambian: precio (precio de lista), precioDeVenta con… |
zalora_set_price_status | Cambia la fila de precio de un producto en un país a activo o inactivo. inactivo quita el producto de la venta en ese país |
zalora_cancel_order_items | Cancela artículos de un pedido con una razón de zalora_list_failure_reasons. No se puede deshacer; el cliente es reembolsado y la cancelación… |
zalora_set_delivery_failed | Marca artículos de un pedido como entrega fallida con una razón de zalora_list_failure_reasons (solo dropship) |
zalora_approve_return | Aprueba la devolución de artículos que esperan aprobación (solo donde el vendedor maneja devoluciones). Aprobar conduce a que el cliente sea reembolsado |
Ejemplos de mensajes
- "¿Qué pedidos de ZALORA están pendientes y necesitan ser empaquetados hoy?"
- "Marca el artículo de pedido 81234567 como listo para enviar y obtén la etiqueta de envío."
- "¿Qué conjuntos de productos tienen menos de 5 unidades en stock?"
- "Cambia el precio del SKU ZL-DRESS-NVY-M a 59.90 SGD."
- "Muestra las devoluciones del pedido 260112345 y sus razones."
Preguntas frecuentes
¿De dónde provienen las credenciales? ZALORA Seller Center, Configuración, Gestión de Integración, Aplicaciones OAuth: crea una aplicación como usuario con Acceso Completo de Vendedor y copia su ID de Aplicación y secreto. Elige también tu país del Seller Center.
¿Qué países cubre? Singapur, Malasia, Indonesia, Filipinas y Hong Kong. Cada país tiene su propio Seller Center, así que instala un conector por país.
¿Qué herramientas se instalan desactivadas? zalora_cancel_order_items, zalora_set_delivery_failed, zalora_approve_return y zalora_set_price_status. Actívalas en la página del conector solo si la IA debe usarlas.
¿Cursor admite servidores MCP personalizados en el plan gratuito? Sí, MCP está disponible en los planes Hobby, Pro y Business.
Próximos pasos
¿Te ha sido útil esta guía?