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

# Primeiros passos

> Gerencie sua loja, filiais e produtos no Jelou Shop via API REST.

Com a API do Jelou Shop você pode gerenciar filiais e criar ou atualizar produtos programaticamente, caso não use um e-commerce externo como fonte de dados.

## Autenticação

Para consumir os endpoints você precisa de:

| Credencial   | Descrição                                                           |
| ------------ | ------------------------------------------------------------------- |
| `app_id`     | O ID da sua loja no Jelou Shop                                      |
| Chave de API | Chave de API para autenticar as requisições ao gateway de ecommerce |

<Note>
  Encontre o `app_id` (Shop ID) em [Shop Admin → Configuração](/pt/guias/integracoes/e-commerce/shop-admin#configuração) ou diretamente em [Configuração](https://apps.jelou.ai/shop-v2/settings).

  Gere e administre sua chave de API no módulo de [Chaves de API](/pt/guias/configuracao/chaves-api).
</Note>

Inclua a chave de API no header `x-api-key` de cada requisição:

```bash theme={null}
x-api-key: YOUR_API_KEY
```

## URL base

Use a seguinte URL base para todos os endpoints:

```
https://gateway.jelou.ai/ecommerce
```

## Recursos disponíveis

<CardGroup cols={2}>
  <Card title="Filiais" icon="store" href="/pt/guias/integracoes/e-commerce/api-sucursales/criar">
    Crie e gerencie filiais para organizar seus produtos por localização.
  </Card>

  <Card title="Produtos" icon="box" href="/pt/guias/integracoes/e-commerce/api-productos/listar">
    Crie ou atualize produtos com variações e atribuição de filial.
  </Card>

  <Card title="Promoções" icon="ticket" href="/pt/guias/integracoes/e-commerce/api-cupones/criar">
    Crie cupons de desconto por porcentagem ou valor fixo, com vigência e escopo por filial.
  </Card>
</CardGroup>