Resumen
API de vendedor de Rozetka Marketplace para el mayor mercado de Ucrania: pedidos con actualizaciones de estado y guía de remisión (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 acceso del gabinete de vendedor.
Configuración guiada
Conecta Rozetka Marketplace a Claude, ChatGPT o Copilot 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 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 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.
💡 ¿No tienes 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
API de vendedor de Rozetka Marketplace para el mayor mercado de Ucrania: pedidos con actualizaciones de estado y guía de remisión (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 acceso del gabinete de vendedor.
Configuración
La API inicia sesión con el nombre de usuario y la contraseña del gabinete de vendedor de Rozetka (seller.rozetka.com.ua); no hay una clave API separada.
- Coloca el nombre de usuario 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 propia computadora, 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 nuevamente cada cuatro horas. Un nombre de usuario o contraseña incorrectos se informan comoincorrect_username_password.
Por dónde empezar: rozetka_get_order_counts y rozetka_get_message_counts muestran lo que está pendiente (nuevos pedidos, chats no leídos, solicitudes de devolución abiertas). Luego rozetka_list_orders con types=4 (nuevos) o types=2 (en procesamiento).
Pedidos
rozetka_list_order_statusesmapea elstatusnumérico de un pedido a su nombre.rozetka_list_ordersfiltra portypes(1 todos, 2 en procesamiento, 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 remisión (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 que se agrega un TTN, Rozetka rastrea el paquete y mueve 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 el 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, en revisión o cancelado (almacenado en caché durante 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 que se ha incrementado más de 1.5 veces o reducido a 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 agotándose, 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 las 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 desea el comprador y el chat, y rozetka_save_refund_ttn para almacenar la guía de remisión 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 remisión pagadas con transportistas, cuentas de gerentes y eliminaciones. El conector nunca mueve dinero.
Formatos y peculiaridades
- Rozetka responde con 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 los 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 nuevamente 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 ajustados 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 autohospedadas.
Requisitos previos: ROZETKA_USERNAME, ROZETKA_PASSWORD_BASE64
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 Rozetka Marketplace y pega las variables de entorno que se enumeran en Requisitos previos.
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 remisión (TTN).… |
rozetka_get_order | Obtiene un pedido de Rozetka por id con montos, estado y comentarios. Usa expand para artículos (compras), entrega, comprador (usuario), historial de estado… |
rozetka_list_order_statuses | Lista los estados de pedidos 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 remisión (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 procesamiento), nuevos, entregando, inDone (completados), inNotDone (fallidos), 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 las reseñas de los compradores de la tienda (no de 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 las 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 submotivo 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 remisión (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 solicitudes
- "¿Cuántos nuevos pedidos de Rozetka y mensajes de compradores no leídos 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 remisión de Nova Poshta 20450000000000 al pedido 123456789 y márcalo como enviado."
Próximos pasos
¿Te ha sido útil esta guía?