Creazione Clienti

👤 Funzionalità di Creazione/Aggiornamento Cliente

L'endpoint consente di creare o aggiornare un cliente su Shopify.

🔍 Logica di ricerca del cliente:

1. Se è presente l'Id del cliente, viene effettuata una ricerca tramite Id Shopify.
   • Se il cliente esiste, viene restituito per effettuare l'aggiornamento.
   • Se non viene trovato e l'Id fornito in input contiene il prefisso dell'Id shopify, la ricerca si interrompe e si procede con la creazione del cliente.
   • In caso contrario la ricerca prosegue.
2. Se non è stato possibile individuare il cliente tramite Id, e l'email fornita è valida, viene effettuata una ricerca tramite email.
   • Se il cliente viene trovato, viene restituito.
   • In caso contrario, la ricerca prosegue.
3. Se non è disponibile (o non valida) l’email, ma è presente un numero di telefono valido, viene eseguita una ricerca tramite numero di telefono.
   • Se viene trovato un cliente, viene restituito.
4. Se nessuna delle ricerche restituisce risultati, viene restituito un cliente vuoto, e il sistema procederà successivamente con la creazione di un nuovo cliente.

Configurazione del Flusso di Creazione Clienti

Oltre alla configurazione base del flusso dati, è necessario aggiungere le seguenti impostazioni nei Settings Override della destinazione:

Campo	Valore	Note
Base Url	https://adapt.flowlyze.com	url degli adapter
Resource Path	api/adp/shopify/egress/sync-customer-to-shopify	Path dell'adapter per il flusso di creazione dei clienti.
Headers :: x-api-key	**********	L'api key di verifica per l'interazione con l'endpoint
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret della custom app creata per l'integrazione
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Url dello shopify con cui connettersi

Messaggio di Input

L’endpoint lavora in modalità upsert: è possibile inviare JSON parziali e solo i campi specificati verranno aggiornati su Shopify. I campi non inclusi nella richiesta non subiranno modifiche.

Se è necessario svuotare un campo (es. rimuovere un valore precedentemente presente), occorre inviarlo esplicitamente come stringa vuota ("").

Esempi Messaggi di Input

1. Creazione/Aggiornamento cliente

{
    "id": "123456789",
    "email": "mario.bianchi@gmail.com",
    "firstName": "Mario",
    "lastName": "Bianchi",
    "phone": "3342233222",
    "tags": ["tag1","tag2"],
    "acceptsEmailMarketing": false,
    "acceptsSmsMarketing": false
}

💡 Nota: Se si desidera fornire l’Id nel formato Shopify, è possibile utilizzare la versione con prefisso:

"id": "gid://shopify/Customer/123456789"