curl -X DELETE "https://api.sistema-representantes.com.br/api/v1/products/PROD-TESTE-001" \
-H "x-api-key: sua-api-key-aqui"
const produtoId = 'PROD-OBSOLETO';
const response = await fetch(`https://api.sistema-representantes.com.br/api/v1/products/${produtoId}`, {
method: 'DELETE',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Produto deletado com sucesso');
console.log(result.message);
} else {
console.error('Erro ao deletar:', result.error);
}
import requests
produto_id = "TESTE-PRODUTO-123"
url = f"https://api.sistema-representantes.com.br/api/v1/products/{produto_id}"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.delete(url, headers=headers)
result = response.json()
if response.status_code == 200:
print("Produto deletado com sucesso!")
print(result['message'])
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
# Se o produto tem vendas associadas
if "está sendo usado em" in result.get('error', ''):
print("💡 Dica: Considere desativar o produto em vez de deletar")
<?php
$produtoId = 'PROD-ANTIGO';
$url = "https://api.sistema-representantes.com.br/api/v1/products/{$produtoId}";
$headers = [
'x-api-key: sua-api-key-aqui'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$result = json_decode($response, true);
if ($httpCode === 200) {
echo "Produto deletado com sucesso!\n";
echo $result['message'] . "\n";
} else {
echo "Erro: " . $result['error'] . "\n";
if (strpos($result['error'], 'está sendo usado') !== false) {
echo "O produto possui vendas associadas e não pode ser deletado.\n";
echo "Considere desativá-lo em vez de deletar.\n";
}
}
?>
{
"success": true,
"message": "Produto deletado com sucesso"
}
{
"error": "Produto não encontrado"
}
{
"error": "Produto está sendo usado em 25 venda(s) e não pode ser deletado"
}
{
"error": "API key ausente"
}
{
"error": "Empresa inativa"
}
{
"error": "Erro ao deletar produto"
}
Produtos
Deletar Produto
Remove permanentemente um produto do sistema
DELETE
/
api
/
v1
/
products
/
{id}
curl -X DELETE "https://api.sistema-representantes.com.br/api/v1/products/PROD-TESTE-001" \
-H "x-api-key: sua-api-key-aqui"
const produtoId = 'PROD-OBSOLETO';
const response = await fetch(`https://api.sistema-representantes.com.br/api/v1/products/${produtoId}`, {
method: 'DELETE',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Produto deletado com sucesso');
console.log(result.message);
} else {
console.error('Erro ao deletar:', result.error);
}
import requests
produto_id = "TESTE-PRODUTO-123"
url = f"https://api.sistema-representantes.com.br/api/v1/products/{produto_id}"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.delete(url, headers=headers)
result = response.json()
if response.status_code == 200:
print("Produto deletado com sucesso!")
print(result['message'])
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
# Se o produto tem vendas associadas
if "está sendo usado em" in result.get('error', ''):
print("💡 Dica: Considere desativar o produto em vez de deletar")
<?php
$produtoId = 'PROD-ANTIGO';
$url = "https://api.sistema-representantes.com.br/api/v1/products/{$produtoId}";
$headers = [
'x-api-key: sua-api-key-aqui'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$result = json_decode($response, true);
if ($httpCode === 200) {
echo "Produto deletado com sucesso!\n";
echo $result['message'] . "\n";
} else {
echo "Erro: " . $result['error'] . "\n";
if (strpos($result['error'], 'está sendo usado') !== false) {
echo "O produto possui vendas associadas e não pode ser deletado.\n";
echo "Considere desativá-lo em vez de deletar.\n";
}
}
?>
{
"success": true,
"message": "Produto deletado com sucesso"
}
{
"error": "Produto não encontrado"
}
{
"error": "Produto está sendo usado em 25 venda(s) e não pode ser deletado"
}
{
"error": "API key ausente"
}
{
"error": "Empresa inativa"
}
{
"error": "Erro ao deletar produto"
}
Esta ação é irreversível. O produto será permanentemente removido do sistema.
Produtos que já foram vendidos (existem em itens de vendas) não podem ser deletados para manter a integridade do histórico.
Path Parameters
string
required
ID único do produto (código/SKU)
Headers
string
required
API key de autenticação
curl -X DELETE "https://api.sistema-representantes.com.br/api/v1/products/PROD-TESTE-001" \
-H "x-api-key: sua-api-key-aqui"
const produtoId = 'PROD-OBSOLETO';
const response = await fetch(`https://api.sistema-representantes.com.br/api/v1/products/${produtoId}`, {
method: 'DELETE',
headers: {
'x-api-key': 'sua-api-key-aqui'
}
});
const result = await response.json();
if (result.success) {
console.log('Produto deletado com sucesso');
console.log(result.message);
} else {
console.error('Erro ao deletar:', result.error);
}
import requests
produto_id = "TESTE-PRODUTO-123"
url = f"https://api.sistema-representantes.com.br/api/v1/products/{produto_id}"
headers = {
'x-api-key': 'sua-api-key-aqui'
}
response = requests.delete(url, headers=headers)
result = response.json()
if response.status_code == 200:
print("Produto deletado com sucesso!")
print(result['message'])
else:
print(f"Erro: {result.get('error', 'Erro desconhecido')}")
# Se o produto tem vendas associadas
if "está sendo usado em" in result.get('error', ''):
print("💡 Dica: Considere desativar o produto em vez de deletar")
<?php
$produtoId = 'PROD-ANTIGO';
$url = "https://api.sistema-representantes.com.br/api/v1/products/{$produtoId}";
$headers = [
'x-api-key: sua-api-key-aqui'
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "DELETE");
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
$result = json_decode($response, true);
if ($httpCode === 200) {
echo "Produto deletado com sucesso!\n";
echo $result['message'] . "\n";
} else {
echo "Erro: " . $result['error'] . "\n";
if (strpos($result['error'], 'está sendo usado') !== false) {
echo "O produto possui vendas associadas e não pode ser deletado.\n";
echo "Considere desativá-lo em vez de deletar.\n";
}
}
?>
Response
Sucesso
boolean
Indica se a operação foi bem-sucedida
string
Mensagem de confirmação
Erro
string
Mensagem de erro descritiva
{
"success": true,
"message": "Produto deletado com sucesso"
}
{
"error": "Produto não encontrado"
}
{
"error": "Produto está sendo usado em 25 venda(s) e não pode ser deletado"
}
{
"error": "API key ausente"
}
{
"error": "Empresa inativa"
}
{
"error": "Erro ao deletar produto"
}
Considerações Importantes
Antes de deletar um produto:
- Verifique se não há vendas associadas
- Considere o impacto no histórico e relatórios
- Faça backup se necessário
- Avalie se desativar não seria mais apropriado
Alternativa Recomendada
Em vez de deletar, considere desativar o produto:Vantagens de desativar:
curl -X PUT "https://api.sistema-representantes.com.br/api/v1/products/{id}" \
-H "Content-Type: application/json" \
-H "x-api-key: sua-api-key-aqui" \
-d '{"ativo": false}'
- Mantém histórico de vendas intacto
- Permite reativar no futuro se necessário
- Preserva relatórios e análises
- Evita problemas de integridade referencial
Quando Deletar
Delete produtos apenas quando:
- Foram criados por engano
- São dados de teste
- Nunca foram utilizados em vendas
- Não há necessidade de manter histórico