A Chinese address is written from the largest area to the smallest: the province, then the city, the district, the street with its number, and finally the building, the floor and the room. The same address written in English or in pinyin runs the other way, from the room up to the province. Business partner data holds both orders, often in the same file, and sometimes mixes them in one record. What breaks integrations is reading the components by their position rather than by the words that mark them, and deciding which of the several "cities" in a Chinese address is the city.
This article describes the Chinese address format, how CDQ represents it in the CDQ address model, how the province and the postcode are handled, and which reference data CDQ maintains for China. It is the reference for anyone mapping Chinese business partner data into CDQ, or consuming curated Chinese addresses from CDQ.
In this article, you will understand:
- Why the same Chinese address is written in two opposite orders
- Which administrative levels appear on an address, and which of them is the city
- How the street, the number, the building, the floor and the room are written
- What the six-digit postcode encodes
- How each element maps to a concept in the CDQ address model, and which SAP field it reaches
- Which country code applies to Hong Kong and Macao
- Which reference data CDQ maintains for China, and where it is incomplete
Available in:
- CDQ Wiki: business partner metadata for China: browse the published Chinese metadata
| Specific to China | Why it matters |
|---|---|
| Written largest-first in Chinese, smallest-first in English and pinyin | 北京市海淀区知春路12号 and No.12 Zhichun Road, Haidian District, Beijing are the same address; a parser that relies on position reads one of them backwards |
| Each level carries a marker word | 省 province, 市 city, 区 district, 县 county, 镇 town, 路 road, 号 number; the marker, not the position, tells you what a value is |
| Several levels can be called a city | a municipality (北京市), a prefecture-level city (苏州市) and a county-level city (昆山市) all end in 市, and one address can name two of them |
| Four municipalities are both province and city | Beijing, Shanghai, Tianjin and Chongqing are province-level; the same name is the region and the city |
| The building, unit, floor and room follow the number | 3号楼2单元10层1001室 is building 3, unit 2, floor 10, room 1001, all after the street number |
| The postcode is six digits and identifies the delivery area | it is written before the province in English and can start with 0 |
| Hong Kong and Macao have their own country codes | HK and MO, although ISO also lists them as regions of China (CN-HK, CN-MO) |
The People's Republic of China has a deep administrative hierarchy. Not every level is written on an address.
| Level | What it is | Used to address mail | Example |
|---|---|---|---|
| province-level division | 22 provinces (省), 5 autonomous regions (自治区) and 4 municipalities (直辖市) on the mainland, plus the two special administrative regions | yes | 江苏省 Jiangsu, 北京市 Beijing |
| prefecture-level city | 地级市; the city that governs the districts and counties around it. A municipality has no such level | yes | 苏州市 Suzhou |
| district, county or county-level city | 区 urban district, 县 county, 县级市 county-level city, and in Inner Mongolia 旗 banner | yes | 海淀区 Haidian, 昆山市 Kunshan |
| township or subdistrict | 镇 town, 乡 township, 街道 subdistrict | in rural addresses; urban addresses usually omit it | 丹阳镇 Danyang |
| village or community | 村 village, 社区 community, and development zones such as 开发区 | in rural addresses and in some business parks | 新阳村 Xinyang |
A county-level city is a city in its own right, and businesses in it usually name it as their city. It still belongs to a prefecture-level city: 昆山市 Kunshan is part of 苏州市 Suzhou.
The same address in the three forms found in business data. In Chinese, from the largest area to the smallest:
北京市海淀区知春路12号In English and in pinyin, as China Post gives it in the UPU addressing sample, from the smallest to the largest, with the postcode in front of the province:
No.12 Zhichun Road
Haidian District
100191 BEIJING
P.R. CHINAZhichun Lu 12 Hao
Haidian Qu
100191 BEIJING
P.R. CHINAA rural address names the town, the county and the prefecture-level city, which the urban example does not need:
No.10 Tuanjie Road, Xinyang Village, Danyang Town
Lianjiang County, Fuzhou City
350503 FUJIAN
P.R. CHINAIn Beijing the province-level line is the municipality, so BEIJING stands for both the region and the city.
| Part | Chinese | Pinyin | English |
|---|---|---|---|
| road, street, avenue | 路, 街, 大道, 大街 | Lu, Jie, Dadao, Dajie | Road, Street, Avenue |
| number | 号, after the number | Hao, after the number | No., before the number |
| residential or office complex | 小区, or the complex name | Xiaoqu | Residential area |
| building | 号楼, 栋, 幢, after the number | Lou | Building |
| unit (stairwell) | 单元 | Danyuan | Unit |
| floor | 层 | Ceng | Floor |
| room | 室 | Shi | Room |
A direction is part of the street name, not a separate element: 前进中路 is Qianjin Middle Road and 中山东路 is Zhongshan East Road. In Chinese the building, unit, floor and room follow the street number without separators; in English they move to a line of their own above the street, as in Room 1001, Floor 10, Building 3.
The postcode has six digits. The first two identify the province-level division, the third the postal zone within it, the fourth the post office, and the last two the delivery area. One postcode covers many addresses; it does not identify a building.
Hong Kong and Macao have their own ISO 3166-1 codes, HK and MO, their own postal administrations, and their own address formats. ISO 3166-2 also lists them as regions of China, CN-HK and CN-MO, which is why business data sometimes holds them under CN.
This standard uses HK and MO. An address supplied as CN with the region Hong Kong or Macao is accepted as input, and identifies the same place. Hong Kong uses no postcode. Addresses in Taiwan are outside the scope of this article.
A Chinese source may deliver Haidian District in the city column and Beijing in the district column, or a whole address largest-first in a field that a system expects smallest-first. The marker words, 省, 市, 区, 县 and 镇 in Chinese, Sheng, Shi, Qu, Xian and Zhen in pinyin, Province, City, District and County in English, are the only reliable way to tell the levels apart. Map each value by its marker before loading.
The city is the prefecture-level city. An address in Kunshan names 苏州市 Suzhou and 昆山市 Kunshan. Both are cities; this standard keeps the prefecture-level city as the city and the county-level city as the district (see below). Storing whichever comes first, or concatenating them, produces values that no comparison will match.
Beijing as region and as city is correct. For a municipality, the same name in the region and in the city is not a duplicate to clean up.
Shaanxi and Shanxi are two provinces. 陕西 Shaanxi (CN-SN) and 山西 Shanxi (CN-SX) differ only in the tone of the first syllable, which pinyin without tone marks cannot show. The double a in Shaanxi is the official spelling that tells them apart. A source that writes both as Shanxi has merged two provinces.
ISO changed the region codes in 2017. The numeric codes were replaced by letters: CN-11 became CN-BJ, CN-31 became CN-SH, CN-32 became CN-JS, CN-44 became CN-GD, and so on for every province. Data and mappings built before 2017 may still hold the numeric codes.
A postcode is text, not a number. Inner Mongolia postcodes start with 0, as in 027212. Stored as a number, the code loses its first digit.
Hong Kong has no postcode. A value such as 999077 in a Hong Kong address is an internal China Post code for international mail, not a Hong Kong postcode.
The CDQ address model has two parallel hierarchies. Administrative areas represent the political containers, typed REGION and COUNTY. Localities represent the places themselves, typed CITY, DISTRICT, QUARTER or BLOCK. Streets are held as thoroughfares with the number in its own field, and buildings, units, floors and rooms as typed premises.
China maps as follows:
| Chinese element | CDQ concept | Type | SAP field |
|---|---|---|---|
| province, autonomous region or municipality | administrative area, level 1 | REGION | region |
| prefecture-level city, or the municipality itself | locality, level 1 | CITY | city |
| district, county or county-level city | locality, level 2 | DISTRICT | district |
| township or subdistrict (镇, 乡, 街道) | locality, level 3 | QUARTER | none |
| village or community (村, 社区) | locality, level 4 | QUARTER | none |
| development zone (开发区) | thoroughfare | INDUSTRIAL_ZONE | none |
| road or street, with its marker | thoroughfare | STREET | street |
| number (号) | thoroughfare number | n/a | house number |
| building | premise | BUILDING | building |
| unit | premise | UNIT | street 5 |
| floor | premise | LEVEL | floor |
| room | premise | ROOM | room number |
| PO box | postal delivery point | POST_OFFICE_BOX | PO box |
| postcode | post code | REGULAR | post code |
The prefecture-level city is the city in this standard, and for a municipality the city is the municipality: Beijing is both the region and the city. A district, a county or a county-level city goes to the district, so an address in Kunshan has the city Suzhou and the district Kunshan. The township and the village go to locality levels 3 and 4, below the district, and a development zone is held as an industrial zone next to the street. None of the three has an SAP field of its own in this standard. China does not use the SAP house number supplement, HOUSE_NUM2, which CDQ fills only for the Iberian and Latin American convention.
The city, the district and the street are kept in the script in which they arrive. A record in Chinese characters is not romanised, and a record in pinyin or English is not converted to Chinese characters.
CDQ standardises the province against reference data and writes back the canonical name and the ISO 3166-2 code. The reference data holds each province-level division in Chinese characters, with its suffix, and in pinyin and English, so 江苏省, Jiangsu and Jiangsu Sheng identify the same record.
The province is not derived from the postcode, and the postcode is not checked against the province. Where an address provider is enabled, it can complete and correct both.
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, T005S, which is part of a customer's configuration.
The region key is customer-specific configuration, so this standard does not define one: a 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.
For China, do not assume that your key equals the two letters of the ISO code. A mapping built from ISO before 2017 holds the numeric codes (CN-11 for Beijing, CN-44 for Guangdong), which ISO replaced with letters that year. Confirm that your table covers all 31 mainland province-level divisions.
Room 1001, Floor 10, Building 3, No.12 Zhichun Road, Haidian District, 100191 Beijing, adapted from the China Post sample, in the CDQ address model:
| Field | Value |
|---|---|
| Country | CN |
Administrative area 1 (REGION) | Beijing |
| Administrative area 1 code | CN-BJ |
Locality 1 (CITY) | Beijing |
Locality 2 (DISTRICT) | Haidian District |
Thoroughfare (STREET) | Zhichun Road |
| Thoroughfare number | 12 |
Premise (BUILDING) | 3 |
Premise (LEVEL) | 10 |
Premise (ROOM) | 1001 |
| Post code | 100191 |
In the SAP fields, 12 is the house number, 3 the building, 10 the floor and 1001 the room number; Zhichun Road is the street, Haidian District the district, and Beijing both the city and the region.
The examples below show the shape of each dataset, not its full contents. The complete published lists for China are on the CDQ Wiki page business partner metadata for China, which also covers legal forms, identifier types and the integrated data sources.
34 entries, the full ISO 3166-2 list: 23 provinces, 5 autonomous regions, 4 municipalities and the 2 special administrative regions. Each carries its ISO code, its name in Chinese characters with its suffix, and its name in pinyin and English.
| Code | Chinese | English | Category |
|---|---|---|---|
CN-BJ | 北京市 | Beijing | municipality |
CN-SH | 上海市 | Shanghai | municipality |
CN-GD | 广东省 | Guangdong | province |
CN-JS | 江苏省 | Jiangsu | province |
CN-SN | 陕西省 | Shaanxi | province |
CN-SX | 山西省 | Shanxi | province |
CN-GX | 广西壮族自治区 | Guangxi | autonomous region |
CN-HK | 香港 | Hong Kong | special administrative region |
The pinyin forms are published with and without the suffix and with the syllables written apart, for example Jiangsu, Jiangsu Sheng and Jiang Su Sheng.
A small vocabulary: 大厦 and 办公楼 for a building, 楼 for a floor, 室 for a room, and English street and building words such as Road (RD), Street (ST) and Avenue (AVE).
Six digits.
The province is standardised against reference data, in Chinese characters, pinyin or English, and the canonical name and the ISO code are written back.
The city, the district, the street and the postcode are preserved as submitted. Where an address provider is enabled, it can enrich and complete them.
These are the gaps worth knowing about before designing an integration.
| Limitation | What it means for an integration |
|---|---|
| A full address in simplified characters is split only partly | When the whole address arrives as one string in Chinese characters, CDQ splits it by its marker words, but recognises the district, county, town, number and floor markers only in traditional characters (區, 縣, 鎮, 號, 樓). In simplified characters only 市, 村, 街, 路, 道 and 巷 are recognised. A district (区) can then stay in the street, and the city can take everything up to the last 市, the province and a county-level city included. Supply the province, the city and the district in their own fields. |
| Chinese street and premise words are not published | 路, 街, 号, 区, 县, 层, 单元, 栋 and their pinyin forms (Lu, Jie, Hao, Ceng) are not yet published as reference data, so the number, the unit and the floor may stay in the street. Supply them in their own fields where you can. |
| 楼 is read as a floor | The published term 楼 is typed as a floor. In a mainland address 3号楼 is building 3, so it may arrive as a floor. |
| Hong Kong and Macao are not converted | An address supplied as CN with the region Hong Kong or Macao keeps the country CN and the region CN-HK or CN-MO. Supply HK or MO where the record is in one of them. |
| The numeric ISO codes are not published | The pre-2017 codes (CN-11, CN-44) are not alternative names in the reference data, so a province supplied only by its numeric code may not resolve. Supply the name or the current code. |
| The Chinese province name without its suffix is not published | 江苏 and 广东, without 省, are not alternative names in the reference data and may not resolve. The pinyin form without the suffix, Jiangsu, is published. |
| The province is not derived from the postcode | A missing province is not completed from the postcode, and a postcode that belongs to another province is not flagged. |
| The formatted address writes the number after the street | The formatted street line reads Zhichun Road 12. That is the Chinese order, but not the English one (No.12 Zhichun Road). The street and the number are separate fields in the model and in SAP, so only the single-line presentation is affected. |
| Levels below the district are not standardised | Townships, villages and development zones are not published as reference data, so they are kept as supplied and not checked. When a full address string is split, a village (村) is typed as a city rather than placed at locality level 4, and a township or a development zone is not recognised. Supply them in their own fields. |
A Chinese address names the province, the city, the district, the street with its number, and then the building, the floor and the room. Chinese writes it from the largest area to the smallest; English and pinyin write it the other way, with the six-digit postcode in front of the province. Each level carries a marker word, and the marker, not the position, identifies it. Several levels end in 市, and this standard keeps the prefecture-level city as the city. Hong Kong and Macao have their own country codes.
CDQ places the province in administrative area level 1, the prefecture-level city in locality level 1, the district, county or county-level city in locality level 2, and the township and the village in levels 3 and 4. The street, the number, the building, the unit, the floor and the room are separate fields, and the city, the district and the street stay in the script they arrive in. The province is standardised from its Chinese, pinyin or English name. The SAP region key is customer configuration.
The 34 province-level divisions are maintained as CDQ reference data. The Chinese street and premise vocabulary, the splitting of a full address in simplified characters, and the conversion of Hong Kong and Macao are where the current coverage is weakest.
We are constantly working on providing an outstanding user experience with our products. Please share your opinion about this tutorial!