GET api/SKUs/SpecificSKUCode/{id}
Retrieves a certain SKU. There may be multiple records if this SKU is linked to multiple Trade Customers.
Request Information
URI Parameters
Name | Description | Type | Additional information |
---|---|---|---|
id |
The SKU code |
string |
Required |
Body Parameters
None.
Response Information
Resource Description
Collection of EskimoClassLibraries.clsSKUName | Description | Type | Additional information |
---|---|---|---|
eskimo_product_identifier | string |
Required |
|
trade_customer_id |
Eskimo Customer ID - See the Customer Controller. If this product is specifically for a trade customer, then this property denotes which customer it is for. If it is a generic product then this will be zero-length string. |
string |
Matching regular expression pattern: \d{3}[-]\d{6} String length: inclusive between 10 and 10 |
sku_code |
This is the barcode or PLU number. In a retail shop, this will be the code that the operator will scan into the till at POS. This can either be a code that exclusively represents that product worldwide, or it could be a unique code for that retailer only - one that they have assigned to the product. |
string |
Required String length: inclusive between 0 and 35 |
additional_sku_code |
Optional. An additional barcode. Supplier's EAN perhaps. |
string |
String length: inclusive between 0 and 35 |
Style_Reference |
On top of the sku code, Eskimo uses a Style Reference code to group SKUs together of a similar type. For example, you may have a jumper that comes in 3 colours and 3 sizes. All 9 of the SKUs will share the same Style Reference code (JUM-01 for example) but they will also have unique sku codes. This field should have the same value as the style_reference property on the Products controller for the same product. |
string |
String length: inclusive between 0 and 20 |
ColourID |
The Eskimo Colour code. (i.e. BK) |
string |
String length: inclusive between 0 and 6 |
ColourName |
The name of the colour (i.e. Black) |
string |
String length: inclusive between 0 and 50 |
Size |
The size of the product (i.e. Small or 23") |
string |
String length: inclusive between 0 and 50 |
CostPrice |
The price that the retailer pays to obtain the product |
decimal number |
Required |
RRP |
Optional. The Supplier's Recommended Retail Selling price of the item. Where this is higher than the 'Sell Price', a 'saving' can be advertised to the end-user. |
decimal number |
None. |
SellPrice |
The sell price to be used on the website |
decimal number |
Required |
SellPrice2 |
A secondary sell price which can sometimes be used on the website, usually as a trade price |
decimal number |
Required |
PhysicalStock |
The Physical amount of stock the retailer has for this item |
integer |
None. |
Demand |
Customer demand for this item. Orders that customer's have placed which are yet be dispatched to them. |
integer |
None. |
StockAmount |
The quantity of items the retailer has on hand to sell in the current shop. Free stock. (Physical Stock minus Demand) |
integer |
Required |
TaxCodeID |
The Eskimo Tax Code ID. Links to the TaxCodes controller. |
integer |
Required |
PersonalisationPrompt |
If this product is personalisable (i.e. printed t-shirts or engraved trophies) then this text denotes the prompt to the purchaser (i.e. Please enter the name to be engraved.) |
string |
String length: inclusive between 0 and 50 |
PersonalisationSurCharge |
Some products have the option of being personalised for a extra fee. This field denotes that fee. |
decimal number |
None. |
Position |
The order in which these should be displayed in the GUI to the end user |
integer |
None. |
web_id |
This is the Primary Key that the website is using for this SKU. Note this is unique per product - so they same SKU may be in two different products and will therefore have a different Web ID assigned. Call the UpdateCartIDs method to set these values |
string |
None. |
OutOfStockBehaviour |
Specified the desired behaviour when the product is out of stock |
EskimoClassLibraries.clsSKU+OutOfStockBehaviourEnum |
None. |
WeightValue |
The value of the weight of this SKU. |
decimal number |
None. |
WeightUnit |
The weight unit. For example kg, lbs, grams. See GET api/MeasureUnits/All |
integer |
None. |
BrandId |
The Id of the Brand |
integer |
None. |
BrandName |
The name of the brand if applicable (i.e. Nike, Adidas) |
string |
None. |
PackageStatus |
Controls whether the SKU should be sold as a normal SKU, or only be used within a Product Package/Kit |
EskimoClassLibraries.clsSKU+PackageStatusEnum |
None. |
CustomAttributeLinks | Collection of EskimoClassLibraries.clsSKUAttributeLink |
None. |
|
AddField01 |
An additional string field for this product. The retailer can use this for whatever purpose they need. |
string |
String length: inclusive between 0 and 30 |
AddField02 |
An additional string field for this product. The retailer can use this for whatever purpose they need. |
string |
String length: inclusive between 0 and 50 |
AddField03 |
An additional string field for this product. The retailer can use this for whatever purpose they need. |
string |
String length: inclusive between 0 and 4000 |
AddField04 |
An additional key/value pair field for this product. The retailer can use this for whatever purpose they need. |
Pair of integer [key] and string [value] |
None. |
AddField05 |
An additional key/value pair field for this product. The retailer can use this for whatever purpose they need. |
Pair of integer [key] and string [value] |
None. |
AddField06 |
An additional boolean field for this product. The retailer can use this for whatever purpose they need. |
boolean |
None. |
AddField15 |
An additional boolean field for this product. The retailer can use this for whatever purpose they need. |
boolean |
None. |
Response Formats
application/json, text/json
[ { "eskimo_product_identifier": "sample string 1", "trade_customer_id": "sample string 2", "sku_code": "sample string 3", "additional_sku_code": "sample string 4", "Style_Reference": "sample string 5", "ColourID": "sample string 6", "ColourName": "sample string 7", "Size": "sample string 8", "CostPrice": 9.0, "RRP": 1.0, "SellPrice": 10.0, "SellPrice2": 11.0, "PhysicalStock": 12, "Demand": 13, "StockAmount": 14, "TaxCodeID": 15, "PersonalisationPrompt": "sample string 16", "PersonalisationSurCharge": 17.0, "Position": 18, "web_id": "sample string 19", "OutOfStockBehaviour": 1, "WeightValue": 20.0, "WeightUnit": 21, "BrandId": 1, "BrandName": "sample string 22", "PackageStatus": 0, "CustomAttributeLinks": [ { "Id": 1, "AttributeValueId": 2, "AttributeId": 3, "Active": true }, { "Id": 1, "AttributeValueId": 2, "AttributeId": 3, "Active": true } ], "AddField01": "sample string 23", "AddField02": "sample string 24", "AddField03": "sample string 25", "AddField04": { "Key": 1, "Value": "sample string 2" }, "AddField05": { "Key": 1, "Value": "sample string 2" }, "AddField06": true, "AddField15": true }, { "eskimo_product_identifier": "sample string 1", "trade_customer_id": "sample string 2", "sku_code": "sample string 3", "additional_sku_code": "sample string 4", "Style_Reference": "sample string 5", "ColourID": "sample string 6", "ColourName": "sample string 7", "Size": "sample string 8", "CostPrice": 9.0, "RRP": 1.0, "SellPrice": 10.0, "SellPrice2": 11.0, "PhysicalStock": 12, "Demand": 13, "StockAmount": 14, "TaxCodeID": 15, "PersonalisationPrompt": "sample string 16", "PersonalisationSurCharge": 17.0, "Position": 18, "web_id": "sample string 19", "OutOfStockBehaviour": 1, "WeightValue": 20.0, "WeightUnit": 21, "BrandId": 1, "BrandName": "sample string 22", "PackageStatus": 0, "CustomAttributeLinks": [ { "Id": 1, "AttributeValueId": 2, "AttributeId": 3, "Active": true }, { "Id": 1, "AttributeValueId": 2, "AttributeId": 3, "Active": true } ], "AddField01": "sample string 23", "AddField02": "sample string 24", "AddField03": "sample string 25", "AddField04": { "Key": 1, "Value": "sample string 2" }, "AddField05": { "Key": 1, "Value": "sample string 2" }, "AddField06": true, "AddField15": true } ]
application/xml, text/xml
<ArrayOfclsSKU xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/EskimoClassLibraries"> <clsSKU> <AddField01>sample string 23</AddField01> <AddField02>sample string 24</AddField02> <AddField03>sample string 25</AddField03> <AddField04 xmlns:d3p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic"> <d3p1:key>1</d3p1:key> <d3p1:value>sample string 2</d3p1:value> </AddField04> <AddField05 xmlns:d3p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic"> <d3p1:key>1</d3p1:key> <d3p1:value>sample string 2</d3p1:value> </AddField05> <AddField06>true</AddField06> <AddField15>true</AddField15> <BrandId>1</BrandId> <BrandName>sample string 22</BrandName> <ColourID>sample string 6</ColourID> <ColourName>sample string 7</ColourName> <CostPrice>9</CostPrice> <CustomAttributeLinks> <clsSKUAttributeLink> <Active>true</Active> <AttributeId>3</AttributeId> <AttributeValueId>2</AttributeValueId> <Id>1</Id> </clsSKUAttributeLink> <clsSKUAttributeLink> <Active>true</Active> <AttributeId>3</AttributeId> <AttributeValueId>2</AttributeValueId> <Id>1</Id> </clsSKUAttributeLink> </CustomAttributeLinks> <Demand>13</Demand> <OutOfStockBehaviour>NoPurchaseAllowed</OutOfStockBehaviour> <PackageStatus>NormalOrPackageComponent</PackageStatus> <PersonalisationPrompt>sample string 16</PersonalisationPrompt> <PersonalisationSurCharge>17</PersonalisationSurCharge> <PhysicalStock>12</PhysicalStock> <Position>18</Position> <RRP>1</RRP> <SellPrice>10</SellPrice> <SellPrice2>11</SellPrice2> <Size>sample string 8</Size> <StockAmount>14</StockAmount> <Style_Reference>sample string 5</Style_Reference> <TaxCodeID>15</TaxCodeID> <WeightUnit>21</WeightUnit> <WeightValue>20</WeightValue> <additional_sku_code>sample string 4</additional_sku_code> <eskimo_product_identifier>sample string 1</eskimo_product_identifier> <sku_code>sample string 3</sku_code> <trade_customer_id>sample string 2</trade_customer_id> <web_id>sample string 19</web_id> </clsSKU> <clsSKU> <AddField01>sample string 23</AddField01> <AddField02>sample string 24</AddField02> <AddField03>sample string 25</AddField03> <AddField04 xmlns:d3p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic"> <d3p1:key>1</d3p1:key> <d3p1:value>sample string 2</d3p1:value> </AddField04> <AddField05 xmlns:d3p1="http://schemas.datacontract.org/2004/07/System.Collections.Generic"> <d3p1:key>1</d3p1:key> <d3p1:value>sample string 2</d3p1:value> </AddField05> <AddField06>true</AddField06> <AddField15>true</AddField15> <BrandId>1</BrandId> <BrandName>sample string 22</BrandName> <ColourID>sample string 6</ColourID> <ColourName>sample string 7</ColourName> <CostPrice>9</CostPrice> <CustomAttributeLinks> <clsSKUAttributeLink> <Active>true</Active> <AttributeId>3</AttributeId> <AttributeValueId>2</AttributeValueId> <Id>1</Id> </clsSKUAttributeLink> <clsSKUAttributeLink> <Active>true</Active> <AttributeId>3</AttributeId> <AttributeValueId>2</AttributeValueId> <Id>1</Id> </clsSKUAttributeLink> </CustomAttributeLinks> <Demand>13</Demand> <OutOfStockBehaviour>NoPurchaseAllowed</OutOfStockBehaviour> <PackageStatus>NormalOrPackageComponent</PackageStatus> <PersonalisationPrompt>sample string 16</PersonalisationPrompt> <PersonalisationSurCharge>17</PersonalisationSurCharge> <PhysicalStock>12</PhysicalStock> <Position>18</Position> <RRP>1</RRP> <SellPrice>10</SellPrice> <SellPrice2>11</SellPrice2> <Size>sample string 8</Size> <StockAmount>14</StockAmount> <Style_Reference>sample string 5</Style_Reference> <TaxCodeID>15</TaxCodeID> <WeightUnit>21</WeightUnit> <WeightValue>20</WeightValue> <additional_sku_code>sample string 4</additional_sku_code> <eskimo_product_identifier>sample string 1</eskimo_product_identifier> <sku_code>sample string 3</sku_code> <trade_customer_id>sample string 2</trade_customer_id> <web_id>sample string 19</web_id> </clsSKU> </ArrayOfclsSKU>