API Docs

Index

1. Check the business status

1.1. CheckCorpNum - Check a single case

ㆍCheck the business status of a single business registration number.

CorpState CheckCorpNum(String MemberCorpNum, String CheckCorpNum) throws PopbillException

Parameters

순번 변수명 타입 길이 필수 설명
1 MemberCorpNum String 10 O User's business registration number
2 CheckCorpNum String - O Business registration number to be checked

Return

CorpState

Throws

PopbillException

1.2. CheckCorpNum - Check multiple cases

ㆍCheck the business status of multiple business registration numbers in bulk. (Maximum : 1,000 numbers)

CorpState[] CheckCorpNum(String MemberCorpNum, String[] CorpNumList) throws PopbillException

Parameters

순번 변수명 타입 길이 필수 설명
1 MemberCorpNum String 10 O User's business registration number
2 CorpNumList String[ ] 1000 O [Array] Business registration number to be checked (Maximum : 1,000 numbers)

Return

CorpState[ ]

Throws

PopbillException

A. Object information

A.1. Response

No. Name Type Length Description
1 code long - Response code for API processing
2 message String - Response message for API processing

A.2. PopbillException

No. Name Type Length Description
1 code long - Error code for failure of API process (8 digits starting with '-')
└ [Reference] Error codes
2 message String - Error message for failure of API process

A.3. CorpState

No. Name Type Length Description
1 corpNum String - Business registration number
2 taxType String - Taxation Type
└ Valid Value : null / 10 / 20 / 30 / 31 / 40
└ null = Unavailable to check, 10 = General taxable company, 20 = Exempted taxable company
└ 30 = Simplified taxable company, 31 = Simplified taxable company to have issuance duty of e-Tax invoice
└ 40 = Nonprofit · Government Institution · Organization an unique number is assigned
3 typeDate String - Date of taxation type change
└ Format : yyyy-MM-dd
4 state String - Company Status
└ Valid Value : null / 0 / 1 / 2 / 3
└ null = Unavailable to check, 0 = Unregistered, 1 = In business, 2 = Closed, 3 = Suspended
5 stateDate String - Confirmed date of suspended/closed business
└ Format : yyyy-MM-dd
6 checkDate String - Date of checking