409 Conflict response "Cliente già esistente" in fase di creazione

[MattiaMarchiorato]

Buonasera community,

Vi scriviamo per sapere se qualcuno si è imbattuto nel nostro dubbio/problema:
Come viene verificato dalle API se un cliente esiste già in fase di creazione?
Riceviamo il seguente errore:
[409] Client error: POST https://api-v2.fattureincloud.it/c/COMPANY_ID/entities/clients resulted in a 409 Conflict response:
{"error":{"message":"Cliente gi\u00e0 esistente."}}

Grazie mille

MM

[valmoz]

Buongiorno,
i campi su cui effettuiamo il controllo di duplicità per le entities (clients/suppliers) sono:

• code
• vat_number
• tax_code
• name

I diversi campi vengono aggiunti al controllo solo se dichiarati esplicitamente nella richiesta di creazione.

Grazie
Mauro

[valmoz]

Per quanto riguarda i dati obbligatori, puoi controllare gli schema all'interno dell'API Reference.
Ad esempio, nella Create Client cliccando su "schema" nella request body è possibile osservare che "name" e "value" sono obbligatori, in quanto sono evidenziati tramite asterisco rosso.

Per quanto riguarda il nome, confermo che non è possibile inserire due clienti con lo stesso nome, ma solo nel caso in cui l'unico dei parametri inseriti sia "name". Aggiungendo uno degli altri campi su cui effettuiamo il controllo (ad esempio il codice fiscale) tutto dovrebbe funzionare correttamente.

[MattiaMarchiorato]

Ok, forse anche il required è stato aggiunto recentemente perchè quando abbiamo sviluppato l'ingregrazione non era presente. Per quanto riguarda l'univocità del nome è un problema perchè lavoriamo spesso con clienti esteri a cui non richiediamo quindi il codice fiscale e può succedere che esistano due "Mario Rossi", forse avrebbe senso aggiungere prima del nome la verifica sull'email se presente? Perchè nel nostro caso l'abbiamo e spesso è un identificativo univoco, cosa ne pensi? Oltre al fatto che come immagini chiedere il codice fiscale ad un privato (rispetto chiedere l'email che probabilmente una piattafoma web ha già per l'utente) è abbastanza noioso e sbarrante.

[valmoz]

Buongiorno Mattia.
Senza andare a modificare il comportamento attuale delle API, potete tranquillamente utilizzare il campo "code".
Assegnando ai due utenti con lo stesso nome un code univoco, non ci saranno problemi di duplicazione.

Grazie
Mauro

[MattiaMarchiorato]

Ciao Mauro,

Si recentemente abbiamo aggiunto proprio il code prendendo l'id dell'utente sulla nostra piattaforma, non credo sia la soluzione ottimale ma ce lo faremo andare bene così.

A presto

MM

[valmoz]

Ok, in caso di ulteriori dubbi scrivi pure senza problemi.

Grazie
Mauro