{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","partial"]},"type":"markdown"},"seo":{"title":"United States Address Standard","llmstxt":{"hide":false,"sections":[{"title":"Table of contents","includeFiles":["**/*"],"excludeFiles":[]}],"excludeFiles":[]},"description":"How United States addresses are structured, how CDQ models them in the CDQ address model, how ZIP and ZIP+4 are handled, and which reference data CDQ maintains for the United States."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"united-states-address-standard","__idx":0},"children":["United States Address Standard"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A United States address looks simple and is not. The street line is defined by a national standard down to the abbreviation of every suffix, the delivery point is identified by a nine digit code rather than by the street address, and the second line of the address carries a suite or apartment that a naive mapping will lose."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article describes the United States address format, how CDQ represents it in the CDQ address model, how ZIP and ZIP+4 are handled, and which reference data CDQ maintains. It is the reference for anyone mapping United States business partner data into CDQ, or consuming curated United States addresses from CDQ."]},{"$$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 United States address is structured, and what the postal standard requires of each element"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which elements are needed to deliver mail, and which are carried for other purposes"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["How each element maps to a concept in the CDQ address model, and which SAP field it reaches"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What ZIP+4 identifies, why it is one value and not two, and how CDQ delivers it"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which reference data CDQ maintains for the United States, and what the published values look like"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Where the current CDQ coverage for the United States 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/US"},"children":["CDQ Wiki: business partner metadata for the United States"]},": browse the published United States metadata"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-united-states-address-is-built","__idx":2},"children":["How a United States address is built"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A United States address has an ordinary shape: a number, a street, a place and a post code. What is unusual is not the shape but how tightly it is specified, and what the post code is for."]},{"$$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 the United States"},"children":["Specific to the United States"]},{"$$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":["A published national standard prescribes the vocabulary and the line order"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the abbreviation of every street suffix and every secondary unit designator is fixed, so a delivered value can be compared against a known set"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The delivery point is identified by a nine digit code, not by the street address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the four digit add-on is derived by the postal service and narrows the address to one side of a block, one building or one floor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The state is written on every address and is mandatory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["unlike Germany, France or Portugal, a United States address without a state is genuinely incomplete"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The city is a post office name, not a municipality"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["it cannot be used as a key for the municipality, and several names are frequently valid for one post code"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The county is not postal and is needed anyway"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["tax jurisdiction is assigned by county, so it has to be carried alongside the city rather than instead of it"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A directional is part of the address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N MAIN ST"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 S MAIN ST"]}," are different buildings, usually on opposite sides of a baseline"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-elements","__idx":3},"children":["The elements"]},{"$$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":"Element"},"children":["Element"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"What it is"},"children":["What it is"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Used to address mail"},"children":["Used to address mail"]},{"$$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":["state"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["top level subdivision, always written as its two letter code in postal use"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes, and it is mandatory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["county"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["subdivision of a state, present in business data and required for tax jurisdiction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Santa Clara"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["city"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the post office name serving the address, which is not always the municipality the address sits in"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SAN JOSE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["street line"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number, directional, name, suffix, and a second directional where one applies"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N MAIN ST"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["secondary unit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["suite, apartment, floor, room, building or department"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STE 400"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ZIP"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["five digit code identifying the delivery area"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["95113"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ZIP+4"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["four further digits identifying the delivery point inside that area"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["not required, and derived rather than supplied"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["2007"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A complete address in the form the postal standard asks for:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"ACME MANUFACTURING INC\n123 N MAIN ST STE 400\nSAN JOSE CA 95113-2007\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The postal standard asks for uppercase, no punctuation, standard abbreviations, and the city, state and ZIP on one final line. That is a presentation convention for the envelope. The values behind it are what CDQ stores, and they are stored separately."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-street-line-is-four-things-not-one","__idx":4},"children":["The street line is four things, not one"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N MAIN ST"]}," is a number, a directional, a name and a suffix. Two of those four are standardised vocabulary:"]},{"$$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":"Part"},"children":["Part"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Example"},"children":["Example"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Standardised"},"children":["Standardised"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["no, but it may carry a fraction (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 1/2"]},") or a hyphen (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123-45"]}," in Queens, New York)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["directional"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SW"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes, to one or two letters, and it can appear before or after the name"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAIN"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["no"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["suffix"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AVE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLVD"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes, to the published suffix abbreviation"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A directional is part of the address, not decoration."]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N MAIN ST"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 S MAIN ST"]}," are different buildings, usually on opposite sides of a baseline that runs through the city. Dropping the directional does not shorten the address, it changes it."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"zip4-identifies-a-delivery-point-not-an-area","__idx":5},"children":["ZIP+4 identifies a delivery point, not an area"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The five digit ZIP identifies a delivery area. The four digit add-on narrows it to a delivery point: one side of one block, one building, one floor of a building, or one high volume recipient. Written together they are ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["95113-2007"]},"."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"ZIP+4 is derived, not supplied"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The add-on is assigned by the postal service from the rest of the address. It is not something a business partner knows about itself, and it is not stable if the street address changes. That is why it is looked up rather than requested, and why an address arriving with five digits is complete rather than deficient."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"properties-that-regularly-cause-integration-errors","__idx":6},"children":["Properties that regularly cause integration errors"]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"danger","name":"The city on the address is a post office name, not a municipality"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The United States postal city is the name of the post office that serves the address. A building can sit inside one incorporated city and carry the name of another on its mail, and several distinct place names are frequently acceptable for the same ZIP. So a United States city value cannot be used as a reliable key for the municipality, and a mismatch between the city you hold and the city the postal service returns is usually not an error in either."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The secondary unit belongs on the same line as the street."]}," The postal standard puts ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STE 400"]}," at the end of the street line, not on a line of its own above it. Systems that model a second street line often receive the suite there instead, and both forms occur in real data."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A county is not part of the postal address."]}," It is nonetheless in most business records, because it drives tax jurisdiction. It has to be carried, and it has to be carried separately from the city."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Not every county is called a county."]}," Louisiana has parishes, Alaska has boroughs and census areas, and Virginia has independent cities that sit outside any county. In Virginia the same name can be both: Fairfax County and the city of Fairfax are different jurisdictions."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["PO Box, rural route and highway contract addresses are not street addresses."]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PO BOX 1234"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RR 2 BOX 152"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HC 1 BOX 15"]}," are delivery points, and a building cannot be found from any of them."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Puerto Rico uses an extra line."]}," A Puerto Rican address can carry an urbanizacion name above the street, which identifies the development the street sits in and is required to deliver."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"A ZIP with a lost leading zero is not a ZIP"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ZIP codes in New England, New Jersey and Puerto Rico begin with a zero. Handled as a number at any point in the chain, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["01730"]}," becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1730"]},", which is a valid looking four digit value and an invalid ZIP. Always carry a ZIP as text."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-cdq-models-a-united-states-address","__idx":7},"children":["How CDQ models a United States 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"]},". Streets are held as ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["thoroughfares"]}," with the number in its own field, and secondary units as typed ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["premises"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The United States 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":"United States element"},"children":["United States element"]},{"$$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":["state"]},{"$$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":["county"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["administrative area, level 2"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COUNTY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["county"]},", with its FIPS code in the county FIPS field"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["city"]},{"$$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":["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":["street name with its directional and suffix"]},{"$$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":["house 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":["suite, unit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["premise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUITE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNIT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["street 5"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["building"]},{"$$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":["floor"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["premise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LEVEL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["floor"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["apartment, room"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["premise"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APARTMENT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ROOM"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["room number"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PO Box"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["postal delivery point"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST_OFFICE_BOX"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PO box"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ZIP, with the add-on where it is known"]},{"$$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":"Admonition","attributes":{"type":"info","name":"The number is delivered before the street"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The United States is one of the countries for which the formatted address writes the number in front of the street value, giving ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N MAIN ST"]},". The two values remain separate in the model; only the presentation is reversed."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"why-zip-and-zip4-share-one-field","__idx":8},"children":["Why ZIP and ZIP+4 share one field"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The nine digits are one postal code, written with a hyphen after the fifth. Splitting them across two fields would:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["weaken matching"]},", because two addresses differing only in the add-on are usually the same building, and two sharing an add-on across different ZIPs are unrelated"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["invite partial writes"]},", where the add-on survives an update of the ZIP and produces a nine digit value that was never issued"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["push postal logic downstream"]},", into systems that have no reason to know what an add-on is"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["So the canonical form is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["95113-2007"]}," in the post code field, and an address for which no add-on is known carries the five digit value alone. Nothing is lost either way, and the delivered value is always a code the postal service would recognise."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mapping-the-region-to-an-sap-region-key","__idx":9},"children":["Mapping the region to an SAP region key"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDQ delivers the state 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 the United States the key your configuration holds is conventionally the two letter state code, which is also the ISO subdivision code, so the mapping is usually the identity. That makes the United States the easy case rather than the normal one: most countries need a real mapping."]},{"$$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":10},"children":["Worked example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 N Main St Ste 400, San Jose CA 95113"]},", 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":["US"]}]}]},{"$$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":["California"]}]},{"$$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":["CA"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 1 FIPS code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["06"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 2 (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["COUNTY"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Santa Clara"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 2 FIPS code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["06085"]}]}]},{"$$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":["San Jose"]}]},{"$$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":["North Main Street, delivered as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N MAIN ST"]}]}]},{"$$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":["123"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Premise (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUITE"]},")"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STE 400"]}]}]},{"$$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":["95113-2007"]}," once the add-on is resolved, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["95113"]}," otherwise"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference-data-cdq-maintains-for-the-united-states","__idx":11},"children":["Reference data CDQ maintains for the United States"]},{"$$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 the United States are on the CDQ Wiki page ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/DataModel:CDQ/Business_Partner/Address/Country/US"},"children":["business partner metadata for the United States"]},", which also covers legal forms, identifier types and the integrated data sources."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"states-and-territories","__idx":12},"children":["States and territories"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["57 entries"]},": the 50 states, the District of Columbia, and the territories and outlying islands. Each carries its ISO 3166-2 code, its FIPS state code, and names in English, German, French and Chinese."]},{"$$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":"FIPS"},"children":["FIPS"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"English"},"children":["English"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-CA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["06"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["California"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-NY"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["36"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["New York"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-DC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["11"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["District of Columbia"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-PR"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["72"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Puerto Rico"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"counties","__idx":13},"children":["Counties"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["3,145 entries"]},", one per county or county equivalent, each linked to its state and keyed by its five digit FIPS code. That key is the state FIPS followed by the county FIPS, so the parent is readable from the key itself."]},{"$$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":"State"},"children":["State"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Name"},"children":["Name"]},{"$$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":["01001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-AL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Autauga"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Autauga County"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["06085"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-CA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Santa Clara"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Santa Clara County"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["22001"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-LA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acadia Parish"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Acadia Parish"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["51600"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["US-VA"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fairfax city"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Fairfax city"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A county supplied with the word County attached is matched: the word is removed before the lookup."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"street-suffixes","__idx":14},"children":["Street suffixes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["137 entries"]}," covering the published postal suffix vocabulary, each with its official abbreviation. The abbreviation is what the delivered street line carries."]},{"$$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":"Term"},"children":["Term"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Abbreviation"},"children":["Abbreviation"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["STREET"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["AVENUE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AVE"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["BOULEVARD"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLVD"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["DRIVE"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["DR"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["HIGHWAY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HWY"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["PARKWAY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PKY"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["CROSSING"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["XING"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["EXPRESSWAY"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["EXPY"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The same list carries the post office box vocabulary: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PO Box"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P.O. Box"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P.O."]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Box"]}," all identify a post office box, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MS"]}," a mail station."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"post-code-format","__idx":15},"children":["Post code format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Five digits, optionally followed by a four digit add-on. The canonical written form is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345-6789"]},". Both ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123456789"]}," are accepted as input and understood."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The format is validated and the value is not rewritten, so a ZIP that lost its leading zero upstream is carried as supplied rather than padded, and a nine digit value gains its hyphen only when the postal lookup runs. Post code normalisation is currently available for Canada and Mexico."]},{"$$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":["state"]}," is standardised against reference data: whether it arrives as a name or as a two letter code, the canonical name, the ISO code, the postal code and the FIPS code are written back."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["county"]}," is standardised against reference data, with or without the word County, and its five digit FIPS code is written back. That code is what a tax jurisdiction lookup needs."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Street suffixes"]}," are recognised in the street text and rewritten to the official postal abbreviation, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Street"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["St"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST"]}," produce the same delivered value."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["ZIP+4 add-on"]}," is resolved through the postal service address lookup where that data source is enabled and credentials are configured. The lookup needs the state, the street, and either the city or the ZIP."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The city is preserved as submitted."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"current-limitations","__idx":16},"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 postal lookup resolves the add-on, not the street line"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The lookup is used to obtain the ZIP+4. It does not rewrite your street line into the postal standard form, so an address gains its add-on and keeps the street wording it arrived with. Where you need the postal standard street line as well, that is a separate step."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The street line vocabulary is not yet fully published"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Directionals and the secondary unit designators are not yet maintained as reference data, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["North Main St"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N Main St"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N. Main St"]}," remain three different values to a comparison, and a suite written as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STE 400"]}," may not be parsed into a premise. Normalise directionals on your side before matching, never drop one since it changes which building the address names, and supply the secondary unit in its own field where you need it there."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Supply the county suffix where the county carries one"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Louisiana parishes, Alaska boroughs and census areas, and the Virginia independent cities are published with their suffix in the name, because the suffix is part of what they are called. A bare name may therefore not resolve for those. In Virginia the suffix is also the only thing distinguishing a county from a same-named independent city, so Fairfax, Franklin and Richmond need it."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A third administrative level is not delivered"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The address model carries two administrative levels, the state and the county. A civil township, which sits below the county and matters in the Midwest and in New England, has no level of its own and is not carried."]}]}]}]}]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"The postal lookup is a licensed data source"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Resolving the ZIP+4 requires the postal service data source to be enabled for your workspace and credentials to be configured. Without it, United States addresses are curated from reference data alone and keep the five digit ZIP they arrived with."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"summary","__idx":17},"children":["Summary"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A United States address is a street line built from a number, a directional, a name and a suffix, followed by a secondary unit, and closed by a line carrying the city, the two letter state code and the ZIP. The postal standard prescribes the vocabulary for the suffix and the secondary unit, and it prescribes uppercase without punctuation for presentation only."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The state is mandatory on a United States address, which sets the country apart from Germany, France and Portugal, where the top level subdivision is not written at all. The county is the element that goes the other way: it is not postal, and it is carried because tax jurisdiction is assigned by it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDQ places the state in administrative area level 1 and the county in level 2, so the county and its FIPS code travel with the address and can drive a tax jurisdiction lookup. The city goes in locality level 1, the street and its number stay in separate fields, and the suite, floor and room are typed premises."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["ZIP and ZIP+4 are one value in one field, written ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["12345-6789"]},", because the nine digits are one postal code and splitting them weakens matching. The add-on is resolved through the postal service lookup rather than requested from the business partner."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["All 57 states and territories are maintained as CDQ reference data with their postal codes and FIPS codes, together with 3,145 counties keyed by FIPS and the postal street suffix vocabulary. Directionals, the secondary unit designators and the military state codes are not yet published as reference data."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-resources","__idx":18},"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/US"},"children":["Business partner metadata for the United States"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/articles/country-standards/france-address-standard"},"children":["France Address Standard"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/articles/country-standards/germany-address-standard"},"children":["Germany 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":19},"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":"United States Address Standard","id":"united-states-address-standard","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"How a United States address is built","id":"how-a-united-states-address-is-built","depth":2},{"value":"The elements","id":"the-elements","depth":3},{"value":"The street line is four things, not one","id":"the-street-line-is-four-things-not-one","depth":3},{"value":"ZIP+4 identifies a delivery point, not an area","id":"zip4-identifies-a-delivery-point-not-an-area","depth":3},{"value":"Properties that regularly cause integration errors","id":"properties-that-regularly-cause-integration-errors","depth":3},{"value":"How CDQ models a United States address","id":"how-cdq-models-a-united-states-address","depth":2},{"value":"Why ZIP and ZIP+4 share one field","id":"why-zip-and-zip4-share-one-field","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 the United States","id":"reference-data-cdq-maintains-for-the-united-states","depth":2},{"value":"States and territories","id":"states-and-territories","depth":3},{"value":"Counties","id":"counties","depth":3},{"value":"Street suffixes","id":"street-suffixes","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":"United States Address Standard","description":"How United States addresses are structured, how CDQ models them in the CDQ address model, how ZIP and ZIP+4 are handled, and which reference data CDQ maintains for the United States."},"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/united-states-address-standard","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}