KERN ERP API: sales | Codeverse Developers

✦Developers

KERN ERP API — Sales

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

Sales

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

Buyer POs

Access: erp.sales.buyer_pos:read(or :write)

GET/public/v1/sales/buyer-pos

List Buyer POs (paged; status, search, vendorId)

Scope erp.sales.buyer_pos:read · the client's role needs view on Buyer POs

Parameters

Name	In	Type	Notes
`page`	query	integer (int32)	Page number, starting at 0.
`size`	query	integer (int32)	Items per page.
`status`	query	string	Only records with this status (see the record's status values).
`search`	query	string	Search text (part of a name, number or code; not case-sensitive).
`vendorId`	query	integer (int64)	Only this vendor / customer (id).
`productId`	query	integer (int64)	Only this product / style (id).

Response (200) — data

Field	Type	Notes
`content`	array of object
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`vendorId`	integer (int64)
`vendorName`	string
`buyerPoNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`shippingMethod`	string
`exLocation`	string
`status`	string
`netTotal`	number
`lineCount`	integer (int32)
`totalQty`	integer (int32)
`createdAt`	string (date-time)
`styleNames`	array of string
`packingSlipGenerated`	boolean
`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 Buyer POs (paged; status, search, vendorId)
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

POST/public/v1/sales/buyer-pos

Create a Buyer PO (draft)

Scope erp.sales.buyer_pos:write · the client's role needs create on Buyer POs · 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
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`adjustment`	number
`lines`	array of object
`id`	integer (int64)
`productId`	integer (int64)
`productCode`	string
`productName`	string
`colorId`	integer (int64)
`colorName`	string
`locationName`	string
`sku`	string

…11 more fields — see the OpenAPI file.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`subTotal`	number
`discountAmt`	number
`gstAmt`	number
`adjustment`	number
`netTotal`	number
`status`	string
`guidance`	object
`nextActions`	array of object

…32 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 — Create a Buyer PO (draft)
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

GET/public/v1/sales/buyer-pos/{id}

Get one Buyer PO with lines

Scope erp.sales.buyer_pos:read · the client's role needs view on Buyer POs

Parameters

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

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`subTotal`	number
`discountAmt`	number
`gstAmt`	number
`adjustment`	number
`netTotal`	number
`status`	string
`guidance`	object
`nextActions`	array of object

…32 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 Buyer PO with lines
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY"

PUT/public/v1/sales/buyer-pos/{id}

Update a Buyer PO (draft / open / planned)

Scope erp.sales.buyer_pos:write · the client's role needs edit on Buyer POs · 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
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`adjustment`	number
`lines`	array of object
`id`	integer (int64)
`productId`	integer (int64)
`productCode`	string
`productName`	string
`colorId`	integer (int64)
`colorName`	string
`locationName`	string
`sku`	string

…11 more fields — see the OpenAPI file.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`subTotal`	number
`discountAmt`	number
`gstAmt`	number
`adjustment`	number
`netTotal`	number
`status`	string
`guidance`	object
`nextActions`	array of object

…32 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 Buyer PO (draft / open / planned)
curl -X PUT "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

POST/public/v1/sales/buyer-pos/{id}/finalize

Finalise a draft Buyer PO (→ OPEN)

Scope erp.sales.buyer_pos:write · the client's role needs edit on Buyer POs · 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.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`subTotal`	number
`discountAmt`	number
`gstAmt`	number
`adjustment`	number
`netTotal`	number
`status`	string
`guidance`	object
`nextActions`	array of object

…32 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 — Finalise a draft Buyer PO (→ OPEN)
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos/{id}/finalize" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json"

POST/public/v1/sales/buyer-pos/{id}/cancel

Cancel a Buyer PO

Scope erp.sales.buyer_pos:write · the client's role needs edit on Buyer POs · 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.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`poCode`	string
`poType`	string
`orderSource`	string
`internalCustomerName`	string
`vendorId`	integer (int64)
`vendorName`	string
`onBehalfVendorId`	integer (int64)
`onBehalfVendorName`	string
`billToLocationId`	integer (int64)
`billToName`	string
`billToAddress`	string
`shipToAddress`	string
`buyerPoNo`	string
`piNo`	string
`poNo`	string
`txnDate`	string (date)
`deliveryDate`	string (date)
`exLocation`	string
`shippingMethod`	string
`shippingTerms`	string
`poReceiveDate`	string (date)
`prReceiveDate`	string (date)
`exDate`	string (date)
`netWeight`	number
`grossWeight`	number
`dimensions`	string
`mfgDate`	string (date)
`invoiceFormat`	string
`billToType`	string
`eanRequired`	boolean
`notes`	string
`subTotal`	number
`discountAmt`	number
`gstAmt`	number
`adjustment`	number
`netTotal`	number
`status`	string
`guidance`	object
`nextActions`	array of object

…32 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 — Cancel a Buyer PO
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/sales/buyer-pos/{id}/cancel" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json"

Invoices

Access: erp.sales.invoices:read(or :write)

GET/public/v1/sales/invoices

List sales invoices (paged)

Scope erp.sales.invoices:read · the client's role needs view on Invoices

Parameters

Name	In	Type	Notes
`page`	query	integer (int32)	Page number, starting at 0.
`size`	query	integer (int32)	Items per page.
`status`	query	string	Only records with this status (see the record's status values).
`customerId`	query	integer (int64)	Only this customer (id).
`mode`	query	string	Only this invoice mode (EXPORT or DOMESTIC).
`source`	query	string	Only this source.
`search`	query	string	Search text (part of a name, number or code; not case-sensitive).

Response (200) — data

Field	Type	Notes
`content`	array of object
`id`	integer (int64)
`qcNo`	string
`qcDate`	string (date)
`qcPerson`	string
`process`	string
`dcNo`	string
`vendorName`	string
`locationName`	string
`status`	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 sales invoices (paged)
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/sales/invoices?page=0&size=20" \
  -H "Authorization: Bearer $KERN_API_KEY"

POST/public/v1/sales/invoices

Create a draft sales invoice

Scope erp.sales.invoices:write · the client's role needs create on Invoices · 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
`qcNo`	string
`qcDate` *	string (date)
`qcPerson` *	string
`process` *	string
`locationId`	integer (int64)
`inspectionLines`	array of object
`grnLineId` *	integer (int64)
`fabricProgramNo`	string
`itemType`	string
`itemNo`	string
`rollNo`	string
`gsm`	number
`width`	number
`weight`	number
`rollQty`	number
`acceptedQty`	number
`qcResult`	string
`stockInwardLines`	array of object
`id`	integer (int64)
`grnLineId` *	integer (int64)
`fabricProgramNo`	string
`itemType`	string
`fabricId` *	integer (int64)
`inwardFabricColor`	string
`uomId`	integer (int64)
`lotNo`	string
`width`	number
`gsm`	number
`weight`	number
`locationId`	integer (int64)
`rollNo`	string
`qty` *	number

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`qcNo`	string
`qcDate`	string (date)
`qcPerson`	string
`process`	string
`locationId`	integer (int64)
`locationName`	string
`status`	string
`inspectionLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`itemNo`	string
`rollNo`	string
`gsm`	number
`width`	number
`weight`	number
`rollQty`	number
`acceptedQty`	number
`qcResult`	string
`stockInwardLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`fabricId`	integer (int64)
`itemName`	string
`inwardFabricColor`	string
`uomId`	integer (int64)
`uomName`	string
`lotNo`	string
`width`	number
`gsm`	number
`weight`	number
`locationId`	integer (int64)
`locationName`	string
`rollNo`	string

…5 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 — Create a draft sales invoice
curl -X POST "https://kronex.codeverse.co/cedge/public/v1/sales/invoices" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{ … }'

GET/public/v1/sales/invoices/{id}

Get one sales invoice

Scope erp.sales.invoices:read · the client's role needs view on Invoices

Parameters

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

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`qcNo`	string
`qcDate`	string (date)
`qcPerson`	string
`process`	string
`locationId`	integer (int64)
`locationName`	string
`status`	string
`inspectionLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`itemNo`	string
`rollNo`	string
`gsm`	number
`width`	number
`weight`	number
`rollQty`	number
`acceptedQty`	number
`qcResult`	string
`stockInwardLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`fabricId`	integer (int64)
`itemName`	string
`inwardFabricColor`	string
`uomId`	integer (int64)
`uomName`	string
`lotNo`	string
`width`	number
`gsm`	number
`weight`	number
`locationId`	integer (int64)
`locationName`	string
`rollNo`	string

…5 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 sales invoice
curl -X GET "https://kronex.codeverse.co/cedge/public/v1/sales/invoices/{id}" \
  -H "Authorization: Bearer $KERN_API_KEY"

PATCH/public/v1/sales/invoices/{id}/issue

Issue a sales invoice

Scope erp.sales.invoices:write · the client's role needs edit on Invoices · 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.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`qcNo`	string
`qcDate`	string (date)
`qcPerson`	string
`process`	string
`locationId`	integer (int64)
`locationName`	string
`status`	string
`inspectionLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`itemNo`	string
`rollNo`	string
`gsm`	number
`width`	number
`weight`	number
`rollQty`	number
`acceptedQty`	number
`qcResult`	string
`stockInwardLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`fabricId`	integer (int64)
`itemName`	string
`inwardFabricColor`	string
`uomId`	integer (int64)
`uomName`	string
`lotNo`	string
`width`	number
`gsm`	number
`weight`	number
`locationId`	integer (int64)
`locationName`	string
`rollNo`	string

…5 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 — Issue a sales invoice
curl -X PATCH "https://kronex.codeverse.co/cedge/public/v1/sales/invoices/{id}/issue" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json"

PATCH/public/v1/sales/invoices/{id}/cancel

Cancel a sales invoice

Scope erp.sales.invoices:write · the client's role needs edit on Invoices · 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.

Response (200) — data

Field	Type	Notes
`id`	integer (int64)
`qcNo`	string
`qcDate`	string (date)
`qcPerson`	string
`process`	string
`locationId`	integer (int64)
`locationName`	string
`status`	string
`inspectionLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`itemNo`	string
`rollNo`	string
`gsm`	number
`width`	number
`weight`	number
`rollQty`	number
`acceptedQty`	number
`qcResult`	string
`stockInwardLines`	array of object
`id`	integer (int64)
`grnLineId`	integer (int64)
`dcNo`	string
`fabricProgramNo`	string
`itemType`	string
`fabricId`	integer (int64)
`itemName`	string
`inwardFabricColor`	string
`uomId`	integer (int64)
`uomName`	string
`lotNo`	string
`width`	number
`gsm`	number
`weight`	number
`locationId`	integer (int64)
`locationName`	string
`rollNo`	string

…5 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 — Cancel a sales invoice
curl -X PATCH "https://kronex.codeverse.co/cedge/public/v1/sales/invoices/{id}/cancel" \
  -H "Authorization: Bearer $KERN_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json"

Build on KERN.

Read the guides Talk to us