Retaela, Powering Retail Intelligence
Get Started

Documentation

Ushuru eTIMS API

Complete reference for the Ushuru Kenya Revenue Authority eTIMS OSCU integration API. Submit invoices, register items, and stay compliant with Kenya Revenue Authority requirements.

Base URL

http://localhost:8100/api/v1

Version: v1.0

Format: JSON

Key Endpoints

GET
/api/v1/health

Check service availability

GET
/api/v1/status

Device and taxpayer status

POST
/api/v1/initialize

Initialize device and sync reference data

POST
/api/v1/sync

Sync latest reference data from Kenya Revenue Authority

GET
/api/v1/codes

Fetch Kenya Revenue Authority code lookup tables

GET
/api/v1/customers/:pin

Look up a buyer by Kenya Revenue Authority PIN

POST
/api/v1/items/service

Register a service item

POST
/api/v1/items/goods

Register a physical goods item

GET
/api/v1/items

List all registered items

POST
/api/v1/sales

Submit a sales invoice to Kenya Revenue Authority

POST
/api/v1/sales/credit-note

Issue a credit note for a prior sale

GET
/api/v1/purchases

Fetch incoming purchase invoices

POST
/api/v1/purchases

Confirm receipt of a purchase invoice

POST
/api/v1/stock/io

Record a stock movement transaction

PUT
/api/v1/stock/master

Update master stock quantity for an item

67 endpoints documented. Use the sidebar to browse the full API reference.