Skip to main content (Press Enter)
Helcim Logo
Click here if you return to contents

View a Product

This API call let's you retrieve a product. The response is an XML of the product's information.

Request Fields

Field Name Type Required Description
action String Yes productView
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control.
productId Integer Yes (or) You can provide either product ID or product SKU to retrieve a product.
sku String Yes (or) You can provide either product ID or product SKU to retrieve a product.

Response Fields

Field Name Type Description
products - XML structure
product - XML structure
id Integer The product ID.
name String The product name.
sku String The product SKU.
brand - XML structure
id Integer The brand ID.
name String The brand name.
category - XML structure
id Integer The category ID.
name String The category name.
description String The product description.
barcode String The product bar code.
availability Integer 1 or 0 - Whether the product is available for sale.
availabilityOnline Integer 1 or 0 - Whether the product is available for sale online.
featured Integer 1 or 0 - Whether the product is featured (front page) item online.
stock Integer The number of items in stock.
price Decimal The product price.
salePrice Decimal The product sale price.
weight Decimal The product weight - based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionW Decimal The product width- based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionL Decimal The product length - based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionH Decimal The product height - based on Helcim Commerce Unit of Measurement (UoM) account settings.
shippingExempt Integer 1 or 0 - Whether the product is exempt from shipping fees.
taxExempt Integer 1 or 0 - Whether the product is exempt from taxes.
pictures - XML structure - Pictures are ordered with the primary picture set as the first one.
picture - XML structure
main String The URL location of the full-size picture (1200px)
thumb String The URL location of the small-size picture (500px)
small String The URL location of the thumbnail-size picture (120px)

Errors

For all API requests, there are also generic API authentication and user access restriction errors.

Response Code Error Code Message Description
0 - Invalid Product ID The product ID you provided could not be found.
0 - Invalid Product SKU The product SKU you provided could not be found.
0 - Invalid API Token1 The API Token is invalid, or not entered.
0 - Missing or Invalid Fields - Account ID The Account ID is invalid, or not entered.

Related Articles

Add or Edit a Product
Update Product Inventory
List Products
View a Category
List Categories
View a Brand
List Brands

Was this article helpful?

Feedback submitted - Thank you!
Click here if you return to the content