Stock Inventory Feed

The API works over HTTPS and follows REST semantics. Authentication is handled with HTTP Basic - method. The credentials used are those which are set-up for the account to access the Fruugo Retailer Portal.

Stock Inventory Feed

The 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.

URLhttps://www.fruugo.com/stockstatus-api
HTTP MethodGET
Returns

Product XML of the retailer's Skus and availability held on Fruugo, MIME type "application/XML"

Note: There is a 30,000 SKU limit on the single inventory XML. Accounts exceeding 30,000 SKU must use paging mode.

Stock Inventory Specification

The sku (<sku>) element contains three Ids and the following expected values:

NameFormatDescription
fruugoSkuIdLong IntegerFruugo's internal Id for the sku.
merchantProductIdStringThe Product Id provided in the retailer's product data feed.
merchantSkuIdStringThe Sku Id provided in the retailer's product data feed.
nameStringThe product title provided in the retailer's product data feed.
availabilityStringValid values for the availability element are the same as in the product data feed specification:
INSTOCK - If you have the product currently in stock.
OUTOFSTOCK - The product is currently out of stock but may return.
NOTAVAILABLE - The product is permanently out of stock and needs to be removed.
itemsInStockIntegerThe quantity of stock held by the retailer.^

^Only included if the information about the quantity held by the retailer is provided in the product data feed, and therefore exists in Fruugo's product database.

Stock Inventory Paging

If you have in-excess of 30,000 SKUs paging mode must be used to call the inventory feed. Each page will return an XML feed with 1000 SKUs.

URLhttps://www.fruugo.com/stockstatus-api
HTTP MethodGET
Returns

Product XML of the retailer's Skus and availability held on Fruugo, MIME type "application/XML"

Parameter

NameMandatoryDescription
pageYes^Paging is zero based. Add 0 as a parameter to begin paging mode.

^ For accounts with in-excess of 30,000 SKUs.

Root Element

The root element of the XML feed returned will change in paging mode to give additional information which indicates the total number of SKUs, number of pages, SKUs per page and the current page. See example below:

<skus totalNumberOfSkus="203746" numberOfPages="204.0" skusPerPage="1000" currentPage="0">