Create variant group (product)

Create a new variant group for the provided product id.

Path Parameters
productId string — REQUIRED The id of the product for which to create the variant group.

Query Parameters
productIdType int32 Possible values: [0, 1, 2, 3] The type of product id supplied. 0 = Internal. Internal product id set by Geins. Eg: 10001. 1 = ArticleNumber. Article number set by customer. Eg: ABC123. 2 = MarketPrefixedInternal. Internal product id set by Geins, prefixed with market. Eg: SE10001. 3 = MarketPrefixedArticleNumber. Article number set by customer, prefixed with market. Eg: SEABC123.
include string Comma separated list of product child collections to also include with the variant group. Set to empty string to only include basic product data or null to not include any product data. Valid options: Names, ShortTexts, LongTexts, TechTexts, Items, Prices, Categories, Parameters, Variants, Markets, Images, Feeds, Urls, ShippingFees, RelatedProducts, DiscountCampaigns

Request Body — REQUIRED The settings for the new group.
Name string The optional internal name of the variant group.
CollapseInLists boolean A setting to control the display behaviour in product listings of variants belonging to this group.
VariantLabels string[] The labels of the variant data that this group keeps track of.
Products object[] Products to be created and connected to the group. ArticleNumber string The article number of the product. Names object[] The localized names of the product. LanguageCode string The 2-letter ISO 639-1 language code for this locale. Content string The localized content. Active boolean The current state of the product. PurchasePrice double The purchase price in the currency defined in PurchasePriceCurrency. PurchasePriceCurrency string The 3-letter ISO 4217 currency code for the amount given in PurchasePrice. ShortTexts object[] Localized short texts for the product. LanguageCode string The 2-letter ISO 639-1 language code for this locale. Content string The localized content. LongTexts object[] Localized long texts for the product. LanguageCode string The 2-letter ISO 639-1 language code for this locale. Content string The localized content. TechTexts object[] Localized tech texts for the product. LanguageCode string The 2-letter ISO 639-1 language code for this locale. Content string The localized content. BrandId int32 The brand of the product. MaxDiscountPercentage int32 Maximum discount percentage for the product. SupplierId int32 The supplier id of the product. Items object[] The items belonging to the product. Only valid for product creation. ItemId int32 Id of the product item. ArticleNumber string The article number for the product item. Name string The name of the product item. Shelf string The shelf name where the product item can be found. Weight int32 The weight of the item in grams (g). Length int32 The length of the item in millimeters (mm). Width int32 The width of the item in millimeters (mm). Height int32 The height of the item in millimeters (mm). Gtin string The GTIN number for the item. Also known as EAN, UCC or UPS number. Active boolean The current state of the item. ExternalId string External Id of the product item. DateIncoming date-time The date the item will be in stock again. CategoryIds int32[] The category ids the product belongs to. ParameterValues object[] The parameter values associated with the product. Only valid for product creation. ProductId int32 The product id of the parameter. This value can be omitted if the value is part of a product request. ParameterId int32 The unique identifier of the parameter that this value belongs to. Value string The identifying value of the parameter. Although always presented as a string, the data within Value must validate against the ProductParameterType of the parameter: String = Any string. Float = Any floating point number. DateTime = Any date. Multi = Any predefined value id from the predefined set of values for this parameter. Single = Any predefined value id from the predefined set of values for this parameter. Headline = Any string. Tags = Any string, as part of a pipe-separated list. A string containing the pipe (|) character is not allowed. LocalizedDescriptions object[] The localized descriptions of the parameter. Only used for parameter types String or Headline. For Multi and Single, use LocalizedNames. LanguageCode string The 2-letter ISO 639-1 language code for this locale. Content string The localized content. Variants object[] The variants for this product. Label string The name of the variant, eg "Color", "Weight" etc. Value string The value of this variant, eg "Blue", "250g" etc. Markets object[] The markets for this product. Id int32 Market id. Name string Market Name. DisplayName string Market display name. Currency string Default currency iso code of the market. VatRate double Default VAT Rate of the market. MarketPrefix string Market prefix. Usually the top level domain of the market. CountryId int32 Default country Id of the market. CurrencyId int32 Default currency Id of the market. CurrencyRate double Currency rate of the default currency. LanguageId int32 Default language Id of the market. Language string Default language iso code of the market. Languages object[] All languages of the market. LanguageId int32 Language id. Name string Language Name Code string ISO code of the language. Countries object[] All countries of the market. CountryId int32 Country id. Name string Country Name Code string ISO code of the country. VatRate double VAT Rate of the country. CurrencyId int32 Currency id of the country. Currencies object[] All currencies of the market. Name string Currency Name. Code string Iso code of the currency. CurrencyId int32 Currency id. CurrencyRate double Currency rate. FreightClassId int32 Id of freight class. IntrastatCode string Intrastat code of the product. CountryOfOrigin string Country of orgin of product. VariantGroupId int32 Id of Variant Group to whom the product should be associated. Vat int32 ID or rate of VAT (On create and if no VAT is provided then default VAT will be used). VatType string Defines how VAT parameter should be interpreted. Actual = VAT parameter is interpreted as VAT rate. VatId = VAT parameter is interpreted as VAT Id. ExternalId string External id of the product. ActivationDate date-time Activation date for the product. Weight int32 The weight of the product in grams (g). Can also be set on product item level. Length int32 The length of the Product in millimeters (mm). Can also be set on product item level. Width int32 The width of the product in millimeters (mm). Can also be set on product item level. Height int32 The height of the product in millimeters (mm). Can also be set on product item level. SortOrder object Custom sort values for a product. Custom1 int32 Custom sort value 1. Custom2 int32 Custom sort value 2. Custom3 int32 Custom sort value 3. Custom4 int32 Custom sort value 4. Custom5 int32 Custom sort value 5.

