Offline URLs
Overview
To promptly update a customer to a business about a sale progress sync to KRA, DigiTax has a new Promise URL feature. Meaning that when integrating, you can formulate a QR code immediately to mitigate the following scenarios where:
- your system is running offline
- your system has intermittent connection to DigiTax API
- there's extended downtime on eTIMS and we have not resolved the transaction on the DigiTax API side
Format
The Offline URL is in the format: https://etims.ke/r
/<business_id>
/<trader_invoice_number>
Example: https://etims.ke/r/clno9s9zb02fqs601u5i79a06/v5241554
How do I get my business_id
?
business_id
?The business_id
is the alphanumeric value in the path when logged into the dashboard and viewing your business account.
Example:
If your URL is https://digitax.tech/dashboard/orgs/clqt3am8r000/apps/clqthjtvg0001l7
clqthjtvg0001l7
(which is after the ".../apps/") would be the business_id.
What is the trader_invoice_number
?
trader_invoice_number
?The trader_invoice_number
is the alphanumeric identifier you generate or pick from your system to tie an invoice in your records (or system records) with an invoice on DigiTax and consequently on eTIMS.
A maximum of 50 characters is allowed!
Currently, for offline URL to work the
<trader_invoice_number>
should only have characters that are safe to use in URLs without URL encoding.These are:
- Alphanumeric characters: A-Z, a-z, 0-9
- Hyphen: -
- Underscore: _
- Period (dot): .
- Tilde: ~
We'll release an update that allow other characters.
Completed status
If the transaction is complete, like the one above, you have a link to view the eTIMS verification.
URL of a complete transaction: https://etims.ke/r/clno9s9zb02fqs601u5i79a06/v5241554
See screenshot below.
Other statuses
If the transaction is not complete, like the one below, you do note get a link to view the eTIMS verification.
- URL of a failed transaction: https://etims.ke/r/clno9s9zb02fqs601u5i79a06/DR24251250
See screenshot below.
- URL of a submitted transaction: https://etims.ke/r/clno9s9zb02fqs601u5i79a06/SL24-100-095834436
See screenshot below.
Updated 4 months ago