Importazione Prodotti

I prodotti di Shopify vengono recuperati attivamente da Flowlyze.

L'Adapter aggiunge un metafield al prodotto per verificarne l'avvenuta esportazione (Flowlyze Exported) ed evitare invii duplicati verso la destinazione, ma solo se l'header di sincronizzazione unica è impostato a true. Questo comportamento consente di sincronizzare un prodotto una sola volta, ignorando eventuali aggiornamenti successivi (comportamento opzionale, configurabile tramite header). Se l’header non è valorizzato, il metafield non viene valorizzato e il prodotto può essere esportato più volte.

Attenzione

Rischio loop di aggiornamento

Flowlyze si basa sulla data di ultimo aggiornamento del prodotto (campo updated_at) per determinare quali elementi recuperare da Shopify. Se il controllo tramite header non è configurato correttamente, ogni modifica (o salvataggio) del prodotto aggiornerà questo campo, causando la sua continua importazione ed eventuali cicli infiniti di sincronizzazione.

Configurazione del Flusso Prodotti (attivo)

Dopo aver creato la destinazione si procede all'inserimento del flusso.

Campo	Valore	Note
Name	es. active-flow-product	Nome della schedulazione
Cron Expression	*/5 * * * *	Ogni quanto si vuole eseguire il recupero dei prodotti (es. */5 * * * * -> ogni 5 minuti)
Source Type	http	Il tipo di sorgente che deve essere utilizzata
Url	https://adapt.flowlyze.com/api/adp/shopify/ingress/get-products-updated-after	Url dell'endpoint che deve essere richiamato (vedi nota a fine tabella)
Method	GET	Il metodo con cui richiamare l'endpoint
Headers :: x-api-key	**********	L'api key di verifica per l'interazione con l'endpoint
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	Url dello shopify con cui connettersi
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret della custom app creata per l'integrazione
Headers :: x-last-product-updated-processed"	lastProductUpdatedProcessed	Data da cui partire per recuperare i prodotti, da utilizzare con autoincrementale
Headers :: x-sync-product-once	true	Booleano per importare il prodotto una sola volta, non propaga aggiornamenti (default false)
Headers :: channel-code"	Your Shopify Store	Il nome o il codice del tuo shop di Shopify
Headers :: x-number-of-products	10	Numero di prodotti da recuperare ad ogni chiamata (default 10)

Esempio delle informazioni recuperate

{
    "channel": "YourShopifyCode",
    "id": "gid://shopify/Product/123456789",
    "title": "The Complete Snowboard",
    "featuredMedia": {
        "alt": "Top and bottom view of a snowboard.",
        "url": "https://cdn.shopify.com/s/files/1/0881/6348/3955/files/Main_123456789.jpg?v=123456789"
    },
    "variants": [
        {
            "sku": "ABC001-Ice",
            "optionValues": {
                "color": "Ice"
            }
        },
        {
            "sku": "ABC001-Dawn",
            "optionValues": {
                "color": "Dawn"
            }
        },
        {
            "sku": "ABC001-Powder",
            "optionValues": {
                "color": "Powder"
            }
        },
        {
            "sku": "ABC001-Electric",
            "optionValues": {
                "color": "Electric"
            }
        },
        {
            "sku": "ABC001-Sunset",
            "optionValues": {
                "color": "Sunset"
            }
        }
    ]
}