Resumen
API de vendedor de Rozetka Marketplace para el mayor marketplace de Ucrania: pedidos con actualizaciones de estado y guía de carga (TTN), estado de pago, productos con actualizaciones masivas de precios y stock y nuevos listados, reseñas de tiendas y preguntas sobre productos con respuestas, chats de compradores y solicitudes de devolución. Inicia sesión con el login del gabinete de vendedor.
Configuración guiada
Conecta Rozetka Marketplace a ChatGPT en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta Rozetka Marketplace con la configuración guiada y añade tu URL MCP a ChatGPT. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
El plugin de AnythingMCP en el directorio de ChatGPT responde, en AnythingMCP Cloud, a preguntas sobre las bases de datos de tu empresa (PostgreSQL, MySQL, SQL Server, Oracle, SAP HANA, SQLite, MongoDB, solo lectura): abre la ficha (se abre en una pestaña nueva) y pulsa Install plugin. Los demás conectores se añaden a ChatGPT como servidor MCP personalizado con la URL MCP de tu AnythingMCP.
Prueba a pedir
Prompts de ejemplo para Rozetka 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 → Rozetka Marketplace, pega tus credenciales, genera una clave API de MCP y listo. Sin Docker, sin
git clone, sin servidor local.
Rozetka Marketplace + ChatGPT
API de vendedor de Rozetka Marketplace para el mayor marketplace de Ucrania: pedidos con actualizaciones de estado y guía de carga (TTN), estado de pago, productos con actualizaciones masivas de precios y stock y nuevos listados, reseñas de tiendas y preguntas sobre productos con respuestas, chats de compradores y solicitudes de devolución. Inicia sesión con el login del gabinete de vendedor.
Requisitos previos
Consulta las instrucciones completas de configuración integradas en el conector (visibles en la tienda de la aplicación cuando seleccionas el conector). Las variables de entorno requeridas para este conector son:
ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
Paso 1 — Obtener credenciales
La API inicia sesión con el login y la contraseña del gabinete de vendedor de Rozetka (seller.rozetka.com.ua); no hay una clave API separada.
- Coloca el login del gabinete en
ROZETKA_USERNAME. - Rozetka espera que la contraseña esté codificada en Base64, así que
ROZETKA_PASSWORD_BASE64toma la forma codificada, no la contraseña en texto plano. Codifícala en tu propio ordenador, por ejemplo, en una terminalprintf '%s' 'tu-contraseña' | base64, y pega el resultado. No uses un codificador en línea para una contraseña real. AnythingMCP inicia sesión conPOST /sitesy envía el token de sesión como un token Bearer. Rozetka mantiene un token activo mientras se utiliza y permite que expire después de 24 horas sin uso; el conector inicia sesión de nuevo cada cuatro horas. Un login o contraseña incorrectos se reportan comoincorrect_username_password.
Dónde empezar: rozetka_get_order_counts y rozetka_get_message_counts muestran lo que está esperando (nuevos pedidos, chats no leídos, solicitudes de devolución abiertas). Luego rozetka_list_orders con types=4 (nuevo) o types=2 (en proceso).
Pedidos
rozetka_list_order_statusesmapea elstatusnumérico de un pedido a su nombre.rozetka_list_ordersfiltra portypes(1 todos, 2 en proceso, 3 completados, 4 nuevos, 5 en entrega, 6 fallidos), estado o fechas;rozetka_get_orderlee un pedido. Agregaexpand=purchases,delivery,userpara artículos, entrega y comprador, ystatus_availablepara los estados a los que el pedido puede pasar a continuación.rozetka_update_ordercambia el estado, agrega la guía de carga (TTN) y un comentario del vendedor. Flujo habitual: nuevo pedido (1) -> confirmar con 2 (siendo empaquetado) -> agregar el TTN con estado 3 (entregado al transportista) o 61 (entrega planificada); un TTN enviado con estado 2 mueve el pedido a 61. Después de agregar un TTN, Rozetka rastrea el paquete y cambia el estado por sí mismo. Los estados 7 y superiores son principalmente cancelaciones o estados de entrega (por ejemplo, 16/42 fuera de stock, 18 comprador inalcanzable, 40 comprador cambió de opinión, 45 cancelado por el comprador): establece una cancelación solo cuando lo pida el vendedor, no se puede deshacer. Verificastatus_availableprimero.rozetka_get_order_payment_statusindica si un pago en línea está pagado, no pagado, siendo verificado o cancelado (almacenado en caché 5 minutos).
Productos y precios
rozetka_list_goodsyrozetka_get_goodsleen los productos del vendedor;rozetka_get_goods_countslos cuenta por pestaña del gabinete (errores, moderación, esperando confirmación).rozetka_update_goods_price_stockcambia el precio y el stock de uno o varios productos poritem_rz_id(el id de Rozetka,id/rz_item_iden la lista de productos, no elitem_idinterno). Los precios están en UAH. Rozetka mantiene un precio elevado más de 1.5 veces o reducido en más de la mitad para que un gerente lo confirme.- Ids de estado de productos: 0 bloqueado, 1 activo, 2 nuevo, 3 en cola para moderación, 4 siendo moderado, 5 rechazado por moderación, 6 necesita confirmación del moderador, 7 archivado, 8 esperando moderación. Estado de venta: 0 no disponible, 1 suministro esperado, 2 llamar, 3 quedándose sin stock, 4 disponible, 5 archivo, 6 estrictamente no disponible, 7 fuera de stock, 8 oculto.
- Nuevo listado:
rozetka_list_goods_categories(encuentra la categoría;is_vendor_required1 significa que un productor es obligatorio) ->rozetka_list_category_attributes(sus características; aumentapageSize, la API devuelve 5 por defecto) ->rozetka_list_attribute_values(valores permitidos para características de tipo lista) ->rozetka_list_producers->rozetka_create_goodscon nombre en ruso y ucraniano, precio, stock y URLs de imágenes. Los nuevos productos pasan por la moderación de Rozetka antes de ser mostrados.
Reseñas, preguntas y chats
- Reseñas de tiendas:
rozetka_list_store_reviews(por ejemplo,reply_search=0para reseñas sin respuesta,vote=dislikepara las negativas), luegorozetka_reply_store_reviewcon elidde la reseña y suorder_id. - Reseñas de productos y preguntas:
rozetka_list_goods_commentsconisAnswered=0lista hilos esperando al vendedor; responde conrozetka_reply_goods_comment(parent_id= id del comentario,item_id=item.id). - Chats:
rozetka_list_chats(msgType=orderspara chats de pedidos,itemspara preguntas sobre productos,has_response_to_user=0para los no respondidos),rozetka_get_chatpara leer los mensajes (esto los marca como leídos),rozetka_get_order_chatpara encontrar el chat de un pedido, yrozetka_send_messageconchat_idy eluser_iddel comprador comoreceiver_id. - Respuestas, contestaciones y mensajes son públicos o llegan al comprador: redacta el texto, muéstraselo al vendedor y envíalo solo después de que ellos estén de acuerdo. Escribe en el idioma del comprador, generalmente ucraniano. Las respuestas y contestaciones de productos son moderadas por Rozetka antes de aparecer.
Devoluciones: rozetka_list_refund_requests (códigos de estado de rozetka_list_refund_statuses), rozetka_get_refund_request para el motivo, la decisión que quiere el comprador y el chat, y rozetka_save_refund_ttn para almacenar la guía de carga de la devolución. rozetka_update_refund_status (aceptar o rechazar una solicitud) está instalado apagado, porque aceptar puede reembolsar al comprador; un administrador lo activa deliberadamente. Los ids de solicitudes de devolución contienen letras (por ejemplo, AM1234567).
No incluido: saldos, facturas, pagos, recibos fiscales (PRRO), creación de guías de carga pagadas con transportistas, cuentas de gerente y eliminaciones. El conector nunca mueve dinero.
Formatos y peculiaridades
- Rozetka responde HTTP 200 incluso cuando una llamada falla, con
success: false; el conector convierte eso en un error que llevaerrors.messageyerrors.code, por ejemplo,incorrect_access_token(1020) oaccess_denied(1010, el rol de la cuenta carece del derecho). - Los precios están en UAH. Las fechas en filtros son YYYY-MM-DD; las marcas de tiempo vienen como
YYYY-MM-DD HH:MM:SSsin zona horaria. - Los textos vienen en el idioma del gabinete (ucraniano o ruso); las solicitudes de devolución responden en ucraniano.
Paginación y límites: las listas se encuentran bajo content con _meta (totalCount, pageCount, currentPage, perPage). Llama de nuevo con page + 1 hasta que currentPage sea igual a pageCount. Los pedidos, reseñas y chats vienen 20 por página; los productos, categorías y directorios aceptan pageSize. No se publica límite de tasa; evita bucles apretados y prefiere una actualización masiva sobre muchas individuales.
Accesibilidad en la nube: api-seller.rozetka.com.ua es público a través de HTTPS, accesible desde AnythingMCP Cloud y desde instalaciones autoalojadas.
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 ChatGPT
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.
ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.
- Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
- Escribe un nombre, por ejemplo Name:
Rozetka Marketplace. - En Connection, introduce como Server URL
https://cloud.anythingmcp.com/mcp/YOUR_SERVER_IDy deja Authentication en OAuth. - Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
- Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.
Herramientas disponibles
| Herramienta | Qué hace |
|---|---|
rozetka_list_orders | Busca los pedidos de Rozetka del vendedor, 20 por página, por grupo de estado, estado, fecha de creación o cambio, id de pedido, teléfono del comprador o guía de carga (TTN).… |
rozetka_get_order | Obtiene un pedido de Rozetka por id con cantidades, estado y comentarios. Usa expand para artículos (compras), entrega, comprador (usuario), historial de estado… |
rozetka_list_order_statuses | Lista los estados de pedido de Rozetka con id, nombre en ucraniano, ruso e inglés y grupo de estado, para leer el estado numérico de un pedido |
rozetka_list_goods | Busca los productos del vendedor en Rozetka (todas las pestañas) por nombre, texto, artículo, id de lista de precios o id de Rozetka, disponibilidad o categoría. Devuelve ids… |
rozetka_get_goods | Obtiene los detalles de uno de los productos del vendedor en Rozetka (precios, categoría, descripción, estado de stock) por el item_id interno o por… |
rozetka_update_order | Cambia el estado de un pedido de Rozetka, agrega el número de guía de carga (TTN) y/o un comentario del vendedor. Devuelve el pedido actualizado. Se requiere un TTN… |
rozetka_get_order_counts | Cuenta los pedidos de Rozetka del vendedor por grupo: inProgress (en proceso), nuevo, entregando, inDone (completado), inNotDone (fallido), no vistos… |
rozetka_get_order_payment_status | Obtiene el estado de pago actual de un pedido pagado en línea: status_payment_id, nombre (pagado, no pagado, cancelado, no aprobado, parcialmente pagado ...)… |
rozetka_update_goods_price_stock | Actualiza el precio y el stock de uno o más productos del vendedor en una sola llamada (actualización masiva). Cada entrada necesita item_rz_id (el id de Rozetka, id en… |
rozetka_get_goods_counts | Cuenta los productos del vendedor por sección del gabinete: activos, inactivos, nuevos, en moderación, esperando confirmación, esperando aprobación… |
rozetka_create_goods | Crea un nuevo listado de producto en el gabinete de Rozetka del vendedor. Necesita nombre en ruso y ucraniano, una categoría de… |
rozetka_list_goods_categories | Busca las categorías de Rozetka en las que el vendedor puede crear productos, por título o ids. Devuelve id, título en ucraniano, ruso e inglés… |
rozetka_list_category_attributes | Lista las características (atributos) de una categoría de Rozetka, necesarias para los parámetros en rozetka_create_goods. Devuelve id, títulos, unidad, tipo… |
rozetka_list_attribute_values | Lista los valores permitidos de una o más características en una categoría (id, título en ucraniano, ruso e inglés), para parámetros de tipo lista en… |
rozetka_list_producers | Busca en el directorio de productores (marcas) de Rozetka por nombre o id, para el productor de rozetka_create_goods. Devuelve id, título y estado, 100… |
rozetka_list_store_reviews | Busca reseñas de los compradores sobre la tienda (no sobre un producto): id, order_id, nombre del comprador, comentario, voto general (me gusta, medio, no me gusta), votos para… |
rozetka_reply_store_review | Publica la respuesta pública del vendedor a una reseña de la tienda. Necesita el id de la reseña y su order_id de rozetka_list_store_reviews. Devuelve la respuesta… |
rozetka_list_goods_comments | Busca reseñas y preguntas de los compradores sobre los productos del vendedor: id, tipo (comentario o pregunta), texto, marca (calificación 1-5), pros y contras, autor… |
rozetka_reply_goods_comment | Publica la respuesta pública del vendedor a una reseña o pregunta de producto. parent_id es el id del comentario y item_id el item.id de… |
rozetka_get_message_counts | Cuenta los chats y solicitudes de compradores no leídos y totales: totalUnread, ordersChatUnread, itemsChatUnread, sellerChatUnread, customerRequestsUnread… |
rozetka_list_chats | Busca los chats del vendedor con los compradores: chats de pedidos, preguntas sobre productos o chats eliminados. Devuelve id de chat, asunto, comprador (user_id, nombre)… |
rozetka_get_chat | Abre un chat con un comprador, con sus mensajes por defecto. Devuelve asunto, user_id del comprador (el receiver_id para rozetka_send_message)… |
rozetka_get_order_chat | Obtiene el chat que pertenece a un pedido, por id de pedido: id de chat, asunto, user_id del comprador y, con expand, los mensajes. Úsalo para escribir al… |
rozetka_send_message | Envía un mensaje a un comprador en un chat existente. Necesita chat_id y receiver_id (el user_id del comprador de rozetka_get_chat o… |
rozetka_list_refund_requests | Busca las solicitudes de devolución y reembolso de los compradores: id de solicitud (letras y dígitos, por ejemplo, AM1234567), status_title, reason_title, order_id, nombre del artículo… |
rozetka_get_refund_request | Obtiene una solicitud de devolución o reembolso: estado, motivo y sub-motivo con el comentario del comprador, decisión deseada (decision_title), pedido y artículo… |
rozetka_list_refund_statuses | Lista los códigos de estado de las solicitudes de devolución y reembolso (status_code con su título en ucraniano), para filtrar rozetka_list_refund_requests y… |
rozetka_save_refund_ttn | Guarda la guía de carga (TTN) del paquete de devolución en una solicitud de devolución, por ejemplo, cuando el vendedor envía un reemplazo o el envío de devolución del comprador… |
rozetka_update_refund_status | Mueve una solicitud de devolución o reembolso a otro estado (aceptar, rechazar con un motivo, bienes recibidos ...). Aceptar una solicitud puede llevar al… |
Ejemplos de indicaciones
- "¿Cuántos nuevos pedidos de Rozetka y mensajes no leídos de compradores tengo?"
- "Muestra el pedido 123456789 con el comprador, la entrega y los artículos."
- "Establece el precio de los productos 987654 a 1,499 UAH y el stock a 20."
- "¿Qué reseñas de tienda de esta semana no tienen respuesta aún? Redacta una respuesta para cada una."
- "Agrega la guía de carga de Nova Poshta 20450000000000 al pedido 123456789 y márcalo como enviado."
Preguntas frecuentes
¿Qué login utiliza? Tu login del gabinete de vendedor de Rozetka (seller.rozetka.com.ua), con la contraseña codificada en Base64. El conector inicia sesión de nuevo cada cuatro horas.
¿Puede cambiar pedidos y precios? Sí: estado del pedido y guía de carga (TTN), actualizaciones masivas de precios y stock, nuevos productos, respuestas a reseñas, preguntas y chats de compradores. Cambiar el estado de una solicitud de devolución está instalado apagado, porque aceptar una devolución puede reembolsar al comprador.
¿Toca saldos o pagos? No. Saldos, facturas, pagos, recibos fiscales (PRRO) y creación de guías de carga pagadas con transportistas no están incluidos.
¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.
Próximos pasos
- Página de inicio del conector
- Conectar a Claude
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
- Conectar a Microsoft Copilot
¿Te ha sido útil esta guía?