Produtos

Criar Produto

Cadastra um produto novo no catálogo

POST

/v1/produtos

Escopo

produtos.escrever

Imagens ainda não são enviadas pela API: cadastre as fotos pelo painel. As URLs aparecem em "imagens" depois.
Respeita o limite de produtos do plano da loja (erro 409 limite_do_plano).

Autorização

Authorizationstringobrigatórioheader

Chave da API no formato Bearer hdl_live_.... Crie no painel da loja em Integração › API e webhooks. Saiba mais.

Corpo da requisição

nomestringobrigatóriobody · application/json

Nome do produto (até 255 caracteres).

preconumberobrigatóriobody · application/json

Preço em reais.

categoria_idintegerobrigatóriobody · application/json

Categoria da loja.

skustringbody · application/json

Código interno. Se não vier, vira REF-{id}.

descricaostringbody · application/json

Descrição com HTML simples.

marcastringbody · application/json

Marca.

preco_promocionalnumber | nullbody · application/json

Preço em oferta.

ativobooleanbody · application/json

Padrão true.

visivelbooleanbody · application/json

Padrão true.

estoqueobjectbody · application/json

{ controlado: boolean, quantidade: integer, minimo: integer }. A quantidade inicial entra no histórico de estoque.

peso_kgnumberbody · application/json

Peso para frete.

dimensoes_cmobjectbody · application/json

{ altura, largura, comprimento }.

variacoesobject[]body · application/json

[{ nome, escolha_minima, escolha_maxima, opcoes: [{ nome, descricao, valor_adicional, cor }] }] (até 20 grupos e 60 opções por grupo).

Resposta

201 — objeto { "dados": {...} } com um Produto.

Erros possíveis

HTTP	código	quando
`401`	`nao_autenticado`	Faltou o cabeçalho Authorization: Bearer <chave>.
`401`	`chave_invalida`	Chave inexistente ou revogada.
`403`	`sem_permissao`	A chave não tem o escopo exigido pelo endpoint.
`409`	`mesmo_status`	O pedido já está no status pedido.
`409`	`pedido_encerrado`	Pedido cancelado ou reembolsado não muda mais.
`409`	`estoque_insuficiente`	Saída maior que o saldo.
`409`	`limite_do_plano`	A loja atingiu o limite de produtos do plano.
`409`	`limite_webhooks`	A loja já tem 10 webhooks.
`409`	`conflito`	O recurso mudou durante a chamada: consulte e tente de novo.
`422`	`validacao`	Campos inválidos: veja o objeto "campos".

curl --request POST \ --url 'https://api.hoteldaslojas.com.br/v1/produtos' \ --header 'Authorization: Bearer <chave>' \ --header 'Content-Type: application/json' \ --data '{"nome": "Camiseta Básica Algodão", "preco": 79.9, "preco_promocional": 69.9, "categoria_id": 783, "sku": "CAM-001", "marca": "Minha Marca", "estoque": {"controlado": true, "quantidade": 25}, "peso_kg": 0.3, "variacoes": [{"nome": "Tamanho", "escolha_minima": 1, "escolha_maxima": 1, "opcoes": [{"nome": "P"}, {"nome": "M"}, {"nome": "G", "valor_adicional": 5}]}]}'

import os, requests resposta = requests.post( "https://api.hoteldaslojas.com.br/v1/produtos", headers={"Authorization": f"Bearer {os.environ['HDL_CHAVE']}"}, json={ "nome": "Camiseta Básica Algodão", "preco": 79.9, "preco_promocional": 69.9, "categoria_id": 783, "sku": "CAM-001", "marca": "Minha Marca", "estoque": { "controlado": True, "quantidade": 25 }, "peso_kg": 0.3, "variacoes": [ { "nome": "Tamanho", "escolha_minima": 1, "escolha_maxima": 1, "opcoes": [ { "nome": "P" }, { "nome": "M" }, { "nome": "G", "valor_adicional": 5 } ] } ] }, timeout=30, ) resposta.raise_for_status() print(resposta.json()["dados"])

<?php $ch = curl_init('https://api.hoteldaslojas.com.br/v1/produtos'); curl_setopt_array($ch, [ CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_HTTPHEADER => ['Authorization: Bearer ' . getenv('HDL_CHAVE'), 'Content-Type: application/json'], CURLOPT_POSTFIELDS => json_encode([ 'nome' => 'Camiseta Básica Algodão', 'preco' => 79.9, 'preco_promocional' => 69.9, 'categoria_id' => 783, 'sku' => 'CAM-001', 'marca' => 'Minha Marca', 'estoque' => [ 'controlado' => true, 'quantidade' => 25 ], 'peso_kg' => 0.3, 'variacoes' => [[ 'nome' => 'Tamanho', 'escolha_minima' => 1, 'escolha_maxima' => 1, 'opcoes' => [[ 'nome' => 'P' ], [ 'nome' => 'M' ], [ 'nome' => 'G', 'valor_adicional' => 5 ]] ]] ]), ]); $resposta = json_decode(curl_exec($ch), true); $status = curl_getinfo($ch, CURLINFO_HTTP_CODE); curl_close($ch); print_r($resposta);

{ "dados": { "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" } }

{ "erro": { "codigo": "sem_permissao", "mensagem": "Esta chave não tem o escopo \"pedidos.ler\". Crie uma chave com esse escopo no painel da loja (Integração › API).", "request_id": "req_95f4a872c180063c" } }