Features

C-Tax provides a complete tax compliance solution for Kenyan businesses. Our platform automates eTIMS integration and simplifies tax management.

Core Features

Automated Invoicing

Create and submit invoices to Kenya Revenue Authority (KRA) eTIMS automatically with zero manual entry.

Key Benefits:

One-Click Submission: Generate compliant invoices and submit to eTIMS instantly
Batch Processing: Handle multiple invoices simultaneously
Auto-Validation: Built-in checks ensure compliance before submission
Real-Time Status: Track approval status in real-time
Error Handling: Automatic retry logic for failed submissions

Supported Transaction Types:

Normal Sales (S)
Copy Receipt (R)
Proforma Invoice (P)
Training Sales (T)


// Create and submit invoice
const invoice = await axios.post('/api/v1/sales', {
  invc_no: 'INV-2024-001',
  orgn_invc_no: 0,
  cust_tin: '000000000',
  cust_name: 'Customer Name',
  sales_ty_cd: 'N',
  rcpt_ty_cd: 'S',
  pmt_ty_cd: 'C',
  sales_sts_cd: '02',
  items: [
    {
      item_seq: 1,
      item_cd: 'ITEM001',
      item_nm: 'Product Name',
      qty: 1,
      prc: 1000,
      supply_amt: 1000,
      tax_ty_cd: 'A',
      tax_amt: 160,
      tot_amt: 1160
    }
  ]
});

Stock Management

Track inventory movements and sync with eTIMS in real-time for complete stock visibility.

Features:

Real-Time Sync: Stock movements automatically reported to eTIMS
Master Item Management: Create and manage your product catalog
Composition Tracking: Handle products with multiple components
Movement Types: Support for all SAR types (In, Out, Adjustments)
Historical Records: Complete audit trail of all stock changes

Stock Adjustment Request (SAR) Types:

11 - Stock In (Purchases, Returns)
12 - Stock Out (Sales, Damages)
13 - Stock Adjustment (Corrections)


// Record stock movement
const movement = await axios.post('/api/v1/stock/movements', {
  sar_no: 'SAR-2024-001',
  orgn_sar_no: 0,
  reg_ty_cd: 'M',
  sar_ty_cd: '11',
  ocr_dt: '20240115',
  tot_item_cnt: 1,
  items: [
    {
      item_seq: 1,
      item_cd: 'ITEM001',
      qty: 100,
      prc: 800,
      supply_amt: 80000,
      tax_amt: 12800,
      tot_amt: 92800,
      remark: 'New stock arrival'
    }
  ]
});

Purchase Management

Record supplier purchases and maintain complete procurement records with eTIMS compliance.

Capabilities:

Supplier Database: Maintain detailed supplier information
Purchase Recording: Track all procurement transactions
Tax Compliance: Automatic VAT and tax calculations
Approval Workflow: Multi-level approval support
Expense Tracking: Categorize and analyze purchasing patterns

Purchase Types:

Normal Purchases
Import Purchases
Service Purchases
Cash Purchases


// Record purchase
const purchase = await axios.post('/api/v1/purchases', {
  invc_no: 'PUR-2024-001',
  orgn_invc_no: 0,
  spplr_tin: '100000000',
  spplr_nm: 'Supplier Name',
  rcpt_ty_cd: 'P',
  pmt_ty_cd: 'C',
  cfm_dt: '20240115120000',
  sales_dt: '20240115',
  items: [
    {
      item_seq: 1,
      item_cd: 'ITEM001',
      item_nm: 'Product Name',
      qty: 50,
      prc: 800,
      supply_amt: 40000,
      tax_ty_cd: 'B',
      tax_amt: 6400,
      tot_amt: 46400
    }
  ]
});

Real-Time Reports & Analytics

Comprehensive dashboard with sales analytics, tax summaries, and compliance status monitoring.

Report Types:

Sales Reports: Daily, weekly, monthly sales summaries
Tax Reports: VAT collected, tax breakdown by category
Stock Reports: Inventory levels, movement history
Purchase Reports: Procurement analysis, supplier performance
Compliance Reports: eTIMS submission status, error logs

Analytics Features:

Interactive charts and graphs
Export to PDF, Excel, CSV
Custom date ranges
Branch-wise filtering
Product performance analysis

Dashboard Widgets:

Total revenue (daily, monthly, yearly)
Tax collected and payable
Top selling items
Low stock alerts
Failed transaction alerts
Compliance score

Multi-Branch Support

Manage multiple business locations from one central dashboard with branch-specific reporting.

Branch Management:

Centralized Control: Manage all branches from single account
Branch Hierarchy: Support for sub-branches and departments
Individual Devices: Separate eTIMS device per branch
Consolidated Reporting: Combined or branch-specific reports
User Permissions: Branch-level access control

