SSEO - Caching Overview

Overview

The SSEO caching feature stores a subset of NetSuite record data on a dedicated cache server to dramatically speed up record matching during email sync. Instead of querying NetSuite live on every sync operation, SSEO queries the cache, reducing latency and NetSuite API load. Caching is opt-in and requires administrator activation.

What Data is Cached

The cache stores NetSuite record data only — no email content, email bodies, or attachments are ever cached. The specific fields stored per record depend on the matched record type configuration, but the default set includes:

  • Record title
  • Record detail
  • URL path to the record in NetSuite
  • Search text (used for matching)
  • Last modified date

For contact records specifically, the cache also includes the contact name and email address, as these are used for matching. More broadly, if a record title or detail field contains personally identifiable information (e.g. a contact name), that data will be cached.

Administrators can configure which fields are included per matching type, including custom labels. Any custom data added to those labels will also be cached.

Where Data is Stored

Field

Detail

Cloud provider

Oracle Cloud Infrastructure (OCI)

Data center region

Phoenix, AZ, USA

Storage type

PostgreSQL database table

Local storage

None — no data is stored on the user's machine or in Outlook

Per-account isolation

Each customer's cache is isolated by account GUID

The cache server is operated and maintained by Netgain. Customers do not have direct access to the underlying database.

Data Retention & Lifecycle

Daily Re-Cache Cycle

The cache is fully refreshed once per day. During each cycle, all existing cache data for an account is deleted and then re-populated from NetSuite. This means any records deleted in NetSuite will not persist in the cache beyond the next daily cycle.

30-Day Inactivity Auto-Purge

If no sync update is received from an account for 30 consecutive days, all cached data for that account is automatically deleted. The 30-day counter resets any time at least one record type is updated. This ensures inactive or churned accounts do not retain data indefinitely.

Manual Purge Options

Administrators can manually purge cached data at any time through two methods:

  • Global purge — available in the SuperSync Email Global Configs; clears all cached data for the account
  • Per record type — available on each matching type record; clears the cache only for that specific record type

Security & Encryption

Data in Transit

All data transmitted between NetSuite and the OCI cache server is sent over HTTPS, providing transport-layer encryption.

Data at Rest

All data at rest is encrypted within the OCI PostgreSQL database. Encryption is applied at the storage layer, ensuring that cached NetSuite record data is protected when not in transit.

Enabling & Configuring Caching

Activation Steps

Caching is disabled by default. To enable it:

  • Go to SuperSync Email Global Configs in NetSuite
  • Check the Enable Cache checkbox
  • Review and accept the End User License Agreement (EULA) presented in the confirmation dialog
  • Click Confirm to activate caching. Clicking No will leave caching disabled.

Once confirmed, the account is activated for caching. The first cache run will occur at the next scheduled sync, or can be triggered immediately using the Cache Now button.

Scope of Caching

Enabling caching at the global level activates it for all matching record types by default. Administrators can opt individual record types out by navigating to the specific matching type record and adjusting the setting there.

If a specific record type needs to be refreshed immediately (e.g. after a data import), administrators can trigger an on-demand cache for that record type from its matching type record.


Was this article helpful?