Stock Status API

The Fruugo StockStatus API is an interface for retailers to allow retailers to enable real-time product stock updates and synchronisation with their own system.

The StockStatus API which allows each product to be updated with real-time requests, but these only relate to stock status and stock quantity. Authentication is handled with HTTP Basic - method. The API doesn't allow the update of other product information such as title or price - these must be controlled by the product feed.

The Stock Status API is in two parts:

  1. Stock Inventory Feed - Allows a GET request which returns a simple XML feed of the retailer's live SKUs on Fruugo to allow you to map the status of the product in your own system. It will provide you with our internal Fruugo Sku Id; retailers Product Id; retailers Sku Id; product title; availability status; and if provided to us it will return the quantity of items in stock.
  2. Stock Inventory Update - Allows a Post request in a simple XML format which prompts our system to update the current stock status of the product. It identifies the product using our internal Fruugo Sku Id, and allows the update of the product availability status, and the quantity of items in stock.

Update Process

The update requests are processed synchronously and subsequent requests for an stock inventory feed will return the updated values.

Replication from Fruugo's master product index to the slaves used by the live site is asynchronous and it may take a few minutes for the update to go live.

Update Logic

In principle the stockstatus API is there to maintain accurate stock levels between product inventory updates to ensure real-time accuracy. The Stockstatus API should only be called and a post request submitted for SKUs which have a change in stock value, and not all SKUs submitted if a change has not been made to their stock levels.

It should be used in one of two ways:

1) An individual SKU update is sent when the stock value of a SKU changes. Alternatively, you could batch these into a group of SKUs which have changed in a short time period, such as 10mins, to avoid multiple individual post requests. Please note: there is a 1000 expression limit per SKU batch update.
2) The stock inventory feed is polled and a comparison is run against the values, and then an update is submitted for the SKUs which have changed.