Skip to main content
DELETE
Esta ação é irreversível. A representada será permanentemente removida do sistema.
Representadas com vendas ou produtos associados não podem ser deletadas para manter a integridade do sistema.

Path Parameters

string
required
ID único da representada (UUID)

Headers

string
required
API key de autenticação

Response

Sucesso

boolean
Indica se a operação foi bem-sucedida
string
Mensagem de confirmação

Erro

string
Mensagem de erro descritiva

Considerações Importantes

Antes de deletar uma representada:
  • Verifique se não há vendas associadas
  • Verifique se não há produtos vinculados
  • Considere o impacto no histórico e relatórios
  • Faça backup se necessário
  • Avalie se desativar não seria mais apropriado

Restrições de Integridade

Uma representada NÃO pode ser deletada se:
  1. Possui vendas realizadas (mesmo antigas)
  2. Possui produtos cadastrados
  3. Está sendo referenciada em outros registros
Estas restrições garantem a integridade do histórico de vendas e relatórios.

Alternativa Recomendada

Em vez de deletar, considere desativar a representada:
Vantagens de desativar:
  • Mantém histórico de vendas intacto
  • Preserva relatórios e análises
  • Permite reativar no futuro se necessário
  • Mantém rastreabilidade completa

Quando Deletar

Delete representadas apenas quando:
  • Foram criadas por engano
  • São dados de teste
  • Nunca foram utilizadas (sem vendas ou produtos)
  • Não há necessidade de manter histórico