Saltar al contenido principal
POST
/
ecommerce
/
v2
/
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"
  }
}
​
app_id
string
requerido
ID de tu tienda en Jelou Shop.
​
name
string
requerido
Nombre de la sucursal (máx. 255 caracteres).
​
code
string
requerido
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
predeterminado:"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.
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.