semvec/pypi-packages huggingface dataset:
kra-etims-sdk 0.1.5
Python SDK for KRA eTIMS OSCU/VSCU API
License: MIT
Requires Python: >=3.9
Keywords: KRA, eTIMS, OSCU, VSCU, Kenya, Tax

<p align="center">
  <a href="https://paybill.ke" target="_blank">
    <picture>
      <source media="(prefers-color-scheme: dark)" srcset="https://paybill.ke/logo-wordmark--dark.png">
      <img src="https://paybill.ke/logo-wordmark--light.png" width="180" alt="Paybill Kenya Logo">
    </picture>
  </a>
</p>

# KRA eTIMS OSCU/VSCU Integration SDK (Python)

![Python](https://img.shields.io/badge/Python-3.9%2B-blue?logo=python)
![Pydantic](https://img.shields.io/badge/Pydantic-v2-3a56c5?logo=pydantic)
![License](https://img.shields.io/badge/License-MIT-green)
![KRA eTIMS](https://img.shields.io/badge/KRA-eTIMS_OSCU-0066CC)
![Postman Compliant](https://img.shields.io/badge/Postman-Compliant-FF6C37?logo=postman)
![Pytest Tested](https://img.shields.io/badge/Tests-Pytest-3776AB?logo=pytest)

A production-ready **Python SDK** for integrating with the Kenya Revenue Authority (KRA) **eTIMS OSCU** (Online Sales Control Unit) and **eTIMS VSCU** (Virtual Sales Control Unit) API. Built to match the official Postman collection specifications with strict header compliance, token management, and comprehensive payload 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**  
📧 support@paybill.dev | 📱 +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.