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).