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

# Criar filial

> Crie uma nova filial para organizar seus produtos por localização.

**app\_id** `string` *required*

O ID da sua loja no Jelou Shop.

**name** `string` *required*

Nome da filial (máx. 255 caracteres).

**code** `string` *required*

Código único da filial dentro da loja (máx. 255 caracteres).

**address** `string`

Endereço da filial (máx. 255 caracteres).

**phone** `string`

Número de telefone da filial (máx. 255 caracteres).

**status** `boolean` (default: true)

Status da filial (ativa/inativa).

**properties** `object`

Objeto JSON com propriedades personalizadas da filial. Você pode incluir qualquer chave própria; a chave `language` é validada.

**Propriedades reservadas**

**language** `string`

Idioma da filial. Campo validado: aceita apenas `es`, `en` ou `pt`. Qualquer outro valor retorna um erro de validação.

> [!NOTE]
>
> O `code` deve ser único por loja. Se você tentar criar duas filiais com o mesmo código na mesma loja, receberá um erro de validação.

```bash cURL theme={null}
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Filial Centro",
    "code": "BRANCH-DOWNTOWN",
    "address": "Av. Principal 123, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    }
  }'
```

```json 201 Created theme={null}
{
  "data": {
    "id": "9e3f2c1a-8b7d-4e6f-a5c4-d3b2a1e0f9c8",
    "name": "Filial Centro",
    "code": "BRANCH-DOWNTOWN",
    "address": "Av. Principal 123, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "schedule": "09:00 - 18:00",
      "zone": "north"
    },
    "created_at": "2026-02-19T15:30:00.000000Z",
    "updated_at": "2026-02-19T15:30:00.000000Z"
  }
}
```

> [!TIP]
>
> **Operações em lote (batch):** você pode gerenciar várias filiais em uma única chamada usando o endpoint `/ecommerce/v2/apps/{app_id}/branches/batch`:
>
> * `POST` — cria várias filiais com um corpo `{ "resources": [ { ... }, { ... } ] }`.
> * `PATCH` — atualiza várias filiais com `{ "resources": { "<branch_id>": { ... } } }`.
> * `DELETE` — exclui várias filiais com `{ "resources": ["<branch_id>", "<branch_id>"] }`.
>
> A resposta do batch retorna as filiais afetadas dentro de `data`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.