Register a Goods Item

POST/api/v1/items/goods

Register a physical goods item with Kenya Revenue Authority using a simplified interface. The API sets item classification to GD (Goods) and fills packaging defaults. Use this for physical products, equipment, and consumables.

Requires x-api-key

http://localhost:8100/api/v1/items/goods

Headers

Field	Type	Required	Description
x-api-key	string	Required	Your Ushuru API key
Content-Type	string	Required	Must be application/json

Request Body

Field	Type	Required	Description
itemName	string	Required	Display name of the goods item (max 100 chars)
taxType	string	Required	Tax type code: A=Exempt, B=16% VAT, C=0% VAT, D=Non-VAT
price	number	Optional	Default unit price in KES inclusive of VAT
itemCode	string	Optional	Custom item code. Auto-generated if omitted.
qtyUnitCd	string	Optional	Quantity unit code (default: U=Unit). Use KG, L, M for weight/volume/length.
pkgUnitCd	string	Optional	Packaging unit code (default: NT=Each).
useYn	string	Optional	Active flag: Y=Active, N=Inactive. Defaults to Y.

Request

{
  "itemName": "USB-C Charging Cable",
  "taxType": "B",
  "price": 850,
  "qtyUnitCd": "U",
  "pkgUnitCd": "NT"
}

Response

{
  "resultCd": "000",
  "resultMsg": "Item registered successfully",
  "data": {
    "itemCd": "GD0000000Z001",
    "itemNm": "USB-C Charging Cable",
    "itemClsCd": "GD",
    "taxTyCd": "B",
    "qtyUnitCd": "U",
    "pkgUnitCd": "NT",
    "useYn": "Y",
    "regDt": "20240115"
  }
}

curl -X POST http://localhost:8100/api/v1/items/goods \\
  -H "x-api-key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "itemName": "USB-C Charging Cable",
    "taxType": "B",
    "price": 850
  }'