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 pedidos, empaquetado, 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 Claude, ChatGPT o 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 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 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
API del ZALORA Seller Center v2 para vendedores en el mercado de moda de Singapur, Malasia, Indonesia, Filipinas y Hong Kong: pedidos y artículos de pedidos, empaquetado, 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
La configuración toma aproximadamente 5 minutos.
- Inicia sesión en el 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 alcances: la aplicación puede hacer lo que permite el rol de su creador.
Por 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.
Empaque y envío: verifica primero zalora_list_shipment_providers. zalora_set_ready_to_ship empaqueta 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 usan 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 recogida 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 del 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ías). 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 pedidos) 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).
Requisitos previos: ZALORA_DOMAIN, ZALORA_CLIENT_ID, ZALORA_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 ZALORA y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
zalora_list_orders | Lista pedidos, el más antiguo primero a menos que esté ordenado: 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 recogida, 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), stockReservado, 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, stockReservado, 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 del 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 mercado). 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 dejar 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ías 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 solicitudes
- "¿Qué pedidos de ZALORA están pendientes y necesitan ser empaquetados hoy?"
- "Marca el artículo del 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."
Próximos pasos
¿Te ha sido útil esta guía?