Metadata-Version: 2.4
Name: kra-etims-sdk
Version: 0.1.5
Summary: Python SDK for KRA eTIMS OSCU/VSCU API
Author: Emmanuel Bartile
License: MIT
Project-URL: Homepage, https://github.com/paybillke/kra-etims-python-sdk
Project-URL: Issues, https://github.com/paybillke/kra-etims-python-sdk/issues
Keywords: KRA,eTIMS,OSCU,VSCU,Kenya,Tax
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Requires-Python: >=3.9
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: requests>=2.31.0
Requires-Dist: pydantic>=2.5
Dynamic: license-file

<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.
