A NodeJs SDK for integrating with the Kenya Revenue Authority (KRA) Electronic Tax Invoice Management System (eTims) API
# KRA eTIMS OSCU/VSCU Integration SDK (JavaScript/TypeScript)
A production-ready **TypeScript SDK** for integrating with the Kenya Revenue Authority (KRA) **eTIMS OSCU** (Online Sales Control Unit) and **eTIMS VSCU** (Virtual Sales Control Unit) APIs.
Built in accordance with the official KRA specifications, the SDK provides strict header compliance, secure token lifecycle management, and robust Joi-based validation.
**Official KRA Specifications**
📄 OSCU Specification (v2.0):
kra.go.ke
📄 VSCU Specification (v2.0):
kra.go.ke
> ⚠️ **Important Notice**: The current release implements the **OSCU specification**.
> Support for the **VSCU specification** will be introduced in upcoming versions.
---
## Author
**Bartile Emmanuel**
📧 support@paybill.dev | 📱 +254 757 807 150
*Lead Developer, Paybill Kenya*
📘 OSCU Documentation:
paybill.ke
📘 VSCU Documentation:
paybill.ke
---
## License
MIT © 2025–2026 Paybill Kenya Limited
🇰🇪 **Proudly Made in Kenya** – Supporting digital tax compliance across East Africa.