Item Attributes

A catalog item is a product or service you sell. It is not usable for KRA compliance until it carries the attributes below. Once an item has everything it needs, it can be registered with KRA and then appear on sales and credit notes.

Create and update items with POST /v1/items, and register them with KRA with POST /v1/items/{id}/register. The attributes below are the request fields. See Items for the walkthrough and the API reference for the endpoints.

Attributes table

Attribute	Required	Data Type	Description — Sample
`externalId`	Yes	string (≤100 chars)	Your own identifier for the item — sending it again updates the same item. `"SKU-1042"`
`name`	Yes	string (≤200 chars)	The item’s name. `"500ml Cooking Oil"`
`sku`	No	string (≤100 chars)	Your ERP’s own SKU/code, kept for reference. `"COOK-OIL-500"`
`taxCategory`	Yes	enum	`VAT_STANDARD` \| `VAT_ZERO` \| `EXEMPT` \| `OTHER` \| `VAT_8`. Maps to KRA’s tax type (`taxTyCd`) automatically — see Codes & Values. `"VAT_STANDARD"`
`productTypeCode`	Yes	enum	KRA product type (`itemTyCd`): `"1"` Raw Material, `"2"` Finished Product, `"3"` Service. Goods (`1`/`2`) are stock-tracked; services (`3`) are not. `"2"`
`classificationCode`	Yes before registration	string (≤20 chars)	KRA item classification code (`itemClsCd`). See Item Classification Codes. Not required to create the item, but registration fails without one. Search with `GET /v1/lookups/classifications`. `"50150000"`
`unitCode`	No	string (≤2 chars)	KRA quantity unit code (`qtyUnitCd`). See Codes & Values. List them with `GET /v1/lookups/codes?codeClass=10`. `"U"`
`packagingUnitCode`	No	string (≤2 chars)	KRA packaging unit code (`pkgUnitCd`). See Codes & Values. List them with `GET /v1/lookups/codes?codeClass=17`. `"NT"`
`unitPrice`	No	number (≥0)	The item’s default unit price (`dftPrc`). It is returned on the item. A sale line always sends its own `unitPrice`. `3500`

externalId is the upsert key: sending it again with changed fields updates the same item rather than creating a duplicate. The item’s own id, assigned when it is created, is what sales and stock movements reference afterwards.

Response fields

Besides the fields you sent, an item in a response carries:

Field	Meaning
`id`	The item’s id, used on sale lines and stock movements.
`taxTypeCode`	The KRA tax type letter `taxCategory` maps to: `A`, `B`, `C`, `D` or `E`.
`stockTracked`	`true` for goods, which have their stock deducted by sales.
`registrationStatus`	Where the item stands with KRA. See below.
`needs`	Why an item cannot be registered yet. See below.

Registration status

An item carries a registrationStatus describing where it stands with KRA:

Value	Meaning
`PENDING`	Not yet registered with KRA. This is the state straight after you create an item.
`REGISTERED`	Accepted by KRA (`saveItem` succeeded); the item can now be sold.
`FAILED`	KRA rejected the registration — see Errors & Troubleshooting.

needs reports what is missing, so you know exactly what to fix:

Flag	Set when
`needs.productType`	`productTypeCode` is missing.
`needs.classificationMapping`	`classificationCode` is missing.

Start here

Guides

API conventions

Reference data

Going live

API reference

Endpoints

Resources

Attributes table

Response fields

Registration status

Read next

​Attributes table

​Response fields

​Registration status

​Read next

Attributes table

Response fields

Registration status

Read next