{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["admonition","partial"]},"type":"markdown"},"seo":{"title":"Canada Address Standard","description":"How Canadian addresses are structured in English and in French, where the unit number goes, how the postal code identifies the province, how CDQ models Canadian addresses in the CDQ address model, and which reference data CDQ maintains for Canada."},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"canada-address-standard","__idx":0},"children":["Canada Address Standard"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"overview","__idx":1},"children":["Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A Canadian address has the North American shape, with a civic number, a street, a municipality and a two-letter province code, but it can be written in English or in French, and the language decides the order of the street line. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 MAIN ST"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 RUE PRINCIPALE"]}," follow the same standard. Two further habits break integrations built for the United States: a unit number written in front of the civic number with a hyphen (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123 MAIN ST"]},"), and a six-character alphanumeric postal code that identifies the province by its first letter."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This article describes the Canadian address format, how CDQ represents it in the CDQ address model, how the province and the postal code are handled, and which reference data CDQ maintains for Canada. It is the reference for anyone mapping Canadian business partner data into CDQ, or consuming curated Canadian 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 Canadian street line is built in English and in French, and where the unit and the direction go"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which administrative levels are written on an address"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["What the postal code encodes, and why it is one value"]},{"$$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":["How CDQ derives the province from the postal code"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Which reference data CDQ maintains for Canada, and where it 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/CA"},"children":["CDQ Wiki: business partner metadata for Canada"]},": browse the published Canadian metadata"]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-a-canadian-address-is-built","__idx":2},"children":["How a Canadian address is built"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Most of a Canadian address needs no special handling. What is specific to Canada is narrower, and it is where integrations actually go wrong:"]},{"$$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 Canada"},"children":["Specific to Canada"]},{"$$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":["The address can be written in English or in French"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the street type follows the name in English (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAIN ST"]},") and precedes it in French (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUE PRINCIPALE"]},"); the street name itself is never translated"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The unit can be written in front of the civic number, with a hyphen"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123 MAIN ST"]}," is unit 10 at number 123, not a number range and not house number ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The province or territory is written on every address"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["as a two-letter code on the same line as the municipality, and it is mandatory"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The postal code is alphanumeric and identifies the province"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K1A 0B1"]}," is six characters with one space, and its first letter tells the province or territory"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A direction is part of the street line"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 MAIN ST W"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 MAIN ST E"]}," are different buildings; the direction comes last, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]}," (ouest) is west in French"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Rural and postal-installation addresses have their own vocabulary"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RR 2"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PO BOX 1234 STN A"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CP 1234 SUCC CENTRE-VILLE"]}," are delivery points, not street addresses"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}," is both Canada and California"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a United States address with the state ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}," is easily read as a Canadian one, and the other way round"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-administrative-levels","__idx":3},"children":["The administrative levels"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Canada has ten provinces and three territories. They are the only administrative level written on an address."]},{"$$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":"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":["province or territory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["13 of them, each with a two-letter postal abbreviation"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes, and it is mandatory"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ontario (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ON"]},")"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["county, regional municipality, regional county municipality (MRC), census division"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["an intermediate level that exists in some provinces and not in others"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["no"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Regional Municipality of Peel"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["municipality"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["the place on the last line, written with its official name"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["yes"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Mississauga"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The intermediate level is not uniform. Ontario has counties, regional municipalities and single-tier cities; Quebec has regional county municipalities; some provinces have none at all. It is not written on an address and it is not needed to deliver mail."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-postal-address","__idx":4},"children":["The postal address"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"ACME LTD\n10-123 MAIN ST NW\nCALGARY AB  T2P 1J9\n"},"children":[]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"EXEMPLE INC\n200-1500 BOUL RENÉ-LÉVESQUE O\nMONTRÉAL QC  H3G 1T7\n"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The recipient comes first, then the street line, then the municipality, the province code and the postal code on one line. Canada Post asks for the province one space after the municipality and the postal code two spaces after the province, in uppercase, without punctuation. The country is omitted for domestic mail. Municipality and street names are written in their official form and never translated: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TROIS-RIVIÈRES"]}," does not become ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["THREE RIVERS"]},"."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-street-line","__idx":5},"children":["The street line"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The street line is the unit, the civic number, the street name and type, and the direction."]},{"$$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":"English"},"children":["English"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"French"},"children":["French"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Notes"},"children":["Notes"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["unit"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-"]}," before the number, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUITE 400"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNIT 10"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APT 5"]}," after the street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["200-"]}," before the number, or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BUREAU 200"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APP 5"]}," after the street"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["with the hyphen form, no unit word is written; the unit can also go on a line of its own above the street line"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["civic number"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123A"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 1/2"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["same"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["a letter suffix is attached, a fraction follows after one space"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["street type"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["after the name: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MAIN ST"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["before the name: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUE PRINCIPALE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOUL RENÉ-LÉVESQUE"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["in French the type follows the name when the name is an ordinal number: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["1RE AV"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["direction"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["E"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["W"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NW"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SW"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["E"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NO"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SO"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["always the last element of the street line"]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Only three street types are translated between the languages: ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ST"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AVE"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AV"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BLVD"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOUL"]},". Every other type stays in the language of the street name, which is why an English street in Quebec keeps its English type."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"the-postal-code","__idx":6},"children":["The postal code"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The postal code is six characters, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A9A 9A9"]},", written with one space and no hyphen. The first three are the forward sortation area, which identifies a region or part of a city; the last three identify a local delivery unit, often one side of a block or one building."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The letters ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["D"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["F"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["I"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Q"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["U"]}," are never used, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["W"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Z"]}," never come first. A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["0"]}," as the second character marks a rural area. The first letter identifies the province or territory:"]},{"$$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":"First letter"},"children":["First letter"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Province or territory"},"children":["Province or territory"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Newfoundland and Labrador"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["B"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["C"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["E"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nova Scotia, Prince Edward Island, New Brunswick"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["G"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["H"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["J"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quebec"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["L"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["M"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["N"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["P"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Ontario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["R"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["S"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["T"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["V"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Manitoba, Saskatchewan, Alberta, British Columbia"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Northwest Territories and Nunavut, shared"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Y"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Yukon"]}]}]}]}]},{"$$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":"Admonition","attributes":{"type":"danger","name":"The unit in front of the number is not part of the number"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123 MAIN ST"]}," is unit 10 in the building at 123 Main Street. Loaded as one house number, it becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123"]},", which no comparison will match against ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["123 MAIN ST SUITE 10"]}," although it is the same unit. Split it before loading, or supply the unit in its own field."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A postal code is one value."]}," Splitting it into its two halves, adding a hyphen, or storing it in lowercase all produce values that do not compare with the canonical ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K1A 0B1"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["The postal code and the province must agree."]}," Because the first letter identifies the province, a mismatch between the two is a sign that one of them is wrong. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["X"]}," is the exception that cannot be resolved from the letter alone, because it serves two territories."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A delivery installation is not a street address."]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PO BOX 1234 STN A"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RR 2"]}," (rural route) and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GD"]}," (general delivery) identify where mail is collected, and a building cannot be found from any of them. The station (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RPO"]},", or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCC"]}," in French) belongs to the delivery point, not to the municipality."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"warning","name":"CA is also California"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}," is the country code of Canada and the postal code of California. A record whose state field holds ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA"]}," and whose country field is empty or wrongly filled can be read as a Canadian address. Keep the country and the province or state in separate, clearly named fields, and check the postal code: a Canadian postal code starts with a letter, a ZIP code with a digit."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-cdq-models-a-canadian-address","__idx":8},"children":["How CDQ models a Canadian 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 units and floors as typed ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["premises"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Canada 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":"Canadian element"},"children":["Canadian 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":["province or territory"]},{"$$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":["municipality"]},{"$$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":["community or neighbourhood inside a municipality"]},{"$$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 type and direction"]},{"$$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":["civic number, with its suffix"]},{"$$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, bureau"]},{"$$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":["apartment"]},{"$$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":["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":["PO box, case postale"]},{"$$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":["postal 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":"p","attributes":{},"children":["The intermediate level (county, regional municipality, MRC) is not part of this standard, and CDQ publishes no second administrative level for Canada. Canada does not use the SAP house number supplement, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["HOUSE_NUM2"]},", which CDQ fills only for the Iberian and Latin American convention."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"how-cdq-determines-the-province","__idx":9},"children":["How CDQ determines the province"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The province can arrive as a name, in English or French, or as the two-letter code. CDQ standardises it against reference data and writes back the canonical name and the ISO 3166-2 code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["For Canada, CDQ also derives the province from the postal code. When the postal code is found in the reference data, the province it belongs to is the one delivered; only when the postal code is missing or not found does CDQ fall back to the province name or code you supplied. Where an address provider is enabled and resolves the province first, the provider's result is used instead."]},{"$$mdtype":"Tag","name":"Admonition","attributes":{"type":"info","name":"The postal code decides"},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A record with a postal code found in Ontario and the province ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["QC"]}," is delivered with Ontario. That is usually the correction you want, but it also means a wrong postal code moves the province with it. Check records where the delivered province differs from the one you sent."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"mapping-the-province-to-an-sap-region-key","__idx":10},"children":["Mapping the province 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."]},{"$$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 Canada the key your configuration holds is conventionally the two-letter postal abbreviation, which is also the suffix of the ISO code (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-ON"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ON"]},"), so the mapping is usually the identity. Older configurations may still hold ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NF"]}," for Newfoundland and Labrador, whose code changed to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["NL"]}," in 2002, or lack an entry for Nunavut, created in 1999. Confirm that your table has all thirteen."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"worked-example","__idx":11},"children":["Worked example"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400-100 King St W, Toronto ON  M5H 2N2"]},", 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":["CA"]}]}]},{"$$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":["Ontario"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Administrative area 1 code"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-ON"]}]}]},{"$$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":["Toronto"]}]},{"$$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":["King St W"]}]},{"$$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":["100"]}]}]},{"$$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":["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":["M5H 2N2"]}]}]}]}]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["In the SAP fields, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100"]}," is the house number, ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["400"]}," goes to street 5, King St W is the street, Toronto the city, and Ontario the region."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"reference-data-cdq-maintains-for-canada","__idx":12},"children":["Reference data CDQ maintains for Canada"]},{"$$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 Canada are on the CDQ Wiki page ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://meta.cdq.com/DataModel:CDQ/Business_Partner/Address/Country/CA"},"children":["business partner metadata for Canada"]},", which also covers legal forms, identifier types and the integrated data sources."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"provinces-and-territories","__idx":13},"children":["Provinces and territories"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["13 entries"]},", each carrying its ISO 3166-2 code, its English name, its French name where it differs, and a Chinese name."]},{"$$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":"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":["CA-QC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Quebec"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Québec"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-BC"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["British Columbia"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Colombie-Britannique"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-NL"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Newfoundland and Labrador"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Terre-Neuve-et-Labrador, Newfoundland"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-NT"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Northwest Territories"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Territoires du Nord-Ouest"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CA-NU"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nunavut"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Nunavut"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"street-types","__idx":14},"children":["Street types"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["63 entries"]}," in English and French, each with its Canada Post abbreviation. Where the two languages abbreviate a type differently, both are held."]},{"$$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":"Language"},"children":["Language"]},{"$$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":["English"]},{"$$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":["English"]},{"$$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":["Avenue"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["AV"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Boulevard"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BOUL"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Chemin"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CH"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Crescent"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["English"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CRES"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Croissant"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["French"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CROIS"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Concession"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["English"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CONC"]}]}]}]}]}]},{"$$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"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Box"]}," in English, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["Case postale"]}," (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CP"]},") in French."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"post-code-format","__idx":15},"children":["Post code format"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["A9A 9A9"]},", with the letters Canada Post does not use excluded and an optional space in the middle."]},{"$$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 English, in French, or as the two-letter code, the canonical name and the ISO code are written back. Where the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["postal code"]}," is found in the reference data, the province is derived from it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["postal code"]}," is completed with its space where it arrives without one, so ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K1A0B1"]}," becomes ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K1A 0B1"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The municipality and the levels below it are preserved as submitted. Where an address provider is enabled, it can enrich and complete them."]}]},{"$$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 formatted address writes the number after the street"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The formatted street line for Canada reads ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["King St W 100"]},", not ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["100 King St W"]},". The street and the number are separate fields in the model and in SAP, so only the single-line presentation is affected. Build the Canadian street line from the separate fields where you need it."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["A unit in front of the civic number is not recognised as a unit"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["There is no Canada-specific handling of the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["10-123"]}," form, so it can arrive as one house number. Supply the unit in its own field, or as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUITE 10"]}," after the street."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Unit, direction and delivery-installation vocabulary is not published"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUITE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["UNIT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APT"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["BUREAU"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["APP"]},", the directions, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RR"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["GD"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["STN"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RPO"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["SUCC"]}," are not yet published as reference data. A unit that arrives inside the street value may stay there, and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["W"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["O"]}," are not recognised as the same direction."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Street types written in full are not all published"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["The published list holds the types that Canada Post abbreviates. Types written in full, such as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["RUE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LANE"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WAY"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["TRAIL"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["MONTÉE"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["CÔTE"]},", are not all in it yet."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Only the missing space is corrected in a postal code"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["A postal code in lowercase or with a hyphen (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["k1a 0b1"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["K1A-0B1"]},") is kept as supplied. Supply it in uppercase with one space."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["No intermediate administrative level"]}]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Counties, regional municipalities and MRCs are not published, so they are not standardised and are carried only as supplied."]}]}]}]}]},{"$$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 Canadian address is a street line, followed by the municipality, the two-letter province code and the postal code on one line. It can be written in English or French: the street type follows the name in English and precedes it in French, the direction comes last, and the unit can be written in front of the civic number with a hyphen. The province is mandatory, and the six-character postal code identifies it by its first letter."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["CDQ places the province in administrative area level 1 and the municipality in locality level 1. The street, the number and the unit are separate fields, and the unit reaches street 5 or the room number by its type. The province is standardised from its English or French name or its code, and derived from the postal code where the postal code is found. The SAP region key is customer configuration and conventionally equals the postal abbreviation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The 13 provinces and territories and the bilingual street-type vocabulary are maintained as CDQ reference data. Units, directions and rural delivery points are where the current coverage is weakest."]},{"$$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/CA"},"children":["Business partner metadata for Canada"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/product-manuals/address-guard/country-standards/united-states-address-standard"},"children":["United States Address Standard"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"/documentation/_public/product-manuals/address-guard/country-standards/france-address-standard"},"children":["France 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":"Canada Address Standard","id":"canada-address-standard","depth":1},{"value":"Overview","id":"overview","depth":2},{"value":"How a Canadian address is built","id":"how-a-canadian-address-is-built","depth":2},{"value":"The administrative levels","id":"the-administrative-levels","depth":3},{"value":"The postal address","id":"the-postal-address","depth":3},{"value":"The street line","id":"the-street-line","depth":3},{"value":"The postal code","id":"the-postal-code","depth":3},{"value":"Properties that regularly cause integration errors","id":"properties-that-regularly-cause-integration-errors","depth":3},{"value":"How CDQ models a Canadian address","id":"how-cdq-models-a-canadian-address","depth":2},{"value":"How CDQ determines the province","id":"how-cdq-determines-the-province","depth":3},{"value":"Mapping the province to an SAP region key","id":"mapping-the-province-to-an-sap-region-key","depth":3},{"value":"Worked example","id":"worked-example","depth":3},{"value":"Reference data CDQ maintains for Canada","id":"reference-data-cdq-maintains-for-canada","depth":2},{"value":"Provinces and territories","id":"provinces-and-territories","depth":3},{"value":"Street types","id":"street-types","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":"Canada Address Standard","description":"How Canadian addresses are structured in English and in French, where the unit number goes, how the postal code identifies the province, how CDQ models Canadian addresses in the CDQ address model, and which reference data CDQ maintains for Canada."},"toc":{"enable":true},"cdqContentMetadata":{"product":"Address Guard","lastUpdate":"2026-10-29T00:00:00.000Z","author":"Product Management","reviewer":"X-Team TechDocs"}},"lastModified":"2026-10-30T12:09:53.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/documentation/_public/product-manuals/address-guard/country-standards/canada-address-standard","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}