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 | 30D24LRED | Yes | String, must be a pre- existing SKU | ||
Warehouse DC Code | GB0064 | Yes | String, must be a pre- existing DC Code | ||
Available Quantity | 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
}
]
}