Skip to content

paybillke/kra-etims-js-sdk

Paybill Kenya Logo

KRA eTIMS OSCU/VSCU Integration SDK (JavaScript/TypeScript)

Node.js TypeScript License KRA eTIMS Postman Compliant Jest Tested Joi Validated

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): https://www.kra.go.ke/images/publications/OSCU_Specification_Document_v2.0.pdf
📄 VSCU Specification (v2.0): https://www.kra.go.ke/images/publications/VSCU_Specification_Document_v2.0.pdf

⚠️ Important Notice: The current release implements the OSCU specification.
Support for the VSCU specification will be introduced in upcoming versions.


Author

Bartile Emmanuel
📧 [email protected] | 📱 +254 757 807 150
Lead Developer, Paybill Kenya

📘 OSCU Documentation: https://paybill.ke/docs/kra-etims-oscu
📘 VSCU Documentation: https://paybill.ke/docs/kra-etims-vscu


License

MIT © 2025–2026 Paybill Kenya Limited

🇰🇪 Proudly Made in Kenya – Supporting digital tax compliance across East Africa.

About

A NodeJs SDK for integrating with the Kenya Revenue Authority (KRA) Electronic Tax Invoice Management System (eTims) API

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Sponsor this project

Contributors