DELETEExcluir caixa
Remove uma caixa de produto de todas as listas e leituras, mantendo as variantes e os textos guardados.
Use esta operação para aposentar uma caixa. A exclusão é um soft delete: a caixa passa a ser tratada como inexistente (some das listas, de GET por id e da loja, e o carrinho não a aceita mais), mas o registro, as variantes e as descrições continuam guardados. Não há rota pública para restaurar uma caixa excluída nem para apagá-la de vez.
Se você só quer parar de vender, prefira mudar o status para D ou H em Alterar caixa: isso é reversível.
/api/v1/admin/product-boxes/{id}AdminExclui uma caixa de produto
Autenticação: Authorization: Bearer <token> de um administrador com o privilégio manage_product_boxes ou manage_catalog.
Parâmetros de caminho
iduuidobrigatórioId da caixa.
Exemplo de requisição
Resposta
204Caixa excluída
A resposta não tem corpo.
Erros
| Status | Quando | Corpo |
|---|---|---|
| 401 | Token ausente ou expirado | {"error":"invalid or expired token"} |
| 403 | Módulo product-boxes desligado, ou sem privilégio | {"error":"module_disabled","module":"product-boxes"} |
| 404 | Caixa não existe ou já foi excluída (a segunda chamada responde 404) | {"error":"not found","detail":"product-boxes: not found"} |
| 500 | id que não é UUID, ou falha interna | {"error":"internal error","detail":"..."} |