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

Add or Edit a Product

This API call let's you add or edit a product. The response is an XML of adding/editing a product.

Request Fields

Field Name Type Required Description
action String Yes productEdit
accountId Integer Yes The Helcim Commerce account ID.
apiToken String Yes API token used for authentication and access control.
name String Yes The product name.
productId Integer No If you do not enter a product ID, you will add a product. If you do enter a product ID, you will edit an existing product.
categoryId Integer No The category ID.
brandId Integer No The brand ID.
description String No The product description.
sku Integer No The product sku.
barcode String No The product barcode.
availability Integer No 1 or 0 - Whether the product is available for sale.
availabilityOnline Integer No 1 or 0 - Whether the product is available for sale online.
featured Integer No 1 or 0 - Whether the product is featured (front page) item online.
price Decimal No The product price.
salePrice Decimal No The product sale price.
weight Decimal No The product weight - based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionW Decimal No The product width- based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionL Decimal No The product length - based on Helcim Commerce Unit of Measurement (UoM) account settings.
dimensionH Decimal No The product height - based on Helcim Commerce Unit of Measurement (UoM) account settings.
shippingExempt Integer No 1 or 0 - Whether the product is exempt from shipping fees.
taxExempt Integer No 1 or 0 - Whether the product is exempt from taxes.
unitOfMeasure String No The unit of measurement.
commodityCode String No The commodity code.
seoURL String No The SEO URL location.
seoDescription String No The SEO description.
seoTags String No The SEO tags.

Response Fields

Field Name Type Description
message - XML structure
response Integer 1 or 0. Whether the product was added/edited or not.
responseMessage String Confirmation of completed inventory update.
product - XML structure
id Integer The product ID.
name String The product name.
sku Integer The product sku.
stock Integer The available units of the product.
price Decimal The product price.
salePrice Decimal The product sale price.
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.

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 - Product Limit Reached Cannot add a new product.
0 - Missing Field - Product Name The product name is missing.
0 - SKU Already Used by Another Product SKU code is already being used for another product.
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

View 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