eTIMS Reference Code Tables

Complete reference for all code tables used across the eTIMS API. These codes are defined by KRA and are required for proper invoice formatting, tax classification, and compliance.

Table of Contents

1. Overview
2. Tax Types
3. Receipt Types
4. Payment Types
5. Item Types
6. Stock Transaction Codes
7. Invoice Statuses
8. Sales Types
9. Purchase Types
10. Package Units
11. Quantity Units
12. Country Codes
13. Currency Codes
14. API Endpoints

Overview

Code tables can be retrieved from KRA via the following endpoints:

Tax Types

Tax type codes classify items by their VAT treatment. Every item on an invoice must have a tax type.

Tax Calculation

For tax-inclusive prices (standard in Kenya):

Taxable Amount = Total Amount / (1 + Tax Rate)
Tax Amount = Total Amount - Taxable Amount

Example (Standard Rate B, 16%):

Total Amount: 11,600.00
Taxable Amount: 11,600 / 1.16 = 10,000.00
Tax Amount: 11,600 - 10,000 = 1,600.00

When to Use Each Tax Type

Receipt Types

Receipt type codes indicate the nature of the transaction receipt.

Payment Types

Item Types

Stock Transaction Codes

Movement types for stock in/out operations.

Common Scenarios

Invoice Statuses

Status Flow

pending --> submitted --> approved
                    |
                    +--> rejected --> (fix) --> submitted
                    |
                    +--> failed --> (retry) --> submitted

approved --> cancelled (via credit note)

Sales Types

Purchase Types

Package Units

Quantity Units

Country Codes

Common country codes used in eTIMS (ISO 3166-1 alpha-2):

Use GET /api/etims/codes/countries for the full list.

Currency Codes

Common currencies:

Use GET /api/etims/codes/currencies for the full list with exchange rates.

API Endpoints

Get Countries

curl -X GET \
  https://yourtenant.salami.dgl.co.ke/api/etims/codes/countries \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

{
  "success": true,
  "data": [
    {"code": "KE", "name": "Kenya"},
    {"code": "UG", "name": "Uganda"},
    {"code": "TZ", "name": "Tanzania"}
  ]
}

Get Currencies

curl -X GET \
  https://yourtenant.salami.dgl.co.ke/api/etims/codes/currencies \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

{
  "success": true,
  "data": [
    {"code": "KES", "name": "Kenyan Shilling", "rate": 1.0},
    {"code": "USD", "name": "US Dollar", "rate": 129.50},
    {"code": "EUR", "name": "Euro", "rate": 142.30}
  ]
}

Get Payment Types

curl -X GET \
  https://yourtenant.salami.dgl.co.ke/api/etims/codes/payment-types \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

{
  "success": true,
  "data": [
    {"code": "01", "name": "Cash"},
    {"code": "02", "name": "Credit"},
    {"code": "03", "name": "Cheque"},
    {"code": "04", "name": "Mobile Money"},
    {"code": "05", "name": "Card"},
    {"code": "06", "name": "Other"}
  ]
}

Get Tax Types

curl -X GET \
  https://yourtenant.salami.dgl.co.ke/api/etims/codes/tax-types \
  -H 'Authorization: Bearer YOUR_API_TOKEN'

{
  "success": true,
  "data": [
    {"code": "A", "name": "VAT Exempt", "rate": 0},
    {"code": "B", "name": "VAT 16% (Standard)", "rate": 16},
    {"code": "C", "name": "VAT 8% (Reduced)", "rate": 8},
    {"code": "D", "name": "Non-VAT", "rate": 0},
    {"code": "E", "name": "Zero-Rated", "rate": 0}
  ]
}

Related Documentation

• eTIMS Sales -- Uses receipt types, payment types, tax types
• eTIMS Items -- Uses item types, package/quantity units
• eTIMS Purchases -- Uses purchase types
• eTIMS Device -- Device configuration

Back to: eTIMS Sales | eTIMS Items