# Product Variant

the Product-Variant API

## POST /erp/product-variants/productVariantCreationJob

> Create a Job according to the Request

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Product-Variant","description":"the Product-Variant API"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/erp/product-variants/productVariantCreationJob":{"post":{"tags":["Product-Variant"],"summary":"Create a Job according to the Request","operationId":"createProductVariantCreationRequest","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/erp-product-ProductVariantCreationRequest"}}},"required":true},"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/core-api-OperationMessage"}}}}}}}},"components":{"schemas":{"erp-product-ProductVariantCreationRequest":{"description":"Request zur Erstellung von Product Varianten","properties":{"mainArticleRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"combinations":{"type":"array","description":"combinations of values","items":{"type":"array","description":"combinations of values","items":{"type":"integer","format":"int64","description":"combinations of values"}}},"blackListedCombinations":{"type":"array","description":"blacklisted combinations of values","items":{"type":"array","description":"blacklisted combinations of values","items":{"type":"integer","format":"int64","description":"blacklisted combinations of values"}}},"productType":{"type":"string","description":"Artikelarten","enum":["WITH_STOCK","WITHOUT_STOCK","SERVICE_ARTICLE","SERVICE_CONTINGENT","ASSEMBLY_GROUP","JUMBO","SHIPPING_COSTS","VARIANT_MAIN_ARTICLE"]}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"core-api-OperationMessage":{"properties":{"context":{"type":"string","description":"message context"},"messageValue":{"type":"string","description":" message"}}}}}}
```

## GET /erp/product-variants/{mainVariantArticleId}/combinations

>

```json
{"openapi":"3.1.0","info":{"title":"OpenAPI definition","version":"2026.14.3"},"tags":[{"name":"Product-Variant","description":"the Product-Variant API"}],"servers":[{"url":"http://localhost:52177/api","description":"Generated server url"}],"paths":{"/erp/product-variants/{mainVariantArticleId}/combinations":{"get":{"tags":["Product-Variant"],"operationId":"getCombinationsForArticleMainProductVariant","parameters":[{"name":"mainVariantArticleId","in":"path","required":true,"schema":{"type":"integer","format":"int64"}}],"responses":{"200":{"description":"OK","content":{"*/*":{"schema":{"$ref":"#/components/schemas/erp-product-ProductVariantCombinationsDto"}}}}}}}},"components":{"schemas":{"erp-product-ProductVariantCombinationsDto":{"properties":{"variantSchema":{"$ref":"#/components/schemas/common-variant-VariantSchema"},"attributes":{"type":"array","description":"Verwendete Attribute","items":{"$ref":"#/components/schemas/common-variant-VariantAttribute"}},"values":{"type":"array","description":"Verwendete Werte","items":{"$ref":"#/components/schemas/common-variant-VariantValue"}},"usedCombinations":{"type":"array","description":"Verwendete Kombinationen","items":{"$ref":"#/components/schemas/erp-product-ProductCombinationDto"}}}},"common-variant-VariantSchema":{"description":"Variantenschema","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Bezeichnung"},"description":{"type":"string","description":"Beschreibung"},"attributeRefs":{"type":"array","description":"Zugeordnete Attribute","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}},"eligibleValueRefs":{"type":"array","description":"Wählbare Werte","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"}},"active":{"type":"boolean","default":true,"description":"Aktiv?","readOnly":true}},"required":["attributeRefs","label"]},"core-api-MetaInfo":{"description":"MetaInformations for this Object","properties":{"createdAt":{"type":"string","format":"date-time","description":"Created At Timestamp","readOnly":true},"createdFrom":{"type":"string","description":"TenantUser-Identifier of the creator","readOnly":true},"updatedAt":{"type":"string","format":"date-time","description":"Last Updated AT Timestamp","readOnly":true},"updatedFrom":{"type":"string","description":"TenantUser-Identifier of most recent updater","readOnly":true}}},"core-api-ApiObjectReference":{"description":"Related account","properties":{"id":{"type":"string","description":"Identifier"},"label":{"type":"string","description":"a label","readOnly":true},"description":{"type":"string","description":"a short description","readOnly":true},"active":{"type":"boolean","description":"Activ","readOnly":true}},"required":["id"]},"common-variant-VariantAttribute":{"description":"Variantenattribut","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"description":{"type":"string","description":"Beschreibung"},"active":{"type":"boolean","default":true,"description":"Aktiv?","readOnly":true},"labels":{"type":"array","description":"Bezeichnung (mehrsprachig)","items":{"$ref":"#/components/schemas/common-variant-VariantDescription"}}},"required":["labels"]},"common-variant-VariantDescription":{"description":"Variantenbeschreibung (mehrsprachig)","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"label":{"type":"string","description":"Bezeichnung"},"languageCode":{"type":"string","description":"Sprache"}},"required":["label","languageCode"]},"common-variant-VariantValue":{"description":"Variantenwert","properties":{"version":{"type":"string","description":"Version Identifier for this Object (for PUT)"},"info":{"$ref":"#/components/schemas/core-api-MetaInfo"},"id":{"type":"string","description":"Unique identifier of the Object"},"attributeRef":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"sortOrder":{"type":"integer","format":"int64","description":"Sortierung"},"active":{"type":"boolean","default":true,"description":"Aktiv?","readOnly":true},"abbreviation":{"type":"string","description":"Abkürzung"},"labels":{"type":"array","description":"Mehrsprachige Bezeichnungen","items":{"$ref":"#/components/schemas/common-variant-VariantDescription"}}},"required":["abbreviation","labels"]},"erp-product-ProductCombinationDto":{"description":"Verwendete Kombinationen","properties":{"article":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"combination":{"type":"array","description":"Wert-Kombination","items":{"$ref":"#/components/schemas/core-api-ApiObjectReference"},"readOnly":true}}}}}}
```