The good news: most codes are resolved for you. You only ever must supply a classification code (and even that can be pre-configured for your account). Everything else has a sensible default or a simple enum.
There is no live lookup endpoint yet — the tables below are the values the API accepts out of the box. For the complete, authoritative KRA lists (especially item classifications), use the KRA references at the bottom.
Tax category
SendtaxCategory (an enum) when registering an item and on each sale line. Sync2Books maps it to the correct KRA tax type automatically — you don’t send a tax code yourself.
Need a special rate (e.g. VAT 8%) that the enum doesn’t cover? Set the KRA tax type explicitly via taxTyCd on item register, or contact support.
Item type & product type
itemType sets whether an item is stock-tracked (see Goods vs Services) and selects the KRA product type:
To use a different KRA product type — e.g. raw materials — set
productTypeCode explicitly on register:
Units & packaging
You have two options when registering an item: Option A — let Sync2Books resolve them. SendinternalUnit with one of these recognized values and the quantity/packaging codes are filled in for you:
Option B — pass the KRA codes directly via
unitCode and packagingUnitCode:
Quantity unit (unitCode):
Packaging unit (
packagingUnitCode):
These are the common units recognized out of the box. KRA defines many more (per the TIS spec). If you need a unit not listed here, pass its KRA code directly inunitCode/packagingUnitCode.
Payment type (sales)
SendpaymentTypeCode when creating a sale:
Classification code (the one you must look up)
classificationCode is the KRA item classification (itemClsCd) for the product — e.g. 14111400. Unlike the other codes, there is no default: you must supply a valid code when registering an item, unless classification rules have been pre-configured for your account.
- Get valid codes from KRA’s item classification list (see references).
- Pick the code that best matches the product.
- Once set, the item can be synced and sold.
Missing classification mapping.
Other sale codes
A sale also carries a couple of KRA status codes. Common values:
These follow the KRA TIS code lists — use the references for the full set.
KRA references
The authoritative, complete code lists are published by KRA:- TIS for OSCU/VSCU Technical Specifications v2.0 — all code lists (tax types, units, packaging, product types, payment methods, receipt/invoice status) and the item classification structure.
- See also eTIMS as a Third-Party Integrator (OSCU) for how these fit the KRA onboarding flow.
Read next
- Catalog — register and sync items
- Sales & Credit Notes — where payment/receipt codes are used
- API Reference — full field reference