Arquivar um produto
Tira o produto do catálogo ativo. Vendas já feitas e cobranças em aberto seguem seu curso normalmente.
DELETEhttps://api.navenaut.com/products/{productId}
Autenticação
A sessão do painel autentica esta rota, e ela é lida de forma autoritativa: não há parâmetro em que o chamador aponte para outra conta.
Esta rota não exige escopo nomeado — o que não quer dizer que ela seja aberta: sem a credencial acima ela recusa.
Exige sessão de vendedor. O dono do produto vem do vínculo da sessão, nunca da requisição.
Parâmetros
Caminho
| Nome | Tipo | Descrição |
|---|---|---|
productIdobrigatório | texto (uuid) | O identificador do produto no seu catálogo. |
Respostas
200 · sucesso
{
"id": "0f2a4e6c-91c4-4e1b-9a3d-5b7c2e8f4a06",
"status": "draft"
}404 · não encontrado
O produto não existe, ou não é seu.
Erros desta rota
| Status | Código | Quando | O que fazer |
|---|---|---|---|
| 404 | PRODUCT_NOT_FOUND | O identificador não existe, ou o produto é de outra conta. As duas causas respondem igual de propósito: distinguir revelaria a existência de produto alheio. | Confira o identificador na listagem de produtos. Repetir não muda o resultado, e nada foi apagado. |
Os códigos são estáveis e fazem parte do contrato. A lista completa, com todos os vocabulários, está na tabela de erros.