Setores

Visão Geral

O módulo Setores gerencia os setores produtivos da empresa, utilizados principalmente no contexto de ordens de produção. Cada setor representa uma área ou célula de trabalho pela qual os itens da ordem de produção podem passar durante o processo de fabricação.

Endpoints

GET /api/setores

Descrição: Lista todos os setores cadastrados com suporte a paginação e filtros. Autenticação: Obrigatória

Parâmetros de Query

Parâmetro	Tipo	Obrigatório	Descrição
pagina	integer	Não	Número da página (padrão: 1)
quantidade	integer	Não	Itens por página (padrão: 20)
nome	string	Não	Filtrar por nome do setor
ativo	boolean	Não	Filtrar por status ativo/inativo

Resposta de Sucesso

{
  "dados": [
    {
      "id": "uuid",
      "codigo": "SET001",
      "nome": "Corte",
      "descricao": "Setor de corte de matéria-prima",
      "ativo": true
    }
  ],
  "total": 8,
  "pagina": 1,
  "quantidade": 20
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
500	Erro interno do servidor

Exemplos de Código

cURL

curl -X GET "https://api.app.hooked.com.br/api/setores" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/setores', {
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.get(
    'https://api.app.hooked.com.br/api/setores',
    headers={'Authorization': 'Bearer {token}'}
).json()

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/setores", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/setores');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — GET /api/setores",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/setores",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

POST /api/setores

Descrição: Cria um novo setor produtivo no sistema. Autenticação: Obrigatória

Corpo da Requisição (Request Body)

{
  "codigo": "SET001",
  "nome": "Corte",
  "descricao": "Setor de corte de matéria-prima",
  "responsavelId": "uuid",
  "ativo": true
}

Resposta de Sucesso

{
  "id": "uuid",
  "codigo": "SET001",
  "nome": "Corte",
  "ativo": true
}

Códigos de Erro Comuns

Código	Descrição
400	Dados inválidos
401	Não autorizado

Exemplos de Código

cURL

curl -X POST "https://api.app.hooked.com.br/api/setores" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"codigo":"SET001","nome":"Corte","descricao":"Setor de corte de matéria-prima","responsavelId":"uuid","ativo":true}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/setores', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "codigo": "SET001",
  "nome": "Corte",
  "descricao": "Setor de corte de matéria-prima",
  "responsavelId": "uuid",
  "ativo": true
})
});
const data = await response.json();

Python

import requests

data = requests.post(
    'https://api.app.hooked.com.br/api/setores',
    headers={'Authorization': 'Bearer {token}'},
    json={'codigo': 'SET001', 'nome': 'Corte', 'descricao': 'Setor de corte de matéria-prima', 'responsavelId': 'uuid', 'ativo': True}
).json()

Go

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"codigo":"SET001","nome":"Corte","descricao":"Setor de corte de matéria-prima","responsavelId":"uuid","ativo":true}`)
req, _ := http.NewRequest("POST", "https://api.app.hooked.com.br/api/setores", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer {token}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/setores');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'codigo' => 'SET001',
        'nome' => 'Corte',
        'descricao' => 'Setor de corte de matéria-prima',
        'responsavelId' => 'uuid',
        'ativo' => true
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — POST /api/setores",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/setores",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"codigo\":\"SET001\",\"nome\":\"Corte\",\"descricao\":\"Setor de corte de matéria-prima\",\"responsavelId\":\"uuid\",\"ativo\":true}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

GET /api/setores/{id}

Descrição: Retorna os detalhes de um setor pelo seu identificador único. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único do setor

Resposta de Sucesso

{
  "id": "uuid",
  "codigo": "SET001",
  "nome": "Corte",
  "descricao": "Setor de corte de matéria-prima",
  "responsavel": "Carlos Souza",
  "ativo": true
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Setor não encontrado

Exemplos de Código

cURL

curl -X GET "https://api.app.hooked.com.br/api/setores/{id}" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/setores/{id}', {
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.get(
    'https://api.app.hooked.com.br/api/setores/{id}',
    headers={'Authorization': 'Bearer {token}'}
).json()

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/setores/{id}", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/setores/{id}');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — GET /api/setores/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/setores/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

PUT /api/setores/{id}

Descrição: Atualiza os dados de um setor existente. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único do setor

Corpo da Requisição (Request Body)

{
  "nome": "Corte e Dobra",
  "descricao": "Setor de corte e dobra de materiais",
  "ativo": true
}

Resposta de Sucesso

{
  "id": "uuid",
  "nome": "Corte e Dobra",
  "ativo": true
}

Códigos de Erro Comuns

Código	Descrição
400	Dados inválidos
401	Não autorizado
404	Setor não encontrado

Exemplos de Código

cURL

curl -X PUT "https://api.app.hooked.com.br/api/setores/{id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Corte e Dobra","descricao":"Setor de corte e dobra de materiais","ativo":true}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/setores/{id}', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "nome": "Corte e Dobra",
  "descricao": "Setor de corte e dobra de materiais",
  "ativo": true
})
});
const data = await response.json();

Python

import requests

data = requests.put(
    'https://api.app.hooked.com.br/api/setores/{id}',
    headers={'Authorization': 'Bearer {token}'},
    json={'nome': 'Corte e Dobra', 'descricao': 'Setor de corte e dobra de materiais', 'ativo': True}
).json()

Go

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"nome":"Corte e Dobra","descricao":"Setor de corte e dobra de materiais","ativo":true}`)
req, _ := http.NewRequest("PUT", "https://api.app.hooked.com.br/api/setores/{id}", bytes.NewBuffer(payload))
req.Header.Set("Authorization", "Bearer {token}")
req.Header.Set("Content-Type", "application/json")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/setores/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'nome' => 'Corte e Dobra',
        'descricao' => 'Setor de corte e dobra de materiais',
        'ativo' => true
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — PUT /api/setores/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "PUT",
        "url": "https://api.app.hooked.com.br/api/setores/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"nome\":\"Corte e Dobra\",\"descricao\":\"Setor de corte e dobra de materiais\",\"ativo\":true}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

DELETE /api/setores/{id}

Descrição: Remove um setor do sistema pelo seu identificador. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único do setor

Resposta de Sucesso

{
  "mensagem": "Setor removido com sucesso"
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Setor não encontrado
409	Setor vinculado a ordens de produção

Exemplos de Código

cURL

curl -X DELETE "https://api.app.hooked.com.br/api/setores/{id}" \
  -H "Authorization: Bearer {token}"

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/setores/{id}', {
  method: 'DELETE',
  headers: { 'Authorization': 'Bearer {token}' }
});
const data = await response.json();

Python

import requests

data = requests.delete(
    'https://api.app.hooked.com.br/api/setores/{id}',
    headers={'Authorization': 'Bearer {token}'}
).json()

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("DELETE", "https://api.app.hooked.com.br/api/setores/{id}", nil)
req.Header.Set("Authorization", "Bearer {token}")
resp, _ := http.DefaultClient.Do(req)
defer resp.Body.Close()
body, _ := io.ReadAll(resp.Body)

PHP

$ch = curl_init('https://api.app.hooked.com.br/api/setores/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'DELETE',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}'],
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — DELETE /api/setores/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "DELETE",
        "url": "https://api.app.hooked.com.br/api/setores/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}