NTS Error Codes
Complete list of NTS error codes that may occur during cash receipt registration.
Error Code List
| Error Code | Auto-Reprocessing | Error Description | Details and Resolution |
|---|---|---|---|
| TS1 | O | Identity verification (resident registration number / business registration number / mobile phone number) error | Input value is incorrect when: • The 'identity verification' field meets any of the following conditions: - 9 digits or fewer - 14 digits or more - 11 digits and does not start with 0 → Not a mobile phone number |
| TS2 | O | Identity verification (card) error | Input value is incorrect when: • A cash receipt dedicated card (starting with 15442020) is not 18 digits • The 'identity verification' field is 12 digits but does not start with 126 → Not a cash receipt M card number |
| TS3 | X | Transaction with excluded business entity error | Input value is incorrect when: • The merchant's business registration number is included in the BLO (issuance-prohibited business list) Resolution • Before submitting cash payment records to the NTS, verify that the merchant's business registration number is not registered in the BLO. |
| TS4 | X | Transaction amount error | Input value is incorrect when: • Total transaction amount ≠ supply value + VAT + service charge • Supply value < VAT • Total transaction amount is 1 or less |
| TS5 | X | Approval number + transaction date duplicate error | Duplicate approval number and transaction date |
| TS6 | O | Transaction date error | Note • For POS approval codes: - Records with a transaction date of 2017.04.03 (Mon) are valid only if submitted by 2017.04.05 (Wed) - Records with a transaction date of 2017.04.06 (Thu) are valid only if submitted by 2017.04.10 (Mon) ※ 4.8 (Sat) and 4.9 (Sun) are excluded from deadline calculation as weekends |
| TS7 | X | Transaction with unregistered business entity error | Resolution • Verify business registration status at NTS Hometax (www.hometax.go.kr) > Inquiry/Issuance > Business Entity Status using the business registration number. Then resubmit within the valid deadline range for the approval code. |
| TS8 | X | File layout error | Input value is incorrect when: • The approval number is not exactly 9 digits, or the last 7 digits are not numeric • The cash receipt business registration number is not 10 numeric digits • The merchant business registration number is not 10 numeric digits |
| TSB | O | Identity verification type mismatch | Registration number type mismatch |
| TSC | O | Void transaction input error – original approval number input error | Input value is incorrect when: • The void transaction is missing either the original approval number or original transaction date |
| TSD | X | Approval transaction input error – original approval number + transaction date input | Original approval number and transaction date input error for approval transaction |
| TSE | X | Void transaction input error – merchant business registration number mismatch | Input value is incorrect when: • The merchant business registration numbers of the approval and void transactions do not match Resolution • When submitting a void transaction, verify the merchant business registration number from the original approval transaction. |
| TSF | X | Void transaction input error – transaction type mismatch | Input value is incorrect when: • Verify and resubmit with the correct transaction type (income deduction / expense proof) for both the approval and void transactions. |
| TSG | X | Void transaction input error – void request total exceeds voidable amount | Input value is incorrect when: • The total of all void requests exceeds the original approval amount — all voids on that date are in error • Duplicate void request |
| TSH | O | Void transaction input error – identity verification mismatch | Input value is incorrect when: • The recipient of the approval and void transactions differ Input value is valid when the 'identity verification' field meets any of the following: - 9 digits or fewer - 14 digits or more - 11 digits and does not start with 0 → Not a mobile phone number |
| TSJ | X | Duplicate void transaction | Duplicate void request |
| TSK | X | Traditional market sub-business serial number input error – layout error | Input value is incorrect when: • The traditional market sub-business serial number is 4 numeric digits, but the serial number does not belong to a sub-business within the traditional market |
| TSL | X | Traditional market sub-business serial number input error – general business entity | Traditional market code entered for a general business entity |
| TSM | X | Traditional market sub-business serial number input error – business entity outside traditional market | Input value is incorrect when: • The business entity exists outside the traditional market |
| TSN | X | Books/performance expenses transaction input error – unregistered books/performance expense business entity | Input value is incorrect when: • The merchant has not applied as a books/performance/sports facility business entity with the NTS 1. Merchant has not applied as a books/performance/sports facility business entity Cultural Expense Income Deduction > Income Deduction Business Entity > Apply 2. Merchant has applied but registration is not yet complete 3. Registration is complete but not yet reflected by the NTS (may take up to one month) Resolution • If TSN errors continue, verify whether the merchant has applied for and been registered as a books/performance/sports facility business entity. |
| TSO | X | Public transportation transaction input error – books/performance/sports facility business entity | Input value is incorrect when: • The merchant for a transaction with the public transportation or books/performance/sports facility flag set to 'Y' is on the NTS books/performance/sports facility business entity list Resolution • If the merchant is a books/performance/sports facility business entity, change the flag to 'C' and resubmit. |
| E1 | O | Transaction eligible date has passed | The valid submission deadline for the transaction has passed |
| E2 | X | No original transaction (on void request) | No original transaction found on void |
| E3 | O | Individual field input value error | Layout error |
| E4 | X | Individual field input value error | Layout error |
| BLO | X | Closed/suspended business entity | Issuance-prohibited business entity |
Auto-Reprocessing Information
NOTE
Auto-Reprocessable Error Codes
Error codes marked 'O' for auto-reprocessing can be automatically reprocessed by Hecto Financial. If enrolled as an auto-reprocessing merchant, these error codes are reprocessed automatically.
Auto-reprocessable error codes (8 codes): TS1, TS2, TS6, TSB, TSC, TSH, E1, E3
Non-auto-reprocessable error codes (18 codes): TS3, TS4, TS5, TS7, TS8, TSD, TSE, TSF, TSG, TSJ, TSK, TSL, TSM, TSN, TSO, E2, E4, BLO
Important Notes
- Merchants not enrolled in auto-reprocessing must manually submit reprocessing requests via the reprocessing API when errors occur.
- The TSN error code indicates that the transaction type was changed to standard and successfully issued to the NTS.
If it cannot be confirmed as a cultural expense deduction in the future, refer to the details and resolution in the error code list above. - When an error code occurs, refer to the details and resolution to identify the cause, correct it, and resubmit.
Need technical support?
Code Samples
HectoFinancial GitHub