Crea un nuovo cliente o aggiorna uno esistente in base all'indirizzo email.

POST /api/customer/createorupdate

Questo endpoint fornisce la funzionalità di upsert utilizzando l'email come identificatore univoco.

Se esiste un cliente con l'email fornita, verrà aggiornato e restituito.
Se non esiste alcun cliente con tale email, verrà creato un nuovo cliente dopo aver verificato l'univocità dell'email e della combinazione tipo+numero di documento.

Regole di validazione:

L'email è obbligatoria e viene utilizzata come chiave di ricerca primaria
Se vengono forniti Id o GlobalId (diversi da zero/non vuoti), la richiesta verrà rifiutata con 400 - utilizzare invece l'endpoint UpdateCustomer
Per i nuovi clienti: verifica che la combinazione di email e tipo+numero di documento non esista già
Per gli aggiornamenti: se il tipo o il numero del documento sono cambiati, verifica che la nuova combinazione non sia utilizzata da un altro cliente (richiede autorizzazioni)

Request

Cliente creato o aggiornato correttamente