nexus
masterThe nexus list: one row per tax jurisdiction the account is registered in, hierarchical through a parent nexus, with the country, state and the tax agency filings go to.
no lastmodifieddate — full refresh. taxagency joins the VENDOR master, not an agency record of its own — tax agencies are vendors in NetSuite.
The jurisdiction axis a tax report is grouped by. Two edges ship, both page-attested: the parent hierarchy, and taxagency into vendor — tax authorities are modeled as vendors, which is what makes a payable to a tax authority an ordinary vendor balance. taxdatefromfulfillment moves the tax point date from the invoice to the fulfillment, so a jurisdiction with it set reports tax in a different period than the invoice date implies.
What the badges mean
- master
- Data class: what the record holds — master data, transaction documents, control/configuration, or a documented convenience record. NetSuite has no product-family or schema axis, so this is the whole classification.
- Subsidiary-scoped
- The record carries a
subsidiarycolumn that partitions its rows, so the generated SQL anchors it. On a few records the column is a multiselect rather than a scalar foreign key — the table notes say which (see the quirks guide). - Location-scoped
- The record carries a
locationcolumn — an org segment in NetSuite before it is a warehouse — and the generated SQL anchors it the same way. - View
- A documented convenience record rather than a stored one. Land the records it stands in for instead of assuming it extracts as-is — the table notes say where the rows actually live.
Structural facts — how the record is partitioned, not a trap by itself
Join & extract hazards — verify before you rely on this
'T'/'F' string.Fields
8 fields · 1 key
8 fields.
| # | Field | Description | Type | Flags |
|---|---|---|---|---|
| 1 | id | Internal ID | NUMBER | Primary-key field |
| 2 | country | Country (internal id) | NUMBER | |
| 3 | state | State, province or county (internal id) | NUMBER | |
| 4 | description | Description | VARCHAR | |
| 5 | parentnexus | Parent nexus (internal id) — the jurisdiction hierarchy | NUMBER | |
| 6 | taxagency | Tax agency filings go to (internal id) — a VENDOR record | NUMBER | |
| 7 | taxdatefromfulfillment | Tax point date comes from the fulfillment, not the invoice | VARCHAR | |
| 8 | isinactive | Inactive | VARCHAR |
Field provenance: hand-curated. 1 key field.
Boilerplate SQL
Starting point for reading the Connect-landed copy of nexus on Databricks — dates are real DATE/TIMESTAMP columns and need no conversion, and the partition anchors are already in place. This record carries no modification stamp, and the snippet says so where the watermark would otherwise go. Set your Unity Catalog location, schema, and filter values below; they’re substituted into the SQL and the copy button.
3 parameters not filled: <catalog>, <schema>, <id>
-- ============================================================
-- Table : nexus — The nexus list: one row per tax jurisdiction the account is registered in, hierarchical through a parent nexus, with the country, state and the tax agency filings go to.
-- Purpose: Column-selected read of nexus — auto-generated from field metadata
-- Grain : One row per id
-- Caution: no lastmodifieddate — full refresh. taxagency joins the VENDOR master, not an agency record of its own — tax agencies are vendors in NetSuite.
-- Notes : Auto-generated skeleton for NetSuite data landed in your lakehouse from a SuiteAnalytics Connect (or SuiteQL) extract — it never addresses live NetSuite. Identifiers are lowercase as NetSuite2.com renders them. Select-type columns hold numeric internal ids: BUILTIN.DF() display resolution exists only at extraction time, so decode ids by joining the landed list records; see quirks #display-values. Check-box columns arrive as 'T'/'F' strings; see quirks #tf-booleans.
-- ============================================================
SELECT
t.id AS "Internal ID",
t.country AS "Country (internal id)",
t.state AS "State, province or county (internal id)",
t.description AS "Description",
t.parentnexus AS "Parent nexus (internal id) — the jurisdiction hierarchy",
t.taxagency AS "Tax agency filings go to (internal id) — a VENDOR record",
t.taxdatefromfulfillment AS "Tax point date comes from the fulfillment, not the invoice", -- 'T'/'F' string — compare = 'T', or CAST via CASE; see quirks #tf-booleans
t.isinactive AS "Inactive" -- 'T'/'F' string — compare = 'T', or CAST via CASE; see quirks #tf-booleans
FROM <catalog>.<schema>.nexus t
WHERE
1 = 1 -- no partition column on this record; the filters below are optional
-- AND t.id = <id>
-- no lastmodifieddate on this record — there is no watermark column, so incremental extraction must full-refresh it (see quirks #deletes)
ORDER BY t.id;Verified August 2026 · Analytics Browser 2021.1 · corroborated 2025.2
Select columns hold internal ids, not display text — see decoding display values.
Relationships
Diagram of 1-hop neighbors — join details below. Document-link edges are highlighted; they chain one document to the next and are the joins newcomers most often get wrong.
Join details
- nexusnexusforeign key · N:1
ON nexus1.parentnexus = nexus2.id ON nexus.taxagency = vendor.id
More Financials tables
- salestaxitemThe tax-code list: one row per tax code a transaction line can be taxed under, pointing at the tax type that decides how the tax behaves.
- taxitemtaxgroupThe tax-item supertype: one row per tax code and tax group together, which is the surface a transaction line's tax pointer actually resolves against.
- taxtypeThe tax-type list: one row per type, carrying the behavior flags that decide how tax under it posts — whether it adds to the transaction total, whether it lands in item cost, whether it is a reverse charge, and whether it is included in the net amount.
- accountThe chart of accounts: one row per account, hierarchical through parent, with its type, currency, special-account marker and the balance NetSuite maintains on it.
- accounttypeThe account-type list: one row per type, carrying the side of the ledger it posts to, whether it belongs on the balance sheet, and the default revaluation and consolidation-rate behavior for accounts of that type.
- budgetcategoryThe budget-category list: four columns naming the categories a budget can be filed under — the original plan, a revision, a forecast — and whether a category is global.