---
title: "Atualizar setores em lote"
description: "PATCH /v1/catalog/sectors — reordenar, ativar e desativar setores em lote na API BeeFood."
method: "PATCH"
path: "/v1/catalog/sectors"
url: "https://developer.beefood.com.br/docs/catalogo/atualizar-setores-lote"
group: "Catálogo"
scope: "catalog:write"
lang: "pt"
---
# Atualizar setores em lote

`PATCH /v1/catalog/sectors`

- Produção: `https://api.beefood.app/v1/catalog/sectors`
- Sandbox: `https://api-sandbox.beefood.app/v1/catalog/sectors`

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

## Autenticação

Envie o access token no header `Authorization: Bearer <accessToken>`. Escopo necessário: `catalog:write`. Limite: 300 requisições a cada 3 minutos.




## Parâmetros do body

- `[]` *array* **obrigatório** — Lote com pelo menos 1 item.

- `[].sectorId` *integer* **obrigatório** — Identificador do setor. Exemplo: `221145`.

- `[].type` *string* **obrigatório** — Tipo de atualização. Exemplo: `sector`.
  - *Valores:* `sector`, `menu`

- `[].sector` *object* — Obrigatório quando type é sector; campos da atualização parcial do setor.

- `[].sector.name` *string* — Nome do setor, até 150 caracteres. Exemplo: `Sobremesas`.

- `[].sector.publicName` *string* — Nome exibido no cardápio digital, até 150 caracteres. Exemplo: `Doces`.

- `[].sector.delivery` *boolean* — Indica se o setor aparece no delivery.

- `[].sector.dineIn` *boolean* — Indica se o setor aparece no presencial.

- `[].menu` *object* — Obrigatório quando type é menu; um único cardápio.

- `[].menu.merchantId` *integer* **obrigatório** — Identificador do cardápio vinculado ao setor, inteiro maior ou igual a 1. Exemplo: `122`.

- `[].menu.active` *boolean* — Indica se o setor fica ativo no cardápio.

- `[].menu.sortOrder` *integer* — Posição do setor no cardápio, inteiro maior ou igual a 0 ou null. Exemplo: `2`.



## Exemplos de requisição

### cURL

```bash
curl -X PATCH "https://api.beefood.app/v1/catalog/sectors" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '[
  {
    "sectorId": 221145,
    "type": "menu",
    "menu": {
      "merchantId": 122,
      "sortOrder": 1
    }
  },
  {
    "sectorId": 221146,
    "type": "menu",
    "menu": {
      "merchantId": 122,
      "sortOrder": 2
    }
  },
  {
    "sectorId": 221146,
    "type": "sector",
    "sector": {
      "publicName": "Promoções"
    }
  }
]'
```


## Exemplos de resposta

### 200 OK

```json
[
  {
    "sectorId": 221145,
    "type": "menu",
    "success": true
  },
  {
    "sectorId": 221146,
    "type": "menu",
    "success": false,
    "message": "Sector ID 221146 is not linked to merchant ID(s) 122"
  },
  {
    "sectorId": 221146,
    "type": "sector",
    "success": true
  }
]
```


## Campos da resposta

- `[].sectorId` *integer* — Identificador do setor.

- `[].type` *string* — Tipo de atualização. Exemplo: `sector`.
  - *Valores:* `sector`, `menu`

- `[].success` *boolean* — Indica se este item foi atualizado.

- `[].message` *string* — Mensagem retornada somente quando success é false.


## Atualização em lote

Cada item informa o setor, 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`.
- `sector`: envie `sector` com os campos a alterar; os omitidos preservam o valor atual.
- Para ordenar setores, use `menu` com `sortOrder`; a ordem é definida por cardápio.
- `menu`: envie `menu` com `merchantId` e os campos a alterar; o cardápio precisa estar vinculado ao setor.
- Item com `sectorId`, `type` ou payload inválido volta com `success: false`.
- Falhas de negócio (setor inexistente, vínculo) voltam no item com a mesma mensagem da rota unitária; falha inesperada retorna `Failed to update sector`.
- 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.

## Erros

| Status | Mensagem |
| --- | --- |
| 401 | Authentication token is missing |
| 401 | Invalid or expired access token |
| 403 | This credential does not include the catalog:write scope |
| 429 | Too many requests |
| 400 | Body must be a non-empty array of sector updates |


## Vocabulários usados neste endpoint

## Atualização em lote de setores · type

| Valor | Significado | Uso |
| --- | --- | --- |
| `sector` | Dados do setor | Objeto sector |
| `menu` | Cardápio do setor | Objeto menu |