회원 관리

1. CheckIsMember - 연동회원 가입여부 확인

사업자번호를 조회하여 연동회원 가입여부를 확인합니다.

function response checkismember(string corpnum, string a_linkid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	a_linkid	string	-	Y	팝빌에서 발급한 링크아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 0 미가입 1 가입
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

2. CheckID - 연동회원 아이디 중복 확인

사용하고자 하는 아이디의 중복여부를 확인합니다.

function response checkID(string id) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	id	string	50	Y	중복여부를 확인할 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 0 미사용 1 사용
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

3. JoinMember - 연동회원 신규가입

프로그램 공급사의 고객사를 팝빌 연동회원으로 가입하는 API 입니다.

function response joinmember(ref joinform joininfo) throws popbillexception

회원의 정보가 현행화 되지 않은 경우 연동회원 신규가입 API 사용이 제한될 수 있으니 유의하시기 바랍니다.

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	joinInfo	JoinForm	-	Y	연동회원 객체정보
JoinForm 순번 변수명 타입 길이 필수 설명 1 ID string 50 Y 아이디 → 6자 이상 50자 이하 2 Password string 20 Y 비밀번호 → 8자 이상 20자 이하 영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함 3 LinkID string 20 Y 파트너 링크아이디 → 팝빌에서 발급한 링크아이디 4 CorpNum string 10 Y 사업자번호 ('-' 제외) 5 CEOName string 100 Y 대표자 성명 6 CorpName string 200 Y 회사명 7 Addr string 300 Y 사업장 주소 8 BizType string 100 Y 업태 9 BizClass string 100 Y 종목 10 ContactName string 100 Y 담당자 성명 11 ContactEmail string 100 Y 담당자 메일 12 ContactTEL string 20 Y 담당자 휴대폰

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

4. GetCorpInfo - 회사정보 확인

연동회원의 회사정보를 확인합니다.

function corpinfo getcorpinfo(string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

CorpInfo

순번	변수명	타입	길이	설명
1	ceoname	string	100	대표자 성명
2	corpName	string	200	회사명
3	addr	string	300	주소
4	bizType	string	100	업태
5	bizClass	string	100	종목

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

5. UpdateCorpInfo - 회사정보 수정

연동회원의 회사정보를 수정합니다.

function response updatecorpinfo(string corpnum, ref corpinfo corpinfoObj, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	corpinfoObj	CorpInfo	-	Y	회사정보 객체
CorpInfo 순번 변수명 타입 길이 필수 설명 1 ceoname string 100 Y 대표자 성명 2 corpName string 200 Y 회사명 3 addr string 300 Y 주소 4 bizType string 100 Y 업태 5 bizClass string 100 Y 종목
3	userid	string	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

6. RegistContact - 담당자 추가

연동회원에 담당자를 추가합니다.

function response registcontact(string corpnum, ref Contact contactinfo, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	contactInfo	Contact	-	Y	담당자 객체정보
Contact 순번 변수명 타입 길이 필수 설명 1 id string 50 Y 아이디 → 6자 이상 50자 이하 2 password string 20 조건부 비밀번호 → 8자 이상 20자 이하 영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함 함수 [RegistContact - 담당자 추가]호출을 위한 필수값 3 personName string 100 Y 담당자 성명 4 tel string 20 Y 담당자 휴대폰 5 email string 100 Y 담당자 메일 6 searchRole integer 1 N 권한 1 개인권한 2 읽기권한 3 회사권한 : 기본값
3	userid	string	50	N	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

7. GetContactInfo - 담당자 정보 확인

연동회원에 추가된 담당자 정보를 확인합니다.

function contact getcontactInfo(string corpnum, string contactid, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	contactid	string	50	Y	담당자 아이디
3	userid	string	50	N	팝빌회원 아이디

응답

Contact

순번	변수명	타입	길이	설명
1	id	string	50	아이디
2	personName	string	100	담당자 성명
3	tel	string	20	담당자 휴대폰
4	email	string	100	담당자 메일
5	regDT	string	14	등록일시 → 형식 : yyyyMMddHHmmss
6	searchRole	integer	1	권한 1 개인권한 2 읽기권한 3 회사권한
7	mgrYN	boolean	-	역할 true 관리자 false 담당자 → 팝빌 사이트 [ 마이페이지 > 회사정보 > 담당자 관리 ] 메뉴에서 수정 가능
8	state	string	1	계정상태 1 사용중

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

8. ListContact - 담당자 목록 확인

연동회원에 추가된 담당자 목록을 확인합니다.

subroutine listcontact(string corpnum, string userid, ref contact ref_returnlist[]) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디
3	ref_returnlist	ref Contact[ ]	-	Y	서브루틴 반환 결과값
ref Contact[ ] 순번 변수명 타입 길이 필수 설명 1 id string 50 N 아이디 2 personName string 100 N 담당자 성명 3 tel string 20 N 담당자 휴대폰 4 email string 100 N 담당자 메일 5 regDT string 14 N 등록일시 → 형식 : yyyyMMddHHmmss 6 searchRole integer 1 N 권한 1 개인권한 2 읽기권한 3 회사권한 7 mgrYN boolean - N 역할 true 관리자 false 담당자 → 팝빌 사이트 [ 마이페이지 > 회사정보 > 담당자 관리 ] 메뉴에서 수정 가능 8 state string 1 N 계정상태 1 사용중

응답

contact[ ] - 요청 파라미터의 ref_returnlist 확인

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

9. UpdateContact - 담당자 정보 수정

연동회원에 추가된 담당자 정보를 수정합니다.

function response updatecontact(string corpnum, ref contact contactinfo, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	contactinfo	Contact	-	Y	담당자 객체정보
Contact 순번 변수명 타입 길이 필수 설명 1 id string 50 Y 아이디 → 6자 이상 50자 이하 2 password string 20 조건부 비밀번호 → 8자 이상 20자 이하 영문, 숫자, 특수문자(~!@#$%^&*()_+) 포함 함수 [RegistContact - 담당자 추가]호출을 위한 필수값 3 personName string 100 Y 담당자 성명 4 tel string 20 Y 담당자 휴대폰 5 email string 100 Y 담당자 메일 6 searchRole integer 1 N 권한 1 개인권한 2 읽기권한 3 회사권한 : 기본값
3	userid	string	50	Y	팝빌회원 아이디

응답

Response

순번	변수명	타입	길이	설명
1	code	long	-	API 처리에 대한 응답코드 1 성공
2	message	string	-	API 처리에 대한 응답메시지

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지

10. GetAccessURL - 팝빌 로그인 팝업 URL

미리보기

팝빌 회원 로그인 상태의 팝업 URL을 반환합니다.

• 권장 사이즈 : width = 1,280px (최소 1,000px) / height = 800px
• 반환되는 URL은 30초 동안만 사용이 가능합니다.
• 반환되는 URL은 팝빌회원의 로그인 세션을 포함하고 있으니 사용에 유의하여 주시기 바랍니다.

function string getAccessURL(string corpnum, string userid) throws popbillexception

요청

Parameters

순번	변수명	타입	길이	필수	설명
1	corpnum	string	10	Y	팝빌회원 사업자번호 ('-' 제외)
2	userid	string	50	N	팝빌회원 아이디

응답

string - 요청에 대한 응답 URL

예외

PopbillException

순번	변수명	타입	길이	설명
1	code	long	-	API 처리 실패에 대한 오류코드 → 음의 정수 8자리 숫자값 [참고] 오류코드
2	message	string	-	API 처리 실패에 대한 오류메시지