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

<ParamField path="app_id" type="string" required>
  O ID da sua loja no Jelou Shop.
</ParamField>

<ParamField body="name" type="string" required>
  Nome da filial (máx. 255 caracteres).
</ParamField>

<ParamField body="code" type="string" required>
  Código único da filial dentro da loja (máx. 255 caracteres).
</ParamField>

<ParamField body="address" type="string">
  Endereço da filial (máx. 255 caracteres).
</ParamField>

<ParamField body="phone" type="string">
  Número de telefone da filial (máx. 255 caracteres).
</ParamField>

<ParamField body="status" type="boolean" default="true">
  Status da filial (ativa/inativa).
</ParamField>

<ParamField body="properties" type="object">
  Objeto JSON com propriedades personalizadas da filial. Você pode incluir qualquer chave própria; a chave `language` é validada.

  <Expandable title="Propriedades reservadas">
    <ParamField body="language" type="string">
      Idioma da filial. Campo validado: aceita apenas `es`, `en` ou `pt`. Qualquer outro valor retorna um erro de validação.
    </ParamField>
  </Expandable>
</ParamField>

<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.
</Note>

<RequestExample>
  ```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"
      }
    }'
  ```
</RequestExample>

<ResponseExample>
  ```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"
    }
  }
  ```
</ResponseExample>

<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`.
</Tip>