• Pages
  • /
  • Dealers
  • /
  • Data Depot
  • /
  • Version 4
  • /
  • API
  • /
  • Services
  • /
  • Items

Items

Items are the building blocks of a Product; they are simplest form of a Product and refer to one individual variant (specific configuration) or SKU of a Product.

For example:

The FLY Patrol Jersey is a Product, whereas the SKU:370-6402X 2X-Large Black/Grey FLY Patrol Jersey is an Item.

Products Items
FLY Patrol Jersey

370-640S → Small → Black/Grey → FLY Patrol Jersey

370-640M → Medium → Black/Grey → FLY Patrol Jersey

370-640L → Large → Black/Grey → FLY Patrol Jersey

370-640X → X-Large → Black/Grey → FLY Patrol Jersey

370-6402X → 2X-Large → Black/Grey → FLY Patrol Jersey

...
FLY Trekker Helmet

73-1010XS → X-Small → Gloss Black → Trekker Helmet

73-1010S → Small → Gloss Black → Trekker Helmet

73-1010M → Medium → Gloss Black → Trekker Helmet

...

73-1014XS → X-Small → Hi-Vis Yellow → Trekker Helmet

73-1014S → Small → Hi-Vis Yellow → Trekker Helmet

73-1014M → Medium → Hi-Vis Yellow → Trekker Helmet

...

Example requests

Collection

http://api.wps-inc.com/items

Entity

http://api.wps-inc.com/items/216584

...or send multiple ids separated by a comma(,)

http://api.wps-inc.com/items/216584,22864,72757,220510

Associated Attributevalues

http://api.wps-inc.com/items/216584/attributevalues

Parent Country

http://api.wps-inc.com/items/216584/country

Associated Images

http://api.wps-inc.com/items/216584/images

Parent Product

http://api.wps-inc.com/items/216584/product

Associated Quantities

http://api.wps-inc.com/items/216584/quantities

Associated Tags

http://api.wps-inc.com/items/216584/tags

Associated Taxonomyterms

http://api.wps-inc.com/items/507431/taxonomyterms

Associated Vehicles

http://api.wps-inc.com/items/81897/vehicles

Item Inventory

http://api.wps-inc.com/items?filter[sku]=72-7044L&include=quantities

...or even better would be target the exact Item by using a crutch...

http://api.wps-inc.com/items/crutch/72-7044L?include=quantities

This will give you an specific entity response instead of a collection with one result.

...or even better would be to include each Quantity records associated Warehouse like so...

http://api.wps-inc.com/items/crutch/72-7044L?include=quantities.warehouse

...or even better would be to clean up the response by specifying exactly which fields you care about like so...

http://api.wps-inc.com /items/crutch/72-7044L?include=quantities.warehouse&fields[items]=sku&fields[quantities]=obtainable&fields[warehouses]=name

Now you have all the inventory levels of all Warehouses for one particular Item in one request.