Zum Hauptinhalt springen

Kunde erstellen oder aktualisieren

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​

Kunde erfolgreich erstellt oder aktualisiert