Tabelas de Preços

Visão Geral

O módulo Tabelas de Preços gerencia as tabelas de preço da empresa, permitindo configurar diferentes políticas de preço para distintos perfis de clientes, canais de venda ou períodos. Cada tabela pode ter preços específicos por produto.

Endpoints

GET /api/tabelas-precos

Descrição: Lista todas as tabelas de preços cadastradas 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 da tabela
ativo	boolean	Não	Filtrar por status ativo/inativo

Resposta de Sucesso

{
  "dados": [
    {
      "id": "uuid",
      "nome": "Tabela Varejo",
      "descricao": "Preços para clientes do varejo",
      "tipo": "varejo",
      "ativo": true
    }
  ],
  "total": 5,
  "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/tabelas-precos" \
  -H "Authorization: Bearer {token}"

JavaScript

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

Python

import requests

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

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/tabelas-precos", 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/tabelas-precos');
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/tabelas-precos",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos",
        "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/tabelas-precos

Descrição: Cria uma nova tabela de preços no sistema. Autenticação: Obrigatória

Corpo da Requisição (Request Body)

{
  "nome": "Tabela Atacado",
  "descricao": "Preços diferenciados para atacadistas",
  "tipo": "atacado",
  "percentualDesconto": 15.0,
  "ativo": true
}

Resposta de Sucesso

{
  "id": "uuid",
  "nome": "Tabela Atacado",
  "tipo": "atacado",
  "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/tabelas-precos" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"nome":"Tabela Atacado","descricao":"Preços diferenciados para atacadistas","tipo":"atacado","percentualDesconto":15.0,"ativo":true}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/tabelas-precos', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "nome": "Tabela Atacado",
  "descricao": "Preços diferenciados para atacadistas",
  "tipo": "atacado",
  "percentualDesconto": 15.0,
  "ativo": true
})
});
const data = await response.json();

Python

import requests

data = requests.post(
    'https://api.app.hooked.com.br/api/tabelas-precos',
    headers={'Authorization': 'Bearer {token}'},
    json={'nome': 'Tabela Atacado', 'descricao': 'Preços diferenciados para atacadistas', 'tipo': 'atacado', 'percentualDesconto': 15.0, 'ativo': True}
).json()

