Track the lifecycle of every invoice from submission through completion using Kenya Revenue Authority eTIMS transaction status codes.
Sales Status Codes (salesSttsCd)
| Code | Status | Description |
|---|---|---|
| 01 | Awaiting Approval | Invoice submitted, pending Kenya Revenue Authority confirmation |
| 02 | Approved | Kenya Revenue Authority confirmed, receipt signature returned, use for normal sales |
| 03 | Cancellation Requested | Cancellation has been initiated |
| 04 | Cancelled | Invoice has been voided |
| 05 | Credit Note | Invoice is linked to a credit note |
Receipt Type Codes (rcptTyCd)
| Code | Type | Description |
|---|---|---|
| S | Sale | Standard sale, use for all regular invoices |
| R | Return | Reverse invoice or return transaction |
| T | Training | Test / training mode, not reported to Kenya Revenue Authority |
| C | Copy | Copy of an existing receipt |
Payment Type Codes (pmtTyCd)
| Code | Payment Method |
|---|---|
| 01 | Cash |
| 02 | Credit |
| 03 | Cheque |
| 04 | Voucher |
| 05 | Mobile Money (general) |
| 06 | RTGS |
| 07 | EFT |
| 08 | Credit Card |
| 09 | M-PESA |
-
01: Cash
-
02: Credit
-
03: Cheque
-
04: Voucher
-
05: Mobile Money (general)
-
06: RTGS
-
07: EFT
-
08: Credit Card
-
09: M-PESA
Important
Always use
salesSttsCd: '02' (Approved) for normal sales. Using '01' (Awaiting Approval) means Kenya Revenue Authority has not yet confirmed the transaction, the receipt is not yet legally valid.Stock Movement Codes (sarTyCd)
Used when recording stock movements via POST /api/v1/stock-io.
| Code | Direction | Description |
|---|---|---|
| 01 | In | Stock in from purchase |
| 02 | In | Stock in from customer return |
| 03 | In | Stock in direct |
| 11 | Out | Stock out from sale |
| 12 | Out | Stock out, return to supplier |
| 13 | Out | Stock out direct / transfer |