Notices

The Notices API allows taxpayers to retrieve official notices issued by KRA and delivered through the eTIMS OSCU system.

Notices may include:

• Compliance alerts
• System announcements
• Regulatory updates
• Operational instructions

Endpoint

POST /selectNoticeList

---

Purpose

This API:

• Retrieves notices registered or updated after a given date
• Enables taxpayer systems to display official KRA notices
• Ensures taxpayers remain compliant with current guidance

ℹ️ Notices should be checked periodically (e.g. daily or weekly).

---

Request Object: NoticeSearchReq

Request Fields

Field	Description	Type	Required	Length
lastReqDt	Last Request Date (YYYYMMDDHHmmss)	CHAR	✅ Yes	14

🔎 lastReqDt is used to retrieve only notices created or updated after the specified timestamp.

---

JSON Request Example

{
  "lastReqDt": "20200218191141"
}

---

Response Object: NoticeSearchRes

Top-Level Fields

Field	Description	Type
resultCd	Result code (000 = success)	CHAR(3)
resultMsg	Result message	CHAR
resultDt	Response timestamp	CHAR(14)

---

Notice List (noticeList)

Each entry represents a single official notice.

Field	Description	Type	Length
noticeNo	Notice Number	NUMBER	—
title	Notice Title	CHAR	1000
cont	Notice Content	CHAR	4000
dtlUrl	Detail URL	CHAR	200
regrNm	Registered By	CHAR	60
regDt	Registration Date	CHAR	14

---

JSON Response Example

{
  "resultCd": "000",
  "resultMsg": "It is succeeded",
  "resultDt": "20200226191722",
  "data": {
    "noticeList": [
      {
        "noticeNo": 42,
        "title": "Notice Test [2020.02.18]",
        "cont": "Notice Test [2020.02.18]\r\n\r\nNotice Test [2020.02.18]",
        "dtlUrl": "http://localhost:9980/common/link/ebm/receipt/indexEbmNotice?noticeNo=42",
        "regrNm": "Administrator",
        "regDt": "20200218191141"
      }
    ]
  }
}

✅ resultCd = 000 means the notice search succeeded.

---

SDK Usage Examples

PHP

$notices = $etims->selectNoticeList([
    'lastReqDt' => lastReqDt('-30 days')
]);

$noticeList = $notices['data']['noticeList'] ?? [];

echo "Notices found: " . count($noticeList) . PHP_EOL;

foreach ($noticeList as $notice) {
    echo "- Notice No: {$notice['noticeNo']}" . PHP_EOL;
    echo "  Title: {$notice['title']}" . PHP_EOL;
    echo "  Contents: {$notice['cont']}" . PHP_EOL;
    echo "  Detail URL: {$notice['dtlUrl']}" . PHP_EOL;
    echo "  Registered by: {$notice['regrNm']}" . PHP_EOL;
    echo "  Registration Date: {$notice['regDt']}" . PHP_EOL . PHP_EOL;
}

JavaScript / Typescript

const response = await client.selectNoticeList({
  lastReqDt: formatDateForEtims(-30),
});

const notices = response.data?.noticeList || [];
console.log(`Found ${notices.length} notices`);

notices.forEach(notice => {
  console.log(`- [${notice.noticeNo}] ${notice.title}`);
});

Python

notices = etims.select_notice_list({
    'lastReqDt': last_req_dt(-30)
})

notice_list = notices.get('data', {}).get('noticeList', [])
print(f"Notices found: {len(notice_list)}")

for notice in notice_list:
    print(f"- Notice No: {notice['noticeNo']}")
    print(f"  Title: {notice['title']}")
    print(f"  Contents: {notice['cont']}")
    print(f"  Detail URL: {notice['dtlUrl']}")
    print(f"  Registered by: {notice['regrNm']}")
    print(f"  Registration Date: {notice['regDt']}\n")

---

Best Practices

• Poll notices regularly (daily or weekly)
• Display notices clearly to users
• Persist notice numbers to avoid duplicate processing
• Do not modify or suppress official notice content

---

Next Steps

• 👉 Customers
• 👉 Code Lists
• 👉 Sales Transactions