BlueDuka

Send your sales to KRA eTIMS

BlueDuka sends every sale to KRA through eTIMS (OSCU) using your shop's own KRA registration. You apply to KRA yourself; once KRA approves, you enter your details in BlueDuka, and receipts carry KRA's invoice number, signature and QR code. Returns go to KRA as credit notes.

BlueDuka is not a KRA-certified eTIMS integrator. KRA decides whether to approve your OSCU request, and your shop stays responsible for its own tax records. BlueDuka only sends KRA what you record, with your details, which it keeps encrypted.

Before you start

  • BlueDuka on the Business plan or above (or the 14-day free trial)
  • Your shop's KRA PIN and iTax password
  • Time for KRA to approve your OSCU request. You can sell on BlueDuka meanwhile; receipts simply don't go to KRA yet

Step by step

  1. Have your KRA PIN and iTax password

    They are the same as for filing returns. If you have forgotten the password, reset it on itax.kra.go.ke.

  2. Apply to KRA for OSCU yourself

    On KRA's eTIMS portal (etims.kra.go.ke) choose Sign Up, use the PIN option and confirm the code KRA sends to your phone. To try it first, KRA's test portal is etims-sbx.kra.go.ke.

    Sign in, open Service Request, choose eTIMS and pick OSCU (Online Sales Control Unit), the type for shops that sell with their own software. Fill in and upload KRA's eTIMS Commitment Form.

    Register each branch that sells. The head office is usually branch 00.

  3. Wait for KRA's approval

    KRA sends an SMS when it approves your request. Note your branch id and the device serial number for OSCU.

    If KRA also gave you API keys (a Consumer Key and Consumer Secret from its developer portal), keep them. Otherwise you don't need any.

  4. Connect in BlueDuka

    Open Integrations, then KRA eTIMS. Tick that this is your shop's own registration and enter your KRA PIN, branch id, device serial and, if KRA gave you any, the API keys.

    Test in the sandbox first if you registered there. When KRA has approved you, tick that KRA approved the request, choose Live and press Save and connect.

  5. Set the tax on your products and check a receipt

    Give each product its tax category (VAT 16%, exempt or zero-rated) and choose a default KRA item class.

    Make a sale: within seconds the receipt shows KRA's invoice number, signature and QR code.

Questions for KRA

KRA's eTIMS team answers questions about registration and approval at timsupport@kra.go.ke. For help with BlueDuka's side, call or WhatsApp +254 727 177 155, Monday to Saturday. Never share your iTax password with anyone, including us.

Open BlueDuka