ICORE eTIMS Gateway

Initialize device

POST /api/v1/devices/initialize

Use this first when pairing a VSCU or OSCU device.

Idle
Response appears here.

Product form data

GET /api/v1/master-data/product-form

Reference codes used by product registration.

No JSON body.
Idle
Response appears here.

Item classifications

GET /api/v1/master-data/item-classifications?lastReqDt=20230101000000

Classification list for goods and services.

No JSON body.
Idle
Response appears here.

Customer lookup

GET /api/v1/customers/A000000001Z

Check a customer PIN before invoicing.

No JSON body.
Idle
Response appears here.

Registered items

GET /api/v1/items?lastReqDt=20230101000000

Read items already known to the gateway.

No JSON body.
Idle
Response appears here.

Item composition

POST /api/v1/items/composition

Attach raw materials or components to a finished item.

Idle
Response appears here.

Sales invoice

POST /api/v1/sales

Submit a normal sale from the client system.

Idle
Response appears here.

Credit note

POST /api/v1/sales

Submit a credit note through the same sales endpoint.

Idle
Response appears here.

Pending purchases

GET /api/v1/purchases?lastReqDt=20100101000000

Pull pending purchase documents.

No JSON body.
Idle
Response appears here.

Stock master

POST /api/v1/stock/master

Send stock master data for a branch.

Idle
Response appears here.

Imported items

GET /api/v1/imports?lastReqDt=20230101000000

Fetch imported items awaiting action.

No JSON body.
Idle
Response appears here.

Branches

GET /api/v1/branches

Read branches linked to the taxpayer.

No JSON body.
Idle
Response appears here.

Branch customer

POST /api/v1/branches/customers

Create or update a customer under a branch.

Idle
Response appears here.

Notices

GET /api/v1/notices?lastReqDt=20230101000000

Read notices from KRA.

No JSON body.
Idle
Response appears here.

Branch user

POST /api/v1/branches/users

Create a branch user for setup tests.

Idle
Response appears here.