NetSuite

Connect your NetSuite ERP to sync and manage business records

NetSuite is a cloud-based enterprise resource planning (ERP) software that helps businesses manage financials, operations, and customer relationships. The Cargo integration enables you to sync and manage records across all your NetSuite objects.

Authentication

NetSuite uses Token-Based Authentication (TBA) for secure API access.

Connection details

Field	Description
Account ID	Your NetSuite account ID
Consumer Key	OAuth consumer key
Consumer Secret	OAuth consumer secret
Token	Access token
Token Secret	Access token secret

Generate your credentials in NetSuite under Setup → Integration → Manage Integrations.

A companion Netsuite (SOAP) integration (catalog slug netsuiteSoap) talks to NetSuite’s SuiteTalk SOAP web services instead of the API used here. It authenticates with the same token-based credentials and exposes a single Insert record action (returning the created record’s id). Use it when a record type is only writable through the SOAP interface; use this integration for everything else.

---

NetSuite actions

NetSuite actions support all standard and custom record types in your account.

Search records

Retrieve multiple records from any NetSuite object.

Configuration

Field	Description
Object type	Select the record type to search
Filter	Define filter conditions
Sort	Sort results by field
Limit	Maximum records to retrieve (default: 100)

Insert record

Create a new record in NetSuite.

Configuration

Field	Description
Object type	Select the record type
Mappings	Map field values for the record

Update records

Update existing records in NetSuite.

Configuration

Field	Description
Object type	Select the record type
Matching Value	Value to match against
Netsuite Matching Property Name	Property to match on
Mappings	Map fields to update
Skip if exist	Update only if field is currently empty

Upsert records

Insert or update records based on a matching field.

Configuration

Field	Description
Object type	Select the record type
Matching Value	Value to match against
Netsuite Matching Property Name	Property to match on
Mappings	Map field values
Skip if exist	Update only if field is currently empty

Delete records

Delete records from NetSuite.

Configuration

Field	Description
Object type	Select the record type
Matching Value	Value to match against
Netsuite Matching Property Name	Property to match on

Delete operations are permanent. Ensure you have proper filters configured.

---

Data models

Create data models from any NetSuite record type with incremental sync support.

Configuration

Field	Description
Object type	Select the record type to sync

Supported record types

Financial records

Sync invoices, transactions, journal entries, and other financial data.

Customer records

Sync customer and contact information with full relationship data.

Inventory records

Track inventory items, locations, and stock levels.

Custom records

Access any custom record types defined in your NetSuite instance.

---

Best practices

1. Use incremental sync - NetSuite data models support incremental sync for efficient updates
2. Rate limits - NetSuite has strict rate limits (15 requests/minute). Plan workflows accordingly
3. Custom fields - All custom fields are automatically available through dynamic field selection