Skip to main content

Imports

You can import stock positions for up to 50,000 products in a single operation via an import. This is useful for synchronosing external systems with Elastic Path. The API uses a JSONL file, with one line per product. For each product one specifies the total stock in each location. For example

{"data":{"type":"stock","id":"b36ba644-6fdc-49b3-9ebb-410ed34908a8","attributes":{"locations":{"vancouver":{"total":20}}}}}
{"data":{"type":"stock","id":"2e5a4c7b-6f88-4aad-a3c2-4d8b29bc32a4","attributes":{"locations":{"vancouver":{"total":54},"denver":{"total":1},"boston":{"total":20},"portland":{"total":100}}}}}

Characteristics of Inventories Import​

The Inventories Import API has the following characteristics:

  • The Inventories Import API reads the entire file and then updates the inventory.

  • Inventories imports are asynchronous and are processed one at a time. You can continue to send import requests, but these are queued.

  • If a product in an import does not already exist in the inventories database it will be created.