쿼리 파라미터 활용 가이드

법인의 신원을 확인하는 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 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