Listini Prezzo

Questo endpoint consente di aggiornare i prezzi dei prodotti su ChannelEngine.
I prezzi possono essere modificati sia per il listino base del prodotto sia per i listini di mercato associati a specifici canali.

Le regole principali prevedono che lo Sku sia sempre specificato e univoco per la variante (child), che il prezzo sia sempre fornito e non negativo, e che l’eventuale compareAtPrice sia maggiore o uguale al prezzo.

Quando si aggiorna il prezzo di mercato, i valori vengono inseriti negli Extra Data secondo le seguenti convenzioni:

• price_<marketId> per il prezzo del mercato
• priceCompareAt_<marketId> per il prezzo di confronto

Se invece non viene specificato alcun mercato, l’aggiornamento riguarda il prezzo base del prodotto.

Campi del Payload

Obbligatori

• sku: SKU del prodotto variante (child)
• price: prezzo da aggiornare (obbligatorio e non negativo)

Facoltativi

• compareAtPrice: prezzo di confronto (tipicamente il prezzo originale di listino)
• marketId: ID del mercato o del canale; necessario solo per aggiornare prezzi di mercato

Comportamento dell’Aggiornamento Prezzi

• Il prezzo base viene aggiornato solo se non è fornito il campo marketId.
• Se viene fornito marketId, il prezzo base non viene modificato e l’aggiornamento viene applicato negli Extra Data come descritto sopra.
• L’aggiornamento segue una logica di upsert, sovrascrivendo eventuali valori già presenti.
• Tutte le regole di validazione (price >= 0, compareAtPrice >= price) si applicano sia al prezzo base sia ai prezzi di mercato.

Esempio JSON

{
  "data": [
    // Aggiornamento listino base
    {
      "sku": "FS-03-1",
      "price": 182.00,
      "compareAtPrice": 200.00
    },
    {
      "sku": "FS-03-2",
      "price": 183.00
    },
    // Aggiornamento listino mercato (Svizzera)
    {
      "sku": "FS-03-1",
      "marketId": "83005178131",
      "price": 190.00,
      "compareAtPrice": 200.00
    },
    {
      "sku": "FS-03-2",
      "marketId": "83005178131",
      "price": 191.00
    }
  ]
}

Configurazioni flusso prezzi

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

Campo	Valore	Note
Base Url	https://adapt.flowlyze.com	url degli adapter
Resource Path	/api/adp/channel-engine/egress/sync-prices-to-ce	path dell'adapter per la sincronizzazione dei prezzi
Headers :: x-api-key	**********	api key di verifica interazione endpoint
Headers :: x-ce-url	https://CEURL.channelengine.net/api	url del Channel Engine con cui connettersi
Headers :: x-ce-token	CODICEALFANUMERICO	token per l'integrazione