POPBill Developers
SDK Reference
Java

Company Status Inquiry

1. CheckCorpNum - Check a single case

  • This API checks the company status of a single case.
CorpState CheckCorpNum(String MemberCorpNum, String CheckCorpNum) throws PopbillException
Parameters
Parameters
No.FieldTypeLengthMandatoryDescription
MemberCorpNum String 10 Y Business registration number of a user who inquire a company status
10-digits except (‘-’)
CheckCorpNum String - Y Business registration number to check
Return
CorpState
No.FieldTypeLengthDescription
corpNum String 10 Business registration Number
10-digits except (‘-’)
taxType String 2 Taxation types
nullunavailable to check
10general
20exempted
30simplified taxpayer
31simplified taxpayer with a tax invoice issuance duty
40nonprofit, government institution, or an organization certified with proper number
typeDate String 10 Date of taxation type change
format: yyyy-MM-dd
state String 1 Company status
nullunavailable to check
0unregistered business
1in business
2closed
3suspended
stateDate String 10 Date of business suspension/closure
format: yyyy-MM-dd
checkDate String 10 Confirmed date of status checking from the NTS
date of checking via POPBiLL system
format: yyyy-MM-dd
Throws
PopbillException
No. Field Type Length Description
code long - API response code
8 digits code that starts with (‘-’) [Error Code]
message String - Error message for any failed API process

2. CheckCorpNums - Check multiple cases

  • This API checks the company status of multiple cases. (Maximum : 1,000 cases)
CorpState[] CheckCorpNum(String MemberCorpNum, String[] CorpNumList) throws PopbillException
Parameters
Parameters
No.FieldTypeLengthMandatoryDescription
MemberCorpNum String 10 Y Business registration number of a user who inquire a company status
10-digits except (‘-’)
CorpNumList String[ ] Y Business registration number to check
maximum : 1,000 cases
Return
CorpState
No.FieldTypeLengthDescription
corpNum String 10 Business registration Number
10-digits except (‘-’)
taxType String 2 Taxation types
nullunavailable to check
10general
20exempted
30simplified taxpayer
31simplified taxpayer with a tax invoice issuance duty
40nonprofit, government institution, or an organization certified with proper number
typeDate String 10 Date of taxation type change
format: yyyy-MM-dd
state String 1 Company status
nullunavailable to check
0unregistered business
1in business
2closed
3suspended
stateDate String 10 Date of business suspension/closure
format: yyyy-MM-dd
checkDate String 10 Confirmed date of status checking from the NTS
date of checking via POPBiLL system
format: yyyy-MM-dd
Throws
PopbillException
No. Field Type Length Description
code long - API response code
8 digits code that starts with (‘-’) [Error Code]
message String - Error message for any failed API process