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

> Administre o Jelou Shop pelo CLI: catálogo, filiais, categorias, cupons, pedidos, importações, sincronização de catálogos externos e métricas.

`jelou shop` administra a loja da sua empresa: catálogo, pedidos, cupons e a
configuração do app.

## Começar

```bash theme={null}
jelou shop info        # mostra o app Shop atual
jelou shop activate    # habilita o Shop para a empresa ativa
jelou shop settings    # atualiza a configuração do app
jelou shop usage       # uso do plano e totais do catálogo
```

<Tip>
  `jelou shop usage` é a forma rápida de ver quantos produtos você tem contra o
  limite do seu plano antes de uma importação grande.
</Tip>

## Produtos

| Subcomando                    | Descrição                                                                                    |
| ----------------------------- | -------------------------------------------------------------------------------------------- |
| `products list`               | Lista e busca produtos do catálogo                                                           |
| `products search`             | Busca de descoberta (a que o storefront usa)                                                 |
| `products show <id>`          | Detalhes de um produto                                                                       |
| `products upsert`             | Cria ou atualiza conforme exista                                                             |
| `products update`             | Aplica um patch em massa por id (`--file`) ou em um único produto (`--id --status\|--patch`) |
| `products status`             | Muda o status de vários produtos de uma vez (`--ids p1,p2 --status true\|false`)             |
| `products delete`             | Exclui vários produtos de uma vez (`--ids p1,p2`), com confirmação (`--yes` para pular)      |
| `products bulk`               | Operações em massa                                                                           |
| `products images add\|delete` | Gerencia as imagens do produto (por SKU)                                                     |

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

# Atualizar produtos
jelou shop products update --file product-patch.json       # patch em massa por id
jelou shop products update --id prod_123 --status false    # um único produto

# Mudar status ou excluir em massa
jelou shop products status --ids p1,p2 --status false
jelou shop products delete --ids p1,p2 --yes
```

<Note>
  `products list` e `products search` não são a mesma coisa: `list` percorre seu
  catálogo como administrador, `search` usa o motor de descoberta do storefront —
  o que o cliente final realmente vê.
</Note>

## Filiais e categorias

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

jelou shop categories list
jelou shop categories create --name "Sapatos"
jelou shop categories update <id> --name "Calçados"
jelou shop categories delete <id>
```

## Cupons

| Subcomando            | Descrição                               |
| --------------------- | --------------------------------------- |
| `coupons list`        | Lista os cupons                         |
| `coupons show <code>` | Detalhes do cupom, pelo código          |
| `coupons create`      | Cria um cupom                           |
| `coupons update <id>` | Atualiza um cupom                       |
| `coupons delete <id>` | Exclui um cupom                         |
| `coupons uses <code>` | Histórico de usos do cupom, pelo 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
```

## Importações

Carga em massa de produtos a partir de um arquivo XLSX:

```bash theme={null}
jelou shop imports template                                          # baixa o modelo XLSX
jelou shop imports upload --file produtos.xlsx --uploaded-by alex --json
jelou shop imports show imp_01h2xcejq --json                         # status de uma importação
```

<Warning>
  Revise `jelou shop usage` antes de uma importação grande: se o arquivo exceder o
  limite de produtos do seu plano, a carga falha no meio do caminho.
</Warning>

## Catálogos externos

Quando você conecta um catálogo externo (por exemplo Shopify pelo
[marketplace](/pt/guias/cli/marketplace)), estes comandos mostram as contas
conectadas e o histórico de sincronização:

```bash theme={null}
jelou shop accounts              # contas de catálogo conectadas
jelou shop syncs <accountId>     # execuções de sincronização dessa conta
```

Use-os para responder "por que este produto não aparece na loja?": veja se a
última sincronização da conta rodou e com qual resultado.

## Atividade

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

Lista o registro de atividade da loja, agrupado por entidade (`app`,
`product`, `product_variation`, `branch`, `category`, `coupon`). Útil para
auditar o que mudou e quando.

## Métricas

```bash theme={null}
jelou shop metrics overview     # resumo composto: vendas, buscas, catálogo e clientes
jelou shop metrics sales        # vendas sobre carrinhos concluídos, ticket médio, conversão
jelou shop metrics search       # buscas totais, taxa de resultados vazios, consultas mais frequentes
jelou shop metrics catalog      # retrato do estoque: produtos ativos, sem estoque, variações
jelou shop metrics customers    # clientes novos vs. recorrentes, principais compradores
```

Analytics da loja no escopo da empresa: vendas, buscas, catálogo e clientes.