# Products

You may find descriptions of endpoints for work with products below.

## POST /products/filter

> Filter products

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductsGridResponse":{"type":"object","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/ProductsGrid"}},"required":["statusCode","message"]},"ProductsGrid":{"type":"object","properties":{"data":{"$ref":"#/components/schemas/Products"},"request":{"$ref":"#/components/schemas/ProductGridRequest"},"totalCount":{"type":"number"}}},"Products":{"type":"array","items":{"$ref":"#/components/schemas/CreateProductBody"}},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]},"ProductGridRequest":{"type":"object","properties":{"page":{"type":"integer","description":"Page number, can be used for pagination","default":1,"minimum":1},"items":{"type":"integer","description":"items per page","default":10,"minimum":1,"maximum":1000},"columns":{"$ref":"#/components/schemas/ProductColumns"},"sorts":{"$ref":"#/components/schemas/ProductSorts"},"filters":{"$ref":"#/components/schemas/ProductsFilters"}}},"ProductColumns":{"type":"array","description":"List of columns you want to retrieve. If empty, all possible columns will be retrieved","items":{"$ref":"#/components/schemas/ProductColumnEnum"}},"ProductColumnEnum":{"type":"string","enum":["id","customField1","customField2","customField3","description","ean","expMethod","guid","hsCode","isbn","mpn","name","note","price","productType","rop","sku","upc","active","scanSerialNumber","originCountry","snRegex","unitPrice","weight","width","height","length","insertToProductId","insertType","insertByOrderType","insertPriceFrom","insertPriceTo","expirationDays","createdAt","updatedAt","dimensionsChangedAt","quantityConversion","isDeleted","ageCheck","batteryType"]},"ProductSorts":{"type":"array","items":{"$ref":"#/components/schemas/ProductSortItem"}},"ProductSortItem":{"type":"object","properties":{"column":{"$ref":"#/components/schemas/ProductColumnEnum","description":"Name of the column to order by"},"direction":{"type":"string","description":"Direction of the order","enum":["ASC","DESC","asc","desc"]}},"required":["column","direction"]},"ProductsFilters":{"type":"array","description":"Array of AndFilters. They will be joined with OR operator.","items":{"$ref":"#/components/schemas/ProductsFiltersItems"}},"ProductsFiltersItems":{"type":"array","description":"Array of AND filters. Filters you specify in this array will be joined with AND operator.","items":{"$ref":"#/components/schemas/ProductFilterItem"}},"ProductFilterItem":{"type":"object","properties":{"column":{"$ref":"#/components/schemas/ProductColumnEnum","description":"Name of the column to filter by","minLength":2},"operator":{"type":"string","description":"\n                                eq - equal\n                                neq - not equal\n                                gt -  greater than\n                                gte - greater than or equal\n                                lt - less than\n                                lte - less than equal\n                                in - in array of values (expects array of values in value property)\n                                nin - not in array of values (expects array of values in value property)\n                                like - like\n                                nline - not like\n                                between - between given interval (expects array of two values in value),\n                                nbetween - not between given interval (expects array of two values in value)\n                                null - is null\n                                notnull - is not null\n                                empty - is null or empty string\n                                notempty - is not null neither empty string","enum":["eq","neq","like","nlike","gt","lt","gte","lte","in","nin","between","nbetween","null","notnull","empty","notempty"]},"value":{"type":"string","description":"Value can be string, number, boolean or array"}},"required":["column","operator","value"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/products/filter":{"post":{"summary":"Filter products","operationId":"postProductsFilter","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductsGridResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductGridRequest"}}}}}}}}
```

## GET /products/{sku}

> Get product by sku

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/products/{sku}":{"get":{"summary":"Get product by sku","operationId":"getProductsSku","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"sku","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}}}}}}
```

## GET /products/guid/{guid}

> Get product by guid

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]}}},"paths":{"/products/guid/{guid}":{"get":{"summary":"Get product by guid","operationId":"getProductsGuidGuid","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"guid","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}}}}}}
```

## POST /products

> Creates new product

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]}}},"paths":{"/products":{"post":{"summary":"Creates new product","operationId":"postProducts","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductBody"}}}}}}}}
```

## PUT /products/{sku}

