Save Item

The Save Item API is used to register or update product master data in the KRA eTIMS OSCU system.

Each item represents a sellable or purchasable product and must be registered before it can be used in:

• Sales transactions
• Purchase transactions
• Inventory management
• Tax calculations

Endpoint

POST /saveItem

---

Purpose

This API allows you to:

• Register new items in eTIMS
• Update existing item information
• Assign tax types, units, and pricing
• Control item availability (active / inactive)

⚠️ Items must reference valid classification, unit, tax, and nation codes obtained from the Code Lists and Item Classifications APIs.

---

Request Object: ItemSaveReq

Request Fields

Field	Description	Type	Required	Length
itemClsCd	Item Classification Code	CHAR	✅ Yes	10
itemCd	Item Code	CHAR	✅ Yes	20
itemTyCd	Item Type Code	CHAR	✅ Yes	5
itemNm	Item Name	CHAR	✅ Yes	200
itemStdNm	Item Standard Name	CHAR	❌ No	200
orgnNatCd	Origin Nation Code	CHAR	✅ Yes	5
pkgUnitCd	Packaging Unit Code	CHAR	✅ Yes	5
qtyUnitCd	Quantity Unit Code	CHAR	✅ Yes	5
taxTyCd	Taxation Type Code	CHAR	✅ Yes	5
btchNo	Batch Number	CHAR	❌ No	10
bcd	Barcode	CHAR	❌ No	20
dftPrc	Default Unit Price	NUMBER	✅ Yes	18,2
grpPrcL1	Group 1 Unit Price	NUMBER	❌ No	18,2
grpPrcL2	Group 2 Unit Price	NUMBER	❌ No	18,2
grpPrcL3	Group 3 Unit Price	NUMBER	❌ No	18,2
grpPrcL4	Group 4 Unit Price	NUMBER	❌ No	18,2
grpPrcL5	Group 5 Unit Price	NUMBER	❌ No	18,2
addInfo	Additional Information	CHAR	❌ No	7
sftyQty	Safety Quantity	NUMBER	❌ No	13,2
isrcAplcbYn	Insurance Applicable (Y/N)	CHAR	✅ Yes	1
useYn	Active Status (Y/N)	CHAR	✅ Yes	1
regrId	Registration ID	CHAR	✅ Yes	20
regrNm	Registration Name	CHAR	✅ Yes	60
modrId	Modifier ID	CHAR	✅ Yes	20
modrNm	Modifier Name	CHAR	✅ Yes	60

---

JSON Request Example

{
  "itemCd": "KE1NTXU0000006",
  "itemClsCd": "5059690800",
  "itemTyCd": "1",
  "itemNm": "test material item3",
  "itemStdNm": null,
  "orgnNatCd": "KE",
  "pkgUnitCd": "NT",
  "qtyUnitCd": "U",
  "taxTyCd": "B",
  "btchNo": null,
  "bcd": null,
  "dftPrc": 3500,
  "grpPrcL1": 3500,
  "grpPrcL2": 3500,
  "grpPrcL3": 3500,
  "grpPrcL4": 3500,
  "grpPrcL5": null,
  "addInfo": null,
  "sftyQty": null,
  "isrcAplcbYn": "N",
  "useYn": "Y",
  "regrId": "Test",
  "regrNm": "Test",
  "modrId": "Test",
  "modrNm": "Test"
}

---

Response Object: ItemSaveRes

Response Fields

Field	Description	Type
resultCd	Result Code (000 = success)	CHAR(3)
resultMsg	Result Message	CHAR
resultDt	Result Timestamp	CHAR(14)

---

JSON Response Example

{
  "resultCd": "000",
  "resultMsg": "It is succeeded",
  "resultDt": "20200226193918",
  "data": null
}

---

SDK Usage Examples

Python

item_data = {
    'itemCd': 'KE1NTXU0000006',
    'itemClsCd': '5059690800',
    'itemTyCd': '1',
    'itemNm': 'test material item3',
    'itemStdNm': None,
    'orgnNatCd': 'KE',
    'pkgUnitCd': 'NT',
    'qtyUnitCd': 'U',
    'taxTyCd': 'B',
    'dftPrc': 3500,
    'isrcAplcbYn': 'N',
    'useYn': 'Y',
    'regrId': 'Test',
    'regrNm': 'Test',
    'modrId': 'Test',
    'modrNm': 'Test',
}

response = etims.save_item(item_data)

print("Result Code:", response.get('resultCd'))
print("Result Message:", response.get('resultMsg'))
print("Result Date:", response.get('resultDt'))

JavaScript / Typescript

const response = await client.saveItem({
  itemCd: `KE1NTXU${Date.now()}`,
  itemClsCd: '5059690800',
  itemTyCd: '1',
  itemNm: `Test Item ${Date.now()}`,
  orgnNatCd: 'KE',
  pkgUnitCd: 'NT',
  qtyUnitCd: 'U',
  taxTyCd: 'B',
  dftPrc: 3500,
  isrcAplcbYn: 'N',
  useYn: 'Y',
  regrId: 'Test',
  regrNm: 'Test',
  modrId: 'Test',
  modrNm: 'Test',
});

console.log(`✅ Item saved: ${response.resultMsg}`);

PHP

$requestData = [
    'itemCd'      => 'KE1NTXU0000006',
    'itemClsCd'   => '5059690800',
    'itemTyCd'    => '1',
    'itemNm'      => 'test material item3',
    'orgnNatCd'   => 'KE',
    'pkgUnitCd'   => 'NT',
    'qtyUnitCd'   => 'U',
    'taxTyCd'     => 'B',
    'dftPrc'      => 3500,
    'isrcAplcbYn' => 'N',
    'useYn'       => 'Y',
    'regrId'      => 'Test',
    'regrNm'      => 'Test',
    'modrId'      => 'Test',
    'modrNm'      => 'Test',
];

$response = $etims->saveItem($requestData);

echo "Result Code: {$response['resultCd']}\n";
echo "Result Message: {$response['resultMsg']}\n";
echo "Result Date: {$response['resultDt']}\n";

---

Best Practices

• Generate unique item codes
• Validate all reference codes before saving
• Cache item master data locally
• Do not delete items — set useYn = 'N' instead

---

Related APIs

• 👉 Item Classifications
• 👉 Code Lists