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

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.

📥 Exemplo de requisição

Criando um departamento raiz chamado Livros:

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.

Referência completa deste endpoint:

Swagger UIapi.toplojas.com.br