Importazione Trasferimenti Inventario

I trasferimenti inventario (Inventory Transfer) di Shopify vengono recuperati attivamente da Flowlyze.

Vengono importati solo ed esclusivamente i trasferimenti in stato TRANSFORMED.

Le informazioni recuperate per ciascun trasferimento includono:

• identificativo e nome del trasferimento.
• note e stato.
• quantità totale e ricevuta.
• origine e destinazione (origin e destination): codice e nome delle location coinvolte.
• data di creazione (createdAt).
• righe (items): SKU e quantità per ogni articolo del trasferimento.

L'Adapter aggiunge un tag al trasferimento inventario al momento dell'esportazione, in modo da non recuperarlo nelle chiamate successive.

💡 Filtro per data di creazione

È possibile indicare l'header x-inventory-transfer-created-from per limitare il recupero ai trasferimenti in stato TRANSFORMED creati a partire da quella data. Se l'header è vuoto, vengono considerati tutti i trasferimenti idonei dall'inizio.

Non utilizzare questo valore in modalità autoincrementale: in caso di aggiornamenti intermedi su Shopify alcuni trasferimenti potrebbero non essere più visibili con il filtro incrementale e andare persi.

Configurazione del Flusso Trasferimenti Inventario (attivo)

Dopo aver creato la destinazione, che nel caso di un flusso attivo può essere un database o un endpoint, è necessario configurare il flusso attivando la schedulazione (Schedulation Enabled) e impostandolo come segue:

Campo	Valore	Note
Name	es. active-flow-inventory-transfer	Nome della schedulazione
Cron Expression	*/5 * * * *	Ogni quanto eseguire il recupero (es. */5 * * * * -> ogni 5 minuti)
Source Type	http	Il tipo di sorgente da utilizzare
Url	https://adapter.flowlyze.io/api/adp/shopify/ingress/get-inventory-transfer	URL dell'endpoint da richiamare
Method	GET	Metodo HTTP per richiamare l'endpoint
Headers :: x-api-key	**********	API key per l'interazione con l'endpoint
Headers :: x-shopify-graphql-url	https://SHOPIFYURL.myshopify.com/	URL dello shop Shopify
Headers :: x-shopify-access-token	shpat_CODICEALFANUMERICO	Secret della custom app creata per l'integrazione
Headers :: x-inventory-transfer-created-from	es. 2024-11-15T12:00:00Z	Data di creazione minima; se vuoto si parte dall'inizio (non usare autoincrementale)
Headers :: x-number-of-inventory-transfers	10	Numero di trasferimenti da recuperare per ogni chiamata
Headers :: channel-code	Your Shopify Store	Nome o codice dello shop Shopify

Esempio delle informazioni recuperate

{
  "id": "gid://shopify/InventoryTransfer/123456",
  "name": "#T0011",
  "note": null,
  "status": "TRANSFERRED",
  "totalQuantity": 10,
  "receivedQuantity": 10,
  "origin": {
    "locationCode": "gid://shopify/Location/124578",
    "locationName": "Magazzino Principale"
  },
  "destination": {
    "locationCode": "gid://shopify/Location/987654",
    "locationName": "Negozio"
  },
  "createdAt": "2026-05-11T00:00:00+00:00",
  "items": [
    {
      "id": "gid://shopify/InventoryTransferLineItem/147852369",
      "sku": "ART_01_12",
      "quantity": 5
    },
    {
      "id": "gid://shopify/InventoryTransferLineItem/958674",
      "sku": "ART_01_11",
      "quantity": 5
    }
  ]
}