{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","partial"]},"type":"markdown"},"seo":{"title":"Korea Address Standard","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"How Korean addresses are structured, how CDQ models them in the CDQ address model, how the road name and the older lot number systems relate, and which reference data CDQ maintains for Korea."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"korea-address-standard","__idx":0},"children":["Korea Address Standard"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Korea replaced its address system. Until 2014 an address located a building by the number of the land parcel it stood on; since then it locates it by a road name and a building number. Both systems are still present in business master data, they use different numbers for the same building, and neither can be converted into the other by rule."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article describes the Korean address format, how CDQ represents it in the CDQ address model, and which reference data CDQ maintains for Korea. It is the reference for anyone mapping Korean business partner data into CDQ, or consuming curated Korean addresses from CDQ. It covers the Republic of Korea."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["In this article, you will understand:"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How a Korean address is structured, and how the road name system differs from the lot number system it replaced"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How each Korean level maps to a concept in the CDQ address model, and which SAP field it reaches"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Why a Korean address is identified as a whole rather than parsed field by field"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which reference data CDQ maintains for Korea, and what the published values look like"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Where the current CDQ coverage for Korea is incomplete"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Available in:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/DataModel:CDQ/Business_Partner/Address/Country/KR"},"children":["CDQ Wiki: business partner metadata for Korea"]},": browse the published Korean metadata"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-korean-address-is-built","__idx":2},"children":["How a Korean address is built"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Korean address is a road and a number under a nest of places, which is not an unusual shape. What is specific to Korea is that the country changed the system, and both are still in use."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Specific to Korea"},"children":["Specific to Korea"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Why it matters"},"children":["Why it matters"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Two addressing systems are in circulation for the same building"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a road name address and a lot number address look alike and are not interchangeable, and neither converts into the other by rule"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The road name carries the size of the road"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["대로, 로 and 길 are part of the name and tell you what kind of road it is"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The building number is derived from position along the road"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["it is meaningful only with the road name, and unrelated to the lot number of the same building"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The address is written largest first, and reversed when romanised"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["position is not a reliable way to tell which level a value belongs to"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Every level from the province down is used to address mail"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["unlike Germany, France or Portugal, no Korean level is administrative-only"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-levels","__idx":3},"children":["The levels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All five are used to address mail."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Level"},"children":["Level"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Korean"},"children":["Korean"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Romanised"},"children":["Romanised"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it is"},"children":["What it is"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["시 / 도"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["si / do"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["province level: special city, metropolitan city, province, special self-governing city or province"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["서울특별시 (Seoul)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["시 / 군 / 구"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["si / gun / gu"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["city, county, or autonomous district of a metropolitan city"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["중구 (Jung-gu)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["3"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["읍 / 면 / 동"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["eup / myeon / dong"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["town, township, or neighbourhood"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["태평로1가 (Taepyeongno 1-ga)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["도로명"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["road name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the road, ending in 대로, 로 or 길"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["세종대로 (Sejong-daero)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["5"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["건물번호"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["building number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the number on that road"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["110"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under the road name system the neighbourhood at level 3 is replaced by the road name, so an urban Korean address commonly has four of these five levels rather than all five."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A complete address, largest first as written in Korean, with the post code first:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"04524\n서울특별시 중구 세종대로 110\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Written in English the order is reversed: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["110 Sejong-daero, Jung-gu, Seoul 04524"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-road-name-carries-its-own-size","__idx":4},"children":["The road name carries its own size"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Korean road name ends in one of three words, and the word tells you what kind of road it is:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Korean"},"children":["Korean"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Romanised"},"children":["Romanised"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it is"},"children":["What it is"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["대로"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-daero"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a major boulevard, eight lanes or more"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["로"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-ro"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a road, two to seven lanes"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["길"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["-gil"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a smaller street branching off a road"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In romanised form the word is joined to the name with a hyphen: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Sejong-daero"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Teheran-ro"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Bukchon-gil"]},". The hyphen and the word are part of the name, not punctuation to be cleaned away."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-building-number-is-derived-from-position","__idx":5},"children":["The building number is derived from position"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Under the road name system, building numbers are assigned by distance along the road, odd on one side and even on the other, ascending from west to east and from south to north. Two consequences follow: the number is meaningful only together with the road name, and a building number from the road name system has no relationship to the lot number that identified the same building before 2014."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-two-systems","__idx":6},"children":["The two systems"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"System"},"children":["System"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Korean"},"children":["Korean"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Locates a building by"},"children":["Locates a building by"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Status"},"children":["Status"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Road name address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["도로명주소"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["road name and building number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the legal address since 2014"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Lot number address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["지번주소"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["neighbourhood and land parcel number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["superseded, still common in business data and still how many people give directions"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same building has both. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["서울특별시 중구 세종대로 110"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["서울특별시 중구 태평로1가 31"]}," are the same place. There is no rule that turns one into the other; it requires the national address database."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"A lot number is not a building number"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both are a small integer following a place name, and both sit in what a western model calls the house number. Treating them as the same value merges two different addresses or splits one, depending on which way it goes. The reliable signal is the level above: a road name ending in 로, 길 or 대로 introduces a building number, and a neighbourhood ending in 동 or 가 introduces a lot number."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"properties-that-regularly-cause-integration-errors","__idx":7},"children":["Properties that regularly cause integration errors"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["동 means two different things."]}," As a level in an address it is a neighbourhood. Inside an apartment complex it is a building block: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["101동 1502호"]}," is building 101, unit 1502. The same character, one level of the address apart."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Apartment complexes carry two numbers below the address."]}," 동 for the block and 호 for the unit. Both are premises, and they are frequently the only thing that distinguishes two business partners at the same address."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post codes changed in 2015."]}," The current post code is five digits. The previous one was six, written as three digits, a hyphen and three digits. A Korean record that has not been touched since 2015 carries the old form."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Romanisation is not stable across decades."]}," The official system changed in 2000, and the earlier spellings survive in company names and legacy records: Pusan for Busan, Taegu for Daegu, Kwangju for Gwangju, Inchon for Incheon, Cheju for Jeju."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The province suffix is part of the name."]}," 서울특별시 is Seoul the special city and 경기도 is Gyeonggi the province. The suffix says which kind of unit it is, and the bare form is a different string."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"A romanised Korean address is written in the opposite order"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Korean writes the province first and the building last. English writes the building first and the province last. A Korean address arriving in Latin script may be in either order, and position is therefore not a reliable way to tell which level a value belongs to. Read the suffix instead."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-cdq-models-a-korean-address","__idx":8},"children":["How CDQ models a Korean address"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The CDQ address model has two parallel hierarchies. ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Administrative areas"]}," represent the political containers, typed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REGION"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COUNTY"]},". ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Localities"]}," represent the places themselves, typed ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CITY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DISTRICT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QUARTER"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLOCK"]},". Roads are held as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["thoroughfares"]}," with the number in its own field, and blocks and units as typed ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["premises"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Korea maps as follows:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Korean level"},"children":["Korean level"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"CDQ concept"},"children":["CDQ concept"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Type"},"children":["Type"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"SAP field"},"children":["SAP field"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["시 / 도 province level"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["administrative area, level 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REGION"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["region"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["시 / 군 / 구 city, county or district"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["locality, level 1"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CITY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["city"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["읍 / 면 / 동 town, township or neighbourhood"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["locality, level 2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DISTRICT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["district"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["도로명 road name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["thoroughfare"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STREET"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["street"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["건물번호 building number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["thoroughfare number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["n/a"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["house number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["동 apartment block"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["premise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BUILDING"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["building"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["호 unit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["premise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APARTMENT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["room number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["post code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["post code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REGULAR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["post code"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-the-province-is-the-only-administrative-level","__idx":9},"children":["Why the province is the only administrative level"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Korea's second administrative level, the 시 / 군 / 구, is a place as much as a jurisdiction: it is what a Korean would call the city. Placing it in the locality hierarchy keeps it on the city line of every output, which is where a consumer looks for it, and leaves the county level free rather than filling it with a value that no receiving system reads for Korea. The same reasoning places the 동 on the district line."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"korean-addresses-are-identified-not-parsed","__idx":10},"children":["Korean addresses are identified, not parsed"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For most countries CDQ parses an address by splitting the text and recognising vocabulary. For Korea it does the opposite: the address is assembled into a single string and identified against a Korean address index built from the national postal address database. The index returns the complete structured address."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is deliberate. A Korean address cannot be reliably split by rule, because the same characters mean different things at different levels, the two numbering systems are indistinguishable in isolation, and the romanised order is not fixed. Matching the whole string against known addresses answers all three questions at once, and it is the only route that can return the road name address for a lot number address and the other way round."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"The index is a data source"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Korean address identification runs when the Korean address index is enabled for your workspace. Where it is not, a Korean address is preserved as submitted and the levels it arrived in are kept."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mapping-the-region-to-an-sap-region-key","__idx":11},"children":["Mapping the region to an SAP region key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDQ delivers the province with its ISO 3166-2 code. An SAP system does not validate against ISO: it validates the region field against its own region key table, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T005S"]},", which is part of a customer's configuration. That key exists for tax and jurisdiction purposes, which is why it follows national tax or statistical numbering rather than ISO, and why the level it sits at differs from one country to the next."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The region key is customer-specific configuration, so this standard does not define one: a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T005S"]}," is specific to a customer and to a client, and no single value would be correct everywhere. What this standard fixes is the ISO 3166-2 code. The mapping from it to the key your system expects is yours to maintain."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Korea the key your configuration holds is conventionally the two digit province number, which is the numeric part of the ISO code you receive, so the mapping is a transformation rather than a lookup."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Treat the ISO code as the value CDQ guarantees and the SAP key as a mapping you own."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"worked-example","__idx":12},"children":["Worked example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["서울특별시 중구 세종대로 110"]},", in the CDQ address model:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Field"},"children":["Field"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Value"},"children":["Value"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Country"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 1 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["REGION"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["서울특별시"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 1 short name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["11"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Locality 1 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CITY"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["중구"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Locality 2 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DISTRICT"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["empty for this address, since the road name system replaces the neighbourhood"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Thoroughfare (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STREET"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["세종대로"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Thoroughfare number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["110"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Post code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["04524"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference-data-cdq-maintains-for-korea","__idx":13},"children":["Reference data CDQ maintains for Korea"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"These tables are extracts"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The examples below show the shape of each dataset, not its full contents. The complete published lists for Korea are on the CDQ Wiki page ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/DataModel:CDQ/Business_Partner/Address/Country/KR"},"children":["business partner metadata for Korea"]},", which also covers legal forms, identifier types and the integrated data sources."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"provinces-metropolitan-cities-and-special-cities","__idx":14},"children":["Provinces, metropolitan cities and special cities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["All 17"]},", each with its ISO 3166-2 code and names in Korean, English, Chinese, French and German."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Korean"},"children":["Korean"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"English"},"children":["English"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Also matched as"},"children":["Also matched as"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR-11"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["서울특별시"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seoul"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Seoul"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR-26"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["부산광역시"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Busan"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Busan, 부산"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR-41"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["경기도"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gyeonggi Province"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Gyeonggi, Gyeonggi-do"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR-49"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["제주특별자치도"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Jeju Province"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Jeju, Jeju-do"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["KR-50"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["세종특별자치시"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sejong City"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Sejong-si"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The Korean name carries its administrative suffix, so 서울특별시 rather than 서울, and 경기도 rather than 경기. The suffix identifies the kind of unit and is part of the reference value."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"address-index","__idx":15},"children":["Address index"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Korean address index built from the national postal address database, refreshed from the source. It is what answers an address identification request and what allows a lot number address and a road name address to be recognised as the same place."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"post-code-format","__idx":16},"children":["Post code format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Five digits. The six digit form used before 2015, written as three digits, a hyphen and three digits, is registered as the superseded format so that a legacy value is recognised rather than rejected."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Both forms are validated and neither is rewritten, so a legacy six digit code is recognised as superseded and is not converted to the current five digit code. That conversion needs the address rather than the code."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"success","name":"What CDQ standardises"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["province"]}," is standardised against reference data: whether it arrives in Korean with or without its suffix, or romanised in either the current or an older spelling, the canonical Korean name and the ISO code are written back."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["whole address"]}," is identified against the Korean address index where that data source is enabled, and the structured result replaces the submitted levels."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Post codes"]}," are validated against the five digit format, with the six digit form recognised as superseded."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Levels below the province are preserved as submitted where the index is not enabled."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"current-limitations","__idx":17},"children":["Current limitations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["These are the gaps worth knowing about before designing an integration."]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Limitation"},"children":["Limitation"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it means for an integration"},"children":["What it means for an integration"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The Korean address vocabulary is not yet published"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The level markers 시, 도, 군, 구, 읍, 면, 대로, 로 and 길 are not yet maintained as reference data, so a Korean address level cannot be identified from its marker word. That is the signal that works regardless of the order the address is written in, and its absence is the reason the address index rather than text parsing is the route for Korea."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Korean addresses are parsed by the address index, and not by the generic parser"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The generic text parser does not run for Korea, because splitting a Korean address by rule cannot distinguish a building number from a lot number or a neighbourhood from a block. Where the address index is not enabled for your workspace, a Korean address is preserved exactly as submitted, in the levels it arrived in."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Korean localities are not transliterated"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A Korean locality is not romanised and a romanised locality is not converted to Korean, so whichever script an address arrives in is the script it leaves in. Where you need both, supply both."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Geocoding for Korea is resolved on the road name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Coordinates are resolved through a single provider, and the building number is deliberately left out of that request because the provider answers more reliably on the road name alone. A returned coordinate is therefore accurate to the road rather than to the building."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"Keep both address systems where you have them"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Where your source holds a road name address and a lot number address for the same partner, keep both. They are not redundant: the road name address is the legal one, the lot number address is what many Korean systems and people still use, and neither can be recovered from the other without the national database."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":18},"children":["Summary"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Korean address is written largest first, from the province down to the building, and it exists in two systems. The road name system, legal since 2014, locates a building by a road name ending in 대로, 로 or 길 and a number derived from its position along that road. The lot number system it replaced locates the same building by a neighbourhood and a land parcel number. Both are in circulation and neither converts into the other by rule."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDQ places the province in administrative area level 1, the city, county or district in locality level 1, and the neighbourhood in locality level 2, so that each reaches its own output field. The road name goes to the street and the building number to the house number. The apartment block and the unit are typed premises."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All 17 provinces and metropolitan cities are maintained as CDQ reference data with their Korean names, administrative suffixes and ISO codes. Below that, a Korean address is identified as a whole against a Korean address index built from the national postal address database rather than parsed field by field, because the same characters mean different things at different levels and the written order is not fixed. The Korean address vocabulary itself is not yet published, which is why the identification route matters so much."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":19},"children":["Related Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/DataModel:CDQ/Business_Partner/Address/Country/KR"},"children":["Business partner metadata for Korea"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/articles/country-standards/japan-address-standard"},"children":["Japan Address Standard"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/articles/country-standards/thailand-address-standard"},"children":["Thailand Address Standard"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/articles/country-standards/india-address-standard"},"children":["India Address Standard"]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"your-opinion-matters","__idx":20},"children":["Your opinion matters!"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["We are constantly working on providing an outstanding user experience with our products. Please share your opinion about this tutorial!"]}]},"headings":[{"value":"Korea Address Standard","id":"korea-address-standard","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"How a Korean address is built","id":"how-a-korean-address-is-built","depth":2},{"value":"The levels","id":"the-levels","depth":3},{"value":"The road name carries its own size","id":"the-road-name-carries-its-own-size","depth":3},{"value":"The building number is derived from position","id":"the-building-number-is-derived-from-position","depth":3},{"value":"The two systems","id":"the-two-systems","depth":3},{"value":"Properties that regularly cause integration errors","id":"properties-that-regularly-cause-integration-errors","depth":3},{"value":"How CDQ models a Korean address","id":"how-cdq-models-a-korean-address","depth":2},{"value":"Why the province is the only administrative level","id":"why-the-province-is-the-only-administrative-level","depth":3},{"value":"Korean addresses are identified, not parsed","id":"korean-addresses-are-identified-not-parsed","depth":3},{"value":"Mapping the region to an SAP region key","id":"mapping-the-region-to-an-sap-region-key","depth":3},{"value":"Worked example","id":"worked-example","depth":3},{"value":"Reference data CDQ maintains for Korea","id":"reference-data-cdq-maintains-for-korea","depth":2},{"value":"Provinces, metropolitan cities and special cities","id":"provinces-metropolitan-cities-and-special-cities","depth":3},{"value":"Address index","id":"address-index","depth":3},{"value":"Post code format","id":"post-code-format","depth":3},{"value":"Current limitations","id":"current-limitations","depth":2},{"value":"Summary","id":"summary","depth":2},{"value":"Related Resources","id":"related-resources","depth":2},{"value":"Your opinion matters!","id":"your-opinion-matters","depth":2}],"frontmatter":{"seo":{"title":"Korea Address Standard","description":"How Korean addresses are structured, how CDQ models them in the CDQ address model, how the road name and the older lot number systems relate, and which reference data CDQ maintains for Korea."},"toc":{"enable":true},"cdqContentMetadata":{"product":"Address Guard","lastUpdate":"2026-09-03T00:00:00.000Z","author":"Product Management","reviewer":"X-Team TechDocs"}},"lastModified":"2026-09-09T10:44:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/_public/articles/country-standards/korea-address-standard","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}