OCI Credentials for Expanded DocumentCapture Usage in NetSuite

TL;DR Opening

Starting in NetSuite 2026.1, users can now utilize Oracle Cloud Infrastructure (OCI) credentials to expand their monthly usage pool for the documentCapture module. This enhancement is crucial for organizations needing to process a high volume of documents without exhausting their free limit.

What's New

NetSuite has introduced functionality that allows customers to leverage OCI credentials, which can significantly increase their document processing capacity. Calls made to documentCapture.documentToStructure(options) consume requests from the free monthly pool, but obtaining additional usage via OCI credentials can mitigate limitations when processing documents. This feature is vital for businesses operating in data-intensive environments.

Monthly Usage Pools

• Free Usage Pool: Each NetSuite account automatically receives a monthly quota for documentCapture requests, which is renewed each month. Tracking this usage can be done on the AI Preferences page in NetSuite.
• SuiteApp Usage Pools: Each SuiteApp installed on an account has its own distinct monthly usage pool for documentCapture methods. This separation means that the usage of SuiteApps does not interfere with the quota available for regular scripts. For example:
  • If you install multiple SuiteApps, each can independently draw from its usage pool.

Utilizing OCI Credentials

Organizations can configure their OCI accounts to enhance the documentCapture functionality by providing OCI credentials, which shifts usage from the NetSuite free pool to the OCI account. There are two main ways to configure OCI credentials:

1. AI Preferences Page: You can set up OCI credentials directly within the AI Preferences section in NetSuite.
2. Options Parameter: Including the options.ociConfig parameter when calling documentCapture.documentToStructure(options) will override any existing configurations set in the AI Preferences.

Synchronous vs. Asynchronous Requests

• Synchronous Requests: For standard usage, you need to provide basic OCI configuration parameters:

docTask.ociConfig = {
    userId: 'user-ocid',
    tenancyId: 'user-tenancy',
    compartmentId: 'user-compartment',
    fingerprint: 'custsecret_secret_fingerprint_id',
    privateKey: 'custsecret_secret_privatekey_id'
};

• Asynchronous Requests: For document capture tasks that require asynchronous processing, additional fields must be provided:

docTask.ociConfig = {
    objectStorageNamespace: 'oraclenetsuite',
    outputBucketName: 'in-bucket-name',
    inputBucketName: 'out-bucket-name'
};

Usage Management

To manage and view your usage:

• Navigate to Setup > Company > AI > AI Preferences.
• In the AI Preferences page, click the SuiteScript subtab to find details regarding the monthly limits and your current usage status.

Who This Affects

This change impacts:

• Administrators: Who configure AI preferences and monitor usage.
• Developers: Creating and managing integration with document capture capabilities.
• IT Teams: Implementing OCI credential configurations for streamlined document processing.

Key Takeaways

• OCI credentials can be used to augment monthly usage for the documentCapture module since NetSuite 2026.1.
• Each SuiteApp operates with its own independent usage pool for documentCapture requests.
• Adjustments to OCI parameters can be done either through the AI Preferences page or by directly embedding them in your scripting calls.
• Users can monitor their remaining free usage directly in NetSuite, ensuring they stay within their allocated limits.