Stocks

Tracciato per l'invio degli stock su location, una singola chiamata può contenere aggiornamenti su diverse location.

Il location_id fa riferimento all'id della location Shopify recuperabile nella URL: es: https://admin.shopify.com/store/myshopify/settings/locations/99333760019

Stocks specifiche flusso

Gli aggiornamenti dell'inventario aggiornano lo stock ONHAND, ovvero la quantità presente in magazzino, che viene stornato dagli ordini ancora da evadere (manca il fulfillment). In alternativa, è possibile aggiornare lo stock AVAILABLE, ovvero la la quantità vendibile (ONHAND - COMMITTED = AVAILABLE).

La location_id corrisponde all'id della location Shopify a cui è associato lo stock, nel caso sia univoca è possibile configurarla direttamente su Flowlyze evitando quindi di inviarla ad ogni comunicazione.

[
    {
        "sku": "BGSM001C210A-1",
        "qty": 34,
        "location_id": 99333760019
    },
    {
        "sku": "BGSM001C210A-2",
        "qty": 35,
        "location_id": 99333760071
    }
]

È possibile inviare quantità negative, ma è necessario prestare attenzione, dato che in base al tipo di stock che viene aggiornato si ha un determinato comportamento:

• se l'aggiornamento riguarda lo stock AVAILABLE, il valore verrà sincronizzato così com'è;
• se invece l'aggiornamento riguarda lo stock ONHAND, il valore verrà impostato a 0 (non sono ammesse quantità negative a magazzino).

Configurazione destinazione

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

Campo	Valore	Note
Destination Type	Shopify
Operation	Stock update	POST /egress/stock-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
Fulfillment location	gid://shopify/Location/…	Identificativo location Shopify usato per gli aggiornamenti inventario
Update available quantity	true / false	Se true, aggiorna le quantità available alla location (obbligatorio)
Ignore missing SKU	true / false	Se true, ignora gli SKU non trovati invece di fallire (default: false, obbligatorio)

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/stock-to-shopify	path dell'adapter per lo stock
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
Headers :: x-shopify-update-available	true	permette di modificare direttamente AVAILABLE dello stock
Headers :: x-shopify-location	locationID	location di default per ogni chiamata
Headers :: x-ignore-missing-sku	true	ignora SKU mancanti (default: false)