HZ_PARTIES
Product: HZmasterThe 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
Global — no BU, org, or set striping anywhere in the TCA party layer. PARTY_TYPE is Person/Organization/Group. The address and contact columns here are denormalized copies of the identifying address — the real address spine is party site → location. Suppliers resolve here too: the supplier master's PARTY_ID is where the supplier name lives (see quirks #tca-layers).
What the badges mean
- master
- Data class: what the table holds — master data, transaction documents, control/configuration, interface/staging, or a documented view.
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.PartyExtractPVOOTBI: Sales - CRM Customers and Contacts Real Time
Party data store — keyed on PartyId. Lives in the CX extract book under the CrmAnalyticsAM root (TCA is a CX-owned product family in Fusion).
Oracle data-store documentation →
Fields
15 fields · 1 key
| # | Field | Description | Type | Flags |
|---|---|---|---|---|
| 1 | PARTY_ID | Surrogate key of the party — what customers, suppliers, and sites all resolve to | NUMBER | Key |
| 2 | PARTY_NUMBER | The party's unique number | VARCHAR2 | |
| 3 | PARTY_NAME | The party's name — the customer or supplier display name reports actually want | VARCHAR2 | |
| 4 | PARTY_TYPE | Person, Organization, or Group | VARCHAR2 | |
| 5 | STATUS | Party status flag — values not enumerated in the dictionary | VARCHAR2 | |
| 6 | CATEGORY_CODE | User-defined party category | VARCHAR2 | CUSTOMER_CATEGORY |
| 7 | DUNS_NUMBER_C | D&B DUNS number — stored as text, not validated to nine digits | VARCHAR2 | |
| 8 | JGZZ_FISCAL_CODE | Tax / fiscal registration identifier | VARCHAR2 | |
| 9 | EMAIL_ADDRESS | Primary email — a denormalized copy of the contact point | VARCHAR2 | |
| 10 | PRIMARY_PHONE_NUMBER | Primary phone in local format — no country or area code | VARCHAR2 | |
| 11 | ADDRESS1 | First line of the denormalized identifying address | VARCHAR2 | |
| 12 | CITY | City of the identifying address | VARCHAR2 | |
| 13 | COUNTRY | Country of the identifying address (territory code) | VARCHAR2 | |
| 14 | VALIDATED_FLAG | Whether the party has been validated | VARCHAR2 | |
| 15 | ORIG_SYSTEM_REFERENCE | Legacy-system key the party was migrated under | VARCHAR2 |
Field provenance: hand-curated. 1 key field.
Boilerplate SQL
Starting point for reading the BICC-landed copy of HZ_PARTIESon 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.
-- ============================================================
-- Table : HZ_PARTIES — The 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
-- Purpose: Column-selected read of HZ_PARTIES — auto-generated from field metadata
-- Grain : One row per PARTY_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.PARTY_ID AS "Surrogate key of the party — what customers, suppliers, and sites all resolve to",
t.PARTY_NUMBER AS "The party's unique number",
t.PARTY_NAME AS "The party's name — the customer or supplier display name reports actually want",
t.PARTY_TYPE AS "Person, Organization, or Group",
t.STATUS AS "Party status flag — values not enumerated in the dictionary",
t.CATEGORY_CODE AS "User-defined party category", -- decode t.CATEGORY_CODE via FND_LOOKUP_VALUES (LOOKUP_TYPE = 'CUSTOMER_CATEGORY', LANGUAGE-filtered)
t.DUNS_NUMBER_C AS "D&B DUNS number — stored as text, not validated to nine digits",
t.JGZZ_FISCAL_CODE AS "Tax / fiscal registration identifier",
t.EMAIL_ADDRESS AS "Primary email — a denormalized copy of the contact point",
t.PRIMARY_PHONE_NUMBER AS "Primary phone in local format — no country or area code",
t.ADDRESS1 AS "First line of the denormalized identifying address",
t.CITY AS "City of the identifying address",
t.COUNTRY AS "Country of the identifying address (territory code)",
t.VALIDATED_FLAG AS "Whether the party has been validated",
t.ORIG_SYSTEM_REFERENCE AS "Legacy-system key the party was migrated under"
FROM <catalog>.<schema>.HZ_PARTIES t
WHERE
1 = 1 -- no partition column on this table; the filters below are optional
-- AND t.PARTY_ID = <PARTY_ID>
-- AND t.LAST_UPDATE_DATE >= TIMESTAMP '<watermark>' -- the column incremental BICC extracts key on
ORDER BY t.PARTY_ID;4 parameters not filled: <catalog>, <schema>, <PARTY_ID>, <watermark>
Relationships
1-hop neighbors — click a table to navigate there. FND lookup decode and translation edges are highlighted; they’re the joins newcomers most often get wrong.
Join details
ON HZ_CUST_ACCOUNTS.PARTY_ID = HZ_PARTIES.PARTY_IDON HZ_CUST_ACCOUNTS.SELLING_PARTY_ID = HZ_PARTIES.PARTY_IDON HZ_PARTY_SITES.PARTY_ID = HZ_PARTIES.PARTY_IDON POZ_SUPPLIERS.PARTY_ID = HZ_PARTIES.PARTY_IDON AP_INVOICES_ALL.PARTY_ID = HZ_PARTIES.PARTY_ID