Stock feed

FOR RETURNS ONLY. Contains stock data (Quantity and Warehouse) on all the goods that are being sold by the retailer.

Used when integrating with our partner ZigZag to manage returns.

It can be integrated via FTP, or via API.

Is interconnected with the retailer's product feed via the Product SKU.

FTP integration

Naming convention: StockDE{timestamp}.csv; StockGB{timestamp}.csv etc. Timestamps supplied in ISO 8601 format. e.g. 2013-10-31T000000Z

Upload frequency: once per day, stock files will be processed after the order and product feeds to ensure products are created before the stock info is uploaded.

Column Name (csv)

Field Name (XML, XLSX)

Example Data

Obligatory

Restrictions

Comments

SKU

<SKU>

30D24LRED

Yes

String, must be a pre- existing SKU

Warehouse DC Code

<WarehouseDCCode>

GB0064

Yes

String, must be a pre- existing DC Code

Available Quantity

<AvailableQuantity>

980

Yes

Integer, max value 2147483647, min value 0

Overwrites the current value

API integration

The purpose of this endpoint is to update stock levels used to identify exchangable products.

PUT https://api.returns.international/Return/api/v1/ExchangeStocks/Update

Example payload:

{
  "retailerCode": "GL123",
  "exchangeStocks": [
    {
      "sku": "VasilTestsss",
      "warehouseDcCode": "DC999",
      "availableQuantity": 100
    }
  ]
}