Go

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"nome":"Tabela Atacado","descricao":"Preços diferenciados para atacadistas","tipo":"atacado","percentualDesconto":15.0,"ativo":true}`)
req, _ := http.NewRequest("POST", "https://api.app.hooked.com.br/api/tabelas-precos", 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/tabelas-precos');
curl_setopt_array($ch, [
    CURLOPT_POST           => true,
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'nome' => 'Tabela Atacado',
        'descricao' => 'Preços diferenciados para atacadistas',
        'tipo' => 'atacado',
        'percentualDesconto' => 15.0,
        'ativo' => true
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — POST /api/tabelas-precos",
  "nodes": [
    {
      "parameters": {
        "method": "POST",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"nome\":\"Tabela Atacado\",\"descricao\":\"Preços diferenciados para atacadistas\",\"tipo\":\"atacado\",\"percentualDesconto\":15.0,\"ativo\":true}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

GET /api/tabelas-precos/{id}

Descrição: Retorna os detalhes de uma tabela de preços 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 da tabela de preços

Resposta de Sucesso

{
  "id": "uuid",
  "nome": "Tabela Atacado",
  "descricao": "Preços diferenciados para atacadistas",
  "tipo": "atacado",
  "percentualDesconto": 15.0,
  "ativo": true
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Tabela de preços não encontrada

Exemplos de Código

cURL

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

JavaScript

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

Python

import requests

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

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/tabelas-precos/{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/tabelas-precos/{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/tabelas-precos/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos/{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/tabelas-precos/{id}

Descrição: Atualiza os dados de uma tabela de preços existente. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
id	string (uuid)	Sim	Identificador único da tabela de preços

Corpo da Requisição (Request Body)

{
  "percentualDesconto": 20.0,
  "ativo": true
}

Resposta de Sucesso

{
  "id": "uuid",
  "nome": "Tabela Atacado",
  "percentualDesconto": 20.0,
  "ativo": true
}

Códigos de Erro Comuns

Código	Descrição
400	Dados inválidos
401	Não autorizado
404	Tabela de preços não encontrada

Exemplos de Código

cURL

curl -X PUT "https://api.app.hooked.com.br/api/tabelas-precos/{id}" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{"percentualDesconto":20.0,"ativo":true}'

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/tabelas-precos/{id}', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer {token}',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
  "percentualDesconto": 20.0,
  "ativo": true
})
});
const data = await response.json();

Python

import requests

data = requests.put(
    'https://api.app.hooked.com.br/api/tabelas-precos/{id}',
    headers={'Authorization': 'Bearer {token}'},
    json={'percentualDesconto': 20.0, 'ativo': True}
).json()

Go

import (
    "bytes"
    "net/http"
)

payload := []byte(`{"percentualDesconto":20.0,"ativo":true}`)
req, _ := http.NewRequest("PUT", "https://api.app.hooked.com.br/api/tabelas-precos/{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/tabelas-precos/{id}');
curl_setopt_array($ch, [
    CURLOPT_CUSTOMREQUEST  => 'PUT',
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer {token}', 'Content-Type: application/json'],
    CURLOPT_POSTFIELDS     => json_encode([
        'percentualDesconto' => 20.0,
        'ativo' => true
    ]),
    CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
curl_close($ch);

n8n

{
  "name": "Hooked API — PUT /api/tabelas-precos/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "PUT",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos/{id}",
        "sendHeaders": true,
        "headerParameters": {
          "parameters": [
            {
              "name": "Authorization",
              "value": "Bearer SEU_TOKEN_AQUI"
            }
          ]
        },
        "sendBody": true,
        "contentType": "json",
        "specifyBody": "json",
        "jsonBody": "{\"percentualDesconto\":20.0,\"ativo\":true}",
        "options": {}
      },
      "id": "node-1",
      "name": "HTTP Request",
      "type": "n8n-nodes-base.httpRequest",
      "typeVersion": 4.2,
      "position": [
        250,
        300
      ]
    }
  ],
  "connections": {},
  "pinData": {}
}

---

DELETE /api/tabelas-precos/{id}

Descrição: Remove uma tabela de preços 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 da tabela de preços

Resposta de Sucesso

{
  "mensagem": "Tabela de preços removida com sucesso"
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Tabela de preços não encontrada
409	Tabela vinculada a clientes ou produtos

Exemplos de Código

cURL

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

JavaScript

const response = await fetch('https://api.app.hooked.com.br/api/tabelas-precos/{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/tabelas-precos/{id}',
    headers={'Authorization': 'Bearer {token}'}
).json()

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("DELETE", "https://api.app.hooked.com.br/api/tabelas-precos/{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/tabelas-precos/{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/tabelas-precos/{id}",
  "nodes": [
    {
      "parameters": {
        "method": "DELETE",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos/{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": {}
}

---

GET /api/tabelas-precos/{tabelaPrecoId}/{produtoServicoId}

Descrição: Recupera o preço específico de um produto ou serviço dentro de uma tabela de preços. Autenticação: Obrigatória

Parâmetros de Path

Parâmetro	Tipo	Obrigatório	Descrição
tabelaPrecoId	string (uuid)	Sim	Identificador da tabela de preços
produtoServicoId	string (uuid)	Sim	Identificador do produto ou serviço

Resposta de Sucesso

{
  "tabelaPrecoId": "uuid",
  "tabelaPrecoNome": "Tabela Atacado",
  "produtoServicoId": "uuid",
  "produtoServicoNome": "Camiseta Básica",
  "preco": 42.42,
  "precoMinimo": 35.00,
  "precoMaximo": 50.00
}

Códigos de Erro Comuns

Código	Descrição
401	Não autorizado
404	Combinação tabela/produto não encontrada

Exemplos de Código

cURL

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

JavaScript

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

Python

import requests

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

Go

import (
    "io"
    "net/http"
)

req, _ := http.NewRequest("GET", "https://api.app.hooked.com.br/api/tabelas-precos/{tabelaPrecoId}/{produtoServicoId}", 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/tabelas-precos/{tabelaPrecoId}/{produtoServicoId}');
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/tabelas-precos/{tabelaPrecoId}/{produtoServicoId}",
  "nodes": [
    {
      "parameters": {
        "method": "GET",
        "url": "https://api.app.hooked.com.br/api/tabelas-precos/{tabelaPrecoId}/{produtoServicoId}",
        "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": {}
}