Responses

200 The created variant group. Schema — OPTIONAL Resource object — OPTIONAL A variant group for a collection of related variants. GroupId int32 — OPTIONAL The id of variant goup. Name string — OPTIONAL The optional internal name of the variant group. CollapseInLists boolean — OPTIONAL Determine visibility of non-main products of this group in lists. MainProductId int32 — OPTIONAL The main product of this group. If the group is collapsed in lists, this will be the only visible product. ProductIds int32[] — OPTIONAL The product ids of the variants that belong to this group. Products object[] — OPTIONAL Products belonging to the Variant group. Only included when parameter "include" is supplied in the query string. ProductId int32 — OPTIONAL The unique identifier for the product. ArticleNumber string — OPTIONAL The article number of the product. Names object[] — OPTIONAL The localized names of the product. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. DateCreated date-time — OPTIONAL The date the product was created. DateUpdated date-time — OPTIONAL The date the product was last updated. DateFirstAvailable date-time — OPTIONAL The date the product was first available. MaxDiscountPercentage int32 — OPTIONAL Maximum discount percentage for the product. Active boolean — OPTIONAL The current state of the product. PurchasePrice double — OPTIONAL The purchase price in the currency defined in PurchasePriceCurrency. PurchasePriceCurrency string — OPTIONAL The 3-letter ISO 4217 currency code for the amount given in PurchasePrice. ShortTexts object[] — OPTIONAL Localized short texts for the product. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. LongTexts object[] — OPTIONAL Localized long texts for the product. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. TechTexts object[] — OPTIONAL Localized tech texts for the product. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. Items object[] — OPTIONAL The items belonging to the product. ItemId int32 — OPTIONAL The product item id. ArticleNumber string — OPTIONAL The article number for the product item. ProductId int32 — OPTIONAL The id of the product that the item belongs to. Name string — OPTIONAL The name of the product item. Shelf string — OPTIONAL The shelf name where the product item can be found. Weight int32 — OPTIONAL The weight of the item in grams (g). Length int32 — OPTIONAL The length of the item in millimeters (mm). Width int32 — OPTIONAL The width of the item in millimeters (mm). Height int32 — OPTIONAL The height of the item in millimeters (mm). Gtin string — OPTIONAL The GTIN number for the item. Also known as EAN, UCC or UPS number. DateCreated date-time — OPTIONAL The date the item was created. DateUpdated date-time — OPTIONAL The date the item was last updated. DateIncoming date-time — OPTIONAL The date the item will be in stock again. Active boolean — OPTIONAL The current state of the item. ExternalId string — OPTIONAL External Id of the product item. Stock object — OPTIONAL A stock value for a product item ItemId int32 — OPTIONAL A value to uniquely identity a single product item. Stock int32 — OPTIONAL The physical stock value. StockOversellable int32 — OPTIONAL The oversellable stock value. StockStatic int32 — OPTIONAL The static stock value. StockSellable int32 — OPTIONAL The sellable stock value. ShippingFees object[] — OPTIONAL The lowest shipping fees for each market and country for the product item. Market int32 — OPTIONAL The market that the shipping fee is applicable on. Country string — OPTIONAL The country that the shipping fee is applicable in. Service string — OPTIONAL The shipping service with the current fee. ServiceId int32 — OPTIONAL The shipping service id with the current fee. Fee double — OPTIONAL The shipping fee. Prices object[] — OPTIONAL The current prices of the product. ProductId int32 — OPTIONAL The id of the product that this price applies to. PriceListId int32 — OPTIONAL The id of the price list that this price is associated with. PriceListName string — OPTIONAL The name of the price list that this price is associated with. PriceIncVat double — OPTIONAL The price, inc VAT, in the currency of the associated price list. PriceExVat double — OPTIONAL The price, ex VAT, in the currency of the associated price list. VatRate double — OPTIONAL The VAT Rate. Country string — OPTIONAL The 2-letter ISO country code for this price. Currency string — OPTIONAL The 3-letter ISO 4217 currency code for this price. StaggeredCount int32 — OPTIONAL Staggered count for this price. Defaults to 1. This field is ignored for prices on default (Ordinary, Sale and Campaign) price lists. ValidFrom date-time — OPTIONAL The date the price is valid from. No start boundary if null. ValidTo date-time — OPTIONAL The date the price is valid to. No end boundary if null. Categories object[] — OPTIONAL The categories the product belongs to. CategoryId int32 — OPTIONAL The id of the category. ParentCategoryId int32 — OPTIONAL The id of the parent category for the category. Names object[] — OPTIONAL The localizable names of the category. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. Descriptions object[] — OPTIONAL The localized descriptions of the category. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. GoogleCategoryPath string — OPTIONAL The Google Taxonomy category path for the category, if any. Hidden boolean — OPTIONAL Indicates if the category should be hidden from menus, filters etc. Active boolean — OPTIONAL True if the category is active for use. Images object[] — OPTIONAL The images for the product ProductId int32 — OPTIONAL Url string — OPTIONAL Url of Image. Order int32 — OPTIONAL Order of image (ascending). First image is the main image for the product. Tags string[] — OPTIONAL The tags associated with this image. BrandId int32 — OPTIONAL The brand id of the product. BrandName string — OPTIONAL The brand name of the product. SupplierId int32 — OPTIONAL The supplier id of the product. SupplierName string — OPTIONAL The supplier name of the product. ParameterValues object[] — OPTIONAL The parameter values associated with the product. ParameterValueId int32 — OPTIONAL The unique identifier of this parameter value. ProductId int32 — OPTIONAL The product id of the parameter. ParameterId int32 — OPTIONAL The unique identifier of the parameter that this value belongs to. ParameterName string — OPTIONAL The non-localized name of the parameter. GroupId int32 — OPTIONAL The unique identifier of the group that this parameter belongs to. GroupName string — OPTIONAL The name of the group that this parameter belongs to. ParameterType int32 — OPTIONAL Possible values: [1, 2, 3, 4, 5, 6, 7] The type of parameter. The Value field must validate against this type. 1 = String. Any string value. 2 = Float. Any floating point number. Period as decimal separator and no thousands separator. Eg: 10001.789. 3 = DateTime. Any ISO 8601 date. Eg: 2017-03-06T16:31:24+02:00. 4 = Multi. A string value from a predefined set of values. This type may occur multiple times for the same parameter. 5 = Single. A string value from a predefined set of values. 6 = Headline. A string value used mainly for grouping in layout. 7 = Tags. A pipe-separated list of product specific values. Eg: red|green|blue. Value string — OPTIONAL The identifying value of the parameter. Although always presented as a string, the data within Value must validate against the type of the parameter: String = Any string. Float = Any floating point number. DateTime = Any date. Multi = Any predefined value id from the predefined set of values for this parameter. Single = Any predefined value id from the predefined set of values for this parameter. Headline = Any string. Description string — OPTIONAL The non-localized description of the parameter. This is usually the same value as Value for all parameter types, except Single Multi. LocalizedDescriptions object[] — OPTIONAL The localized descriptions of the parameter. Not used for parameter types Float or DateTime. LanguageCode string — OPTIONAL The 2-letter ISO 639-1 language code for this locale. Content string — OPTIONAL The localized content. InternalIdentifier string — OPTIONAL The internal identifier of the parameter. Order string — OPTIONAL Value indicating order of the parameter value. The value takes the order of the parameter into account. Formula: (ParameterOrder * 10000) + ParameterValueOrder. Variants object[] — OPTIONAL The variants for this product. ProductId int32 — OPTIONAL The id of the product this variant information belongs to. GroupId int32 — OPTIONAL The id of the group this variant belongs to. Label string — OPTIONAL The name of the variant information, eg "Weight", "Length" etc. Value string — OPTIONAL The value of the variant information, eg "250g", "89cm" etc. Markets object[] — OPTIONAL The markets for this product Id int32 — OPTIONAL Market id. Name string — OPTIONAL Market Name. DisplayName string — OPTIONAL Market display name. Currency string — OPTIONAL Default currency iso code of the market. VatRate double — OPTIONAL Default VAT Rate of the market. MarketPrefix string — OPTIONAL Market prefix. Usually the top level domain of the market. CountryId int32 — OPTIONAL Default country Id of the market. CurrencyId int32 — OPTIONAL Default currency Id of the market. CurrencyRate double — OPTIONAL Currency rate of the default currency. LanguageId int32 — OPTIONAL Default language Id of the market. Language string — OPTIONAL Default language iso code of the market. Languages object[] — OPTIONAL All languages of the market. LanguageId int32 — OPTIONAL Language id. Name string — OPTIONAL Language Name Code string — OPTIONAL ISO code of the language. Countries object[] — OPTIONAL All countries of the market. CountryId int32 — OPTIONAL Country id. Name string — OPTIONAL Country Name Code string — OPTIONAL ISO code of the country. VatRate double — OPTIONAL VAT Rate of the country. CurrencyId int32 — OPTIONAL Currency id of the country. Currencies object[] — OPTIONAL All currencies of the market. Name string — OPTIONAL Currency Name. Code string — OPTIONAL Iso code of the currency. CurrencyId int32 — OPTIONAL Currency id. CurrencyRate double — OPTIONAL Currency rate. Vat double — OPTIONAL The vat percent for this product. Eg) 0.25 meaning 25% VAT. PrimaryImage string — OPTIONAL The filename of this products primary image. FreightClassId int32 — OPTIONAL Id of freight class. IntrastatCode string — OPTIONAL Intrastat code of the product. CountryOfOrigin string — OPTIONAL Country of orgin of product. VariantGroupId int32 — OPTIONAL Id of Variant Group to which the product is associated. VatId int32 — OPTIONAL Id of VAT. ExternalId string — OPTIONAL External Id of the product. ActivationDate date-time — OPTIONAL Activation date for the product. Feeds object[] — OPTIONAL The feeds the product is a member of. FeedId int32 — OPTIONAL The feed id. AllowSale boolean — OPTIONAL True if the feed is allowed to display the sale price of the product. Urls object[] — OPTIONAL All canonical urls for the product. Url string — OPTIONAL The canonical url to the product. Market int32 — OPTIONAL The market of the url. Countries string[] — OPTIONAL The countries or regions of the url. Language string — OPTIONAL The language code of the url. MainCategoryId int32 — OPTIONAL The main category id for the product. RelatedProducts object[] — OPTIONAL The related products for the product. ProductId int32 — OPTIONAL The unique identifier for the product. RelatedProductId int32 — OPTIONAL The unique identifier for the related product. RelationTypeId int32 — OPTIONAL The product relation type id. DiscountCampaigns object[] — OPTIONAL The discount campaigns for the product. CampaignId uuid — OPTIONAL Id of Campaign. CampaignName string — OPTIONAL Name of Campaign. Title string — OPTIONAL Title that can be displayed for the product. HideTitle boolean — OPTIONAL Indicates if the title should be displayed. RuleType string — OPTIONAL Type of discount rule. I.e. Percentage. Category string — OPTIONAL Campaign Category. Cart, PromoCode or Product. Enabled boolean — OPTIONAL true if campaign is enabled. ValidFrom date-time — OPTIONAL Valid from. ValidTo date-time — OPTIONAL Valid to. Markets string — OPTIONAL List of markets where the campaign is available in fthe format {domain|marketId}. LowestPrice object[] — OPTIONAL Contains information about the lowest price during last 30 days and the legal comparison price (EU). LowestPrice double — OPTIONAL ComparisonPrice double — OPTIONAL MarketId int32 — OPTIONAL Currency string — OPTIONAL SortOrder object — OPTIONAL Sort order values for a product. Default int32 — OPTIONAL Default sort value. Is usually calculated from the products availability date and cannot be set manually. Custom1 int32 — OPTIONAL Custom sort value 1. Custom2 int32 — OPTIONAL Custom sort value 2. Custom3 int32 — OPTIONAL Custom sort value 3. Custom4 int32 — OPTIONAL Custom sort value 4. Custom5 int32 — OPTIONAL Custom sort value 5. Weight int32 — OPTIONAL The weight of the product in grams (g). Can also be set on product item level. Length int32 — OPTIONAL The length of the product in millimeters (mm). Can also be set on product item level. Width int32 — OPTIONAL The width of the product in millimeters (mm). Can also be set on product item level. Height int32 — OPTIONAL The height of the product in millimeters (mm). Can also be set on product item level. Message string — OPTIONAL A status message for the action taken. Details string[] — OPTIONAL Any validation messages for the data on the current action.