China
| Property | Value |
|---|---|
| Code | CN |
| Currency | CNY |
| Region | Asia, Eastern Asia |
| Name order | Given name first |
| State | Province, a list of 34 |
| Postcode | Required, checked, like 266033 |
| Rules | GET /v1/countries/CN |
Form
The address form, in English. A field that is not required shows its optional label.
Fields
| Field | Label | Required | Autocomplete |
|---|---|---|---|
country | Country (list) | yes | country |
first_name | First name | yes | given-name |
last_name | Last name | yes | family-name |
line1 | Address | yes | address-line1 |
line2 | Apartment, suite, etc. | no | address-line2 |
city | City | yes | address-level2 |
state | Province (list) | yes | address-level1 |
postcode | Postal code | yes | postal-code |
phone_number | Phone number | no | tel |
email | yes | email |
Postcode
| Rule | Value |
|---|---|
| Required | yes |
| Pattern | ^[0-9]{6}$ |
| Example | 266033 |
| Written as | as typed |
| Checked by state | no |
Phone
| Rule | Value |
|---|---|
| Calling code | +86 |
| National prefix | 0 |
| Pattern | ^[0-9]{7,13}$ |
| Example | 131 2345 6789 |
| Written as | ### #### #### |
Address format
How an address is written for reading, on an order page, a receipt or a label: address.format in the rules.
CODE
{postcode}
{state}{city}
{line1}
{line2}
{first_name} {last_name}
{country}Written in Latin script, the lines differ:
CODE
{first_name} {last_name}
{line1}
{line2}
{city}
{state}, {postcode}
{country}On an envelope, the province is written in capitals.
Example
A real address in China, from address.example, written with the format and the state by its name:
CODE
100006
Beijing Shi北京市
东城区东长安街16号
三 张
ChinaThe same address in Latin script:
CODE
San Zhang
16 East Chang'an Avenue, Dongcheng District
Beijing
Beijing Shi, 100006
ChinaProvince
The form submits the code, which is what an order stores; the name is what the shopper reads, in their language.
| Code | Name |
|---|---|
Anhui Sheng | Anhui Sheng |
Beijing Shi | Beijing Shi |
Chongqing Shi | Chongqing Shi |
Fujian Sheng | Fujian Sheng |
Gansu Sheng | Gansu Sheng |
Guangdong Sheng | Guangdong Sheng |
Guangxi Zhuangzu Zizhiqu | Guangxi Zhuangzu Zizhiqu |
Guizhou Sheng | Guizhou Sheng |
Hainan Sheng | Hainan Sheng |
Hebei Sheng | Hebei Sheng |
Heilongjiang Sheng | Heilongjiang Sheng |
Henan Sheng | Henan Sheng |
Hong Kong SAR | Hong Kong SAR |
Hubei Sheng | Hubei Sheng |
Hunan Sheng | Hunan Sheng |
Jiangsu Sheng | Jiangsu Sheng |
Jiangxi Sheng | Jiangxi Sheng |
Jilin Sheng | Jilin Sheng |
Liaoning Sheng | Liaoning Sheng |
Macao SAR | Macao SAR |
Nei Mongol Zizhiqu | Nei Mongol Zizhiqu |
Ningxia Huizu Zizhiqu | Ningxia Huizu Zizhiqu |
Qinghai Sheng | Qinghai Sheng |
Shaanxi Sheng | Shaanxi Sheng |
Shandong Sheng | Shandong Sheng |
Shanghai Shi | Shanghai Shi |
Shanxi Sheng | Shanxi Sheng |
Sichuan Sheng | Sichuan Sheng |
Taiwan Sheng | Taiwan Sheng |
Tianjin Shi | Tianjin Shi |
Xinjiang Uygur Zizhiqu | Xinjiang Uygur Zizhiqu |
Xizang Zizhiqu | Xizang Zizhiqu |
Yunnan Sheng | Yunnan Sheng |
Zhejiang Sheng | Zhejiang Sheng |
Messages
What the form shows under a field when a value is refused, in English. Every language is on its page under Languages.
| Field | Error | Message |
|---|---|---|
country | not_selected | Select a country |
first_name | blank | Enter a first name |
first_name | invalid_characters | First name can only contain letters, spaces, hyphens and apostrophes |
first_name | contains_emoji | First name can't contain emojis |
first_name | too_long | First name must be 255 characters or fewer |
last_name | blank | Enter a last name |
last_name | invalid_characters | Last name can only contain letters, spaces, hyphens and apostrophes |
last_name | contains_emoji | Last name can't contain emojis |
last_name | too_long | Last name must be 255 characters or fewer |
line1 | blank | Enter an address |
line1 | contains_emoji | Address can't contain emojis |
line1 | too_long | Address must be 255 characters or fewer |
line2 | blank | Enter address line 2 |
line2 | contains_emoji | Address line 2 can't contain emojis |
line2 | too_long | Address line 2 must be 255 characters or fewer |
city | blank | Enter a city |
city | invalid | Enter a valid city |
city | contains_emoji | City can't contain emojis |
city | too_long | City must be 255 characters or fewer |
state | not_selected | Select a province |
state | invalid | Choose a province from the list |
postcode | blank | Enter a postal code |
postcode | invalid | Enter a valid postal code, like 266033 |
postcode | contains_emoji | Postal code can't contain emojis |
postcode | too_long | Postal code must be 64 characters or fewer |
phone_number | blank | Enter a phone number |
phone_number | invalid | Enter a valid phone number, like 131 2345 6789 |
phone_number | contains_emoji | Phone number can't contain emojis |
phone_number | too_long | Phone number must be 24 characters or fewer |
email | blank | Enter an email address |
email | invalid | Enter a valid email, like name@example.com |
email | contains_emoji | Email can't contain emojis |
email | too_long | Email must be 254 characters or fewer |