Pubblicazione Prodotti

Flusso che consente di pubblicare, de-pubblicare o archiviare prodotti su Shopify, aggiornando solamente lo stato dei singoli prodotti senza agire su altri campi.

Tracciato - Singolo SKU

Tracciato per gestire lo stato dei prodotti a partire da una singola variante:

{
    "sku": "BGSM001C210", // Codice univoco di una delle varianti presenti
    "status": "DRAFT"
}

Attenzione

Il campo sku indicato deve corrispondere a quello di una variante. Una volta trovato, l’operazione di cambio stato si applica a tutto il prodotto a cui appartiene quella variante, non solo alla singola variante.

Valori possibili per il campo status

Valore	Descrizione
DRAFT	Il prodotto è salvato come bozza e non è visibile nello shop.
ACTIVE	Il prodotto è pubblicato e visibile nello shop.
ARCHIVED	Il prodotto è archiviato. Non è più visibile ma resta nel catalogo Shopify.
UNLISTED	Il prodotto è pubblicato, ma è necessario avere il link diretto per visualizzarlo.

Comportamento in caso di SKU inesistente

• Se lo SKU esiste → lo stato del prodotto viene aggiornato e, a meno di errori lato Shopify, l’operazione andrà in successo.
• Se lo SKU non esiste e lo status specificato è DRAFT o ARCHIVED → l’operazione viene considerata riuscita (successo).
• Se lo SKU non esiste e lo status richiesto è ACTIVE o UNLISTED → l'operazione viene considerata non riuscita (errore).

Configurazione destinazione

Configurare una destinazione Shopify e associarla al flusso (tracciato singolo SKU).

Campo	Valore	Note
Destination Type	Shopify
Operation	Product status	POST /egress/sync-status-to-shopify
GraphQL endpoint URL	https://SHOPIFYURL.myshopify.com/	URL dell'endpoint GraphQL Admin API dello shop Shopify
Admin API access token	shpat_CODICEALFANUMERICO	Oppure Client ID (API key) + Client secret — vedi Autenticazione
Client ID (API key)	IL_TUO_CLIENT_ID
Client secret	IL_TUO_CLIENT_SECRET

Deprecato — configurazione precedente (HTTP Adapter)

Deprecato

La configurazione tramite HTTP Adapter con Base Url, Resource Path e header x-api-key nei Settings Override è deprecata. Utilizzare la destinazione Shopify descritta sopra.

Oltre alle configurazioni base del flusso dati era necessario impostare nei Settings Override:

Campo	Valore	Note
Base Url	https://adapter.flowlyze.io	url degli adapter
Resource Path	/api/adp/shopify/egress/sync-status-to-shopify	path dell'adapter per sincronizzare lo stato dei prodotti
Headers :: x-api-key	**********	api key di verifica interazione 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

Tracciato - Lista di SKU

Tracciato per gestire lo stato dei prodotti tramite una lista di SKU delle varianti:

{
    "skus": [
        "BGSM001C210",
        "BGSM001C210-0",
        "BGSM001C210-1",
        "BGSM001C210-2"
    ], // Codici univoci delle varianti presenti nel prodotto
    "status": "DRAFT"
}

Attenzione

Il campo skus indicato può contenere la lista degli sku delle varianti presenti nel prodotto. Una volta trovato, l’operazione di cambio stato si applica a tutto il prodotto a cui appartengono quelle varianti.

Comportamento in caso di SKU inesistente

• Se uno degli SKU esiste → lo stato del prodotto viene aggiornato e, a meno di errori lato Shopify, l’operazione andrà in successo.
• Se tutti gli SKU non esistono e lo status specificato è DRAFT o ARCHIVED → l’operazione viene considerata riuscita (successo).
• Se tutti gli SKU non esistono e lo status richiesto è ACTIVE o UNLISTED → l'operazione viene considerata non riuscita (errore).

Configurazione destinazione

Configurare una destinazione Shopify e associarla al flusso (tracciato con lista di SKU).

Campo	Valore	Note
Destination Type	Shopify
Operation	Many products status	POST /egress/sync-products-status-to-shopify
GraphQL endpoint URL	https://SHOPIFYURL.myshopify.com/	URL dell'endpoint GraphQL Admin API dello shop Shopify
Admin API access token	shpat_CODICEALFANUMERICO	Oppure Client ID (API key) + Client secret — vedi Autenticazione
Client ID (API key)	IL_TUO_CLIENT_ID
Client secret	IL_TUO_CLIENT_SECRET

Deprecato — configurazione precedente (HTTP Adapter)

Deprecato

La configurazione tramite HTTP Adapter con Base Url, Resource Path e header x-api-key nei Settings Override è deprecata. Utilizzare la destinazione Shopify descritta sopra.

Oltre alle configurazioni base del flusso dati era necessario impostare nei Settings Override:

Campo	Valore	Note
Base Url	https://adapter.flowlyze.io	url degli adapter
Resource Path	/api/adp/shopify/egress/sync-products-status-to-shopify	path dell'adapter per sincronizzare lo stato dei prodotti con lista di sku
Headers :: x-api-key	**********	api key di verifica interazione 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

Valori possibili per il campo status

Valore	Descrizione
DRAFT	Il prodotto è salvato come bozza e non è visibile nello shop.
ACTIVE	Il prodotto è pubblicato e visibile nello shop.
ARCHIVED	Il prodotto è archiviato. Non è più visibile ma resta nel catalogo Shopify.
UNLISTED	Il prodotto è pubblicato, ma è necessario avere il link diretto per visualizzarlo.