Skip to content
Fusion Reference

HZ_LOCATIONS

Product: HZmaster

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

Identity
Module: Customers (TCA)Not org-partitioned
Notes

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.

Structural facts — how the table is partitioned, not a trap by itself

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 with INVENTORY_ITEM_ID on 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_ID on the GL journal tables), or a named business-unit column (PRC_BU_ID / REQ_BU_ID in 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 LANGUAGE column (a _TL translation table or FND_LOOKUP_VALUES) — one row per language. Filter to one LANGUAGE or a join multiplies rows.

Join & extract hazards — verify before you rely on this

Date-effective
This is an _F table — one row per entity per effectivity window, with EFFECTIVE_START_DATE and EFFECTIVE_END_DATE part 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.
In field listings, the Key chip marks a key field — a member of the documented primary key or of a documented unique index.

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.

Fields

13 fields · 1 key

13 fields.

Table fields: position, field name, description, data type, and flags. 13 fields.
#FieldDescriptionTypeFlags
1LOCATION_IDSurrogate key of the addressNUMBER
Key
2ADDRESS1Address line 1VARCHAR2
3ADDRESS2Address line 2VARCHAR2
4CITYCityVARCHAR2
5STATEStateVARCHAR2
6POSTAL_CODEPostal codeVARCHAR2
7COUNTRYCountry territory code — requiredVARCHAR2
8LATITUDELatitude for proximity analysisNUMBER
9LONGITUDELongitude for proximity analysisNUMBER
10TIMEZONE_CODETime zone code for the addressVARCHAR2
11VALIDATED_FLAGWhether the address passed validationVARCHAR2
12VALIDATION_STATUS_CODEStandardized address-validation resultVARCHAR2
13ORIG_SYSTEM_REFERENCELegacy-system address key — requiredVARCHAR2

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.

Query parameters

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

  • HZ_PARTY_SITESHZ_LOCATIONSforeign key · N:1
    ON HZ_PARTY_SITES.LOCATION_ID = HZ_LOCATIONS.LOCATION_ID

Browse more Customers (TCA) tables

More Customers (TCA) tables

Maintained by Summit Analytics, a supply chain analytics practice. The tools and references are free — the consulting is selective.

Part of the Summit Analytics reference library.

Work with the practice

Not affiliated with or endorsed by Oracle. Oracle and Oracle Fusion Cloud Applications are registered trademarks of Oracle and/or its affiliates.