Erstellt einen neuen Kunden oder aktualisiert einen vorhandenen anhand der E-Mail-Adresse.
POST/api/customer/createorupdate
Dieser Endpunkt bietet Upsert-Funktionalität, wobei die E-Mail als eindeutige Kennung verwendet wird.
- Wenn ein Kunde mit der angegebenen E-Mail existiert, wird er aktualisiert und zurückgegeben.
- Wenn kein Kunde mit dieser E-Mail existiert, wird nach der Validierung der Eindeutigkeit von E-Mail und Dokumenttyp+Nummer ein neuer Kunde erstellt.
Validierungsregeln:
- E-Mail ist erforderlich und wird als primärer Suchschlüssel verwendet
- Wenn Id oder GlobalId angegeben werden (ungleich null/nicht leer), wird die Anfrage mit 400 abgelehnt – verwenden Sie stattdessen den Endpunkt UpdateCustomer
- Für neue Kunden: validiert, dass die Kombination aus E-Mail und Dokumenttyp+Nummer noch nicht existiert
- Für Aktualisierungen: Wenn sich der Dokumenttyp oder die Nummer geändert hat, wird validiert, dass die neue Kombination nicht von einem anderen Kunden verwendet wird (erfordert Berechtigungen)
Request
Responses
- 200
- 400
- 403
Kunde erfolgreich erstellt oder aktualisiert
Ungültige Kundendaten oder ID/GlobalID angegeben oder Api Error
Nicht authentifizierter Benutzer