> ## 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

> Administra Jelou Shop desde el CLI: catálogo, sucursales, categorías, cupones, pedidos, importaciones, sincronización de catálogos externos y métricas.

`jelou shop` administra la tienda de tu empresa: catálogo, pedidos, cupones y la
configuración de la app.

## Empezar

```bash theme={null}
jelou shop info        # muestra la app Shop actual
jelou shop activate    # habilita Shop para la empresa activa
jelou shop settings    # actualiza la configuración de la app
jelou shop usage       # uso del plan y totales del catálogo
```

<Tip>
  `jelou shop usage` es la forma rápida de ver cuántos productos tienes contra el
  límite de tu plan antes de una importación grande.
</Tip>

## Productos

| Subcomando                    | Descripción                                                                                 |
| ----------------------------- | ------------------------------------------------------------------------------------------- |
| `products list`               | Lista y busca productos del catálogo                                                        |
| `products search`             | Búsqueda de descubrimiento (la que usa el storefront)                                       |
| `products show <id>`          | Detalle de un producto                                                                      |
| `products upsert`             | Crea o actualiza según exista                                                               |
| `products update`             | Aplica un parche masivo por id (`--file`) o a un solo producto (`--id --status\|--patch`)   |
| `products status`             | Cambia el estado de varios productos a la vez (`--ids p1,p2 --status true\|false`)          |
| `products delete`             | Elimina varios productos a la vez (`--ids p1,p2`), con confirmación (`--yes` para omitirla) |
| `products bulk`               | Operaciones masivas                                                                         |
| `products images add\|delete` | Gestiona las imágenes del producto (por SKU)                                                |

```bash theme={null}
jelou shop products list --json
jelou shop products search "camiseta negra"
jelou shop products images add SKU-123 --file product.jpg --json

# Actualizar productos
jelou shop products update --file product-patch.json       # parche masivo por id
jelou shop products update --id prod_123 --status false    # un solo producto

# Cambiar estado o eliminar en bloque
jelou shop products status --ids p1,p2 --status false
jelou shop products delete --ids p1,p2 --yes
```

<Note>
  `products list` y `products search` no son lo mismo: `list` recorre tu catálogo
  como administrador, `search` usa el motor de descubrimiento del storefront, que
  es el que ve el cliente final.
</Note>

## Sucursales y categorías

```bash theme={null}
jelou shop branches list
jelou shop branches show <id>
jelou shop branches create --name "Sucursal Norte"
jelou shop branches update <id> --name "Sucursal Centro"
jelou shop branches delete <id>

jelou shop categories list
jelou shop categories create --name "Zapatos"
jelou shop categories update <id> --name "Calzado"
jelou shop categories delete <id>
```

## Cupones

| Subcomando            | Descripción                             |
| --------------------- | --------------------------------------- |
| `coupons list`        | Lista los cupones                       |
| `coupons show <code>` | Detalle del cupón, por código           |
| `coupons create`      | Crea un cupón                           |
| `coupons update <id>` | Actualiza un cupón                      |
| `coupons delete <id>` | Elimina un cupón                        |
| `coupons uses <code>` | Historial de usos del cupón, por código |

```bash theme={null}
jelou shop coupons list --json
jelou shop coupons show WELCOME10 --json
jelou shop coupons uses WELCOME10 --json
```

## Pedidos

```bash theme={null}
jelou shop orders list
jelou shop orders show ord_01h2xcejq
```

## Importaciones

Carga masiva de productos desde un archivo XLSX:

```bash theme={null}
jelou shop imports template                                          # descarga la plantilla XLSX
jelou shop imports upload --file productos.xlsx --uploaded-by alex --json
jelou shop imports show imp_01h2xcejq --json                         # estado de una importación
```

<Warning>
  Revisa `jelou shop usage` antes de una importación grande: si el archivo excede
  el límite de productos de tu plan, la carga falla a medio camino.
</Warning>

## Catálogos externos

Cuando conectas un catálogo externo (por ejemplo Shopify desde el
[marketplace](/guides/cli/marketplace)), estos comandos muestran las cuentas
conectadas y el historial de sincronización:

```bash theme={null}
jelou shop accounts              # cuentas de catálogo conectadas
jelou shop syncs <accountId>     # corridas de sincronización de esa cuenta
```

Úsalos para responder "¿por qué este producto no aparece en la tienda?": revisa
si la última sincronización de la cuenta corrió y con qué resultado.

## Actividad

```bash theme={null}
jelou shop activity list --json
```

Lista el registro de actividad de la tienda, agrupado por entidad (`app`,
`product`, `product_variation`, `branch`, `category`, `coupon`). Útil para
auditar qué cambió y cuándo.

## Métricas

```bash theme={null}
jelou shop metrics overview     # resumen compuesto: ventas, búsquedas, catálogo y clientes
jelou shop metrics sales        # ventas sobre carritos completados, AOV, conversión
jelou shop metrics search       # búsquedas totales, tasa de resultados vacíos, consultas más frecuentes
jelou shop metrics catalog      # foto del inventario: productos activos, sin stock, variaciones
jelou shop metrics customers    # clientes nuevos vs. recurrentes, top compradores
```

Analítica de la tienda a nivel de empresa: ventas, búsquedas, catálogo y
clientes.