POPBill Developers
SDK Reference
Java

Status Code for Cash Receipt

The status code ranges from stateCode(status code) of checking a document status derives from issuance to NTS filing process, and ntsresultCode(NTS filing result code) of checking the detailed information on the NTS filing result(succeeded/failed).

You can check the POPBiLL stateCode and ntsresult via [GetInfo-Check the status of a cash receipt] API.

stateCode

POPBiLL returns this 3-digit value when processing the document status derives from cash receipt issuance to the NTS filing.

Status Code Message Description
300 Issued A seller successfully issued a cash receipt.
304 Succeeded Issued cash receipt is filed to the NTS successfully.
305 Failed Issued cash receipt is failed from the NTS filing.

ntsresultCode

This value derives from the NTS server when the filing process of an issued cash receipt is completed.

Succeeded

Status Code Message Description
0000 Succeeded A cash receipt successfully passed all the authentication process.

Failed

Status Code Message Description
TS1 Identification number error – resident registration number/business registration number/ cell phone number - If identification number is not between 10 ~ 13 digits
- If identification number is 11 digits but does not begin with ‘0’
TS2 Identification number error – cash receipt purpose card - If identification number is 16 digits
- If identification number is 18 digits but does not begin with ‘15442020’
- If identification number is 12 digits but does not begin with ‘126’
TS3 Transaction error - Company restricted from issuance by the NTS - If the seller’s business registration number is identified as the company restricted from issuance by the NTS
TS4 Total amount error - If the sum amount of supplyCost + tax + serviceFee is not identical to the totalAmount.
- If the amount of supplyCost is lower than the tax
- If the totalAmount is lower than 1
TS7 Transaction error – Unregistered company - If the seller’s business registration number is not registered in the NTS system
- If the seller’s business registration number is not registered as a cash receipt franchise
TSC Cash receipt for revocation error – identification number/date of trade/reason for revocation - If the original cash receipt does not exist
- If there is null value found in the confirmNum, tradeDate, and cancelType of the original cash receipt
- Invalid value of the cancelType
TSE Cash receipt for revocation error – mismatch of the seller’s business registration number - If the business registration number of the original cash receipt is not identical to the cash receipt for revocation
TSF Cash receipt for revocation error – mismatch of the tradeUsage - If the value of the tradeUsage from the original cash receipt is not identical to the cash receipt for revocation
TSG Cash receipt for revocation error – mismatch of the seller’s totalAmount - If the amount of the totalAmount from the original cash receipt is not identical to the cash receipt for revocation
TSH Cash receipt for revocation error – mismatch of the seller’s identitiyNum - If the value of the identityNum from the original cash receipt is not identical to the cash receipt for revocation
TSK Branch place of the traditional market error – franchiseTaxRegID - If the value of the franchiseTaxRegID is not 4-digit number
- If the value of the franchiseTaxRegID is 4-digit number when the business is not identified as an official traditional marketplace
TSL Branch place of the traditional market error – general business - If the seller’s company is identified as the general business
TSM Branch place of the traditional market error – business not registered as the traditional market - If the seller’s company is identified as the unit VAT taxation business but is not registered as the traditional market
TSN TradeOpt error – book/performance type - If the seller’s company is not registered as an official book/performance service business
TSO TradeOpt error – public transportation type - If the seller’s company is not registered as an official public transportation service business.