Your NetSuite Account, Not the Partner, Decides Which AI Ships
- Oracle documents four conditions that determine whether a generative AI feature works in a NetSuite account: whether Oracle Cloud Infrastructure Generative AI is set up for NetSuite in your region, which languages the underlying models support, your company’s account settings, and your user role and permissions. No partner controls any of the four.
- The gates are uneven per feature. Intelligent Bill Capture is US data centers only, English only, and Oracle states it is “currently only available to a limited number of accounts”. The NetSuite CPQ AI Assistant is available only in non-production accounts — sandbox and Release Preview.
- Every
llm.generateTextcall costs 100 governance units. A user event script’s 1,000-unit budget therefore holds at most 10 calls, a RESTlet’s 5,000-unit budget holds 50, before any record read or write is counted. - The same call is metered four separate ways — script governance units, NetSuite AI Units, a free monthly N/llm usage pool, and direct Oracle Cloud spend once that pool is exhausted. Oracle documents each meter on a different page, and none of the four pages reconciles against the others.
- The AI Connector Service cannot run under the Administrator role, by design. Oracle states MCP tools “are never executed with Administrator or roles that have full permissions”, and that by default no users have access at all.
llm.generateText call (Oracle SuiteScript API reference)The advisory pitch is real: routine order-and-inventory sync work has standardised, and buyers are asking implementation teams to scope AI automation instead. What almost every version of that pitch leaves out is that the binding constraints on a NetSuite AI project are set at the account level, not the skill level. Region, language, account type, role permission, and a metered usage pool decide what can run at all — and a partner cannot buy, learn, or certify past any of them.
That changes the due-diligence question. “Do you have AI expertise?” is unfalsifiable. “Which of these five gates is open in my account, and did you check before quoting?” is answerable in the NetSuite UI in about ten minutes. This post specifies the gates, the governance arithmetic underneath them, and the checks to run before signing a scope. Facts verified against Oracle’s documentation in August 2026; NetSuite rolls out in phases, so confirm against your own account’s Release Portlet.
Contents
- The four conditions Oracle actually gates on
- Which AI features are available where
- Two features that cannot be scoped like the rest
- A signed BAA removes features from the table
- One LLM call costs 100 governance units
- Four meters run on one LLM call
- The MCP connector forbids the admin-role pattern
- Oracle names prompt injection and hallucination as its own risks
- NetSuite pins a legacy MCP revision
- What to make a partner prove
- Where this framework does not apply
The four conditions Oracle actually gates on
Oracle’s Generative AI Feature Availability page lists four factors that decide whether a generative AI feature is available in an account: whether the Oracle Cloud Infrastructure Generative AI service is set up for NetSuite in your region, what languages the large language models can support, your company’s account settings, and your user role and permissions.
Read that list as a sequence of gates rather than a set of caveats. A feature must clear all four before a single prompt runs, and the first two are decisions Oracle made about your data centre — no configuration work reaches them. The third is an administrator setting inside the account. Only the fourth is routine implementation work.
The practical consequence is that a scope document written before anyone opened the AI Preferences page in the customer’s own account is a guess. The gate cascade below is the order in which a request fails.
The diagram states the conclusion the rest of this post specifies: three of the four gates are outside the project, and the one inside it is the cheapest part of the work.
Which AI features are available where
Availability differs per feature, and the differences are large enough to change a scope. Oracle publishes the per-feature breakdown; the table below condenses the rows that most often appear in an implementation plan, as documented in August 2026.
| Feature | Region | Language | Account type |
|---|---|---|---|
| Text Enhance, Prompt Studio, N/llm module, Task Prioritization | 14 listed regions, including the US, UK, EU, Canada, Australia, Japan and Singapore; UAE via Amsterdam and Frankfurt data centres only | All system-supported NetSuite languages | No stated restriction |
| Narrative Insights | Everywhere | All system-supported NetSuite languages | Not available to healthcare customers with a signed BAA |
| Intelligent Bill Capture | United States only | English only | “a limited number of accounts that are hosted in US data centers” |
| NetSuite CPQ AI Assistant | 13 listed regions | English only | Non-production only — sandbox and Release Preview |
| NetSuite Expert in SuiteAnswers, SuiteCloud Developer Assistant Guide | Everywhere | All system-supported NetSuite languages | No stated restriction |
Verdict: treat Text Enhance, Prompt Studio and the N/llm module as the dependable base for a scope in a supported region, and treat everything else as conditional until the account is checked. A proposal that lists Bill Capture for a UK account, or CPQ AI for production, is describing a feature the account cannot run.
Two features that cannot be scoped like the rest
Two NetSuite AI features break the normal assumption that a documented feature can be delivered to any paying customer who wants it.
Intelligent Bill Capture is the more commonly mis-scoped of the pair. Oracle restricts it to the United States, to English, and — in its own words — to “a limited number of accounts that are hosted in US data centers”. Being a US customer on a US data centre is necessary but not sufficient; the account also has to be inside the rollout. Accounts-payable automation is one of the most common AI justifications in an ERP business case, which is precisely why this row deserves a direct check rather than an assumption.
The NetSuite CPQ AI Assistant is the sharper case. Oracle states it “is only available in non-production accounts, including sandbox and Release Preview accounts.” A pilot can be demonstrated; a production rollout cannot be committed to a date. Any plan that treats the sandbox demo as the first phase of a production deployment has an unbounded dependency on Oracle’s roadmap sitting in the middle of it.
A signed BAA removes features from the table
Healthcare customers operating under a signed Business Associate Agreement lose access to specific AI features outright. Oracle states that Narrative Insights “can’t be activated for healthcare customers with a signed Business Associate Agreement (BAA)” and that it “has not yet been assessed for compliance with the US Health Insurance Portability and Accountability Act (HIPAA)”. The AI Prioritized button in Intelligent Close Manager carries the same exclusion for the same reason.
The AI Connector Service carries a parallel warning in its own documentation: Oracle notes it “has not been assessed for compliance with the U.S. Health Insurance Portability and Accountability Act (HIPAA)”. That is not the same statement as a prohibition, and it should not be reported as one — but it is the sentence a regulated buyer’s compliance function will want to see before an external AI client is pointed at ERP data.
This gate is invisible in every capability-led AI pitch, because it is a property of the customer’s contract rather than of the software. It is also the gate that most reliably kills a project after the statement of work is signed.
One LLM call costs 100 governance units
Oracle’s SuiteScript reference puts the governance cost of llm.generateText(options) at 100 units. Set that against the per-script-type unit budgets Oracle documents for SuiteScript, and the ceiling on any in-script AI automation follows arithmetically.
| Script type | Unit budget | Ceiling on generateText calls | Realistic ceiling with record I/O |
|---|---|---|---|
| User event, Suitelet, client, workflow action | 1,000 | 10 | 9 after one transaction load and save |
| RESTlet | 5,000 | 50 | Fewer, in proportion to records touched |
| Scheduled | 10,000 | 100 | Fewer, in proportion to records touched |
| Map/reduce | Per-function invocation budget | Bounded per key, not per job | The only shape that scales past a few hundred records |
Verdict: any AI automation that must touch more than a few hundred records is a map/reduce job, not a user event script — and that is a design decision, not a tuning exercise. A transaction record.load costs 10 units and a record.save costs 20, so the realistic column is always lower than the arithmetic one. Teams that hit the wall here see SSS_USAGE_LIMIT_EXCEEDED mid-batch with partial work already committed, the same failure mode covered in our guide to calling AI APIs from SuiteScript.
Four meters run on one LLM call
A single llm.generateText call is metered four separate ways in NetSuite. Oracle documents each meter on a different help page, and no one of those pages reconciles its meter against the other three. Anyone costing an AI automation needs all four, because they fail differently: one kills a script, one bills the customer, one silently switches billing mode, and one throttles throughput.
| Meter | Unit | Where to read it | What happens at the limit |
|---|---|---|---|
| Script governance | 100 units per generateText call |
Script type budget (1,000 / 5,000 / 10,000) | Script terminates; partial work already committed |
| NetSuite AI Units | “from 5-25 AI Units” per N/llm request | Setup > Company > View Billing Information |
Commercial pool; Oracle labels the figures estimates |
| Free N/llm usage pool | Count of free uses per month | Setup > Company > AI > AI Preferences, SuiteScript subtab |
Refreshes monthly; value is account-specific and unpublished |
| Oracle Cloud spend | OCI Generative AI service charges | The customer’s own Oracle Cloud account | Applies once OCI credentials switch the feature to unlimited usage mode |
Verdict: cost an AI automation against the AI Units meter and the free pool together, then check the governance ceiling separately as a design constraint rather than a cost. Oracle publishes consumption ranges for AI Units per feature — Narrative Insights at 5–200 units, a research-style Ask Oracle question at 50–200 — and states plainly that the displayed values “are only estimates”.
The free pool’s size is the one number Oracle does not print. It defines the field — “Number of free uses of the SuiteScript modules that use AI that are available for the account each month” — and then tells you where to read your own value. That page is the single most useful ten seconds of due diligence available on an AI scope, and it is account-specific by design.
Past the free pool the model changes rather than stopping: configuring OCI credentials switches a feature from the free, limited mode to unlimited usage mode through the customer’s own Oracle Cloud account, and the customer then pays OCI directly for what it consumes. The AI bill then arrives on a different invoice from the ERP subscription, which is the line item most often missing from a business case. Throughput has its own ceiling on top of all four meters — five concurrent calls to N/llm generate methods, five to embed — and that cap is separate again from the account concurrency pool governing inbound integration traffic, a distinction covered in our guide to NetSuite concurrency governance.
The MCP connector forbids the admin-role pattern
The NetSuite AI Connector Service, Oracle’s Model Context Protocol server for NetSuite, inverts the permission habit most integration work is built on. Oracle states that “by default, no users have access” and that “MCP permission must be explicitly granted to a role”. More strictly: MCP tools “are never executed with Administrator or roles that have full permissions to access NetSuite features”, and Oracle documents that it is “not possible to run the NetSuite AI Connector Service if you’ve logged in to NetSuite with the Administrator role”.
The standard shortcut — provision an integration under a high-privilege role and narrow it later — is therefore not available. Oracle also constrains what the tools can reach: “Run as role” is disabled for all tools, tools cannot invoke scripts that run with elevated privileges, cannot invoke Suitelets, and cannot perform HTTP requests to external destinations. All MCP tool usage is logged.
Setup is correspondingly specific. The Server SuiteScript and OAUTH 2.0 features must be enabled under Setup > Company > Enable Features, on the SuiteCloud subtab. The MCP Server Connection and “Log in using OAuth 2.0 Access Tokens” permissions must be granted per role under Setup > Users/Roles > Manage Roles. Using the MCP Standard Tools SuiteApp to read or write records adds the REST Web Services feature and permission. Oracle prices the service itself at zero: the connector “is not a paid feature and the MCP Standard Tools is a free SuiteApp”, though the AI client on the other end may carry its own subscription.
Oracle names prompt injection and hallucination as its own risks
Oracle publishes a risks-and-controls page for the AI Connector Service, and it names two risks directly: prompt injection, which it defines as a malicious actor embedding “hidden instructions within content that is processed by the LLM”, and hallucination, where the model “generates information that appears accurate but is in fact incorrect or entirely fabricated”.
The consequences Oracle lists are the ones a finance function will care about. An AI agent may run “powerful MCP tool functions — such as making payments or granting approvals — without the user’s explicit intent”; may delete or modify data unintentionally; and may disclose sensitive NetSuite data to unauthorised parties. Oracle’s own mitigations are conservative: grant MCP permission only to users who need it, create separate roles per tool set, start new agents with limited scope, prefer clients that confirm before high-impact actions, and review permissions regularly.
This page is the most useful artefact in the whole set for evaluating a partner, because it is a governance checklist written by the vendor rather than by the seller. A team proposing AI automation inside NetSuite should be able to walk through it unprompted and say which control it is relying on for each named risk.
NetSuite pins a legacy MCP revision
Oracle states that the AI Connector Service works with clients supporting “the 2025-06-18 protocol version”, OAuth 2.0 Authorization Code Grant with PKCE, and streamable HTTP. The Model Context Protocol specification’s own versioning page lists the current revision as 2026-07-28, and classes the handshake-based revisions — 2025-11-25 and earlier — as a separate era requiring backward-compatibility handling.
NetSuite’s pin therefore sits behind the current specification, which works in practice because major AI clients support multiple revisions simultaneously, as the spec explicitly permits. It is not a defect. It is a version-compatibility fact that belongs in any integration design that assumes current-spec behaviour such as the mandatory server/discover call, and the background is covered in our explainer on what MCP is and what the 2026 spec changed.
Two operational details travel with it. Execution logs are retained for 21 days in production and 7 days in sandbox, which caps how far back an incident can be reconstructed. And the connector’s traffic draws on the same concurrency limits shared with other integrations — an AI client is another consumer of a pool that was already sized for the sync workload.
What to make a partner prove
Every item below is checkable in the customer’s own NetSuite account or in Oracle’s documentation, and none of them requires trusting a capability claim. Work down the list before signing an AI scope.
- Open
Setup > Company > AI > AI Preferences, SuiteScript subtab, and record the account’s actual monthly free usage limit and current usage. - Confirm the account’s data centre region appears in Oracle’s availability list for each specific feature in the scope, not for “NetSuite AI” generally.
- Confirm the account language is supported for each feature; treat Intelligent Bill Capture and CPQ AI Assistant as English-only.
- For any Bill Capture line item, confirm the account is inside the limited US rollout rather than merely US-hosted.
- Remove any CPQ AI Assistant production commitment, or convert it to a sandbox pilot with no production date.
- If a BAA is in place, strike Narrative Insights and Intelligent Close Manager task prioritisation from the scope.
- Ask which script type each AI automation will run in, and check the call count against the 100-unit ceiling for that type.
- Open
Setup > Company > View Billing Informationand record the account’s current NetSuite AI Units consumption before estimating a new workload against it. - Decide before build whether the workload stays inside the free usage pool or requires an Oracle Cloud account, and put the OCI cost in the business case as a separate line.
- Require a named, least-privilege role for MCP rather than an Administrator role, and confirm the partner knows an Administrator role cannot be used.
- Walk Oracle’s risks-and-controls page with the partner and get a stated control for prompt injection and for hallucination.
- Set a log-retention expectation against the documented 21-day production window before it is needed for an incident.
Get the working checklists
The runbooks and decision checklists from these guides, as printable PDFs — free in the SoftXone guide library.
Where this framework does not apply
The gate model above governs NetSuite’s own generative AI surfaces. It does not govern AI systems that sit outside NetSuite and reach it through ordinary integration channels — a service that reads orders over REST web services, sends them to a model provider directly, and writes results back is bound by API concurrency and authentication rules, not by the AI Preferences page. That architecture avoids every regional and account-type gate in this post, at the cost of owning the model contract, the data-handling posture, and the spend directly.
The framework also says nothing about whether a given automation is worth building. Feature availability is a floor, not a business case: an account can clear all four gates and still have no workflow where generative output is accurate enough to remove a human review step. Judging that is genuinely advisory work, and it is the part of the shift toward AI advisory that holds up.
What does not hold up is treating AI capability as a partner attribute when the binding constraints are account attributes. The five checks above cost an hour. They are the difference between a scope that survives contact with the account and one that gets rewritten after signature.
Planning AI automation on top of a WooCommerce or Shopify to NetSuite integration is largely a question of where the data already flows reliably. Our AI for commerce teams guide hub collects the related guides, and our NetSuite Integration Pro service covers the sync layer that AI workflows read from.
References
- Generative AI Feature Availability in NetSuiteOracle — the four availability factors and the per-feature region, language and account-type table.
- llm.generateText(options)Oracle — the 100-unit governance cost, error identifiers, and OCI configuration parameters.
- Usage Limits and Concurrency Limits for N/llm MethodsOracle — the free monthly usage pool and the five-concurrent-call limit.
- View SuiteScript AI Usage Limit and UsageOracle — where the account’s own usage limit is displayed, and the definition of the field.
- NetSuite AI Units and NetSuite FeaturesOracle — per-feature AI Unit consumption ranges, the billing page where usage is visible, and the estimates caveat.
- AI Connector Service: Associated Risks, Controls, and Mitigation StrategiesOracle — prompt injection and hallucination named as risks, plus the permission and scoping controls.
- AI Connector Service: Required Features and PermissionsOracle — Server SuiteScript, OAUTH 2.0, MCP Server Connection, and the Administrator-role restriction.
- NetSuite AI Connector Service FAQOracle — pricing, the required 2025-06-18 MCP revision, and log retention windows.
- Prompt StudioOracle — custom Text Enhance actions and the Setup Prompts (ADMI_PROMPTS) permission.
- Model Context Protocol — VersioningMCP specification — current revision 2026-07-28 and the handling of earlier handshake-based revisions.
Frequently asked questions
Can a partner enable NetSuite AI features Oracle has not released in my region?
No. Oracle lists region as one of four factors deciding generative AI availability, and it turns on whether the Oracle Cloud Infrastructure Generative AI service is set up for NetSuite in that region. No setting inside the account changes it. The only route around a regional gate is architectural rather than administrative: an external service can call a model provider directly and write results back through REST web services. That sidesteps the gate but moves the model contract, the data-handling posture and the spend onto the customer.
Why can the AI Connector Service not run under an Administrator role?
Oracle blocks it deliberately. MCP tools execute with the permissions of the connected user, and Oracle states they are never executed with Administrator roles or roles holding full permissions. The reasoning sits on its own risks page: a prompt-injection attack against the AI client would otherwise inherit unrestricted access to the account. Grant a purpose-built least-privilege role instead, and create separate roles for different tool sets so one compromised client cannot reach every record type.
How do I find out how many NetSuite AI Units my account has left?
Read them at Setup > Company > View Billing Information. Oracle publishes per-feature consumption ranges but the allocation and remaining balance are account-specific, so a projection has to start from your own figure. Oracle also labels the published ranges as estimates and notes that actual usage for similar transactions may vary, which makes them a planning range rather than a budget. The separate free monthly N/llm usage pool is read elsewhere, on the SuiteScript subtab of the AI Preferences page.
Does the 100-unit governance cost apply to Text Enhance too?
The 100-unit figure is the SuiteScript governance cost Oracle documents for the llm.generateText method, so it applies to AI a developer invokes from script code and counts against that script type’s unit budget. Text Enhance is a built-in feature invoked from the user interface rather than from a script. It does still draw on the NetSuite AI Units meter, which Oracle puts at roughly 5 to 10 units for a rewording request. The two meters are independent and both need checking.
Is NetSuite AI usable by a healthcare organisation under a signed BAA?
Parts of it are unavailable outright. Oracle states Narrative Insights cannot be activated for healthcare customers with a signed Business Associate Agreement, and that the feature has not yet been assessed for HIPAA compliance; the AI Prioritized button in Intelligent Close Manager carries the same exclusion. Oracle separately notes the AI Connector Service has not been assessed for HIPAA compliance. Treat all three as decisions for the compliance function rather than the implementation team.

Leave a Reply