Bulk Update

PUT https://.account-name.krzlabs.io/api/v1/products/bulk

Realiza a atualização em massa de produtos.


Body Params

Field Type Description Optional Searchable
attribute_groups Array(ObjectId) Lista de IDs de grupos de atributos relacionados ao produto. required false
categories Array(ObjectId) Lista de IDs de categorias associadas ao produto. required false
code string Código único do produto. required true
deleted boolean Indica se o produto foi excluído. required false
description Translate Descrição do produto em vários idiomas. required false
enabled boolean Indica se o produto está ativo. required false
family_id ObjectId Referência à família do produto. required false
image string URL da imagem principal do produto. required false
name Translate Nome do produto em vários idiomas. required true
tags Array(string) Tags livres para categorização e busca. required false
Exemplo em JSON
{
  "attribute_groups": [
    "64f1b3d4e5d987654321caaa",
    "64f1b3d4e5d987654321cbbb"
  ],
  "categories": [
    "64f1c4e6e5d567890abcd111",
    "64f1c4e6e5d567890abcd112"
  ],
  "code": "PRD-001",
  "deleted": false,
  "description": {
    "pt": "Descrição do produto em português.",
    "en": "Product description in English.",
    "es": "Descripción del producto en español."
  },
  "enabled": true,
  "family_id": "64f1d5f8e5d135790abcdef1",
  "image": "https://exemplo.com/produto.jpg",
  "name": {
    "pt": "Tênis Esportivo",
    "en": "Running Shoes",
    "es": "Zapatillas de Correr"
  },
  "tags": [
    "esporte",
    "corrida",
    "conforto"
  ]
}

Responses

Resposta de sucesso

200
Successfully retrieved API registry entry.
Field Type optional description Searchable
insertedCount number required Quantidade de documentos inseridos. false
matchedCount number required Quantidade de documentos que correspondem ao filtro de atualização. false
modifiedCount number required Quantidade de documentos modificados. false
deletedCount number required Quantidade de documentos deletados. false
upsertedCount number required Quantidade de documentos upsertados. false
upsertedIds any required IDs dos documentos upsertados. false
insertedIds any required ID do documento inserido. false
ok number required Indica se a operação foi bem sucedida. false
Exemplo em JSON
{
  "insertedCount": 1,
  "matchedCount": 2,
  "modifiedCount": 2,
  "deletedCount": 0,
  "upsertedCount": 1,
  "upsertedIds": {
    "0": "66b8f6f9d9f4ab1234567890"
  },
  "insertedIds": {
    "0": "66b8f6f9d9f4ab1234567891"
  },
  "ok": 1
}

Resposta de erro

400
Bad Request
Field Type Description
code Number Código da resposta http
kind String Tipo de mensagem
name String Nome da exceção lançada pela plataforma
title String Titulo do erro lançado pela plataforma
message String Mensagem indicando o probloma ocorrido
solution String Mensagem indicando uma possível solução para o problema

Copyright © 2025 kruzer | All Rights Reserved