> Update product by sku

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]}}},"paths":{"/products/{sku}":{"put":{"summary":"Update product by sku","operationId":"putProductsSku","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"sku","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductBody"}}}}}}}}
```

## PUT /products/guid/{guid}

> Update product by guid

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]}}},"paths":{"/products/guid/{guid}":{"put":{"summary":"Update product by guid","operationId":"putProductsGuidGuid","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"guid","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductBody"}}}}}}}}
```

## PATCH /products/{sku}

> Partially update product by sku

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]}}},"paths":{"/products/{sku}":{"patch":{"summary":"Partially update product by sku","operationId":"patchProductsSku","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"sku","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductBody"}}}}}}}}
```

## PATCH /products/guid/{guid}

> Partially update product by guid

```json
{"openapi":"3.1.1","info":{"title":"Public Gateway Documentation","version":"2.0.0"},"servers":[{"url":"https://gw.new.skladon.net/v2"}],"security":[{"authorization":[],"XApiKey":[]}],"components":{"securitySchemes":{"authorization":{"type":"apiKey","name":"authorization","in":"header"}},"schemas":{"ProductResponse":{"type":"object","description":"Product success response","properties":{"statusCode":{"type":"number","default":200},"message":{"type":"string"},"data":{"$ref":"#/components/schemas/Product"}},"required":["statusCode","message"]},"Product":{"type":"object","properties":{"id":{"type":"number"},"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"originCountry":{"type":"string","minLength":2,"maxLength":2},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"isDeleted":{"type":"boolean","description":"Info whether product is deleted (soft delete)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation"},"unitPrice":{"type":"string","description":"Unit price as string"},"weight":{"type":"number","minimum":0,"description":"Weight in kg"},"width":{"type":"number","minimum":0,"description":"Width in cm"},"height":{"type":"number","minimum":0,"description":"Height in cm"},"length":{"type":"number","minimum":0,"description":"Length in cm"},"insertToProductId":{"type":"number","description":"ID of product to insert into (for packaging materials)"},"insertType":{"type":"string","description":"Type of insert operation"},"insertByOrderType":{"type":"string","enum":["all","b2c","b2b"],"description":"Order type for automatic insert"},"insertPriceFrom":{"type":"number","description":"Minimum order price for automatic insert"},"insertPriceTo":{"type":"number","description":"Maximum order price for automatic insert"},"expirationDays":{"type":"number","minimum":0,"description":"Number of days until expiration"},"createdAt":{"type":"string","format":"date-time","description":"Product creation timestamp"},"updatedAt":{"type":"string","format":"date-time","description":"Product last update timestamp"},"dimensionsChangedAt":{"type":"string","format":"date-time","description":"Timestamp when product dimensions were last changed"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"}},"required":["sku","name","productType","active"]},"ErrorMessageResponse":{"type":"object","properties":{"statusCode":{"type":"number"},"message":{"type":"string"}},"required":["statusCode","message"]},"CreateProductBody":{"type":"object","properties":{"sku":{"type":"string","minLength":1},"name":{"type":"string","minLength":1},"description":{"type":"string","minLength":1},"price":{"type":"number","minimum":0},"hsCode":{"type":"string","minLength":1},"batteryType":{"type":"string","enum":["no","device","package"]},"upc":{"type":"string","minLength":1,"maxLength":50},"ean":{"type":"string"},"guid":{"type":"string"},"rop":{"type":"number","minimum":0},"expMethod":{"type":"string","enum":["FIFO","FEFO"]},"mpn":{"type":"string","minLength":1,"maxLength":50},"isbn":{"type":"string","minLength":1,"maxLength":50},"note":{"type":"string","minLength":1,"maxLength":255},"productType":{"type":"string","enum":["pack","packagingMaterial","semiProduct","finalProduct","promoMaterial","virtual","serviceProduct"]},"originCountry":{"type":"string","minLength":2,"maxLength":2},"customField1":{"type":"string","minLength":1,"maxLength":255},"customField2":{"type":"string","minLength":1,"maxLength":255},"customField3":{"type":"string","minLength":1,"maxLength":255},"ageCheck":{"type":"boolean","description":"Info whether is necessary to check recipient age by delivery service"},"active":{"type":"boolean"},"scanSerialNumber":{"type":"boolean","deprecated":true,"description":"DEPRECATED: Use scanImeiSn instead. Info whether to scan serial numbers"},"scanImeiSn":{"type":"integer","enum":[0,1,2],"description":"Scan mode: 0=No scanning, 1=Serial numbers, 2=IMEI (with automatic regex ^[0-9]{14,16}$)"},"snRegex":{"type":"string","description":"Regular expression for serial number validation."},"unitPrice":{"type":"string","description":"Unit price."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"}},"required":["sku","name","productType","active","expMethod"]}}},"paths":{"/products/guid/{guid}":{"patch":{"summary":"Partially update product by guid","operationId":"patchProductsGuidGuid","parameters":[{"schema":{"type":"string"},"description":"This is the eshop key you receive during onboarding.","name":"x-api-key","in":"header","required":true},{"schema":{"type":"string"},"description":"Token you get from calling /users/login","name":"authorization","in":"header","required":true},{"schema":{"type":"string"},"name":"guid","in":"path","required":true}],"tags":["Products"],"responses":{"200":{"description":"Success response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProductResponse"}}}},"401":{"description":"Unauthorized response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}},"404":{"description":"Not found response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorMessageResponse"}}}}},"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateProductBody"}}}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.skladon.com/main/integration/api/products.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.