DIdigitax
Imports

Link import item to an item in DigiTax

Links an imported item to an existing DigiTax item and adds the imported quantity to that item's stock balance. If the import is already linked, its stock is not added again.

put/imports/{import_id}/link

Request

  • Base URL
    https://api.digitax.tech/ke/v2
  • Auth
    API key in header X-API-Key

Path parameters

import_idstring required
Example:import_01HC3J1VVVM05YCTS61G7V3KC6

The DigiTax ID of the import item to link.

Request body

item_idstring required

The DigiTax ID of the existing item to link to the import item.

Example request

{
  "item_id": "item_01HC3J1VVVM05YCTS61G7V3KC6"
}

Response

Success

idstring required

The DigiTax ID of the import.

task_codestring required

The code identifying the import task.

declaration_datestring date-time required

Declaration date-time in ISO 8601 format

item_sequenceinteger required

The sequence number of the item in the import declaration.

declaration_numberstring required

The number identifying the import declaration.

hs_codestring required

The Harmonized System code used to classify the imported item.

item_namestring required

The name of the imported item.

origin_nation_codestring required

The country code identifying the item's country of origin.

import_item_status_codestring required

The code identifying the import item's status.

export_nation_codestring required

The country code identifying the exporting country.

packageinteger required

The number of packages for the imported item.

package_unit_codestring required

The code identifying the package unit.

quantityinteger required

The quantity of the imported item.

quantity_unit_codestring required

The code identifying the unit used to measure the quantity.

gross_weightinteger required

The gross weight of the imported item.

net_weightinteger required

The net weight of the imported item.

supplier_namestring required

The name of the supplier of the imported item.

agent_namestring required

The name of the agent handling the import.

invoice_foreign_currency_amountinteger required

The invoice amount in the foreign currency.

invoice_foreign_currency_codestring required

The code identifying the invoice's foreign currency.

invoice_foreign_currency_ratenumber required

The exchange rate applied to the foreign currency amount.

import_item_statusstring required

The current status of the imported item.

item_idstring required

The DigiTax ID of the associated item.

item_class_codestring required

The classification code of the imported item.

item_codestring required

The code identifying the imported item.

Example response

{
  "id": "import_01HC3J1VVVM05YCTS61G7V3KC6",
  "task_code": "202607141365045",
  "declaration_date": "2026-07-14T21:00:00.000Z",
  "item_sequence": 1,
  "declaration_number": "23BUSIM400040606",
  "hs_code": "30049000",
  "item_name": "MEDICAMENT; NORMAL SALINE 0.9% I.V. [ NS ]; CT; 1450; 500ML;",
  "origin_nation_code": "UG",
  "import_item_status_code": "2",
  "export_nation_code": "UG",
  "package": 17,
  "package_unit_code": "KGM",
  "quantity": 23925,
  "quantity_unit_code": "KGM",
  "gross_weight": 24650,
  "net_weight": 23925,
  "supplier_name": "ABACUS PARENTERAL DRUGS LIMITED",
  "agent_name": "Kandito International Company Kenya Limited",
  "invoice_foreign_currency_amount": 14355,
  "invoice_foreign_currency_code": "USD",
  "invoice_foreign_currency_rate": 124.45,
  "import_item_status": "UPDATED",
  "item_id": "item_01HC3J1VVVM05YCTS61G7V3KC6",
  "item_class_code": "30103604",
  "item_code": "KE2CRM0000015"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.