Criar produto
Cadastra um produto (só o nome é obrigatório). Cada produto é um produto, sem variação. Aceita Idempotency-Key e ?dry_run=true.
POST
https://app.salos.com.br/api/products
products:write
Corpo de exemplo
{
"name": "Camiseta Básica",
"type": "physical",
"base_price": 49.9,
"sku": "CAM-1",
"barcode": "7891234567895",
"track_stock": true,
"initial_stock": 10,
"category_id": null
}Campos
| Campo | Tipo | Regras |
|---|---|---|
name |
texto | obrigatório, 1–200 |
type |
physical, digital, service |
padrão physical. Medidas e ncm só valem pra physical |
status |
active, inactive |
padrão active |
category_id, subcategory_id |
id | null | precisam existir na conta; a categoria é de topo e a subcategoria tem que ser filha dela |
brand |
texto | null | até 120 |
description |
texto | null | até 2000 |
external_id |
texto | null | até 200. Código de referência livre — não é único |
ncm |
texto | null | 8 números. Só produto físico |
unit |
UN, PC, CX, PAR, KG, G, L, ML, M, M², M³, H, DIA, MÊS |
padrão UN |
billing |
one_time, monthly, yearly |
padrão one_time |
base_price |
número | ≥ 0, até R$ 9.999.999.999,99, no máximo 2 casas decimais |
track_stock |
verdadeiro/falso | padrão ligado em produto físico; digital e serviço nunca controlam estoque |
sku |
texto | null | até 100. Não repete na conta (sem diferenciar maiúscula) |
barcode |
texto | null | 8, 12, 13 ou 14 números |
stock_min |
número | null | ≥ 0 |
weight_kg, height_cm, width_cm, length_cm |
número | null | 0 a 999.999. Só produto físico |
initial_stock |
número | maior que zero, até 3 casas. Vira a contagem inicial de estoque (só com track_stock) e exige também a credencial de editar produtos |
cost, tax_rate |
número | null | 🔒 só dono ou administrador grava; pra os outros é ignorado e a resposta traz aviso. tax_rate é percentual, 0–100 |
custom_fields |
objeto | campos personalizados de produto |
SKU repetido devolve 409 conflict (no ensaio, com existing_id — o produto que já tem o código).
Resposta
201 com o produto completo — o mesmo corpo de GET/api/products/{id}, sem custom_fields —
mais variant_id (o id que vai na linha do negócio). Se algo não entrou, a resposta diz: aviso
(texto) e estoque_inicial, que vale "lancado", "ignorado" (o produto não controla estoque) ou
"falhou" (o produto foi criado, mas o estoque não — acerte com stock_count no PATCH).