쿼리 파라미터 활용 가이드
법인의 신원을 확인하는 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****
사용 방법
대시보드에서 제출 폼 URL을 확인한다.
URL에서 'kyc.argos-solutions.io/apply' 부분을 'form.jotform.com'로 변경합니다.
URL의 숫자가 끝나는 부분 뒤에 '?'를 입력하고, 아래 표의 ' Qeury Parameters' 열에서 필요한 항목을 복사, 붙여넣기 한다.
'sample' 텍스트 대신 필요한 값을 집어넣습니다.
여러 개의 쿼리 파라미터를 사용해야 할 경우 '&'를 입력하고 연결합니다.
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}®isteredBusiness={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를 지원합니다.
Last updated