Managing Items
This guide explains how to set up and manage items (products and services) in C-Tax. Items are the goods or services you sell and purchase.
What is an Item?
An item in C-Tax represents:
- A product you sell (e.g., “Laptop Computer”)
- A service you provide (e.g., “Consulting Service”)
- Something you purchase from suppliers
Each item has:
- A unique code
- A name and description
- A price
- A tax type (determines VAT rate)
- Classification codes (for KRA)
Viewing Your Items
- Click Items in the sidebar
- See a table of all items showing:
| Column | Description |
|---|---|
| Item Code | Unique identifier assigned by KRA |
| Item Name | Product or service name |
| Branch | Which branch the item belongs to |
| Class Code | KRA classification code |
| Tax Type | VAT category (A, B, C, D, E) |
| Unit Price | Default selling price in KES |
| Barcode | Barcode number (if set) |
| KRA Sync | Whether synced with KRA (✓ Synced or ⚠ Pending) |
| Status | Active or Inactive |
Filtering Items
Use the filter options above the table:
| Filter | Purpose |
|---|---|
| Search box | Find by name, code, or barcode |
| Branch dropdown | Show items for a specific branch |
| Tax Type dropdown | Filter by tax category |
Adding a New Item
Step 1: Open the Registration Form
- Go to Items in the sidebar
- Click “Register New Item” button
A dialog will appear with the item registration form.
Step 2: Select Branch
| Field | Required | Description |
|---|---|---|
| Branch | Yes | Select which branch this item will be registered for |
Each item is registered per branch. If you have multiple branches, you may need to register the item separately for each.
Step 3: Enter Item Name
| Field | Required | Description |
|---|---|---|
| Item Name | Yes | Clear, descriptive name (max 200 characters). Example: “Premium Coffee Beans” |
Step 4: Select Item Classification
| Field | Required | Description |
|---|---|---|
| Item Classification Code | Yes | KRA category code for this type of item |
Start typing to search for the correct classification. This is required by KRA for tax categorization.
Step 5: Select Tax Type
| Field | Required | Description |
|---|---|---|
| Tax Type | Yes | VAT category for this item |
Tax Types Explained
| Type | Rate | Description | Use For |
|---|---|---|---|
| Type A | 16% | Standard Rate | Most goods and services |
| Type B | 0% | Exempt | Tax-exempt items |
| Type C | 0% | Special Rate | Special category items |
| Type D | 0% | Zero-rated | Zero-rated supplies |
| Type E | 0% | Special Exemption | Special exemptions |
Tip: Most items use Tax Type A (16% VAT). Consult your accountant if unsure.
Step 6: Set Unit Price (Optional)
| Field | Required | Description |
|---|---|---|
| Unit Price (KES) | No | Default selling price per unit |
You can change the price when creating transactions, but setting a default saves time.
Step 7: Set Units
| Field | Default | Options |
|---|---|---|
| Package Unit | NT (No Tax Package) | NT, BA (Bag), BO (Bottle), BX (Box), CA (Can), CT (Carton), PK (Package) |
| Quantity Unit | U (Unit) | U (Unit), KG (Kilogram), L (Liter), M (Meter), M2 (Square Meter), M3 (Cubic Meter) |
Step 8: Optional Fields
| Field | Description |
|---|---|
| Item Code | Leave blank to auto-generate from KRA, or enter your own custom code |
| Barcode | Product barcode or SKU for scanning |
Step 9: Register the Item
- Review all information
- Click “Register Item” button
- Wait for KRA registration to complete
- The item will appear in your items list with “Synced” status
Editing an Item
- Go to Items
- Find the item you want to edit
- Click Edit or the item name
- Make your changes
- Click “Save”
Note: Some fields may not be editable after the item is registered with KRA.
Item Status
| Status | Meaning |
|---|---|
| Active | Available for use in transactions |
| Inactive | Hidden from transaction forms |
To change status:
- Edit the item
- Toggle the status
- Save
Syncing Items with KRA
Items must be registered with KRA to be used in transactions.
Automatic Sync
- New items are typically synced automatically
- Status changes when sync completes
Manual Sync
If needed, look for a “Sync with KRA” button to manually sync items.
Sync Status
| Status | Meaning |
|---|---|
| Synced | Registered with KRA |
| Pending | Waiting to sync |
| Failed | Sync error - needs attention |
Item Best Practices
Creating Item Codes
Good codes are:
- Short but descriptive
- Consistent in format
- Easy to remember or type
Examples:
| Good | Why |
|---|---|
LAPTOP-HP-15 | Clear what it is |
SVC-CONSULT | Indicates service type |
DRINK-SODA-500ML | Specific and clear |
Avoid:
| Bad | Why |
|---|---|
12345 | Not descriptive |
Item 1 | Too vague |
asdfgh | Random, hard to use |
Setting Prices
- Set realistic default prices
- You can change prices during transactions
- Use consistent currency (KES)
Organizing Items
- Use consistent naming conventions
- Group similar items with similar codes
- Keep descriptions clear and accurate
Common Item Types
Physical Products
- Tax Type: Usually A (16% VAT)
- Quantity Unit: Pieces, boxes, kg, etc.
- Include HS codes for imports
Services
- Tax Type: Usually A (16% VAT)
- Quantity Unit: Hours, sessions, etc.
- Clear service descriptions
Exempt Items
- Tax Type: B (Exempt) or as applicable
- Follow KRA guidelines for exempt categories
Using Items in Transactions
In Sales
- Start typing item name or code
- Select from dropdown
- Quantity and price fields appear
- Adjust quantity as needed
- Price can be modified if needed
In Purchases
Same process, but recording what you’re buying.
In Stock Movements
Select items when recording stock in/out.
Frequently Asked Questions
Can I delete an item?
Usually no. Items used in transactions must be kept for records. You can mark them as Inactive instead.
Can I change the tax type after creating?
This may require KRA re-registration. Consult your administrator.
What if I don’t know the classification code?
- Search for similar items
- Ask your accountant
- Contact KRA for guidance
- Use the general category if unsure
Can I import items in bulk?
Bulk import may be available through your administrator. Contact them for large item lists.
Why can’t I find my item in sales?
Check that:
- Item status is Active
- Item is synced with KRA
- You’re searching correctly
- You have the right branch selected
Item Reports
Item information appears in:
- Transaction details
- Receipts and invoices
- Stock reports
- Sales summaries
Next: Learn about Viewing Transactions to track your activity