Sign in

v1

latestOpenAPI 3.0.1Apache 2.02026-07-26401961.7 KB
Items

Update an item

Update an item

put/items/{item_id}

Request body

item_namestring

The name of an item

tax_type_codestring

The tax type code of the item

default_unit_pricenumber

The default price of the item

Example request

{
  "item_name": "DigiTax Product 02",
  "tax_type_code": "A",
  "default_unit_price": 1000
}

Response

Success

idstring required

Item ID in DigiTax

item_class_codestring required

The item class code of the item. <br>Refer to the DigiTax Kenya eTIMS Item Classification Code list for more information.

item_type_codestring required

The item type code of the item

item_namestring required

The name of the item

origin_nation_codestring required

The country of origin code of the item

package_unit_codestring required

The package unit code of the item

quantity_unit_codestring required

The quantity unit code of the item

tax_type_codestring required

The tax type code of the item

default_unit_pricenumber required

The default price of the item

etims_item_codestring required

The eTIMS item code of the item

is_stock_itemboolean required

Indicates whether the item is a stock item or not. Can either be "false" or "true"

stock_quantitynumber required

The quantity of items in stock

activeboolean required

Indicates whether the item is active or not

status'PENDING' | 'FAILED' | 'COMPLETE'

sync status against eTIMS

item_bar_codestring

The bar code or unique product code(UPC) of the item

leviesstring[]

Example response

{
  "id": "item_01HC3J1VVVM05YCTS61G7V3KC6",
  "item_name": "DigiTax Product 01",
  "origin_nation_code": "KE",
  "package_unit_code": "NT",
  "quantity_unit_code": "U",
  "tax_type_code": "D",
  "default_unit_price": 1000,
  "etims_item_code": "DT-67717-E7GcGbvYDy",
  "stock_quantity": 1000,
  "active": true,
  "status": "COMPLETE",
  "item_bar_code": "012345678905"
}