Skip to content
Integration playbook

Entity Management for NetSuite: the master-data architecture guide

NetSuite OneWorld uses subsidiaries to represent a hierarchy of companies in the financial system. EntityOS can serve as the governed legal-entity layer around identity, ownership, governance and evidence, then exchange approved data with ERP processes where an integration is configured.

Legal · Finance · Operations

Entiti · Integration playbookReviewed September 2, 2026 · This is an architecture playbook, not a claim that a prebuilt NetSuite connector is currently available.

Entiti × NetSuite

Proposed architecture · Connector unverified

Illustrative

Agree who owns each field.

  • EntitiLegal context · Identity · Governance · Evidence
  • Stable ID + approved fieldsValidate · Exchange · Reconcile
  • NetSuiteFinance context · Subsidiaries · ERP configuration

Oracle describes OneWorld subsidiaries as a hierarchy of legal entities. Financial hierarchy and legal ownership need explicit mapping.

System fit

Use each system for its agreed responsibility.

Oracle documents OneWorld subsidiaries as a hierarchy of separate legal entities. A legal-entity record can add governance, source evidence and history around the Finance context.

  • Do not assume the ERP hierarchy fully describes legal ownership.
  • Map stable entity identifiers to the correct NetSuite subsidiary references.
  • Agree the owner of every shared field with Legal and Finance.
Identifier mapping
Illustrative · Sources retained

A stable link between systems

Legal entity
Ashcombe Holdings Ltd
Entiti reference
ENT-001 · illustrative
NetSuite reference
Subsidiary 17 · illustrative
Mapping owner
Finance systems
Review status
Approved sample mapping
History
Preserve mapping changes

These references illustrate a mapping; they are not production identifiers.

Data contract

Define the rule before exchanging data.

For each field, document the source owner, receiving system, validation, effective-date behavior and what happens when values disagree.

  • Legal names and registration numbers require an approved legal basis.
  • Financial configuration stays under the agreed Finance authority.
  • Conflicts go to a named owner rather than whichever system wrote last.
Field-level data contract
Proposed mapping · Validate during implementation

Approved legal context

Approved legal context
FieldSource ownerControl
Legal nameLegal / approved recordReview before publishing
Registration numberLegal / approved recordValidate identifier
Ownership contextGovernance sourceAgree financial interpretation

Change handling

Design for the update that fails.

A legal change can be approved while the ERP update is still incomplete. Retain the old and proposed values, route errors and verify the target state before closing the work.

  • Use an idempotent operation so a retry does not duplicate the change.
  • Keep failures and partial outcomes visible to a responsible owner.
  • Reconcile missing mappings and changed values at an agreed interval.
Change-event handling
Legal name change · sample

Legal approval

Responsible team
Legal
Keep with the record
Approved change and effective date

Implementation planning

Start with a small, testable contract.

Use one representative group of subsidiaries and a limited field set. Prove ownership, error handling and reconciliation before extending the integration.

Implementation checklistThis session

Source basis

Keep the source with the decision.

Use the current official information and preserve the review date with any regulatory, product or implementation conclusion.

Architecture guidance. Native connector availability and exact API contracts must be confirmed before implementation.

Questions

The things teams ask first.

Answered plainly, including where the next step depends on local requirements, evidence or review.