Zum Hauptinhalt springen

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

Kunde erfolgreich erstellt oder aktualisiert