Profile status
Needs verification
Tax compliance
Tax reportseTIMS Queue
Canonical payloads, idempotency keys, retry safety, provider responses and manual review.
eTIMS status
Manual tracking mode
Current VAT balance
KES 0.00
Reconciliation
No posted tax ledger
Review pending queue
Ready for real business records, approval checks and audit evidence.
Retry safe failures
Ready for real business records, approval checks and audit evidence.
Resolve duplicate warnings
Ready for real business records, approval checks and audit evidence.
VAT treatment register
VAT_STDStandard VAT16%Sales and purchasesRecoverable where eligible
VAT_ZEROZero-rated0%Exports and zero-rated suppliesReport separately from exempt
VAT_EXEMPTExempt0%Exempt suppliesNo output VAT charged
VAT_OUT_OF_SCOPEOut of scope0%Non-taxable movementsExcluded from VAT return boxes
VAT_NON_RECOVERABLENon-recoverable input16%Blocked input VATPosted to expense or asset cost
VAT_PARTIALPartially recoverable input16%Mixed-use purchasesRecoverability percentage stored
eTIMS lifecycle
pendingqueuedsubmittingsubmittedacknowledgedacceptedrejectedfailedretry scheduledneeds reviewduplicate prevented
The eTIMS layer is provider-neutral and stores credential references only; certified adapter code can be added behind the same queue later.
Tax returns are prepared from posted tax ledger entries so draft sales, purchases and journals do not leak into statutory reports.
Closed tax periods reject new tax documents and tax ledger entries unless a controlled reopening workflow records the reason.
Registered tax reports
Business Tax ProfileTax Rule RegisterVAT Code RegisterProduct Tax MappingCustomer Tax RegisterSupplier Tax RegisterSales Tax Invoice RegisterSales VAT LedgerPurchase VAT LedgerOutput VAT ReportInput VAT ReportRecoverable Input VAT ReportNon-Recoverable VAT ReportZero-Rated Sales ReportExempt Sales ReportOut-of-Scope Sales ReportVAT Return PreparationVAT ReconciliationVAT Control Account ReconciliationVAT Credit Note RegisterVAT Debit Note RegistereTIMS Submission RegistereTIMS Failed DocumentseTIMS Pending DocumentseTIMS Accepted DocumentseTIMS Retry ReportExternal Document Audit ReportSupplier Tax Document VerificationWithholding Tax RegisterWithholding Tax Return ScheduleWithholding Certificate RegisterWithholding VAT RegisterTurnover Tax Schedule foundationExcise and Levy Report foundationTax Payment RegisterTax Compliance CalendarTax Period StatusTax Audit Evidence RegisterTax Diagnostics ReportTax Audit Trail
Profile setup checks
KRA PIN captured and format-reviewed
VAT registration status and effective date confirmed
eTIMS branch or outlet references mapped
VAT, withholding and levy obligations selected
Tax contact and evidence retention owner assigned
Default VAT codes mapped to products and purchase categories