eTIMS Accounts
A record describes one connection to the eTIMS system of the Kenya Revenue Authority (KRA): which intermediary service and which key to send documents with, and how to translate ERPJS codes into KRA's language — VAT codes into tax types, units of measure into KRA codes.
The «Company default» account sends all of the company's invoices. A till can be given its own — if the shop has its own KRA device. Without an open «Company default» account, invoices are not sent to eTIMS at all, and ERPJS gives no warning about it; till receipts with their own account go through it.
Where to find it: Modules → eTIMS → Registers → eTIMS Accounts
A worked example
Account ET1:
| Field | Value | Why |
|---|---|---|
| Code | ET1 |
the till and the eTIMS Receipts records refer to it |
| eTIMS URL | https://… |
the intermediary service's address, only http:// or https:// |
| eTIMS API key | a mask | the intermediary's key; stored encrypted |
| Company default | ✓ | the company's invoices go out through this record |
| Default payment type | 02 - Credit |
the payment type of a back-office invoice that is not a cash one |
The key. After saving, the field shows a mask. Leave it as is — the key stays; type a new one — it replaces the old one; clear the field — the key is erased on saving. The key never gets into the exchange log or into API responses. If you change the URL, type the key again: the system will not send the old key to a new address. An open record without a key is not saved — «eTIMS API key is required».
One record — one KRA device. A new key for the same device goes into the same record. For another device, create a new record instead of changing the key in the old one. A retry of a document whose answer was lost, and credit notes to invoices already sent, go through the record the document went through — under the old code with a new key they would reach a different device.
eTIMS VAT mapping — the main table
| VAT Code | eTIMS tax type |
|---|---|
V16 |
B - Standard rate 16% |
V0 |
C - Zero rated |
EX |
A - Exempt |
Every VAT code that appears on invoices must be here. The code's rate must match the rate of the KRA type (B — 16%, E — 8%, A, C, D — 0%): otherwise the document is not sent, and the error names the row and the code.
eTIMS item codes and unit mapping
The «eTIMS item codes» tab holds the defaults for items that have codes neither in eTIMS Item Codes nor in eTIMS Item Group Codes: the KRA classification code, the packaging and unit codes, the country of origin. This is the last step: before the defaults, the packaging and unit codes come from the unit mapping (below), and the country from the item card's «Country of Origin» field if it holds a two-letter ISO code.
The «eTIMS unit mapping» tab holds an ERPJS unit of measure and its KRA codes (unit and packaging). A unit of measure used here cannot be deleted.
Connection test
«Test Connection» in the window menu sends an empty item list to the intermediary. Success shows «eTIMS connection checked successfully»; a refusal by the intermediary shows «eTIMS answered» and its text. The button sends the saved key only to the saved URL: if you changed the URL in the window, type the key.
Typical situations
«Another eTIMS account is already the company default». Clear the flag on the old record or close it.
«The saved key is sent only to the saved server. To use another server, type the key». The URL has changed but the key was not typed (the field still shows the mask) — type the key in again.
Till receipts go out through the wrong account. Check the «eTIMS account» field in the till's POS payment modes and in POS settings: till → POS settings → default account.
The full setup is in the eTIMS guide.