# Jaryo field dictionary

Every record has `record_type`, `source_id`, `source_record_key`, `fetched_at`, `license_id` and `data` (below).
Text values are `{"ko": original, "en": English or null}` — names are **not translated**; `en` is filled only when the source
publishes an English name. Coded values are `{"code", "ko", "en"}`. Dates `YYYY-MM-DD`, timestamps ISO 8601 (KST, +09:00),
amounts `*_krw` are integers in Korean won. Phone numbers, e-mails and contact persons are never included.

## Identifiers
| scheme | meaning | format |
|---|---|---|
| biz_no | Business registration number (사업자등록번호) | 10 digits, check digit verified |
| corp_reg_no | Corporate registration number (법인등록번호) | 13 digits, check digit verified |
| dart_corp_code | DART corp code (고유번호) | 8 digits |
| stock_code | KRX ticker | 6 characters |
| g2b_vendor | KONEPS vendor id | equals biz_no |

## Record types
- **company_profile** (Open DART): name, short_name, representative_name, listing_market {Y kospi, K kosdaq, N konex, E other}, address, website, ir_website, ksic_codes[], founded_on, fiscal_year_end_month
- **vendor_profile** (KONEPS vendor registry): name, representative_name, opened_on, region, address, country, procurement_division {01 goods, 05 services, 07 construction, 03 general_services, 02/04 foreign}, manufacturer_type, employee_count_self_reported, office_type, website, non_profit_id_registered
- **award** (KONEPS final award, corporate winners only): role {award}, notice_no, notice_order, title, awarded_on, amount_krw, buyer {code, name}
- **contract** (KONEPS contract, one row per corporate supplier): role {contract}, contract_no, title, signed_on, total_amount_krw, contracting_agency {code, name}, source_url (the full contract on KONEPS)

Procurement records carry only the fields used to confirm a company. The full original record is kept as a raw snapshot; for contracts, `source_url` opens it on KONEPS.
- **sanction** (KONEPS debarment): name, imposed_by, starts_on, ends_on, duration_days, duration_months, status, legal_basis {law_ko, article, article_code, article_text_ko, decree_code, decree_ko}, document_title, published_at
- **status** (National Tax Service): registered, tax_status {01 active, 02 suspended, 03 closed}, vat_type {01 general, 02 simplified, 03 special, 04 exempt, 05 non_profit_no_business, 06 unique_number_entity, 07 simplified_invoice_issuer}, closed_on, previous_vat_type
- **employment** (National Pension Service, corporate workplaces only): as_of_month, workplace_name, address, enrollment_status {1 registered, 2 withdrawn}, insured_headcount, industry {nts_code, ko}, enrolled_on, withdrawn_on, biz_no_prefix6 (the source publishes only the first 6 digits — not an identifier)
- **filing** (Open DART disclosure list; types A periodic, B major events, F audit): receipt_no, title, filing_type, filed_on, filer_name, remarks_codes[], source_url