KERN ERP API: products | Codeverse Developers

✦Developers

KERN ERP API — Products

Masters, products and styles, Buyer POs, purchase orders, GRNs, sales invoices, packing slips and stock.

Version 2026-10-09.1 · published 9 Oct 2026 · 105 APIs

Base URL https://kronex.codeverse.co/cedge

Download: OpenAPI (JSON) · Postman collection · Guides · Changelog

Products

Grouped by screen, as in the app. Scope for the whole module: erp.products.*:read or :write.

Product List

Access: erp.products.products:read(or :write)

GET/public/v1/products/products

List products / styles (paged; search, category, status)

Scope erp.products.products:read · the client's role needs view on Product List

Parameters

Name	In	Type	Notes
`page`	query	integer (int32)	Page number, starting at 0.
`size`	query	integer (int32)	Items per page.
`search`	query	string	Search text (part of a name, number or code; not case-sensitive).
`category`	query	string	Only this category.
`status`	query	string	Only records with this status (see the record's status values).
`excludeDraft`	query	boolean	true leaves out drafts.
`dateFrom`	query	string	From this date (YYYY-MM-DD), inclusive.
`dateTo`	query	string	Up to this date (YYYY-MM-DD), inclusive.
`excludeIncompleteBom`	query	boolean	true leaves out styles whose bill of materials isn't complete.

Response (200) — data

Field	Type	Notes
`content`	array of object
`id`	integer (int64)
`productCode`	string
`productName`	string
`colorId`	integer (int64)
`colorName`	string
`colorCode`	string
`category`	string
`season`	string
`garmentType`	string
`brandName`	string
`hsnCode`	string
`standardCost`	number
`gstPct`	number
`status`	string
`productImageUrl`	string
`mrp`	number
`moq`	integer (int32)
`sizeCount`	integer (int32)
`totalFgQty`	integer (int32)
`isCombo`	boolean
`createdAt`	string
`page`	integer (int32)
`size`	integer (int32)
`totalElements`	integer (int64)
`totalPages`	integer (int32)
`last`	boolean

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List products / styles (paged; search, category, status)
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/products/products?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

POST/public/v1/products/products

Create a product (one per colour given)

Scope erp.products.products:write · the client's role needs create on Product List · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`productName`	string
`colorIds`	array of integer (int64)
`customerNames`	array of object
`customerName` *	string
`displayOrder`	integer (int32)
`descriptions`	array of object
`description` *	string
`displayOrder`	integer (int32)
`category`	string
`season`	string
`garmentType`	string
`brandId`	integer (int64)
`locationId`	integer (int64)
`sizes`	array of object
`sizeCode` *	string
`sizeName`	string
`gsCode`	string
`quantity`	integer (int32)
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`displayOrder`	integer (int32)
`uomId` *	integer (int64)
`hsnCode`	string
`gstPct`	number
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`remarks`	string
`bom`	array of object
`rmTypeId`	integer (int64)
`materialType` *	string
`rmId`	integer (int64)
`fabricId`	integer (int64)
`materialName` *	string
`consumption` *	number
`uomId`	integer (int64)
`uomName`	string
`pricePerUom`	number
`totalPrice`	number

…16 more fields — see the OpenAPI file.

Response (200) — data

Field	Type	Notes
`createdProducts`	array of object
`id`	integer (int64)
`productCode`	string
`colorName`	string

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Create a product (one per colour given)
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/products/products" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

GET/public/v1/products/products/{id}

Get one product with sizes, SKUs and BOM

Scope erp.products.products:read · the client's role needs view on Product List

Parameters

Name	In	Type	Notes
`id` *	path	integer (int64)	The record's id.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`productCode`	string
`productName`	string
`colorId`	integer (int64)
`colorName`	string
`colorCode`	string
`uomId`	integer (int64)
`uomName`	string
`category`	string
`season`	string
`garmentType`	string
`brandId`	integer (int64)
`brandName`	string
`locationId`	integer (int64)
`locationName`	string
`hsnCode`	string
`gstPct`	number
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`remarks`	string
`productImageUrl`	string
`status`	string
`skuConfig`	string
`skus`	array of object
`id`	integer (int64)
`sizeCode`	string
`sizeName`	string
`sku`	string
`ean`	string
`articleNo`	string
`customerNames`	array of object
`id`	integer (int64)
`customerName`	string
`displayOrder`	integer (int32)
`descriptions`	array of object
`id`	integer (int64)
`description`	string
`displayOrder`	integer (int32)
`sizes`	array of object

…39 more fields — see the OpenAPI file.

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Get one product with sizes, SKUs and BOM
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/products/products/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY"

PUT/public/v1/products/products/{id}

Update a product

Scope erp.products.products:write · the client's role needs edit on Product List · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`id` *	path	integer (int64)	The record's id.
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`productName`	string
`colorId`	integer (int64)
`customerNames`	array of object
`customerName` *	string
`displayOrder`	integer (int32)
`descriptions`	array of object
`description` *	string
`displayOrder`	integer (int32)
`category`	string
`season`	string
`garmentType`	string
`brandId`	integer (int64)
`sizes`	array of object
`sizeCode` *	string
`sizeName`	string
`gsCode`	string
`quantity`	integer (int32)
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`displayOrder`	integer (int32)
`uomId` *	integer (int64)
`hsnCode`	string
`gstPct`	number
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`remarks`	string
`bom`	array of object
`rmTypeId`	integer (int64)
`materialType` *	string
`rmId`	integer (int64)
`fabricId`	integer (int64)
`materialName` *	string
`consumption` *	number
`uomId`	integer (int64)
`uomName`	string
`pricePerUom`	number
`totalPrice`	number
`displayOrder`	integer (int32)

…12 more fields — see the OpenAPI file.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`productCode`	string
`productName`	string
`colorId`	integer (int64)
`colorName`	string
`colorCode`	string
`uomId`	integer (int64)
`uomName`	string
`category`	string
`season`	string
`garmentType`	string
`brandId`	integer (int64)
`brandName`	string
`locationId`	integer (int64)
`locationName`	string
`hsnCode`	string
`gstPct`	number
`standardCost`	number
`mrp`	number
`moq`	integer (int32)
`remarks`	string
`productImageUrl`	string
`status`	string
`skuConfig`	string
`skus`	array of object
`id`	integer (int64)
`sizeCode`	string
`sizeName`	string
`sku`	string
`ean`	string
`articleNo`	string
`customerNames`	array of object
`id`	integer (int64)
`customerName`	string
`displayOrder`	integer (int32)
`descriptions`	array of object
`id`	integer (int64)
`description`	string
`displayOrder`	integer (int32)
`sizes`	array of object

…39 more fields — see the OpenAPI file.

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Update a product
curl -X PUT "https://kronex.codeverse.co/cedge/public/v1/products/products/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

GET/public/v1/products/products/categories

List product categories

Scope erp.products.products:read · the client's role needs view on Product List

Response (200) — data

Returns array of string in data.

Errors: 400, 401, 403, 404, 405, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — List product categories
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/products/products/categories?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

PUT/public/v1/products/products/{id}/status

Change a product's status (DRAFT / ACTIVE / HOLD / ARCHIVED)

Scope erp.products.products:write · the client's role needs edit on Product List · send an Idempotency-Key

Parameters

Name	In	Type	Notes
`id` *	path	integer (int64)	The record's id.
`Idempotency-Key` *	header	string	Any unique text up to 120 characters (e.g. a UUID). A retry with the same key and body returns the first answer instead of doing the work twice.

Request body

Field	Type	Notes
`status` *	string

Response (200) — data

Returns object in data.

Errors: 400, 401, 403, 404, 405, 409, 413, 422, 429, 500 — every error says how to fix it; see error codes and troubleshooting.

Example

# KERN ERP — Change a product's status (DRAFT / ACTIVE / HOLD / ARCHIVED)
curl -X PUT "https://kronex.codeverse.co/cedge/public/v1/products/products/{id}/status" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

Build on KERN.

Read the guides Talk to us