Features:

Create unlimited branches
Assign managers to each branch
Branch-specific inventory
Inter-branch transfers
Consolidated tax reporting


// Create branch
const branch = await axios.post('/api/v1/branches', {
  bhf_id: '01',
  name: 'Downtown Branch',
  address: 'Moi Avenue, Nairobi',
  phone: '+254712345678',
  email: 'downtown@business.ke',
  manager_name: 'John Doe',
  location: {
    latitude: -1.2864,
    longitude: 36.8172
  }
});

Developer API

RESTful API to integrate C-Tax with your existing POS, ERP, or accounting systems.

API Features:

RESTful Design: Simple, predictable endpoints
Authentication: Secure Bearer token authentication
Rate Limiting: 60 requests per minute
Webhooks: Real-time notifications for events
SDKs Available: PHP, JavaScript, Python
Sandbox Environment: Test before going live

Supported Operations:

Sales transaction processing
Stock management
Purchase recording
Report generation
Branch management
Device configuration

API Documentation:

Interactive API explorer
Code examples in multiple languages
Postman collection
OpenAPI/Swagger specification


// Example API integration
const axios = require('axios');
 
const client = axios.create({
  baseURL: 'https://c-tax.1809ltd.co.ke',
  headers: {
    'Authorization': `Bearer ${process.env.CTAX_API_KEY}`,
    'Content-Type': 'application/json'
  }
});
 
// Process sale
async function processSale(saleData) {
  try {
    const response = await client.post('/api/v1/sales', saleData);
    return response.data;
  } catch (error) {
    console.error('Sale processing failed:', error.response.data);
    throw error;
  }
}

24/7 Support

Local support team ready to help whenever you need assistance with setup, troubleshooting, or compliance.

Support Channels:

Email Support: support@c-tax.ke
Phone Support: +254 700 000 000
Live Chat: Available 24/7 on dashboard
WhatsApp: Business support channel
Knowledge Base: Comprehensive documentation

Support Services:

Initial setup assistance
eTIMS device configuration
API integration support
Compliance consultation
Training for your team
Priority bug fixes

Response Times:

Critical issues: < 1 hour
High priority: < 4 hours
Normal priority: < 24 hours
Low priority: < 48 hours

Advanced Features

Async Transaction Processing

Handle high-volume transactions efficiently with asynchronous processing.

Benefits:

Non-blocking operations
Improved performance
Automatic retry mechanism
Webhook notifications on completion


// Async sale processing
const response = await axios.post('/api/v1/sales?async=true', saleData);
// Returns immediately with transaction ID
// Check status via webhook or polling

Webhook Notifications

Receive real-time updates about transaction status, approvals, and errors.

Available Events:

transaction.created - New transaction created
transaction.processing - Transaction being processed
transaction.completed - Transaction successfully processed by KRA
transaction.failed - Transaction submission failed
transaction.retrying - Transaction retry in progress


// Webhook payload example
{
  "event": "transaction.completed",
  "timestamp": "2025-01-15T14:30:00Z",
  "data": {
    "transaction_id": "9d3f4b1a-7c8e-4d2f-b5a6-1e3c9f8d2b4a",
    "invoice_no": "INV-2025-001",
    "receipt_no": "20250115-00-00001",
    "type": "sales",
    "status": "success",
    "synced_to_kra": true
  }
}

Multi-Currency Support

Handle transactions in multiple currencies with automatic conversion (coming soon).

Offline Mode

Continue processing transactions even without internet connectivity, with automatic sync when online (coming soon).

Custom Reporting

Create custom reports with your own metrics and KPIs using our report builder (coming soon).

Security Features

Data Encryption

All data encrypted at rest and in transit
TLS 1.3 for API communications
AES-256 encryption for stored data

Access Control

Role-based access control (RBAC)
Multi-factor authentication (MFA)
IP whitelisting for API access
Audit logs for all actions

Compliance

KRA eTIMS certified
GDPR compliant
Regular security audits
SOC 2 Type II (in progress)

Integration Capabilities

POS Systems

Direct integration with major POS systems
Real-time transaction sync
Product catalog synchronization

Accounting Software

QuickBooks integration
Sage integration
Xero integration
Custom ERP integrations

E-Commerce Platforms

WooCommerce plugin
Shopify app
Magento extension
Custom integrations via API

Getting Started

Ready to automate your tax compliance? Here’s how to get started:

Sign Up - Create your account
Configure Branch - Set up your business branches
Configure Device - Set up your VSCU device for each branch
API Access - Get your API credentials
Sync Reference Data - Sync codes from KRA
First Transaction - Process your first sale

Need help? Contact our support team at support@c-tax.ke