Editar produto
Edição parcial do cadastro — só os campos enviados mudam. status "inactive" só desativa (o produto continua na lista, parado); excluir é o DELETE. Aceita Idempotency-Key.
Corpo de exemplo — desativar
{ "status": "inactive" }Desativar não arquiva: o produto segue na lista, parado. Produto excluído (arquivado) responde
400 a qualquer mudança de status. Trocar type para service ou digital desliga track_stock
(voltar para physical não religa sozinho).
Aceita os mesmos campos do cadastro de produto (name, type, status, category_id,
subcategory_id, brand, description, unit, billing, base_price, track_stock,
external_id, ncm, tax_rate, custom_fields) e também sku, barcode, stock_min, weight_kg,
height_cm, width_cm, length_cm e cost (este último só é gravado se quem responde pela chave é
dono ou administrador). O produto não tem variação: tudo se edita aqui.
Acertar o estoque (stock_count)
stock_count informa a contagem: quanto existe agora (número, zero ou mais). O sistema compara
com o "Em Estoque" atual e lança a diferença como um ajuste — é o mesmo que digitar o número na
tela. Não existe lançamento de entrada ou saída: mande sempre o total contado, e repetir a mesma
contagem não grava nada de novo.
{ "stock_count": 42 }Só vale em produto que controla estoque (track_stock ligado — pode vir na mesma chamada). Em produto
sem controle de estoque a resposta é 422 e nada é gravado. Quando a contagem muda o saldo,
changed_fields traz stock.
A resposta traz o produto completo (como o GET, com custom_fields) e changed_fields (os nomes
dos campos que mudaram de verdade; mudança em SKU, código de barras, mínimo, medidas ou custo aparece
como variants). cost e tax_rate mandados por quem não é dono ou administrador são ignorados, com
aviso. Os limites de cada campo são os mesmos da criação.