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 Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta ZALORA 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 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 + Microsoft Copilot
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 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
ZALORA. - 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 |
|---|---|
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.
¿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?