Kunde aktualisieren

Mit diesem Endpunkt können Sie einen bestehenden Kunden aktualisieren. Alle Felder sind optional; es werden nur die übermittelten Felder aktualisiert.

Request

curl --request PATCH \
     --url 'https://www.zep-online.de/zepinstanz/next/api/v1/customers/K-12345' \
     --header 'Accept: application/json' \
     --header 'Authorization: Bearer {token}' \
     --header 'Content-Type: application/json' \
     --data '{
  "name": "Acme Corporation GmbH",
  "email": "kontakt@acme-corp.de",
  "phone": "+49 30 12345678",
  "website": "https://www.acme-corp.de",
  "status": 1,
  "vat": 19.0,
  "payment_target": 30
}'

Parameter

• customer_number (string, erforderlich): Die Kundennummer des zu aktualisierenden Kunden

Optionale Felder

Alle Felder sind optional. Sie können einzelne oder mehrere Felder gleichzeitig aktualisieren:

• customer_number (string): Eindeutige Kundennummer/Kennung (max. 32 Zeichen)
• name (string): Primärer Kundenname (max. 120 Zeichen)
• additional_name (string): Zusätzlicher Name oder Rechtsform (max. 120 Zeichen)
• website (string): Kunden-Website-URL (max. 120 Zeichen)
• email (string): Primäre Kontakt-E-Mail (max. 320 Zeichen)
• phone (string): Primäre Telefonnummer (max. 32 Zeichen)
• fax (string): Faxnummer (max. 32 Zeichen)
• currency (string): Währungscode (muss in der Währungstabelle existieren)
• comments (string): Zusätzliche Kommentare oder Notizen zum Kunden
• industry (string): Branche oder Geschäftsbereich (max. 32 Zeichen)
• vat (number): Mehrwertsteuersatz in Prozent (0-100)
• tax_number (string): Steueridentifikationsnummer (max. 32 Zeichen)
• iban (string): Internationale Bankkontonummer (max. 34 Zeichen)
• bic (string): Bankleitzahl (SWIFT-Code, max. 11 Zeichen)
• payment_target (integer): Zahlungsziel in Tagen (≥ 0)
• payment_target_discount (integer): Skontofrist in Tagen (≥ 0)
• status (integer): Kundenstatus
  • 0 - Inaktiv
  • 1 - Aktiv
• billing_procedure (boolean): Spezielle Abrechnungsverfahren aktivieren
• automated_invoicing (boolean): Automatische Rechnungsstellung aktivieren
• debit_payment (boolean): Lastschriftzahlung aktivieren
• department_id (integer): Abteilungs-ID (muss in der Abteilungstabelle existieren)
• dynamic_attributes (array): Benutzerdefinierte dynamische Attribute für den Kunden
• categories (array): Array von Kategorie-IDs, die dem Kunden zugeordnet werden sollen

Response

{
	"data": {
		"id": 789,
		"customer_number": "K-12345",
		"name": "Acme Corporation GmbH",
		"additional_name": "Acme Corp.",
		"email": "kontakt@acme-corp.de",
		"phone": "+49 30 12345678",
		"website": "https://www.acme-corp.de",
		"currency": "EUR",
		"status": 1,
		"vat": 19.0,
		"payment_target": 30,
		"created": "2024-01-15T10:30:00.000000Z",
		"modified": "2024-11-20T14:25:00.000000Z"
	},
	"info": null
}

Response-Felder

• data: Das aktualisierte Kundenobjekt
• info: Optionale Konsistenzinformationen, wenn Kundendaten während der Aktualisierung angepasst wurden

Fehlercodes

• 401 Unauthorized: Ungültige oder fehlende Authentifizierung
• 404 Not Found: Kunde nicht gefunden
• 422 Unprocessable Entity: Validierungsfehler

Hinweise

• Nur die übermittelten Felder werden aktualisiert; nicht angegebene Felder bleiben unverändert
• Die Kundennummer kann geändert werden, muss aber weiterhin eindeutig sein
• Währungscode muss in der Systemwährungstabelle existieren
• Abteilungs-ID muss auf eine existierende Abteilung verweisen
• VAT-Wert muss zwischen 0 und 100 liegen
• Zahlungsziel-Werte müssen nicht-negativ sein