Objetos

Produto

Um produto do catálogo da loja, com preço, estoque, imagens e variações.

Campos

campo	tipo	descrição
`id`	`integer`	Identificador do produto.
`sku`	`string`	Código interno (SKU/referência). Gerado como REF-{id} quando não informado.
`nome`	`string`	Nome do produto.
`descricao`	`string`	Descrição. Aceita HTML simples (p, br, b, strong, i, em, ul, ol, li, h2, h3).
`marca`	`string`	Marca ou fabricante.
`categoria_id`	`integer`	Categoria principal.
`preco`	`number`	Preço cheio em reais.
`preco_promocional`	`number \| null`	Preço em oferta, ou null quando não está em promoção.
`preco_final`	`number`	Preço cobrado hoje (o promocional, se houver).
`ativo`	`boolean`	Produto ativo (false = desativado, não aparece nem é vendido).
`visivel`	`boolean`	Aparece nas listas da loja (false = só pelo link direto).
`estoque`	`object`	{ controlado, quantidade, minimo }. Quantidade null quando o estoque não é controlado.
`peso_kg`	`number`	Peso para o cálculo de frete.
`dimensoes_cm`	`object`	{ altura, largura, comprimento } em centímetros.
`imagens`	`string[]`	URLs das imagens (a primeira é a principal).
`variacoes`	`object[]`	Grupos de opções: { nome, escolha_minima, escolha_maxima, opcoes: [{ nome, descricao, valor_adicional, cor, estoque, sku }] }.
`url`	`string`	Endereço da página do produto na loja.
`criado_em`	`string (ISO 8601)`	Data de criação.
`atualizado_em`	`string (ISO 8601)`	Última alteração.

Exemplo

{
  "id": 2496,
  "sku": "LIV-001",
  "nome": "O Farol das Horas Quietas",
  "descricao": "",
  "marca": "Página Dobrada",
  "categoria_id": 783,
  "preco": 59.9,
  "preco_promocional": 39.9,
  "preco_final": 39.9,
  "ativo": true,
  "visivel": false,
  "estoque": {
    "controlado": true,
    "quantidade": 7,
    "minimo": 0
  },
  "peso_kg": 0.0,
  "dimensoes_cm": {
    "altura": 0.0,
    "largura": 0.0,
    "comprimento": 0.0
  },
  "imagens": [],
  "variacoes": [
    {
      "nome": "Edição",
      "escolha_minima": 1,
      "escolha_maxima": 1,
      "opcoes": [
        {
          "nome": "Brochura",
          "descricao": "",
          "valor_adicional": 0.0,
          "cor": null,
          "estoque": null,
          "sku": null
        },
        {
          "nome": "Capa dura",
          "descricao": "",
          "valor_adicional": 20.0,
          "cor": null,
          "estoque": 4,
          "sku": "LIV-001-CD"
        }
      ]
    }
  ],
  "url": "https://demo73.hoteldaslojas.com.br/produto/2496-livro-teste-api",
  "criado_em": "2026-10-28T00:43:26-03:00",
  "atualizado_em": "2026-10-28T00:43:29-03:00"
}