> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jelou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Shop Admin

> Recorrido rápido por el panel de administración de Jelou Shop para gestionar tu catálogo.

La nueva UI de Jelou Shop unifica productos, categorías, sucursales, promociones, pedidos, actividad y configuración en un solo panel, con vista previa en vivo del webview que ven tus clientes.

## Acceso

Ingresa al [panel de Shop Admin](https://apps.jelou.ai/shop-v2/products).

## Productos

Abre en [Productos](https://apps.jelou.ai/shop-v2/products).

Lista del catálogo con buscador y filtros por **sucursal**, **estado** y **stock**. Crea productos con el botón **+ Nuevo producto**.

<Frame caption="Listado de productos con filtros por sucursal, estado y stock.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/productos.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=187652576afc2beb03f0886c217cca4b" alt="Lista de productos en Shop Admin con filtros y buscador" width="1536" height="774" data-path="assets/images/integraciones/e-commerce/shop-admin/productos.png" />
</Frame>

Al abrir un producto verás el formulario en bloques colapsables y, a la derecha, una **vista previa en vivo** que refleja tus cambios:

<Frame caption="Detalle de producto con vista previa en vivo del webview.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/producto-detalle.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=e740f9646d07abb2fc3bcb814a948d5e" alt="Detalle de producto con vista previa en vivo" width="1536" height="826" data-path="assets/images/integraciones/e-commerce/shop-admin/producto-detalle.png" />
</Frame>

| Bloque                           | Para qué sirve                                                           |
| -------------------------------- | ------------------------------------------------------------------------ |
| **Detalles del producto**        | SKU, nombre, descripción, precio, imágenes, categorías.                  |
| **Impuestos y descuentos**       | Impuestos por producto y descuentos (porcentaje o monto).                |
| **Inventario y Sucursal**        | Stock (limitado o ilimitado) y sucursal.                                 |
| **Personalización** *(avanzado)* | Variaciones, características, nota al cliente y grupos de modificadores. |

<Frame caption="Bloque de Personalización con variaciones, características y modificadores.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/producto-secciones.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=325eecefa30e15e524905c7927fec454" alt="Secciones avanzadas: inventario y personalización con variaciones, características y modificadores" width="1536" height="826" data-path="assets/images/integraciones/e-commerce/shop-admin/producto-secciones.png" />
</Frame>

## Categorías

Abre en [Categorías](https://apps.jelou.ai/shop-v2/categories).

Organiza el catálogo en un **árbol jerárquico** con subcategorías. Las categorías se crean automáticamente al asignarlas a un producto, o manualmente con **+ Nueva categoría**.

<Frame caption="Árbol jerárquico con subcategorías y conteo de productos por nodo.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/categorias.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=4c3c99841709cf297733d7af3ddf2442" alt="Árbol jerárquico de categorías con subcategorías y conteo de productos" width="1536" height="826" data-path="assets/images/integraciones/e-commerce/shop-admin/categorias.png" />
</Frame>

## Sucursales

Abre en [Sucursales](https://apps.jelou.ai/shop-v2/branches).

Administra los puntos de venta donde se vende cada producto. Cada sucursal tiene **código**, **nombre**, **dirección**, **teléfono** y **estado**.

<Frame caption="Listado de sucursales con código, nombre, dirección y estado.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/sucursales.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=8e579ca9e2b79332dee8cdd243d17b37" alt="Lista de sucursales con código, nombre, dirección y estado" width="1536" height="826" data-path="assets/images/integraciones/e-commerce/shop-admin/sucursales.png" />
</Frame>

## Promociones

Abre en [Promociones](https://apps.jelou.ai/shop-v2/promotions).

Crea y gestiona **cupones de descuento** para tu tienda. Usa el buscador (por código o nombre) y los filtros por **estado** y **tipo**. Crea cupones con el botón **+ Nuevo cupón**.

<Frame caption="Listado de cupones con código, descuento, vigencia, sucursal, usos y estado.">
  <img src="https://mintcdn.com/jelouai/zRIfvmE-Kt_s3y2c/assets/images/integraciones/e-commerce/shop-admin/promociones.png?fit=max&auto=format&n=zRIfvmE-Kt_s3y2c&q=85&s=82824f00a447bfc7ac6c23e94bc0f99e" alt="Listado de promociones en Shop Admin con cupones, descuentos, vigencia y estado" width="1592" height="722" data-path="assets/images/integraciones/e-commerce/shop-admin/promociones.png" />
</Frame>

Cada cupón se define con:

| Campo         | Para qué sirve                                                             |
| ------------- | -------------------------------------------------------------------------- |
| **Código**    | Lo que el cliente ingresa en el checkout para aplicar el descuento.        |
| **Nombre**    | Nombre interno para identificar el cupón.                                  |
| **Descuento** | Porcentaje (%) o monto fijo.                                               |
| **Vigencia**  | Rango opcional de fecha de inicio y fin. Sin vigencia, el cupón no expira. |
| **Sucursal**  | **Todas** o una o varias sucursales específicas.                           |
| **Usos**      | Límite total de canjes y opción de un uso por cliente.                     |

El **estado** de cada cupón se calcula automáticamente:

| Estado         | Significado                         |
| -------------- | ----------------------------------- |
| **Activo**     | Vigente y aplicable en el checkout. |
| **Programado** | Su fecha de inicio aún no llega.    |
| **Caducado**   | Su fecha de fin ya pasó.            |
| **Agotado**    | Alcanzó su límite de usos.          |
| **Inactivo**   | Desactivado manualmente.            |

El descuento se valida y aplica en el checkout del [webview](/guides/integraciones/e-commerce/webview). Un cupón inválido, expirado o fuera de sucursal se rechaza con un mensaje claro.

<Tip>
  También puedes crear y gestionar cupones por API. Consulta [API → Promociones](/guides/integraciones/e-commerce/api-cupones/crear).
</Tip>

## Pedidos

Abre en [Pedidos](https://apps.jelou.ai/shop-v2/orders).

Consulta el listado de **carritos de tus clientes** con su estado y actividad reciente. Usa el buscador (por ID, referencia o cliente), el filtro por **estado** y el rango de fechas. Cada fila abre su detalle con **Ver detalle**.

<Frame caption="Listado de pedidos con ID del carrito, referencia, ítems, estado y fechas.">
  <img src="https://mintcdn.com/jelouai/zRIfvmE-Kt_s3y2c/assets/images/integraciones/e-commerce/shop-admin/pedidos.png?fit=max&auto=format&n=zRIfvmE-Kt_s3y2c&q=85&s=8113a59e013f3254f3f2d848641f2b9b" alt="Listado de pedidos en Shop Admin con ID del carrito, referencia, ítems, estado y fechas" width="1592" height="730" data-path="assets/images/integraciones/e-commerce/shop-admin/pedidos.png" />
</Frame>

| Columna              | Descripción                                                                                            |
| -------------------- | ------------------------------------------------------------------------------------------------------ |
| **ID del carrito**   | Identificador interno del carrito.                                                                     |
| **Referencia**       | Referencia del pedido o del cliente.                                                                   |
| **Ítems**            | Cantidad de productos en el carrito.                                                                   |
| **Estado**           | **Activo** (en curso), **Completado** (checkout finalizado) o **Abandonado** (sin actividad reciente). |
| **Última actividad** | Fecha y hora del último cambio en el carrito.                                                          |
| **Creado**           | Fecha y hora de creación del carrito.                                                                  |

## Actividad

Abre en [Actividad](https://apps.jelou.ai/shop-v2/activity).

Consulta el **historial completo de cambios** en la tienda. Filtra por **entidad**, **acción**, **origen** y rango de fechas, o busca por autor, SKU, nombre o ID. Puedes **descargar** el historial.

<Frame caption="Historial de actividad con fecha, acción, entidad, autor, origen y campos modificados.">
  <img src="https://mintcdn.com/jelouai/zRIfvmE-Kt_s3y2c/assets/images/integraciones/e-commerce/shop-admin/actividad.png?fit=max&auto=format&n=zRIfvmE-Kt_s3y2c&q=85&s=5f3c1105ae1857702cf1a8f4a4914b86" alt="Historial de actividad en Shop Admin con acción, entidad, autor, origen y cambios" width="1593" height="723" data-path="assets/images/integraciones/e-commerce/shop-admin/actividad.png" />
</Frame>

| Columna        | Descripción                                                            |
| -------------- | ---------------------------------------------------------------------- |
| **Fecha**      | Cuándo ocurrió el cambio.                                              |
| **Acción**     | Tipo de cambio: **Creado**, **Actualizado** o **Eliminado**.           |
| **Entidad**    | Qué se modificó: Producto, Cupón, Categoría, Sucursal o Configuración. |
| **Referencia** | Identificador de la entidad afectada (SKU, código, nombre).            |
| **Autor**      | Quién realizó el cambio.                                               |
| **Origen**     | Desde dónde se hizo: **UI** (panel) o **API**.                         |
| **Cambios**    | Campos modificados en esa acción.                                      |

## Configuración

Abre en [Configuración](https://apps.jelou.ai/shop-v2/settings).

Información de la tienda, integraciones conectadas y preferencias globales.

<Frame caption="Pantalla de configuración con credenciales, integraciones y preferencias.">
  <img src="https://mintcdn.com/jelouai/AwNXLMm37RoVy7Oj/assets/images/integraciones/e-commerce/shop-admin/configuracion.png?fit=max&auto=format&n=AwNXLMm37RoVy7Oj&q=85&s=1a26c25b1263ba2325f80ebb233e50c7" alt="Pantalla de configuración con información, integraciones, moneda e impuestos" width="1536" height="908" data-path="assets/images/integraciones/e-commerce/shop-admin/configuracion.png" />
</Frame>

| Sección           | Qué configurar                                                                                                                                                   |
| ----------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Información**   | Nombre de la tienda y **Shop ID** (`app_id`). Para autenticar tus peticiones al gateway, genera una clave API en [Claves API](/guides/configuracion/claves-api). |
| **Integraciones** | Estado de los conectores (Shopify, WooCommerce, Facebook Catalog) y acceso al marketplace.                                                                       |
| **Moneda**        | Código ISO 4217 con el que se muestran los precios.                                                                                                              |
| **Idioma**        | Idioma en el que la tienda muestra textos y comunicaciones a tus clientes (`es`, `en`, `pt`).                                                                    |
| **Impuestos**     | Tasa global y opción de **impuesto por producto** para tasas individuales.                                                                                       |
| **Inventario**    | Excluir productos sin stock de listados y búsquedas.                                                                                                             |
