Listini prezzo V2

Tracciato di aggiornamento listini prezzo.

⚠️ Nota La versione precedente dell’endpoint è deprecata. Listini prezzo - deprecata
Questa documentazione fa riferimento alla V2, che introduce un comportamento differente nella gestione dei mercati e dei cataloghi.

Informazioni generali

Price List ID e Currency Code non devono essere forniti nel tracciato. Tali informazioni vengono recuperate automaticamente tramite query Shopify.

• L’aggiornamento dei prezzi può avvenire:
• sul listino base (primario o regione di backup)
• sui listini associati ai mercati (cataloghi)

Campi

Campi obbligatori

• sku
• price

Campi facoltativi

• compareAtPrice: prezzo di confronto (prezzo base di listino)
• marketId: id del market di riferimento

Su Shopify l’id del market è l’ultimo numero presente nella URL della pagina del market (es: https://admin.shopify.com/store/yourShopifyStore/markets/123456789)

Comportamento aggiornamento prezzi

Aggiornamento listino base (primario o regione di backup)

Per aggiornare i prezzi del listino base (primario o regione di backup):

• NON deve essere fornito il marketId
• L’aggiornamento avviene a livello di prezzo base del prodotto
• Il campo price non può essere 0

Il prezzo base:

• è il riferimento principale
• viene utilizzato da tutti i mercati non personalizzati

Aggiornamento listini di mercato (cataloghi)

Se viene fornito il marketId:

• l’aggiornamento non agisce sul prezzo base
• l’aggiornamento avviene sui cataloghi associati al market
• un market può avere più cataloghi
• tutti i cataloghi associati al market verranno aggiornati

Gestione del prezzo = 0 sui mercati

• Se marketId è presente:
• price = 0 indica la rimozione dell’aggiustamento di prezzo
• il catalogo tornerà a usare il prezzo base

Priorità dei prezzi

• Se un prodotto ha:
• un prezzo base
• e un prezzo personalizzato su un market
• prevale sempre il prezzo configurato sul market

Tracciato

{
    "data":[
        // Aggiornamento listino base (primario o regione di backup)
        {
            "sku": "FS-03-1",
            "price": 182.00,
            "compareAtPrice": 100.00
        },
        {
            "sku": "FS-03-2",
            "price": 183.00
        },
        // Aggiornamento listini associati a un market
        {
            "sku": "FS-03-1",
            "marketId": "83005178131",
            "price": 190.00,
            "compareAtPrice": 200.00
        },
        {
            "sku": "FS-03-2",
            "marketId": "83005178131",
            "price": 191.00
        }
    ]
}

Configurazione destinazione

Configurare una destinazione Shopify e associarla al flusso, oltre alla configurazione base del flusso dati.

Campo	Valore	Note
Destination Type	Shopify
Operation	Price sync v2	POST /egress/v2/sync-price-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/v2/sync-price-to-shopify	path dell'adapter per i listini prezzo
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