한국어
당사자 — 개인·법인·법인 아닌 단체
상태: 공통 표준 — 2026-10-10 KST 사용자 결정
적용 대상: company-wide — 권리·의무의 주체(고객, 멤버, 거래처, 계약 당사자 등)의 유형·식별 정보
정본 분류: 공통 규칙(이름 짓기, 저장 구조, 값 형식, 확인 기록, 예시 값)은 공통 입력 정보를 따릅니다. 이 쪽은 당사자 필드의 정본입니다.
「인」과 「사업자」는 다른 축입니다.
| 축 | 가르는 것 | 번호 | 이 표준의 쪽 |
|---|---|---|---|
| 인(법적 인격) | 개인(자연인)인가, 법원에 등기한 법인인가 | 13자리: 주민등록번호·외국인등록번호·법인등록번호 | 이 쪽 |
| 사업자(세무 등록) | 국세청에 사업자로 등록했는가 | 10자리: 사업자등록번호·고유번호 | 사업자 |
당사자 하나에 사업자 등록이 0개 이상 딸립니다. 사업자가 아닌 개인도 있고, 한 개인이 사업자를 여럿 낼 수 있으며, 법인은 사업장마다 사업자등록번호를 받을 수 있습니다.
당사자 유형
partyType 값 | 한국어 | 영어 | 무엇인가 | 13자리 번호 |
|---|---|---|---|---|
natural_person | 개인 | Individual | 자연인 | 내국인은 주민등록번호, 외국인은 외국인등록번호 |
legal_person | 법인 | Legal entity | 법원에 설립등기를 한 단체(상법의 회사, 민법의 사단·재단법인 등) | 법인등록번호(설립등기 때 등기관이 부여) |
unincorporated_organization | 법인 아닌 단체 | Unincorporated organization | 등기하지 않은 사단·재단·단체(입주자대표회의, 동호회, 종교단체 등) | 없음 |
- 「인」은 개인과 법인입니다. 법인 아닌 단체는 법적 인격은 없지만 거래 당사자가 되므로 당사자 유형에 둡니다.
- 라벨은 「당사자 유형 / Party type」이고, 저장 값은 key입니다(레코드 식별 필드의 유형 규칙).
세법상 구분
taxpayerType 값 | 한국어 | 영어 |
|---|---|---|
individual | 개인 | Individual |
corporation | 법인 | Corporation |
pass_through | 구성원별 과세 | Pass-through |
- 개인은
individual, 법인은corporation입니다. - 법인 아닌 단체는 다음과 같이 나뉩니다.
- 국세기본법 제13조의 법인으로 보는 단체이면
corporation입니다. 두 경우 모두 수익을 구성원에게 분배하지 않아야 합니다.- 주무관청의 허가·인가·등록을 받았지만 등기하지 않은 단체 등
- 규정·대표자를 갖추고 재산을 독립적으로 소유·관리하며 세무서장의 승인을 받은 단체
- 그 밖의 단체는 소득세법 제2조 제3항을 따릅니다.
- 기본은 단체를 개인(1거주자 또는 1비거주자)으로 봅니다:
individual - 구성원 사이의 이익 분배 비율이 정해져 있고 구성원별 비율이 확인되거나, 비율은 없지만 사실상 구성원별로 이익이 분배되는 것이 확인되면 구성원별로 과세합니다:
pass_through - 일부 구성원의 분배만 확인되는 혼합 과세(소득세법 제2조 제4항)는 이 값으로 표현하지 않고 세무 업무에서 다룹니다.
- 기본은 단체를 개인(1거주자 또는 1비거주자)으로 봅니다:
- 국세기본법 제13조의 법인으로 보는 단체이면
- 그래서 법인으로 보는 단체는 「당사자 유형 = 법인 아닌 단체, 세법상 구분 = 법인」입니다. 법인등록번호는 없습니다.
- 사업자 유형(개인사업자·법인사업자)은 국세청 등록 내용을 따릅니다. 이 값에서 자동으로 정하지 않습니다 (사업자).
개인
| 필드 | autocomplete | 코드 / DB | 형식 | 한국어 라벨 | 영어 라벨 |
|---|---|---|---|---|---|
| 이름 | name | name | 쓴 그대로 | 이름 (성·이름 칸과 함께 보일 때만 「전체 이름」) | Full name |
| 성 | family-name | familyName / family_name | 성 | Family name | |
| 이름(성 제외) | given-name | givenName / given_name | 이름(성 제외) | Given name | |
| 생년월일 | bday | bday | YYYY-MM-DD | 생년월일 | Date of birth |
| 성별 | 쓰지 않음 | sex | KS X ISO/IEC 5218 코드 | 성별 | Sex |
| 국적 | — | nationalities | ISO 3166-1 alpha-2 목록 | 국적 | Nationality |
| 선호 언어 | language | language | BCP 47 | 언어 | Language |
이름
- 기본은 한 칸
name입니다. 사람이 쓴 그대로 저장하고, 한국어 이름은 「홍길동」처럼 붙여 씁니다. 공백을 강제로 지우거나 넣지 않습니다. familyName·givenName은 여권 대조·본인 확인(KYC)·결제사·격식 호칭처럼 외부 요구가 있을 때만 추가합니다. 이때도name이 표시의 정본입니다.name을 자동으로 쪼개거나 성과 이름으로 다시 조합하지 않습니다. 성이 없는 이름도 받습니다.- 로마자 표기가 따로 필요하면 라벨 앞에 「영문」을 붙입니다(「영문 성」·「영문 이름(성 제외)」).
성별
- 업무에 꼭 필요할 때만 받습니다(개인정보 최소 수집).
- 값은 KS X ISO/IEC 5218(ISO/IEC 5218과 같음) 코드입니다:
0모름 ·1남 ·2여 ·9해당 없음.- 받지 않았으면 값을 비웁니다(
0이 아님). 9를 다른 성별 정체성이나 응답 거부의 뜻으로 쓰지 않습니다.
- 받지 않았으면 값을 비웁니다(
- HTML
sex토큰은 자유 입력 성별 정체성이라 뜻이 달라 쓰지 않습니다.
생년월일·국적·언어
- 생년월일 데이터 이름은 토큰과 같은
bday입니다. schema.org로 내보낼 때는birthDate, vCard로 내보낼 때는BDAY의 기본형(19850412)으로 바꿉니다. - 국적은 여러 개일 수 있어 목록입니다.
- 언어는 그 사람이 선호하는 언어입니다.
법인·법인 아닌 단체
| 필드 | 코드 / DB | 한국어 라벨 | 영어 라벨 | 대응 표준 |
|---|---|---|---|---|
| 이름 | name | 상호(회사), 명칭(민법 법인·단체) | Legal name | schema legalName |
| 법인 형태 | legalFormCode / legal_form_code | 법인 형태 | Legal form | ISO 20275 ELF 4자리 |
| 설립일 | foundingDate / founding_date | 설립일 | Founding date | schema foundingDate |
| 법적 대표자 | legalRepresentatives (목록) | 대표자 | Legal representative | schema legalRepresentative |
| 본점주소 | legalAddress (주소 종류 legal) | 본점주소(민법 법인·법인 아닌 단체는 주사무소주소) | Registered address | schema legalAddress |
- 이름: 법인의 상호는 등기된 그대로 저장합니다. 회사는 상호에 회사 종류를 넣습니다(상법 제19조, 예: 「주식회사 예시」).
- 법인 형태: ISO 20275 코드입니다. 한국 형태 예: 주식회사
5RCH, 유한회사J3U5, 유한책임회사UDJG, 합명회사AXEQ, 합자회사BW92, 비영리 사단법인VTH4, 재단법인AKF5. 맞는 코드가 없으면 비웁니다. - 설립일: 법인은 등기상 설립(회사성립) 연월일입니다.
- 법적 대표자
- 등기상 대표자(대표이사 등)이며 여럿일 수 있습니다(공동대표).
- 각 항목은 대표자 개인 당사자를 가리키는
partyId와 표시용name을 가집니다. - 법인 아닌 단체는 대표자나 관리인을 둡니다.
- 국세청에 신고한 사업자의 대표자 이름은 사업자 쪽의
representativeName이며, 법적 대표권과 같다고 가정하지 않습니다.
식별번호
식별번호는 목록 identifiers에 저장합니다. 각 항목은 다음을 가집니다.
| 필드 | 뜻 |
|---|---|
scheme | 번호 체계(아래 표) |
value | 번호 |
issuingCountry | 발급 국가(ISO 3166-1 alpha-2) |
issuer | 발급 기관(필요할 때, 예: 여권 발급 기관) |
validFrom · validThrough | 유효기간(있을 때) |
확인 기록은 공통 입력 정보의 「확인 기록」을 따릅니다.
scheme | 한국어 | 입력·출력 필드 | 형식 | 검증 | 처리 |
|---|---|---|---|---|---|
kr_resident_registration_number | 주민등록번호 | residentRegistrationNumber | 13자리(6-7) | 형식만 | 법령이 요구·허용할 때만 처리(개인정보 보호법 제24조의2, 동의로는 불가). 암호화 저장, 화면에서 가림 |
kr_alien_registration_number | 외국인등록번호 | alienRegistrationNumber | 13자리 | 형식만 | 고유식별정보(같은 법 제24조: 별도 동의 또는 법령 근거). 암호화, 가림 |
kr_corporate_registration_number | 법인등록번호 | corporateRegistrationNumber | 13자리(6-7) | 형식만 | — |
passport_number | 여권번호 | passportNumber | 발급국 형식 | 형식만 | 고유식별정보. 암호화, 가림 |
lei | LEI | leiCode | 20자리(ISO 17442) | 검증 숫자(ISO/IEC 7064 MOD 97-10) | 글로벌 거래용 |
tax_id | 세무 식별번호 | taxId | 발급국 표기 | 형식만(발급국 규칙) | 국내 등록이 없는 해외 당사자의 그 나라 세무번호(미국 EIN, 독일 부가가치세 번호, 싱가포르 UEN 등). issuingCountry 필수 |
- 주민등록번호를 키로 쓰지 않습니다. 유출 피해가 있으면 번호를 바꿀 수 있습니다(주민등록법 제7조의4). 연결은 고유코드 (
id)로 합니다. 회원가입에는 주민등록번호 없이 가입하는 방법을 둡니다. - 법인등록번호는 검증 숫자로 막지 않습니다. 2025-01-31 KST 이후 부여한 번호에는 검증 숫자가 없습니다. 본점을 옮겨도 번호는 그대로입니다.
- 등록번호는 중복을 허용하고, 등록 뒤에는 정정으로만 바꿉니다(레코드 식별 필드).
- 사업자등록번호·고유번호는 당사자가 아니라 사업자 등록에 있습니다(사업자).
- 해외 당사자의 세무 식별번호(2026-10-17 KST 사용자 결정): 국내 사업자등록·법인등록이 없는 해외 당사자는 그 나라가 부여한 세무번호를
tax_id로 둡니다.- 발급 국가(
issuingCountry, ISO 3166-1 alpha-2)를 반드시 함께 저장합니다. 같은 번호 모양이 나라마다 다른 뜻이기 때문입니다. - 값은 발급국 표기 그대로 둡니다. 번호 앞에 붙이던 「EIN」·「UEN」 같은 이름표는 값에 넣지 않고, 부가가치세 번호의 국가 접두어(
DE…)처럼 번호의 일부인 글자는 둡니다. - 국내 사업자등록번호·고유번호는 이 체계에 넣지 않습니다(사업자).
- 발급 국가(
- schema.org의
taxID·vatID는 내보낼 때의 이름입니다. 국내 사업자등록번호는 사업자 등록에서, 해외 세무번호는tax_id에서taxID(부가가치세 번호면vatID)로 내보냅니다.
다루지 않는 것
- 성별 정체성, 재외국민 등록번호처럼 드문 번호: 필요해지면 따로 정합니다.
- 사람과 조직의 소속(직함·부서): 조직에 있습니다.