쿼리 파라미터 활용 가이드

법인의 신원을 확인하는 KYB의 특성상 제출 폼에는 입력해야 할 항목이 많이 있습니다. 만약 KYB 대상 법인에 대한 정보를 미리 알고 있다면 쿼리 파라미터를 활용해 제출 폼에 정보를 미리 입력해두고, 정보가 입력되어 있는 제출 폼 URL을 전달할 수 있습니다.

주의사항!

아르고스의 KYB 폼은 'Jotform'을 이용하여 생성됩니다. 일반적인 경우에는 'kyc.argos-solutions.io/apply'으로 나와있는 제출 폼 URL을 사용해도 무방하지만, 이 기능을 이용하기 위해서는 반드시 링크 주소에서 해당 부분을 'form.jotform.com'으로 변경해야 합니다.

예시 변경 전: https://kyc.argos-solutions.io/apply/12345678199**** 변경 후: https://form.jotform.com/12345678199****

사용 방법

1. 대시보드에서 제출 폼 URL을 확인한다.

2. URL에서 'kyc.argos-solutions.io/apply' 부분을 'form.jotform.com'로 변경합니다.

3. URL의 숫자가 끝나는 부분 뒤에 '?'를 입력하고, 아래 표의 ' Qeury Parameters' 열에서 필요한 항목을 복사, 붙여넣기 한다.

4. 'sample' 텍스트 대신 필요한 값을 집어넣습니다.

5. 여러 개의 쿼리 파라미터를 사용해야 할 경우 '&'를 입력하고 연결합니다.

Parameter	Qeury Parameters	Description
full_Legal	full_Legal={sample}	법인 상호명
companyType181	companyType181={sample}	법인 종류
purposeOf	purposeOf={sample}	법인 설립 목적
businessCategory	businessCategory={sample}	업종
businessRegistration182	businessRegistration182={sample}	상호 번호(사업자 번호)
nameOf	nameOf={sample}	대표이사 이름
registeredBusiness	registeredBusiness={sample}	법인 주소지
principalBusiness	principalBusiness={sample}	본사의 주소지
nameOf191	nameOf191={sample}	제출 대리인
contactInformation	contactInformation={sample}	제출 대리인의 이메일 주소
companyId	companyId={sample}	Company Id

예시

https://form.jotform.com/12345678199****?full_Legal={sample}&companyType181={sample}&companyType181=other&purposeOf={sample}&businessCategory={sample}&businessRegistration182={sample}&nameOf={sample}&registeredBusiness={sample}&principalBusiness={sample}&nameOf191={sample}&contactInformation={sample}

full_Legal

• Full legal name of corporate entity의 Paraneter로 법인 상호명을 뜻합니다.

• Query parameters를 통해 입력할 때에는 'full_Legal' key를 사용합니다.

• Value에는 법인 상호명을 입력합니다.

companyType181

• Company type의 Parameter로 법인 종류를 뜻합니다.

• Query parameters를 통해 입력할 때에는 companyType181 key를 사용합니다.

• Company type은 text input이 아닌 radio button 형식이며 5개의 타입이 존재합니다: Sole proprietorship, Profit corporation, Non-profit corporation, Voluntary association, Other

• Value에는 법인 종류를 입력합니다.

'Other'가 아닐 때

'Other'일 때

purposeOf

• Purpose of Establishment의 Parameter로 법인 설립 목적을 뜻합니다.

• Query parameters를 통해 입력할 때에는 purposeOf key를 사용합니다.

• Value에는 법인 설립 목적을 입력합니다.

businessCategory

• Business Category의 Parameter로 업종을 뜻합니다.

• Query parameters를 통해 입력할 때에는 businessCategory key를 사용합니다.

• Value에는 업종을 입력합니다.

businessRegistration182

• Business registration number의 Parameter로 상호 번호(사업자 번호)를 뜻합니다.

• Query parameters를 통해 입력할 때에는 businessRegistration182 key를 사용합니다.

• Value에는 상호 번호(사업자 번호)를 입력합니다.

nameOf

• Name of CEO의 Parameter로 대표이사 이름을 뜻합니다.

• Query parameters를 통해 입력할 때에는 nameOf key를 사용합니다.

• Value에는 대표이사 이름을 입력합니다.

registeredBusiness

• Registered business address의 Parameter로 사업자 등록증에 등록되어 있는 법인 주소지를 뜻합니다.

• Query parameters를 통해 입력할 때에는 registeredBusiness key를 사용합니다.

• Value에는 법인 주소지를 입력합니다.

principalBusiness

• Principal business address의 Parameter로 여러 지점 중에 본사의 주소지를 뜻합니다.

• Query parameters를 통해 입력할 때에는 principalBusiness key를 사용합니다.

• Value에는 본사의 주소지를 입력합니다.

nameOf191

• Name of representative의 Parameter로 제출 대리인을 뜻합니다.

• Query parameters를 통해 입력할 때에는 nameOf191 key를 사용합니다.

• Value에는 제출 대리인의 이름을 입력합니다.

contactInformation

• Contact information of representative의 Parameter로 제출 대리인의 이메일 주소를 뜻합니다.

• Query parameters를 통해 입력할 때에는 contactInformation key를 사용합니다.

• Value에는 제출 대리인의 이메일을 입력합니다.

companyId

• Company Id의 Parameter로 아르고스의 고객사가 KYB 대상 법인에게 선택적으로 부여하는 ID를 의미합니다.

• Query parameters를 통해 입력할 때에는 companyId key를 사용합니다.

• Value에는 대상 법인에게 부여한 company Id를 입력합니다.

두 개 이상 이용하기

• Query parameters로 두 개 이상의 값을 전달할 수 있습니다.

• &기호를 사용하여 추가 시킬 Query parameter 입력합니다.

• 입력 순서의 우선순위는 없습니다.

• KYB 에서는 최대 10개 까지의 Query parameter를 지원합니다.