Sincronizzazione Prezzi per Quantità (B2B)

Questo endpoint gestisce l'aggiornamento dei prezzi a scaglioni e dei prezzi di listino specifici per i cataloghi B2B di Shopify. Permette di definire sia il prezzo unitario di listino che le soglie di sconto per quantità.

⚠️ Nota Importante Per sincronizzare i prezzi per quantità, il prodotto deve avere un prezzo modificato (Fixed Price) nel listino di riferimento. Il sistema non può applicare sconti quantità su listini che ereditano dinamicamente il prezzo base senza un'eccezione di prezzo già impostata.

Informazioni generali

L'endpoint permette di definire soglie di acquisto e relativi prezzi scontati (es. "Se compri almeno 50 pezzi, il costo unitario passa da 70€ a 60€").

L'identificazione del target avviene tramite marketId o priceListId:

• marketId: L'aggiornamento viene propagato a tutti i listini prezzi associati a quel determinato mercato.
• priceListId: L'aggiornamento è puntuale sul singolo listino specificato.
• Priorità: Se nel tracciato sono presenti entrambi i campi, il sistema utilizzerà esclusivamente il priceListId, ignorando il mercato.

Logica di Gestione dei Campi

La sincronizzazione segue regole specifiche per ogni campo, permettendo l'aggiornamento, la manutenzione o la rimozione totale dei dati.

1. Prezzo Unitario (price)

Questo campo definisce il prezzo principale (Fixed Price) all'interno del listino o del mercato di destinazione.

• Valore superiore a 0: Il prezzo viene aggiornato con il valore numerico inviato.
• Valore uguale a 0: Indica la rimozione dell'eccezione di prezzo. Il listino smetterà di avere un prezzo specifico e il prodotto tornerà a ereditare il prezzo base del catalogo Shopify.
• Valore null: Il sistema ignora il campo. Il prezzo attualmente presente su Shopify rimarrà invariato.

2. Prezzo di Confronto (compareAtPrice)

Utilizzato per gestire l'aspetto promozionale (prezzo barrato) all'interno del listino.

• Valore ≥ price: Viene impostato il valore inviato, mostrando correttamente lo sconto a catalogo.
• Valore < price: Per evitare errori logici (prezzo scontato superiore al prezzo originale), il valore viene forzato e impostato uguale a quello passato nel campo price, annullando di fatto lo sconto visivo.
• Valore uguale a 0: Il prezzo di confronto viene azzerato, rimuovendo l'indicazione del prezzo barrato.
• Valore null: Nessuna modifica applicata; l'eventuale valore esistente resta invariato.

3. Prezzi per Quantità (qtyPricing)

Gestisce gli scaglioni di acquisto per sbloccare prezzi agevolati.

• Valorizzato (Array): Il sistema adotta una logica di sovrascrittura totale. Tutti i prezzi per quantità precedentemente salvati per quel listino verranno eliminati e sostituiti esclusivamente da quelli forniti nel nuovo JSON.
• Array vuoto []: Funziona come comando di cancellazione massiva. Tutti i prezzi per quantità esistenti per quel prodotto e listino vengono rimossi.
• Valore null: Nessuna azione applicata. Utile se si desidera aggiornare solo il prezzo unitario senza modificare le soglie volumetriche esistenti.

Campi di destinazione (Almeno uno obbligatorio)

• marketId: ID del mercato Shopify.
• priceListId: ID del listino prezzi specifico.

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)

Tracciato di esempio

[
  {
    "sku": "VARIANT_SKU_001",
    "marketId": "italy-main",
    "priceListId": "PL_001",
    "price": 35.50,
    "compareAtPrice": 45.00,
    "qtyPricing": [
      {
        "price": 25.50,
        "quantity": 10
      },
      {
        "price": 20.50,
        "quantity": 15
      }
    ]
  }
]

Configurazioni flusso

Oltre alle configurazioni base del flusso dati aggiungere le seguenti impostazioni sui Settings Override:

Campo	Valore	Note
Base Url	https://adapter.flowlyze.io	url degli adapter
Resource Path	/api/adp/shopify/egress/sync-quantity-pricing-to-shopify	path dell'adapter per i prezzi a quantità (B2B)
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