Resumen
Gestiona tu tienda en el marketplace vtwonen desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en los Países Bajos y Bélgica; inicia sesión con la clave API de la tienda desde tu oficina de vendedor vtwonen.
Configuración guiada
Conecta vtwonen Marketplace a Claude, ChatGPT o Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta vtwonen Marketplace 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 vtwonen Marketplace
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 → vtwonen Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
vtwonen Marketplace
Gestiona tu tienda en el marketplace vtwonen desde un agente de IA: pedidos, aceptación, seguimiento y envío, incidentes, ofertas con precios y stock, importaciones, mensajes, devoluciones, facturas y transacciones. El marketplace vende en los Países Bajos y Bélgica; inicia sesión con la clave API de la tienda desde tu oficina de vendedor vtwonen.
Configuración
Países: los Países Bajos y Bélgica. La tienda está en neerlandés; los vendedores deben entregar sin cargo a los Países Bajos y Flandes.
Quién puede vender: vtwonen elige a sus proveedores y productos a través de un comité interno; solicita por correo electrónico ([email protected]). Los vendedores envían desde su propio stock, ofrecen entrega gratuita y devoluciones gratuitas, y responden a las preguntas de los clientes en un plazo de 24 horas. El conector necesita una cuenta de vendedor que vtwonen ya ha abierto.
La configuración tarda unos 5 minutos.
- Inicia sesión en la oficina de vendedor de vtwonen:
https://shop-partnerplatform.vtwonen.nl/login. - En la oficina, abre tu nombre de usuario (arriba a la derecha) > Mis configuraciones de usuario > Clave API y haz clic en Generar una nueva clave (o copia la clave existente). Pégala en
VT_WONEN_API_KEY. La clave se envía tal cual en el encabezadoAuthorization, sinBearer. Generar una nueva clave invalida la anterior, por lo que cualquier otra herramienta que la use dejará de funcionar. - Deja
VT_WONEN_SHOP_IDvacío. Solo si tu usuario gestiona varias tiendas en vtwonen, estableceVT_WONEN_SHOP_IDal id numérico de la tienda en la que debe funcionar este conector (mostrado en el panel de la oficina junto a Identificador o ID de tienda, y devuelto comoshop_idporvt_wonen_get_account). Sin ello, se usará tu tienda predeterminada. - Instala y ejecuta
vt_wonen_get_account: devuelve la tienda a la que pertenece la clave.
Dónde empezar: vt_wonen_get_account muestra la tienda detrás de la clave (id, nombre, estado, moneda y canales). Para el trabajo diario, usa vt_wonen_list_orders con order_state_codes=WAITING_ACCEPTANCE, vt_wonen_list_offers para precios y stock y vt_wonen_list_threads para mensajes que esperan respuesta.
Productos y ofertas competidoras: vt_wonen_get_products busca productos en el catálogo de vtwonen por EAN u otra referencia y devuelve el SKU del producto en el marketplace; vt_wonen_list_product_offers lista las ofertas de cada tienda para productos dados, mejor precio primero, a unas 5 llamadas por minuto.
Flujo de trabajo de pedidos: un nuevo pedido espera en WAITING_ACCEPTANCE. vt_wonen_accept_order acepta (o rechaza) cada línea; después de que se debite al cliente, el pedido pasa a SHIPPING. Luego, vt_wonen_update_tracking almacena el transportista y el número de seguimiento (los códigos de transportista provienen de vt_wonen_list_carriers) y vt_wonen_ship_order confirma el envío (SHIPPED). Los estados posteriores son TO_COLLECT, RECEIVED, CLOSED, REFUSED y CANCELED. Usa vt_wonen_list_orders con order_state_codes=WAITING_ACCEPTANCE para la lista de tareas diaria y has_incident=true para incidentes abiertos; vt_wonen_resolve_incident cierra un incidente en una línea de pedido una vez que se resuelve. Los documentos adjuntos a los pedidos (notas de entrega, etiquetas, facturas de clientes) son listados por vt_wonen_list_order_documents.
Escrituras: confirma primero. vt_wonen_accept_order, vt_wonen_update_tracking, vt_wonen_ship_order, vt_wonen_resolve_incident, vt_wonen_accept_return, vt_wonen_receive_return, vt_wonen_update_offers, vt_wonen_reply_thread, vt_wonen_create_order_thread y vt_wonen_import_products actúan en el marketplace en vivo. Antes de cada llamada, muestra al usuario qué cambiará (id y líneas del pedido, número de seguimiento, SKU de la oferta con el precio o stock antiguo y nuevo, el texto del mensaje y los destinatarios) y espera un sí. Rechazar una línea de pedido la cancela definitivamente. Ninguna herramienta aquí reembolsa, cancela pedidos o mueve dinero; hazlo en la oficina. vt_wonen_import_offers puede eliminar ofertas (el modo REPLACE elimina cada oferta que falta en el archivo), por lo que se instala apagado.
Actualización de ofertas (precios y stock): vt_wonen_update_offers (OF24) reemplaza toda la oferta. Cada campo que dejes fuera se restablece: una quantity faltante se convierte en 0, un discount o description faltante se elimina. Siempre lee la oferta primero (vt_wonen_get_offer o vt_wonen_list_offers con sku) y envíala de vuelta completa con solo el cambio previsto: shop_sku, product_id y product_id_type (de product_references), state_code, price, quantity, leadtime_to_ship, logistic_class (su código), min_quantity_alert, description, discount, all_prices, available_started / available_ended (leído como available_start_date / available_end_date) y cualquier offer_additional_fields. Deja update_delete vacío o update. La llamada devuelve un import_id; el cambio se aplica de forma asíncrona, así que revísalo con vt_wonen_get_offer_import antes de leer la oferta nuevamente. Los códigos de condición para state_code provienen de vt_wonen_list_offer_conditions, los códigos de clase logística de vt_wonen_list_logistic_classes.
Importaciones de archivos: vt_wonen_import_products (P41) y vt_wonen_import_offers (OF01) toman la URL de un archivo CSV, XLSX o XML en el formato de archivo que vtwonen solicita; el conector lo descarga y lo sube a vtwonen. Haz seguimiento con vt_wonen_list_product_imports / vt_wonen_get_product_import y vt_wonen_list_offer_imports / vt_wonen_get_offer_import.
Devoluciones: vt_wonen_list_returns (RT11) lista las solicitudes de devolución. Donde vtwonen deja que la tienda decida, vt_wonen_accept_return acepta o rechaza una en WAITING_ACCEPTANCE y vt_wonen_receive_return confirma que los bienes han llegado. Los reembolsos permanecen en la oficina.
Mensajes: vt_wonen_list_threads lista conversaciones (filtra con entity_type=MMP_ORDER y entity_id=<order id> para un pedido; entity_id sin entity_type es rechazado), vt_wonen_get_thread lee una con sus mensajes, vt_wonen_reply_thread responde (destinatario CUSTOMER o OPERATOR, que es vtwonen) y vt_wonen_create_order_thread abre una nueva conversación sobre un pedido. Los códigos de razón para temas provienen de vt_wonen_list_reasons; deja su locale vacío a menos que sepas que el marketplace tiene ese idioma (un locale inactivo responde 400).
Dinero: vt_wonen_list_invoices (IV01) lista los documentos contables que vtwonen emite a la tienda y vt_wonen_list_transactions (TL02) las líneas de transacción (ventas, comisiones, reembolsos, pagos). Si vtwonen utiliza la Facturación Mejorada para Vendedores, IV01 no devuelve nuevos documentos; usa vt_wonen_list_document_requests (DR11) y las transacciones entonces.
Catálogo completo: para leer cada oferta (una verificación de stock o precio en todo el catálogo, contando ofertas), inicia una exportación con vt_wonen_export_offers, consulta vt_wonen_get_offer_export_status aproximadamente una vez por minuto hasta que esté en COMPLETED, y lee los archivos uno por uno con vt_wonen_get_offer_export_file; include_fields mantiene solo las columnas que necesitas. Se permite una exportación completa una vez al día; para lo que ha cambiado desde entonces, pasa last_request_date (una exportación diferencial, como máximo una vez por minuto). No pagines a través de cada oferta con vt_wonen_list_offers: está destinado a unas pocas ofertas a la vez y responde 429 cuando se pagine a través de un catálogo grande.
Varias tiendas: cada herramienta toma un shop_id opcional. Un usuario que gestiona varias tiendas en este marketplace (una agencia, o una tienda por país) puede trabajar en todas ellas con una sola instalación: pasa el id de la tienda en cada llamada y verifica cuál tienda es con vt_wonen_get_account y el mismo shop_id. Sin shop_id, una llamada utiliza VT_WONEN_SHOP_ID, o la tienda predeterminada del usuario cuando esta está vacía. Pregunta al usuario por los ids de sus tiendas; la oficina los muestra.
Listas de referencia: vt_wonen_list_channels (sitios de país), vt_wonen_list_carriers, vt_wonen_list_shipping_zones, vt_wonen_list_shipping_methods y vt_wonen_list_logistic_classes cambian raramente; léelos una vez por conversación.
Paginación: pedidos, ofertas, facturas e importaciones de productos se paginan con max (como máximo 100) y offset. Hilos, devoluciones, transacciones, solicitudes de documentos e importaciones de ofertas devuelven un next_page_token; pásalo como page_token para obtener la siguiente página (todos los demás filtros se ignoran entonces) hasta que falte.
Fechas son ISO 8601, e.g. 2026-10-01T00:00:00Z; las respuestas están en UTC.
Límites de tasa: Cada API tiene su propio límite y vtwonen puede endurecerlos. Listar ofertas y pedidos está destinado a uso interactivo, importaciones de productos y ofertas como máximo cada 15 minutos, vt_wonen_get_account y las listas de referencia aproximadamente una vez al día. Un 429 lleva un encabezado Retry-After con los segundos a esperar; no intentes de nuevo en un bucle.
Errores: 401 significa que la clave es incorrecta o fue reemplazada por una más nueva, 403 que tu usuario no tiene el derecho para esta acción, 404 que el pedido, oferta o hilo no existe para esta tienda o que el marketplace no utiliza esa función, como devoluciones, 400 un parámetro incorrecto o un pedido en el estado incorrecto (el mensaje lo nombra, e.g. ORDER_INVALID_STATE).
Requisitos previos: VT_WONEN_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 vtwonen Marketplace y pega las variables de entorno listadas bajo Requisitos previos.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
vt_wonen_get_account | Lee la tienda detrás de la clave API en este marketplace (A01): id y nombre de la tienda, estado, canales, moneda, grado y tasa de aprobación, contacto… |
vt_wonen_list_orders | Lista pedidos (OR11) con sus líneas, cliente, dirección de envío, precios, estado e incidentes. Filtra por estado (e.g. WAITING_ACCEPTANCE para… |
vt_wonen_list_offers | Lista las ofertas de la tienda (OF21): SKU, producto, precio y descuento, todos los precios de canal, cantidad en stock, condición, tiempo de entrega y si… |
vt_wonen_get_offer | Lee una oferta completa por su id de oferta (OF22): cada campo de precio, descuento, cantidad, condición, clase logística, tiempo de entrega y personalizado… |
vt_wonen_list_offer_conditions | Lista las condiciones de oferta (OF61) que el marketplace acepta, e.g. nuevo o usado, con el código para poner en state_code al actualizar ofertas |
vt_wonen_list_offer_imports | Lista importaciones y actualizaciones de ofertas (OF04), desde archivos y desde vt_wonen_update_offers: estado (WAITING, RUNNING, COMPLETE, FAILED), líneas leídas… |
vt_wonen_get_offer_import | Lee el estado de una importación de oferta o actualización de oferta (OF02) por su import_id, como lo devuelve vt_wonen_update_offers o… |
vt_wonen_export_offers | Inicia una exportación de todas las ofertas de la tienda como archivos (OF52), la forma de leer todo el catálogo (cada SKU con precio y stock) en lugar de… |
vt_wonen_get_offer_export_status | Estado de una exportación de oferta iniciada con vt_wonen_export_offers (OF53): PENDING, COMPLETED o FAILED (con error.code y error.detail), y… |
vt_wonen_get_offer_export_file | Lee un archivo de una exportación de oferta completada (OF54): las ofertas con su SKU, producto, cantidad, precios y otros campos exportados, como… |
vt_wonen_list_product_imports | Lista importaciones de productos (P51) con su estado (WAITING, RUNNING, SENT, COMPLETE, FAILED, CANCELLED), los recuentos de transformación y el… |
vt_wonen_get_product_import | Lee el estado de una importación de producto (P42) por su import_id: estado de importación, razón, recuentos de transformación y los detalles de integración… |
vt_wonen_get_products | Busca productos en el catálogo del marketplace por sus identificadores (P31), e.g. EAN, y obtén el SKU del producto en el marketplace, título y categoría.… |
vt_wonen_list_product_offers | Lista las ofertas de cada tienda para productos dados (P11), ordenadas por mejor precio, para comparar tu precio con la competencia. Da product_ids… |
vt_wonen_list_threads | Lista hilos de mensajes (M11) con clientes y vtwonen: tema, pedido o oferta vinculada, participantes, fecha del último mensaje y desde cuándo una tienda… |
vt_wonen_get_thread | Lee un hilo de mensaje (M10) con todos sus mensajes, remitentes, destinatarios, adjuntos y el pedido o oferta vinculada |
vt_wonen_list_returns | Lista solicitudes de devolución (RT11) con su estado, líneas de devolución, razón, RMA, seguimiento y el pedido vinculado. Filtra por estado, pedido o fecha.… |
vt_wonen_list_reasons | Lista los códigos de razón del marketplace (RE01): incidente, cancelación, reembolso y razones de mensaje, con sus etiquetas y si la tienda puede… |
vt_wonen_list_carriers | Lista los transportistas que conoce el marketplace (SH21) con su código, etiqueta y URL de seguimiento. Usa el código como carrier_code en… |
vt_wonen_list_invoices | Lista los documentos contables que vtwonen emite a la tienda (IV01): facturas y notas de crédito con período, totales con y sin impuestos… |
vt_wonen_list_transactions | Lista las líneas de transacción de la tienda (TL02): montos de pedidos, envío, comisiones, reembolsos, créditos manuales y pagos, con monto, tipo… |
vt_wonen_list_document_requests | Lista solicitudes de documentos contables (DR11), usadas cuando vtwonen ejecuta la Facturación Mejorada para Vendedores: facturas y notas de crédito que vtwonen o el… |
vt_wonen_list_order_documents | Lista los documentos adjuntos a uno o más pedidos (OR72): notas de entrega, etiquetas de envío, facturas de clientes y otros archivos, con id, archivo… |
vt_wonen_list_channels | Lista los canales de venta del marketplace (CH11), generalmente uno por sitio de país, con código y etiqueta. Usa los códigos como channel_codes en… |
vt_wonen_list_shipping_zones | Lista las zonas de envío activas del marketplace (SH11) con código y etiqueta, e.g. Francia continental o Córcega. Cambios raramente: llámalo… |
vt_wonen_list_shipping_methods | Lista los métodos de envío activos del marketplace (SH12), e.g. estándar, exprés o recogida, con código, etiqueta, si un número de seguimiento… |
vt_wonen_list_logistic_classes | Lista las clases logísticas del marketplace (SH31), los tamaños o bandas de peso que deciden los precios de envío, con código y etiqueta. Usa el código como… |
vt_wonen_accept_order | Acepta o rechaza las líneas de un pedido que espera aceptación (OR21). Cada línea del pedido debe ser listada. Rechazar una línea la cancela… |
vt_wonen_update_tracking | Establece el transportista y el número de seguimiento de un pedido (OR23). Da carrier_code de vt_wonen_list_carriers, o carrier_name con carrier_url para… |
vt_wonen_ship_order | Confirma que un pedido en SHIPPING ha sido enviado (OR24); pasa a SHIPPED y el cliente es notificado. Establece el seguimiento primero con… |
vt_wonen_update_offers | Crea o actualiza ofertas, incluyendo precio y stock (OF24). Reemplaza cada oferta completamente: cada campo dejado fuera se restablece (una falta de… |
vt_wonen_reply_thread | Responde en un hilo de mensaje (M12) al cliente o vtwonen. El mensaje se entrega de inmediato y no puede ser retirado: muestra al usuario el… |
vt_wonen_create_order_thread | Inicia un nuevo hilo de mensaje sobre un pedido (OR43) con el cliente, vtwonen o ambos. El mensaje se entrega de inmediato: muestra al usuario el texto… |
vt_wonen_resolve_incident | Marca el incidente abierto en una línea de pedido como resuelto (OR64), una vez que se soluciona el problema del cliente. reason_code debe ser un INCIDENT_CLOSE… |
vt_wonen_accept_return | Acepta o rechaza una solicitud de devolución en WAITING_ACCEPTANCE (RT21). Solo cuando vtwonen maneja devoluciones en la oficina del vendedor y deja el… |
vt_wonen_receive_return | Confirma que los bienes de una devolución aceptada han llegado a tu almacén (RT25). La devolución pasa a RECEIVED. Actúa en el marketplace en vivo… |
vt_wonen_import_products | Envía un archivo de producto al marketplace (P41) para crear o enriquecer productos en su catálogo. file_url es la dirección de un CSV, XLSX o XML… |
vt_wonen_import_offers | Importa un archivo de ofertas (OF01) para crear, actualizar o eliminar ofertas en bloque. El modo REPLACE elimina cada oferta que no está en el archivo, y… |
Ejemplos de solicitudes
- "¿Qué pedidos de vtwonen están esperando mi aceptación?"
- "¿Qué preguntas de clientes son más antiguas de 24 horas y aún no tienen respuesta?"
- "Establece el stock de mi SKU de funda de cojín de lino VTW-LIN-50 a 60 y mantén el precio."
- "Añade el seguimiento de PostNL 3SXYZ9876543 al pedido 6620118-A y confirma el envío."
- "¿Qué solicitudes de devolución están esperando mi decisión?"
Próximos pasos
¿Te ha sido útil esta guía?