Pular para o conteúdo principal
POST
/
api
/
v2
/
apps
/
{app_id}
/
batch
/
categories
/
upsert
curl -X POST "https://ecommerce.jelou.ai/api/v2/apps/{app_id}/batch/categories/upsert" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "resources": [
      {
        "name": "Pizzas",
        "description": "Todas as nossas pizzas artesanais",
        "image": "https://exemplo.com/images/pizzas.jpg",
        "order": 1,
        "status": true,
        "branch": "FILIAL-CENTRO"
      },
      {
        "name": "Bebidas",
        "description": "Bebidas quentes e frias",
        "order": 2,
        "branch": "FILIAL-CENTRO"
      },
      {
        "name": "Sobremesas",
        "order": 3
      }
    ]
  }'

{
  "message": "Batch upsert process initiated successfully",
  "count": 3,
  "jobs": 1
}
Você pode criar ou atualizar categorias em lote pelo nome. Se uma categoria com o mesmo nome já existir na mesma loja e filial, ela é atualizada; caso contrário, é criada.
​
app_id
string
obrigatório
O ID da sua loja no Jelou Shop.
​
resources
object[]
obrigatório
Lista de categorias para criar ou atualizar (máx. 500 por solicitação).
A filial deve ser criada antes de atribuí-la a uma categoria. Use o endpoint Criar filiais para registrá-la primeiro.
curl -X POST "https://ecommerce.jelou.ai/api/v2/apps/{app_id}/batch/categories/upsert" \
  -H "Authorization: Bearer <API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "resources": [
      {
        "name": "Pizzas",
        "description": "Todas as nossas pizzas artesanais",
        "image": "https://exemplo.com/images/pizzas.jpg",
        "order": 1,
        "status": true,
        "branch": "FILIAL-CENTRO"
      },
      {
        "name": "Bebidas",
        "description": "Bebidas quentes e frias",
        "order": 2,
        "branch": "FILIAL-CENTRO"
      },
      {
        "name": "Sobremesas",
        "order": 3
      }
    ]
  }'

{
  "message": "Batch upsert process initiated successfully",
  "count": 3,
  "jobs": 1
}

​
Comportamento

O endpoint retorna 202 Accepted imediatamente. As categorias são processadas em segundo plano.
As categorias são identificadas pelo name dentro da mesma loja e filial. Se já existir uma com esse nome, ela é atualizada em vez de criar uma nova.
Se o código da filial não corresponder a nenhuma filial da loja, a categoria é criada sem filial atribuída.
Se uma URL de imagem for fornecida, ela é baixada e armazenada em segundo plano após a criação da categoria.

​
Erros de validação

CampoMensagem
resourcesThe resources field is required.
resourcesAt least one category is required.
resourcesCannot process more than 500 categories at once.
resources.*.nameEach category must have a name.
resources.*.imageCategory image must be a valid URL.
resources.*.orderCategory order must be an integer. / Category order cannot be negative.
resources.*.statusCategory status must be a boolean.

​
Limites

  • Máximo 500 categorias por solicitação.
  • Todas as categorias são validadas antes do processamento.
Substitua {app_id} pelo ID da sua loja e <API_KEY> pelo token fornecido pela Jelou.