HZ_LOCATIONS
Product: HZmasterThe location master — the physical postal address itself (street, city, postal code, country, coordinates), shared by every party and account site that points at it
One address, stored once — dedupe-friendly by design; parties reach it only through party sites. COUNTRY is required (FND territory code). TIMEZONE_CODE records the address time zone. VALIDATED_FLAG and VALIDATION_STATUS_CODE carry address-validation state.
What the badges mean
- Product: EGP
- Product: the Oracle product family that owns the object — the short code Oracle's Tables and Views documentation lists as the object owner. Fusion is SaaS, so this isn't a database schema; there's no SQL path to the tables at all (see the quirks guide).
- master
- Data class: what the table holds — master data, transaction documents, control/configuration, interface/staging, or a documented view.
- BU-striped (ORG_ID)
- Rows are scoped to a business unit. The column is still named
ORG_ID, but in Fusion it means business unit, not the EBS operating unit — treat any migrated “operating unit” filter as suspect (see the quirks guide). - Per inventory org
- Rows are scoped to an inventory organization via
ORGANIZATION_ID— always pair it withINVENTORY_ITEM_IDon item-level joins (see the quirks guide). - Set / ledger / named-BU striped
- Some tables stripe by a named column instead of
ORG_ID: reference data set (SET_ID— see the quirks guide), ledger (LEDGER_IDon the GL journal tables), or a named business-unit column (PRC_BU_ID/REQ_BU_IDin procurement). The table page’s partition line names the column, and the generated SQL anchors on it — never treat these tables as unpartitioned. - Language-striped
- The table carries a
LANGUAGEcolumn (a _TL translation table or FND_LOOKUP_VALUES) — one row per language. Filter to oneLANGUAGEor a join multiplies rows. - Date-effective
- This is an
_Ftable — one row per entity per effectivity window, withEFFECTIVE_START_DATEandEFFECTIVE_END_DATEpart of the key. Join without a window filter and every fact multiplies by history (see the quirks guide). - View
- This is a documented convenience view, not a physical table. Extract through the BICC data store that fronts its base objects instead of assuming the view lands as-is.
Structural facts — how the table is partitioned, not a trap by itself
Join & extract hazards — verify before you rely on this
Extract access
The delivered surfaces that reach this table — the BICC extract data store (PVO) for bulk extraction and the OTBI subject areas for real-time queries. There is no SQL path to the SaaS database.
- CrmAnalyticsAM.CrmExtractAM.HzBiccExtractAM.LocationExtractPVO
Location data store — keyed on LocationId. No dedicated subject area — the address fields ride the customer subject areas as dimensions.
Oracle data-store documentation (opens in new tab)
Fields
13 fields · 1 key
13 fields.
| # | Field | Description | Type | Flags |
|---|---|---|---|---|
| 1 | LOCATION_ID | Surrogate key of the address | NUMBER | Key |
| 2 | ADDRESS1 | Address line 1 | VARCHAR2 | |
| 3 | ADDRESS2 | Address line 2 | VARCHAR2 | |
| 4 | CITY | City | VARCHAR2 | |
| 5 | STATE | State | VARCHAR2 | |
| 6 | POSTAL_CODE | Postal code | VARCHAR2 | |
| 7 | COUNTRY | Country territory code — required | VARCHAR2 | |
| 8 | LATITUDE | Latitude for proximity analysis | NUMBER | |
| 9 | LONGITUDE | Longitude for proximity analysis | NUMBER | |
| 10 | TIMEZONE_CODE | Time zone code for the address | VARCHAR2 | |
| 11 | VALIDATED_FLAG | Whether the address passed validation | VARCHAR2 | |
| 12 | VALIDATION_STATUS_CODE | Standardized address-validation result | VARCHAR2 | |
| 13 | ORIG_SYSTEM_REFERENCE | Legacy-system address key — required | VARCHAR2 |
Field provenance: hand-curated. 1 key field.
Boilerplate SQL
Starting point for reading the BICC-landed copy of HZ_LOCATIONS on Databricks — real DATE columns need no conversion, and the org anchor and the LAST_UPDATE_DATE watermark (the column incremental BICC extracts key on) are already in place. Set your Unity Catalog location, schema, and org values below; they’re substituted into the SQL and the copy button.
4 parameters not filled: <catalog>, <schema>, <LOCATION_ID>, <watermark>
-- ============================================================
-- Table : HZ_LOCATIONS — The location master — the physical postal address itself (street, city, postal code, country, coordinates), shared by every party and account site that points at it
-- Purpose: Column-selected read of HZ_LOCATIONS — auto-generated from field metadata
-- Grain : One row per LOCATION_ID
-- Notes : Auto-generated skeleton for Oracle Fusion Cloud data landed in your lakehouse by a BICC extract — there is no SQL path to the SaaS database. Column names follow Oracle's table documentation — if your landed data still carries PVO attribute headers, map names first; see quirks #pvo-drift. Dates are real DATE/TIMESTAMP columns — no conversion needed. WHO audit columns omitted (see the quirks guide); the optional LAST_UPDATE_DATE watermark filter supports incremental extracts.
-- ============================================================
SELECT
t.LOCATION_ID AS "Surrogate key of the address",
t.ADDRESS1 AS "Address line 1",
t.ADDRESS2 AS "Address line 2",
t.CITY AS "City",
t.STATE AS "State",
t.POSTAL_CODE AS "Postal code",
t.COUNTRY AS "Country territory code — required",
t.LATITUDE AS "Latitude for proximity analysis",
t.LONGITUDE AS "Longitude for proximity analysis",
t.TIMEZONE_CODE AS "Time zone code for the address",
t.VALIDATED_FLAG AS "Whether the address passed validation",
t.VALIDATION_STATUS_CODE AS "Standardized address-validation result",
t.ORIG_SYSTEM_REFERENCE AS "Legacy-system address key — required"
FROM <catalog>.<schema>.HZ_LOCATIONS t
WHERE
1 = 1 -- no automatic partition anchor on this table; the filters below are optional
-- AND t.LOCATION_ID = <LOCATION_ID>
-- AND t.LAST_UPDATE_DATE >= TIMESTAMP '<watermark>' -- the column incremental BICC extracts key on
ORDER BY t.LOCATION_ID;Verified September 2026 · docs release 26C
Column names differ in BICC extracts — see PVO header drift.
Relationships
Diagram of 1-hop neighbors — join details below. FND lookup decode and translation edges are highlighted; they’re the joins newcomers most often get wrong.
Join details
ON HZ_PARTY_SITES.LOCATION_ID = HZ_LOCATIONS.LOCATION_ID
More Customers (TCA) tables
- HZ_PARTIESThe party master — one row per person, organization, or group in the trading community, with the party number, type, status, and a denormalized identifying address and primary contact point; the top of the four-layer customer model
- HZ_PARTY_SITESParty sites — the link between a party and a location, carrying the site number, name, addressee, and mailstop; one party can have many sites and one location can serve many parties
- HZ_CUST_ACCOUNTSThe customer account — the commercial (selling) relationship layered on a party; one party can carry several accounts, each with its own account number, status, and type
- HZ_CUST_ACCT_SITES_ALLCustomer account sites — an account's use of a party site (address); the layer order and invoice addresses hang off, with bill-to/ship-to/market purpose flags
- HZ_CUST_SITE_USES_ALLSite uses — the business purposes (bill-to, ship-to, statements) assigned to each customer account site; the bottom TCA layer, and the id AR transactions actually point at