El Portal de Comercios (seller.yummy-marketplace.com) es donde administras tu tienda dentro de Yummy Marketplace: tus datos, tus sucursales, tu catálogo, tus pedidos y tus pagos. Cada parte de este manual tiene un video corto que muestra el paso en pantalla.
Antes de empezar
Este manual tiene un objetivo principal: dejar tu tienda lista y publicar tus primeros productos. Hay dos caminos para lograrlo:
- Carga masiva: subes un archivo con todo tu catálogo de una vez. Es el camino que usa la gran mayoría de los comercios.
- Carga manual: creas un producto a la vez desde un formulario. Útil para pruebas o un producto suelto.
Piénsalo así: cargar producto por producto es como surtir un local caja por caja desde el depósito. La carga masiva es como recibir un camión que ya trae todo organizado en un solo viaje: llegas al mismo resultado con muchísimo menos esfuerzo.
¿Y la integración por API? Es para comercios con equipo técnico propio que conectan su ERP, POS o CRM directamente con Yummy. La mayoría no la necesita; este manual cubre el camino estándar por el Portal. Si te interesa, revisa la documentación de la API.
Al final encontrarás cómo usar el resto del Portal en el día a día: pedidos, pagos, chat, roles y ayuda.
Iniciar sesión
Primer ingreso: contraseña, perfil de la tienda y primera sucursal.
La primera vez:
- Yummy crea tu comercio y te envía una contraseña temporal por correo.
- Entra a
seller.yummy-marketplace.comcon tu correo y esa contraseña. - Confirma tu identidad con el código (OTP) que llega a tu correo.
- Crea tu contraseña definitiva.
- El Portal te pide completar el perfil de la tienda y crear tu primera sucursal (lo ves en la siguiente sección).
Las siguientes veces: entra con tu correo y tu contraseña y haz clic en Iniciar Sesión. Si la olvidaste, usa el enlace ¿Olvidaste tu contraseña? debajo del formulario.
Configura tu tienda
Paso obligatorio antes de vender: sin esto no podrás publicar productos correctamente.
Perfil y Configuración: datos de la tienda, suscripción, sucursales y stock.
Datos generales de tu tienda
En el menú lateral, entra a Configuración → General y completa:
- Nombre comercial y RIF
- Cuenta bancaria, donde recibirás tus pagos
- Estado, ciudad y dirección
- Logo de la tienda (PNG, JPG o SVG, máx. 2 MB)
- Redes sociales (opcional)
Guarda con el botón Guardar Cambios al final del formulario.
En la misma sección tienes otras tres pestañas:
- Suscripción: tu plan, el período y la fecha de vencimiento.
- Sucursales: tus tiendas físicas, horarios y envíos.
- Stock: defines el stock crítico y el saludable de tus productos, y puedes activar alertas por correo para enterarte cuando algo esté por agotarse.
En Perfil ves tus datos personales y puedes cambiar tu contraseña.
Configura tus sucursales
Ve a Configuración → Sucursales y haz clic en Añadir sucursal. Completa:
- Nombre de la sucursal.
- Dirección, con el mapa: puedes arrastrar el pin hasta el punto exacto.
- Teléfono de contacto y WhatsApp, donde te llegan las notificaciones.
- ID externo (opcional, para tus propios sistemas).
- Despacho a Yummer: cuándo llamamos al repartidor, por tiempo estimado de preparación o con un botón manual cuando el pedido esté listo.
- Métodos de envío: envío con Yummy, retiro en agencia MRW o retiro en tienda.
Haz clic en Guardar. El video de Iniciar sesión muestra este paso completo.
Piénsalo así: la sucursal es la dirección física de la que sale tu mercancía, y los métodos de envío son "por qué puerta" puede salir cada pedido. Si tienes una sola sucursal, este paso es rápido, pero igual de obligatorio.
Si tu tienda tiene más de una sucursal, en la carga de productos tendrás que indicar en cuál está el stock de cada producto (columna branch_id en la carga masiva).
Tu catálogo de productos
Productos: tu catálogo, filtros y detalle de cada producto.
En Productos ves todo tu catálogo con precio, stock, estado y si tiene envío gratis.
- Filtra por estado: Todos, Publicado, Archivado o Por publicar.
- En el menú de tres puntos de cada producto puedes archivarlo, activar Cashea o eliminarlo.
- El ícono del ojo abre el detalle: fotos, estado, precio y stock. Desde ahí ves sus órdenes y sus preguntas, o entras a Editar producto.
- En el detalle, en Especificaciones, puedes cambiar la categoría con Editar: búscala o navega hasta la correcta y dale a Guardar cambios. Sirve para corregir las que la IA no asignó bien (ver video).
Dos formas de cargar productos
| Carga masiva (recomendada) | Carga manual | |
|---|---|---|
| Ideal para | Catálogos completos | Un producto puntual o una prueba |
| Cómo | Un archivo CSV con todos tus productos y variantes | Formulario producto por producto |
| Categorías | Asignadas automáticamente por IA (las puedes corregir después) | Las eliges tú |
| Publicación | Todo el lote en un solo paso | Producto por producto |
En ambos casos empiezas en el mismo lugar: Productos → Añadir Producto, donde eliges la pestaña Carga Masiva o Producto Individual.
Carga masiva (recomendada)
Carga masiva: plantilla CSV, ZIP de fotos e historial de cargas.
1. Descarga la plantilla
En Añadir Productos → Carga Masiva, haz clic en Descargar Plantilla CSV. El archivo ya trae los encabezados correctos y una fila de ejemplo: ábrelo en Excel o Google Sheets y reemplaza el ejemplo por tus datos.
Si prefieres no llenar el archivo, también puedes usar Extraer catálogo automáticamente con el cargador de Yummy.
2. Entiende las columnas
Piénsalo así: el CSV es como la ficha técnica de cada producto en tu góndola. Cada columna es un dato que el sistema necesita para mostrarlo bien en la app.
| Columna | ¿Obligatoria? | Qué va aquí |
|---|---|---|
post_id |
Opcional | Identificador propio para agrupar las filas de un mismo producto con variantes. |
name |
Sí | Nombre del producto. |
price |
Sí | Precio base del producto. |
condition |
Opcional | Los comercios solo venden productos nuevos: usa new o déjala vacía. |
description |
Opcional | Descripción visible en la ficha del producto. |
main_image |
Opcional | Nombre de archivo (si adjuntas un ZIP de imágenes) o URL pública de la imagen. |
category_id |
Opcional | Puedes dejarla vacía: un agente de IA asigna categoría y subcategoría después de procesar el archivo. |
branch_id |
Opcional* | Obligatoria solo si tienes más de una sucursal activa. Con una sola, se asigna sola. |
stock |
Opcional | Cantidad disponible de ese producto o variante. |
variant_sku |
Opcional | Identificador de la variante (ej. talla + color). |
variant_price |
Opcional | Precio de esa variante, si es distinto al precio base. |
attr_color, attr_talla, etc. |
Opcional | Un atributo por columna para diferenciar cada variante. |
weight_kg |
Opcional | Peso del producto en kilogramos. |
width_cm, height_cm, length_cm |
Opcional | Medidas del empaque, en centímetros. |
3. Productos con variantes: una fila por variante
Si un producto tiene variantes (colores, tallas), repite el mismo post_id en varias filas, una por cada combinación:
| post_id | name | price | variant_sku | attr_color | attr_talla | stock |
|---|---|---|---|---|---|---|
PROD-002 |
Producto con variantes | 45.00 | VAR-001-A |
Rojo | M | 10 |
PROD-002 |
Producto con variantes | 45.00 | VAR-001-B |
Azul | M | 8 |
PROD-002 |
Producto con variantes | 45.00 | VAR-001-C |
Rojo | L | 5 |
Los datos generales (nombre, descripción, peso) solo hacen falta en la primera fila del grupo. El resto de las filas solo necesita lo que cambia en cada variante: SKU, atributos, precio y stock.
4. Imágenes: por archivo o por URL
- Si usas nombres de archivo en
main_image, adjunta también un ZIP con las imágenes. Los nombres deben coincidir exactamente. - Si usas URLs públicas, no necesitas ZIP.
- Formatos válidos: JPG, PNG, GIF o WEBP, máx. 10 MB por imagen.
- El ZIP es opcional: hasta 50 MB, máx. 1.500 imágenes y 150 MB descomprimido.
5. Sube y procesa el archivo
- En Productos → Añadir Producto → Carga Masiva, arrastra tu CSV (obligatorio) y tu ZIP de imágenes (opcional).
- Haz clic en Procesar CSV y ZIP. El sistema los procesa en segundo plano.
6. Revisa el resultado
Al terminar verás una confirmación. Importante: los productos nuevos quedan inactivos, no visibles en la app, mientras un agente de IA les asigna categoría y subcategoría y tú los revisas.
Haz clic en Ir a publicar para pasar directo al historial de esa carga.
7. Revisa el lote en el Historial de Cargas Masivas
Ahí ves el detalle completo: cuántos productos se procesaron, cuántos salieron bien, cuántos fallaron o se omitieron, y la lista de productos por publicar.
8. Publica todo el lote
- Revisa la lista. Puedes ver el detalle de cada producto con el ícono del ojo, o eliminar alguno con el ícono de basura si algo salió mal.
- Haz clic en Publicar todos.
- Confirma en la ventana: verás cuántos productos se harán visibles en la app de inmediato.
Tus productos aparecen en el catálogo con la categoría asignada, su stock y el estado Publicado.
Si alguna categoría no quedó bien, corrígela desde el detalle del producto: Especificaciones → Editar.
Carga manual de un producto
Añadir un producto, paso a paso.
1. Información básica, envío y precio
En Productos → Añadir Producto → Producto Individual, completa:
- Título, condición, descripción y marca.
- Peso (kg) y medidas del paquete (largo, ancho y alto en cm): son obligatorios.
- Precio: también obligatorio.
- Envío gratis (opcional): se puede activar si el precio está entre $15 y $2.000.
- Fotos: JPG, PNG, GIF o WEBP de hasta 5 MB cada una.
2. Activa variantes (si tu producto las tiene)
- Activa el interruptor Producto con variantes.
- Haz clic en Nuevo atributo y define un nombre (ej. "Color") y sus valores (ej. "Rojo", "Azul"), presionando Enter después de cada valor.
- Haz clic en Regenerar variantes: el sistema arma una fila por cada combinación.
- Completa el precio de cada variante. El SKU se genera solo.
Piénsalo así: el atributo es el tipo de diferencia (color, talla) y cada valor es una opción dentro de ese tipo. El sistema hace las combinaciones por ti.
3. Carga el stock y crea el producto
En Variantes y Stock, agrega stock en al menos una sucursal y haz clic en Crear Producto. Igual que en la carga masiva, el producto queda pendiente de publicación: todavía no se ve en la app.
Para ajustar el stock después:
- Abre el producto con el ícono del ojo desde el listado.
- En Variantes, haz clic en el ícono de caja de la variante que quieras abastecer.
- En Ajustar stock, elige la sucursal, el tipo de ajuste (Agregar, Quitar o Establecer) y la cantidad.
- Haz clic en Guardar ajuste. Repite por cada variante y sucursal con inventario.
4. Publica el producto
En el listado de productos, filtra por Por publicar, selecciona el producto y publícalo para que sea visible en la app.
El día a día en el Portal
Con tu catálogo publicado, estas son las secciones que vas a usar todos los días.
Panel: el resumen de tu tienda
Al iniciar sesión llegas al Panel. Arriba ves tus ventas totales, pedidos totales y pedido promedio. El gráfico muestra tus ventas y puedes cambiar el período en el selector "Últimos 30 días". Más abajo aparece tu último pedido, con el cliente, el monto, la fecha y el tipo de envío.
Pedidos
En Pedidos gestionas las compras de tus clientes. Filtra por fechas o por tipo de envío, y descarga todo con Exportar. El ícono del ojo abre el detalle de cada pedido: cliente, montos, productos y estado del envío.
Pagos
En Pagos consultas tus liquidaciones y su estatus. Cada liquidación muestra el monto en bolívares y en dólares y la tasa de cambio. Más abajo ves el estado del desembolso a tu cuenta.
Chat y Preguntas
- En Chat conversas con tus clientes: elige una conversación de la lista para leer y responder.
- En Preguntas respondes las dudas públicas de tus publicaciones. Usa las pestañas Pendientes, Respondidas y Todas para no dejar ninguna sin contestar.
Roles: suma a tu equipo
En Roles sumas a tu equipo con Agregar Administrador. También puedes crear roles y elegir, sección por sección, qué puede Visualizar o Gestionar cada persona.
Sucursales y ayuda
- Arriba, el selector de sucursales filtra toda la información del Portal por tienda.
- Tutorial, en el menú lateral, abre el manual completo.
- El botón Soporte, arriba a la derecha, te conecta con el equipo de Yummy.
Preguntas frecuentes
¿Por qué mi producto no aparece en la app si ya lo creé? Porque todo producto nuevo, por carga manual o masiva, queda pendiente de publicación hasta que lo revises y lo publiques. Es una protección para que nada salga a la vista sin que lo confirmes.
¿Tengo que saber el ID de categoría antes de subir mi CSV?
No. Puedes dejar category_id vacía: un agente de IA asigna categoría y subcategoría después de la carga.
¿Puedo cambiar la categoría que asignó la IA? Sí. Abre el producto con el ícono del ojo y, en Especificaciones, haz clic en Editar junto a Categoría. Búscala o navega hasta la correcta y dale a Guardar cambios.
¿Debo llenar la columna condition?
Es opcional. Como los comercios solo venden productos nuevos, puedes dejarla vacía o usar new.
Solo tengo una sucursal, ¿debo llenar branch_id?
No. Con una sola sucursal activa, el stock se le asigna automáticamente. La columna solo es obligatoria si tienes más de una.
¿Cuándo conviene la carga manual en vez de la masiva? Para probar el flujo con un solo producto, corregir un caso puntual o si tu catálogo es muy pequeño. Para todo lo demás, la carga masiva ahorra muchísimo tiempo.
Checklist final
- Inicié sesión en el Portal de Comercios
- Completé los datos generales de mi tienda en Configuración
- Agregué al menos una sucursal con su método de envío
- Descargué y llené la plantilla CSV de carga masiva
- Subí mi CSV (y el ZIP de imágenes, si aplica) y lo procesé
- Revisé el Historial de Cargas Masivas
- Publiqué mi primer lote de productos
- Confirmé que mis productos se ven en la app
¡Listo! Tu tienda ya está vendiendo. Si algo no coincide con lo que ves en pantalla, escríbele a tu contacto en Yummy o usa el botón Soporte dentro del Portal.