Atualizar produtos em lote

PATCH

Markdown (LLM)

Atualiza vários produtos em uma requisição.

Escopo:catalog:write

Limite:300 requisições a cada 3 minutos.

Parâmetros do body

productIdinteger

Identificador do produto, inteiro maior ou igual a 1.

131822

typestring

Tipo de atualização.

Enum

productDados do produto
menuCardápio do produto
restrictionsRestrições alimentares
groupsOrdem dos grupos

product

Parâmetros da resposta

Atualização em lote

Cada item informa o produto, o tipo e o objeto correspondente. As regras da atualização unitária continuam valendo.

Regras

Envie um array não vazio; outro formato ou array vazio retorna 400.
product: envie product com os campos a alterar; os omitidos preservam o valor atual.
menu: envie menu com merchantId e os campos a alterar; o cardápio precisa estar vinculado ao produto.
restrictions: envie restrictions como objeto ou null para limpar.
groups: envie groups como array não vazio de { groupId, sortOrder }; só os grupos enviados mudam.
Booleanos com null são ignorados em product, menu e restrictions. Em menu, null limpa preços, sortOrder, featuredOrder e upsell; upsell: [] também limpa.
Os itens são independentes: a falha de um não desfaz os demais.
O retorno mantém a ordem do body; confira success em cada item, mesmo com HTTP 200. message aparece apenas nas falhas.

Body (JSON)

json

123456789101112131415161718192021222324252627282930313233343536[
  {
    "productId": 131822,
    "type": "product",
    "product": {
      "price": 22.5,
      "featured": true
    }
  },
  {
    "productId": 131822,
    "type": "menu",
    "menu": {
      "merchantId": 122,
      "deliveryPrice": 22.5
    }
  },
  {
    "productId": 131822,
    "type": "restrictions",
    "restrictions": {
      "vegetarian": false,
      "serves": 1
    }
  },
  {
    "productId": 131822,
    "type": "groups",
    "groups": [
      {
        "groupId": 266128,
        "sortOrder": 1
      }
    ]
  }
]

Linguagem

Produção

Requisição

PATCH /v1/catalog/products

1234567891011121314151617181920212223242526272829303132333435363738394041424344import axios from "axios";
const { data } = await axios({
  method: "patch",
  url: "https://api.beefood.app/v1/catalog/products",
  headers: {
    Authorization: `Bearer ${accessToken}`,
  },
  data: [
    {
      "productId": 131822,
      "type": "product",
      "product": {
        "price": 22.5,
        "featured": true
      }
    },
    {
      "productId": 131822,
      "type": "menu",
      "menu": {
        "merchantId": 122,
        "deliveryPrice": 22.5
      }
    },
    {
      "productId": 131822,
      "type": "restrictions",
      "restrictions": {
        "vegetarian": false,
        "serves": 1
      }
    },
    {
      "productId": 131822,
      "type": "groups",
      "groups": [
        {
          "groupId": 266128,
          "sortOrder": 1
        }
      ]
    }
  ],
});

Resposta

json

12345678910111213141516171819202122[
  {
    "productId": 131822,
    "type": "product",
    "success": true
  },
  {
    "productId": 131822,
    "type": "menu",
    "success": true
  },
  {
    "productId": 131822,
    "type": "restrictions",
    "success": true
  },
  {
    "productId": 131822,
    "type": "groups",
    "success": true
  }
]