Resumen
API de ABOUT YOU Seller Center para socios de marketplace: pedidos, envíos con seguimiento, facturas y albaranes, productos con estado de aprobación, stock, precios, categorías y atributos, marcas e informes. Clave de API.
Configuración guiada
Conecta ABOUT YOU a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta ABOUT YOU 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 ABOUT YOU
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 → ABOUT YOU, pega tus credenciales, genera una clave de API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
ABOUT YOU
API de ABOUT YOU Seller Center para socios de marketplace: pedidos, envíos con seguimiento, facturas y albaranes, productos con estado de aprobación, stock, precios, categorías y atributos, marcas e informes. Clave de API.
Configuración
La configuración tarda aproximadamente 2 minutos.
- Inicia sesión en el ABOUT YOU Seller Center como usuario Admin. Los usuarios miembros no pueden crear claves de API.
- Abre Configuración, luego Claves de API, y haz clic en + Añadir.
- Introduce una etiqueta, opcionalmente una fecha de caducidad, y haz clic en Añadir clave.
- Copia la clave de inmediato en
ABOUT_YOU_API_KEY: el Seller Center solo la muestra esta vez.
La clave se envía en el encabezado X-API-Key. Para datos de prueba, crea un sandbox en Configuración, Sandbox, Crear Sandbox: tiene su propia clave de API en la misma dirección, los productos se activan allí sin aprobación, y los pedidos de prueba provienen del botón Recibir Pedidos en la página de Pedidos.
Dónde empezar: about_you_list_orders con order_status abierto muestra lo que está esperando ser enviado. about_you_list_products muestra tu catálogo con stock y precios. about_you_list_countries es la llamada económica que prueba que la clave funciona.
Pedidos y envíos: about_you_list_orders devuelve los artículos de cada pedido con su id; las herramientas de envío, cancelación y devolución toman estos ids de artículo, nunca SKUs. Envía con about_you_ship_order_items (clave de transportista de about_you_list_carriers, clave de seguimiento de envío y clave de seguimiento de devolución son todas requeridas). about_you_get_delivery_document devuelve el albarán de un pedido de dropshipping y about_you_get_order_invoices las facturas del cliente, ambos como archivos. about_you_cancel_order_items y about_you_return_order_items están instalados desactivados: un artículo cancelado no puede ser enviado más tarde, y marcar un artículo como devuelto hace que ABOUT YOU reembolse automáticamente al cliente. Verifica una devolución dentro de las 24 horas de la recepción; no registres una que rechaces.
Escrituras asíncronas: cada escritura responde de inmediato con un batchRequestId y se procesa en segundo plano. Lee el resultado con about_you_get_batch_result (elige el result_type correspondiente) hasta que el estado esté completado o fallido; cada artículo lleva éxito y errores. Los resultados se mantienen durante 7 días. La misma carga útil enviada dos veces en un corto período devuelve el mismo id de lote y no se procesa de nuevo.
Productos: una fila es un SKU (un tamaño de un color de un estilo). Crea o cambia productos con about_you_upsert_products utilizando ids de about_you_list_categories, about_you_list_category_attribute_groups y about_you_list_brands, luego envía el estilo para aprobación con about_you_publish_product. Estados: borrador, pendiente_aprobación (bloqueado mientras ABOUT YOU revisa), rechazado (razones en about_you_list_rejected_products), pendiente_activo, activo, inactivo y problema (un producto activo que se volvió inválido; vuelve a ser activo una vez solucionado). about_you_update_product_status (también borrador e inactivo) y about_you_delete_product están instalados desactivados.
Stock y precios: about_you_update_stock y about_you_update_prices aceptan hasta 1000 filas por llamada y siempre se aplican, a diferencia del stock o precios enviados a través del upsert de productos. Los precios de los productos son números decimales en la moneda del país (49.99), mientras que los montos de los pedidos son enteros en la unidad más pequeña (4999 = 49.99 EUR). Envía currency con cada precio.
Informes y webhooks: about_you_list_reports y about_you_download_report (informes de stock y movimiento de mercancías en los almacenes de ABOUT YOU, DAC7), about_you_list_webhooks (solo lectura).
Paginación: las listas devuelven items y pagination. Los pedidos y productos deben paginarse con cursor = pagination.next_cursor; el parámetro de página aún funciona allí pero está en desuso. Listas más pequeñas utilizan page y per_page (máx. 100).
Tipos de cumplimiento: dropshipping significa que tú envías; fulfillment_by_marketplace significa que ABOUT YOU envía desde su propio almacén (FbAY), por lo que no hay nada que enviar y no hay documento de entrega para esos pedidos.
Límites de tasa (por endpoint y por clave): pedidos 100 por minuto, envío 200, cancelación y devolución 50, stock 1000, precios 200, lista de productos 1000, upsert de productos y estado 100, resultados de lotes 200, facturas e informes 10. Los encabezados X-RateLimit-Limit y X-RateLimit-Remaining muestran el presupuesto; un 429 significa esperar hasta el siguiente minuto.
Errores: 400 y 401 responden con un JSON message. Un 404 en un documento significa que el pedido no tiene tal archivo. Esta API no tiene llamada de pago o reembolso; la única acción que lleva a un reembolso es registrar una devolución, que está desactivada.
Requisitos previos: ABOUT_YOU_API_KEY
Instala 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 ABOUT YOU y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
about_you_list_orders | Lista pedidos: por pedido order_number, estado (abierto, enviado, cancelado, devuelto, mixto), fulfillment_type, carrier_key, cost_with_tax y… |
about_you_list_carriers | Lista los transportistas con los que puedes enviar: clave (por ejemplo DHL_STD_NATIONAL, el valor para carrier_key al enviar), carrier_name, display_label y… |
about_you_ship_order_items | Marca artículos de pedidos abiertos como enviados, una entrada por paquete: los ids de los artículos del pedido en él, la clave del transportista, la clave de seguimiento del envío y la devolución… |
about_you_cancel_order_items | Cancela artículos de pedidos abiertos que no puedes entregar (por ejemplo, fuera de stock). Los artículos cancelados no pueden ser enviados más tarde, el stock no se añade… |
about_you_return_order_items | Registra artículos de pedidos enviados como devueltos a ti, con la clave de seguimiento de devolución. Una vez que un artículo se marca como devuelto, ABOUT YOU reembolsa al… |
about_you_get_order_invoices | Descarga las facturas del cliente de un pedido. La respuesta es un archivo adjunto al resultado: un PDF, o un ZIP cuando el pedido tiene varios… |
about_you_get_delivery_document | Descarga el documento de entrega (albarán) de un pedido de dropshipping como un PDF adjunto al resultado. Los pedidos enviados por ABOUT YOU… |
about_you_list_products | Lista tus variantes de producto (una fila por SKU): sku, style_key, colorway_key, ean, name, estado (borrador, pendiente_aprobación, rechazado… |
about_you_list_rejected_products | Lista productos que ABOUT YOU rechazó en la aprobación: style_key, rejection_message, rejection_reasons[] (clave, tipo Requisitos de Imagen o… |
about_you_upsert_products | Crea o actualiza hasta 100 variantes de producto (una entrada por SKU). Los nuevos productos comienzan como borrador; publícalos con about_you_publish_product.… |
about_you_publish_product | Publica un producto (todas las variantes de una clave de estilo). Un borrador va a la aprobación de ABOUT YOU (pendiente_aprobación, luego pendiente_activo, luego… |
about_you_update_product_status | Establece el estado de uno o más productos por clave de estilo: published (enviar a aprobación o volver a estar en línea), draft (retirar de la aprobación; solo… |
about_you_update_stock | Establece la cantidad de stock de hasta 1000 SKUs (tu propio stock de almacén; una cantidad de 0 hace que el tamaño no esté disponible). Una actualización con una… |
about_you_update_prices | Establece el precio de hasta 1000 pares de SKU y país: precio de venta y precio de oferta opcional, como números decimales en la moneda del país.… |
about_you_delete_product | Elimina una variante por SKU. Cuando fue el último tamaño de un color, el color también se elimina, y con el último color, el producto completo.… |
about_you_list_categories | Busca el árbol de categorías de ABOUT YOU: id (el valor de categoría para productos), nombre, ruta (para visualización), parent_id, material_composition_type… |
about_you_list_category_attribute_groups | Lista los grupos de atributos que una categoría exige (color, tamaño, grupos de material y otros atributos): por grupo id, nombre, frontend_name… |
about_you_list_brands | Lista las marcas que tu cuenta puede vender: id (el valor de marca para productos) y nombre. Solo lectura, una llamada devuelve todo, 50 llamadas por minuto |
about_you_list_countries | Lista los países en los que tu cuenta vende (código, nombre), los locales para descripciones de productos y la moneda de cada país (country_code… |
about_you_get_batch_result | Lee el resultado de una escritura asíncrona: estado (pendiente, procesando, completado, reintentar, fallido) y items[] con el artículo de solicitud… |
about_you_list_reports | Lista los archivos de informe que ABOUT YOU generó para tu cuenta: id, tipo (SELLABLE_STOCK, WAREHOUSE_MOVEMENTS, DAC7), file_name, fecha… |
about_you_download_report | Descarga un archivo de informe por id. Un archivo de texto (CSV) regresa como texto, cualquier otro formato como un archivo adjunto al resultado. Solo lectura, 10… |
about_you_list_webhooks | Lista las suscripciones de webhook de la cuenta: id, url, eventos (order.created, order.shipped, stock.updated y otros), habilitado… |
Ejemplos de prompts
- "¿Qué pedidos de ABOUT YOU están abiertos y esperando ser enviados?"
- "¿Cuáles de mis productos fueron rechazados por ABOUT YOU, y por qué?"
- "Establece el stock de SKU AY-TSHIRT-WHT-M en 50."
- "Envía los artículos del pedido 123456789 con DHL, seguimiento 003404341612345678 y seguimiento de devolución 003404341698765432."
- "Descarga el informe de ventas del mes pasado."
Próximos pasos
¿Te ha sido útil esta guía?