> For the complete documentation index, see [llms.txt](https://dev.skladon.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.skladon.com/main/integration/api/products.md).

# 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","description":"Array of full product objects (same schema as Product) returned by GET /products/{sku}, filter, etc.","items":{"$ref":"#/components/schemas/Product"}},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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","insertToProductSkus","insertToCountries","insertType","insertByOrderType","insertPriceFrom","insertPriceTo","expirationDays","createdAt","updatedAt","dimensionsChangedAt","deletedAt","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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"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":"Product currency code (ISO 4217, 3 letters)"},"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"},"insertToProductSkus":{"type":"array","items":{"type":"string"},"description":"SKUs of products this item is inserted with (specificProduct insert type)"},"insertToCountries":{"type":"array","items":{"type":"string","minLength":2,"maxLength":2},"description":"ISO country codes where this insert product applies"},"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"},"deletedAt":{"type":["string","null"],"format":"date-time","description":"Timestamp when product was soft-deleted (null if not deleted)"},"quantityConversion":{"type":"number","description":"Quantity conversion factor"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"required":["sku","name","productType","active"]},"ProductAttachmentFiles":{"type":"array","items":{"$ref":"#/components/schemas/ProductAttachmentFile"}},"ProductAttachmentFile":{"type":"object","description":"Product attachment (Core product_files + files.TYPE instruction|label|other).","properties":{"id":{"type":"integer","minimum":1},"data":{"type":"string","description":"Base64 file payload; required for new files"},"type":{"type":"string","enum":["instruction","label","other"]},"fileName":{"type":"string","minLength":1},"fileType":{"type":"string","minLength":1},"fileSize":{"type":"string"}},"required":["type","fileName","fileType"]},"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":"Product currency code (ISO 4217, 3 letters)."},"expirationDays":{"type":"number","minimum":0,"description":"Threshold of number of days until expiration for email monitoring"},"files":{"$ref":"#/components/schemas/ProductAttachmentFiles"}},"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
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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.