Reference
Code Definitions
KRA-defined codes used across the Integrator API. When a field such as
item_type_code or tax_type_code
appears in the API Reference, use this page for valid values and meanings.
Tax Type
Used by `tax_type_code` on items, sales lines, purchases, and related payloads.
| Code | Name | Description |
|---|---|---|
A
|
A-Exempt | VAT rate: 0% |
B
|
B-VAT 16% | VAT rate: 16% |
C
|
C-Zero Rated | VAT rate: 0% |
D
|
D-Non VAT | VAT rate: 0% |
Taxpayer Status
Taxpayer status values returned by KRA taxpayer lookup workflows.
| Code | Name | Description |
|---|---|---|
A
|
Active | Taxpayer is active |
B
|
Inactive | Taxpayer is inactive |
C
|
Dormant | Taxpayer is dormant |
D
|
Cancelled | Taxpayer registration cancelled |
Product Type
Used by `item_type_code` when creating products/items. Example: `"item_type_code": 3` is a Service.
| Code | Name | Description |
|---|---|---|
1
|
RawMaterial | Raw Material |
2
|
FinishedProduct | Finished Product |
3
|
Service | Service without stock |
Country Codes
Used by `origin_country_code` / `country_code`. ISO 2-letter codes. Full list is synced from KRA code lists when available.
| Code | Name | Description |
|---|---|---|
| No codes available yet. Sync KRA code lists from the admin panel, then refresh this page. | ||
Item Classification
Used by `item_classification_code`. The full HS-style classification list is large and maintained via KRA sync. Prefer `GET /api/v1/item-classifications` or Notices & Code Lists for the complete catalogue.
| Code | Name | Description |
|---|---|---|
10000000
|
Live Plant and Animal Material and Accessories and Supplies | KRA item classification |
10100000
|
Live animals | KRA item classification |
10101500
|
Livestock | KRA item classification |
10101600
|
Birds and fowl | KRA item classification |
10101700
|
Live fish | KRA item classification |
10101800
|
Shellfish and aquatic invertebrates | KRA item classification |
10101900
|
Insects | KRA item classification |
10102000
|
Wild animals | KRA item classification |
10102100
|
Birds and fowl hatching eggs | KRA item classification |
10110000
|
Domestic pet products | KRA item classification |
10111300
|
Domestic pet treatments and accessories and equipment | KRA item classification |
10120000
|
Animal feed | KRA item classification |
10121500
|
Livestock feed | KRA item classification |
10121600
|
Bird and fowl food | KRA item classification |
10121700
|
Fish food | KRA item classification |
10121800
|
Dog and cat food | KRA item classification |
10121900
|
Rodent food | KRA item classification |
10122000
|
Reptile food | KRA item classification |
10122100
|
Miscellaneous animal food | KRA item classification |
10130000
|
Animal containment and habitats | KRA item classification |
10131500
|
Animal shelters | KRA item classification |
10131600
|
Animal containment | KRA item classification |
10131700
|
Animal habitats | KRA item classification |
10140000
|
Saddlery and harness goods | KRA item classification |
10141500
|
Saddlery | KRA item classification |
Packaging Unit
Used by `packaging_unit_code` (part of the generated KRA item code).
| Code | Name | Description |
|---|---|---|
AM
|
Ampoule | KRA packaging unit |
BA
|
Barrel | KRA packaging unit |
BC
|
Bottlecrate | KRA packaging unit |
BE
|
Bundle | KRA packaging unit |
BF
|
Balloon, non-protected | KRA packaging unit |
BG
|
Bag | KRA packaging unit |
BJ
|
Bucket | KRA packaging unit |
BK
|
Basket | KRA packaging unit |
BL
|
Bale | KRA packaging unit |
BQ
|
Bottle, protected cylindrical | KRA packaging unit |
BR
|
Bar | KRA packaging unit |
BV
|
Bottle, bulbous | KRA packaging unit |
BZ
|
Bag | KRA packaging unit |
CA
|
Can | KRA packaging unit |
CH
|
Chest | KRA packaging unit |
CJ
|
Coffin | KRA packaging unit |
CL
|
Coil | KRA packaging unit |
CR
|
Wooden Box, Wooden Case | KRA packaging unit |
CS
|
Cassette | KRA packaging unit |
CT
|
Carton | KRA packaging unit |
CTN
|
Container | KRA packaging unit |
CY
|
Cylinder | KRA packaging unit |
DR
|
Drum | KRA packaging unit |
GT
|
Extra Countable Item | KRA packaging unit |
HH
|
Hand Baggage | KRA packaging unit |
IZ
|
Ingots | KRA packaging unit |
JR
|
Jar | KRA packaging unit |
JU
|
Jug | KRA packaging unit |
JY
|
Jerry CAN Cylindrical | KRA packaging unit |
KZ
|
Canester | KRA packaging unit |
LZ
|
Logs, in bundle/bunch/truss | KRA packaging unit |
NT
|
Net | KRA packaging unit |
OU
|
Non-Exterior Packaging Unit | KRA packaging unit |
PD
|
Poddon | KRA packaging unit |
PG
|
Plate | KRA packaging unit |
PI
|
Pipe | KRA packaging unit |
PO
|
Pilot | KRA packaging unit |
PU
|
Traypack | KRA packaging unit |
RL
|
Reel | KRA packaging unit |
RO
|
Roll | KRA packaging unit |
RZ
|
Rods, in bundle/bunch/truss | KRA packaging unit |
SK
|
Skeletoncase | KRA packaging unit |
TY
|
Tank, cylindrical | KRA packaging unit |
VG
|
Bulk,gas(at 1031 mbar 15 oC) | KRA packaging unit |
VL
|
Bulk,liquid(at normal temperature/pressure) | KRA packaging unit |
VO
|
Bulk, solid, large particles(nodules) | KRA packaging unit |
VQ
|
Bulk, gas (liquefied at abnormal temperature/pressure) | KRA packaging unit |
VR
|
Bulk, solid, granular particles(grains) | KRA packaging unit |
VT
|
Extra Bulk Item | KRA packaging unit |
VY
|
Bulk, fine particles(powder) | KRA packaging unit |
ML
|
Mills | KRA packaging unit |
TN
|
TAN | KRA packaging unit |
Unit of Quantity
Used by `quantity_unit_code` (part of the generated KRA item code).
| Code | Name | Description |
|---|---|---|
BG
|
Bag (BG) | bag |
BA
|
Barrel (BA) | Barrel |
BLL
|
Bll Barrel (petroleum) (158,987 Dm3) (BLL) | BLL Barrel (petroleum) (158,987 dm3) |
BL
|
Block (BL) | block |
BX
|
Box (BX) | box |
BE
|
Bundle (BE) | bundle |
CA
|
Can (CA) | Can |
AV
|
Cap (AV) | Cap |
CR
|
Carat (CR) | CARAT |
CEL
|
Cell (CEL) | Cell |
CMT
|
Centimetre (CMT) | centimetre |
M3
|
Cubic Metre (M3) | Cubic Metre |
DZ
|
Dozen (DZ) | Dozen |
DR
|
Drum (DR) | Drum |
GLL
|
Gallon (GLL) | Gallon |
GRM
|
Gram (GRM) | Gram |
GRO
|
Gross (GRO) | Gross |
KG
|
Kilo-gramme (KG) | Kilo-Gramme |
KTM
|
Kilometre (KTM) | kilometre |
KWT
|
Kilowatt (KWT) | kilowatt |
LK
|
Link (LK) | link |
L
|
Litre (L) | Litre |
LTR
|
Litre (LTR) | Litre |
MWT
|
Megawatt Hour (1000 Kw.h) (MWT) | megawatt hour (1000 kW.h) |
M
|
Metre (M) | Metre |
MTR
|
Metre (MTR) | metre |
MGM
|
Milligram (MGM) | milligram |
NO
|
Number (NO) | Number |
PA
|
Packet (PA) | packet |
4B
|
Pair (4B) | Pair |
PR
|
Pair (PR) | pair |
NX
|
Part Per Thousand (NX) | part per thousand |
U
|
Pieces/item [number] (U) | Pieces/item [Number] |
PG
|
Plate (PG) | plate |
LBR
|
Pound (LBR) | pound |
RL
|
Reel (RL) | reel |
RO
|
Roll (RO) | roll |
SET
|
Set (SET) | set |
ST
|
Sheet (ST) | sheet |
M2
|
Square Metre (M2) | Square Metre |
TNE
|
Tonne (metric Ton) (TNE) | tonne (metric ton) |
TU
|
Tube (TU) | tube |
YRD
|
Yard (YRD) | yard |
Currency
Used by `currency_code` where monetary amounts are expressed. Kenyan operations typically use KES.
| Code | Name | Description |
|---|---|---|
KES
|
Kenyan Shilling | Primary currency for KRA eTIMS in Kenya |
USD
|
US Dollar | United States dollar |
EUR
|
Euro | Euro |
GBP
|
Pound Sterling | British pound |
UGX
|
Ugandan Shilling | Uganda |
TZS
|
Tanzanian Shilling | Tanzania |
Transaction Type
Used by sales `sales_type` / transaction type fields.
| Code | Name | Description |
|---|---|---|
| No codes available yet. Sync KRA code lists from the admin panel, then refresh this page. | ||
Sales Receipt Type
Used by sales `receipt_type`.
| Code | Name | Description |
|---|---|---|
S
|
Sale | Normal sales receipt |
R
|
Credit Note after Sale | Credit/refund receipt type after a sale |
Payment Method
Used by `payment_type` / `payment_method` on sales and purchases.
| Code | Name | Description |
|---|---|---|
01
|
Cash | KRA payment method |
02
|
Credit | KRA payment method |
03
|
M-Pesa | KRA payment method |
04
|
Bank Transfer | KRA payment method |
05
|
Cheque | KRA payment method |
06
|
Other | KRA payment method |
Transaction Progress
KRA transaction progress codes used in sales/purchase lifecycle responses.
| Code | Name | Description |
|---|---|---|
01
|
Wait for Approval | Awaiting approval |
02
|
Approved | Approved |
03
|
Cancel Requested | Cancellation requested |
04
|
Canceled | Cancelled |
05
|
Credit Note Requested | Credit note requested |
06
|
Credited | Credited |
Registration Type
Used by purchase/stock registration type (`registration_type_code` / `regTyCd`).
| Code | Name | Description |
|---|---|---|
M
|
Manual | Manually registered |
A
|
Automatic | Automatically registered |
Purchase Receipt Type
Used by purchase `receipt_type_code`.
| Code | Name | Description |
|---|---|---|
P
|
Purchase | Purchase receipt |
R
|
Return | Purchase return / credit |
Stock Movement Type
KRA stock in/out (`sarTyCd`) codes used when reporting stock movements. For the public Adjust Item Stock API, `action: add` maps to `04` and `action: deduct` maps to `13` automatically.
| Code | Name | Description |
|---|---|---|
01
|
Import | Import |
02
|
Purchase | Purchase |
03
|
Return In (Customer Return) | Customer Return |
04
|
Stock Move / Transfer In | Stock Movement In, Transfer In |
05
|
Processing In | Processing In |
06
|
Adjustment In / Opening | Stock Adjustment (+), Opening Stock |
11
|
Sale | Sale |
12
|
Return Out (Supplier Return) | Supplier Return |
13
|
Stock Move / Transfer Out | Stock Movement Out, Transfer Out |
14
|
Processing Out | Processing Out |
15
|
Discard / Waste | Discard/Waste |
16
|
Adjustment Out | Stock Adjustment (-) |
Import Item Status
Used by `import_item_status` on imported items.
| Code | Name | Description |
|---|---|---|
1
|
Unsent | KRA import item status |
2
|
Waiting | KRA import item status |
3
|
Approved | KRA import item status |
4
|
Cancelled | KRA import item status |
Credit Note Reason
Used by credit note `reason_code` / `credit_note_reason`.
| Code | Name | Description |
|---|---|---|
01
|
Missing Quantity | KRA credit note reason |
02
|
Missing Data | KRA credit note reason |
03
|
Damaged | KRA credit note reason |
04
|
Wasted | KRA credit note reason |
05
|
Raw Material Shortage | KRA credit note reason |
06
|
Refund | KRA credit note reason |
API Response Codes
Common KRA `resultCd` values returned by eTIMS endpoints and surfaced in Integrator responses.
| Code | Name | Description |
|---|---|---|
000
|
Success | Request processed successfully |
001
|
Waiting | Request accepted / waiting |
801
|
Internal Error | KRA internal processing error |
900
|
Validation / Business Error | Request rejected by KRA validation or business rules |
902
|
Unauthorized | Authentication or authorization failure at KRA |
903
|
Not Found | Requested resource not found at KRA |
Prefer live values from Notices & Code Lists in the API Reference when you need the latest synced catalogue (especially item classifications and quantity units).