PUT v1/Products

Update an existing Product.

Request Information

Requires Authorization!

URI Parameters

None.

Body Parameters

The product.

Name	Description	Type	Additional information
SyncProductGroupsOnSave	Set this property to true, to update the ProductGroups collection when saving.	boolean	None.
SyncPropertiesOnSave	Set this property to true, to update the Properties collection when saving.	boolean	None.
OrderComment	Gets or sets the OrderComment.	string	Max length: 2147483647
MainImageChangedTimestamp	Gets the changed timestamp of the Main Image.	date	None.
SyncEnabled	Gets or sets a value indicating whether [synchronize enabled].	boolean	Required
Properties	A collection of translatable Product Properties. Following property codes are system properties which can be used: "Name", "Description", "Published", "DescriptionLong", "MetaTitle", "MetaKeywords", "MetaDescription", "NameTemplate", "DescriptionTemplate", "DescriptionLongTemplate"	Collection of ProductProperty	None.
ShopGroupId	Gets or sets the shop group identifier.	integer	Required
Note	Gets or sets the note.	string	Max length: 2147483647
RefCode	An optional reference for the Product.	string	Max length: 500
ProductBrand	Optionally contains Brand information for the Product.	ProductBrand	None.
ProductVariantParentId	The Id to the ProductVariant parent. The Type of the product should be ProductVariant (2) when used.	integer	None.
VariantInfo	This field contains a summary of the values of the Variation properties. This field is only used when the Type = ProductVariant (2). Eg: 'Black \| XL'	string	Max length: 100
CreationDate	Gets the creation date.	date	Required
KeepStock	Gets or sets a value indicating whether [keep stock].	boolean	Required
IsShippable	Gets or sets a value indicating whether [is shippable]. Note: when a product is not shippable, you can not manage stock for the product.	boolean	Required
MinimumStock	Gets or sets the minimum stock.	decimal number	Required
MainImageFileId	Gets or sets the main image file identifier.	integer	None.
Published	Gets or sets a value indicating whether this is published.	boolean	Required
Weight	Gets or sets the weight.	decimal number	None.
WeightUOMId	Gets or sets the weight uom identifier.	integer	None.
Height	Gets or sets the height.	decimal number	None.
SizeUOMId	Gets or sets the Size (used for length/height/width/diameter) uom identifier.	integer	None.
Length	Gets or sets the length.	decimal number	None.
Width	Gets or sets the width.	decimal number	None.
Diameter	Gets or sets the Diameter.	decimal number	None.
VolumeUOMId	Gets or sets the Volume uom identifier.	integer	None.
Volume	Gets or sets the Volume.	decimal number	None.
PriceExVat	Gets or sets the price ex vat.	decimal number	Required
ProductPropertyDefSetId	Gets or sets the product property definition set identifier.	integer	None.
TransportCategoryId	The Transport Category assigned to the Product.	integer	None.
ProductGroups	Gets or sets the product groups.	Collection of integer	None.
ProductVariantPropertyDefIds	This collection holds the Id's of ProductPropertyDefinitions which are used to create Product Variants for. This collection is only used when the Product is of the Type ProductVariantParent.	Collection of integer	None.
ProductVariantIds	This collection holds the Id's of the (child) Product Variants. This collection is only used when the Product is of the Type ProductVariantParent.	Collection of integer	None.
OriginCountryId	Gets or sets the Country of Origin.	integer	None.
OriginCountryCode	Gets or sets the country code (ISO2) for the Country of Origin.	string	None.
Id	Gets or sets the identifier.	integer	Required
Code	Gets or sets the code.	string	Required Max length: 100
Name	Gets or sets the name.	string	Max length: 400
Hscode	Gets or sets the Harmonized System Code.	string	Max length: 20
EAN	Gets or sets the European Article Number.	string	Max length: 20
Type	The ProductType, available: SimpleProduct = 0, ProductVariantParent = 1, ProductVariant = 2	integer	None.

Request Formats

application/json, text/json

Sample:

{
  "SyncProductGroupsOnSave": true,
  "SyncPropertiesOnSave": true,
  "OrderComment": "sample string 3",
  "MainImageChangedTimestamp": "2021-12-02T20:19:36.1072304+01:00",
  "SyncEnabled": true,
  "Properties": [
    {
      "CultureId": 1,
      "ShopId": 1,
      "ProductPropertyDefId": 1,
      "Code": "sample string 2",
      "Value": "sample string 3"
    },
    {
      "CultureId": 1,
      "ShopId": 1,
      "ProductPropertyDefId": 1,
      "Code": "sample string 2",
      "Value": "sample string 3"
    }
  ],
  "ShopGroupId": 5,
  "Note": "sample string 6",
  "RefCode": "sample string 7",
  "ProductBrand": {
    "Id": 1,
    "Name": "sample string 2",
    "Enabled": true,
    "LogoFileID": 1
  },
  "ProductVariantParentId": 1,
  "VariantInfo": "sample string 8",
  "CreationDate": "2021-12-02T20:19:36.1072304+01:00",
  "KeepStock": true,
  "IsShippable": true,
  "MinimumStock": 12.0,
  "MainImageFileId": 1,
  "Published": true,
  "Weight": 1.0,
  "WeightUOMId": 1,
  "Height": 1.0,
  "SizeUOMId": 1,
  "Length": 1.0,
  "Width": 1.0,
  "Diameter": 1.0,
  "VolumeUOMId": 1,
  "Volume": 1.0,
  "PriceExVat": 14.0,
  "ProductPropertyDefSetId": 1,
  "TransportCategoryId": 1,
  "ProductGroups": [
    1,
    2
  ],
  "ProductVariantPropertyDefIds": [
    1,
    2
  ],
  "ProductVariantIds": [
    1,
    2
  ],
  "OriginCountryId": 1,
  "OriginCountryCode": "sample string 15",
  "Id": 16,
  "Code": "sample string 17",
  "Name": "sample string 18",
  "Hscode": "sample string 19",
  "EAN": "sample string 20",
  "Type": 21
}

application/xml

Sample:

Sample not available.

text/xml

Sample:

Sample not available.

Response Information

Response Codes

OK (200)

Resource Description

The HttpResponseMessage object.

HttpResponseMessage

Name	Type	Additional information
Version	Version	None.
Content	HttpContent	None.
StatusCode	HttpStatusCode	None.
ReasonPhrase	string	None.
Headers	Collection of Object	None.
RequestMessage	HttpRequestMessage	None.
IsSuccessStatusCode	boolean	None.