Kunde löschen

Mit diesem Endpunkt können Sie einen Kunden dauerhaft aus dem System löschen.

Request

curl --request DELETE \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers/K-12345' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}'

Parameter

• customer_number (string, erforderlich): Die Kundennummer des zu löschenden Kunden

Response

Erfolgreiche Löschung

{
	"message": "Customer deleted successfully."
}

Eine erfolgreiche Löschung gibt eine Erfolgsmeldung zurück.

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 404 Not Found: Kunde mit der angegebenen Kundennummer wurde nicht gefunden
• 500 Internal Server Error: Kunde konnte nicht gelöscht werden. Dies kann auftreten, wenn der Kunde verknüpfte Datensätze hat, die eine Löschung verhindern.

Hinweise

• Das Löschen eines Kunden ist eine endgültige Aktion und kann nicht rückgängig gemacht werden
• Ein Kunde kann möglicherweise nicht gelöscht werden, wenn verknüpfte Datensätze existieren (z.B. Projekte, Rechnungen, Angebote)
• Stellen Sie sicher, dass Sie die richtige Kundennummer verwenden, bevor Sie den Löschvorgang ausführen
• Überprüfen Sie, ob der Benutzer die notwendigen Berechtigungen zum Löschen von Kunden hat
• In vielen Fällen ist es empfehlenswerter, den Kundenstatus auf "Inaktiv" zu setzen, anstatt den Kunden zu löschen

Beispiel

DELETE /api/v1/customers/K-12345

Response bei Erfolg:

{
	"message": "Customer deleted successfully."
}

Response bei Fehler (500):

{
	"message": "Customer could not be deleted."
}