Crear sucursal

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"
    }
  }'

{
  "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"
  }
}

POST

ecommerce

apps

{app_id}

branches

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"
    }
  }'

{
  "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"
  }
}

string

requerido

ID de tu tienda en Jelou Shop.

string

requerido

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

string

requerido

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

string

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

string

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

boolean

predeterminado:"true"

Estado de la sucursal (activa/inactiva).

object

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

Mostrar Propiedades reservadas

string

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

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.

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"
    }
  }'

{
  "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"
  }
}

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.

⌘I

Empezando

Desarrollador

Jelou CLI

Mensajería Outbound

Gestión

Marketplace

Canales

Configuración

Facturación