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

# Crear sucursal

> Crea una sucursal para organizar tus productos por ubicación.

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

ID de tu tienda en Jelou Shop.

**name** `string` *required*

Nombre de la sucursal (máx. 255 caracteres).

**code** `string` *required*

Código único de la sucursal dentro de la tienda (máx. 255 caracteres).

**address** `string`

Dirección de la sucursal (máx. 255 caracteres).

**phone** `string`

Teléfono de la sucursal (máx. 255 caracteres).

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

Estado de la sucursal (activa/inactiva).

**properties** `object`

Objeto JSON con propiedades personalizadas de la sucursal. Puedes incluir cualquier clave propia; la clave `language` es validada.

**Propiedades reservadas**

**language** `string`

Idioma de la sucursal. Campo validado: solo acepta `es`, `en` o `pt`. Cualquier otro valor devuelve un error de validación.

> [!NOTE]
>
> El `code` debe ser único por tienda. Si intentas crear dos sucursales con el mismo código en la misma tienda, recibirás un error de validación.

```bash cURL theme={null}
curl -X POST "https://gateway.jelou.ai/ecommerce/v2/apps/{app_id}/branches" \
  -H "x-api-key: TU_CLAVE_API" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sucursal Centro",
    "code": "SUC-CENTRO",
    "address": "Av. Principal 123, Quito",
    "phone": "+593991234567",
    "status": true,
    "properties": {
      "horario": "09:00 - 18:00",
      "zona": "norte"
    }
  }'
```

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

> [!TIP]
>
> **Operaciones en lote (batch):** puedes gestionar varias sucursales en una sola llamada usando el endpoint `/ecommerce/v2/apps/{app_id}/branches/batch`:
>
> * `POST` — crea varias sucursales con un cuerpo `{ "resources": [ { ... }, { ... } ] }`.
> * `PATCH` — actualiza varias sucursales con `{ "resources": { "<branch_id>": { ... } } }`.
> * `DELETE` — elimina varias sucursales con `{ "resources": ["<branch_id>", "<branch_id>"] }`.
>
> La respuesta del batch devuelve las sucursales afectadas dentro de `data`.


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