> For the complete documentation index, see [llms.txt](https://apidoc.toplojas.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://apidoc.toplojas.com.br/departamentos/criar-departamento.md).

# Criar Departamento

Cria um **novo departamento** na loja. Ele pode ser um departamento **raiz** ou um **subdepartamento** (filho de outro departamento).

```
POST /departamentos/
```

## 📋 Campos

| Campo       | Tipo    | Obrigatório | Descrição                                                 |
| ----------- | ------- | ----------- | --------------------------------------------------------- |
| `Nome`      | texto   | ✅ Sim       | Nome do departamento                                      |
| `Status`    | texto   | ✅ Sim       | Status do departamento: `A` (Ativado) ou `D` (Desativado) |
| `CodigoPai` | inteiro | ❌ Não       | Código do departamento **"Pai"** deste departamento       |

{% hint style="info" %}
**Departamento raiz x subdepartamento**

Se você informar `CodigoPai` com o valor **`0`** — ou **não enviar** o campo `CodigoPai` — o departamento será criado como **raiz** (sem pai).

Para criar um **subdepartamento**, informe em `CodigoPai` o `Codigo` de um departamento já existente.
{% endhint %}

## 📥 Exemplo de requisição

Criando um departamento raiz chamado **Livros**:

```bash
curl -X POST "https://api.toplojas.com.br/departamentos/" \
  -H "Authorization: Bearer [Token]" \
  -H "Loja: [Identificador de Sua Loja]" \
  -H "Content-Type: application/json" \
  -d '{
    "Nome": "Livros",
    "Status": "A",
    "CodigoPai": 0
  }'
```

Em caso de sucesso, a API retorna o HTTP Code **201**.

{% hint style="info" %}
Referência completa deste endpoint:

{% embed url="<https://api.toplojas.com.br/doc/#/Departamentos>" %}
{% endhint %}