NetSuite Pre-Built Connector

Edited

OVERVIEW

The NetSuite Pre-Built Connector for Loop automatically syncs return and exchange data between Loop, Shopify, and NetSuite. Built and maintained by NetSuite, it provides full financial tracking and general ledger (GL) impact for every return, exchange, refund, and store credit — without requiring custom development or third-party middleware.

The connector creates automated synchronization between the systems every 90 minutes, ensuring accounting records stay current with minimal manual intervention.


How It Works

The connector sits between Loop, Shopify, and NetSuite, keeping all three systems in sync throughout the return lifecycle:

  1. Orders flow from Shopify into NetSuite via the existing Shopify connector

  2. Orders are fulfilled and invoiced in NetSuite

  3. A shopper initiates a return or exchange in the Loop portal

  4. A return authorization is automatically created in NetSuite

  5. The return is received either in NetSuite (recommended) or in Loop and synced to the other system

  6. Refunds or credits are processed through Loop and Shopify, then synced back to NetSuite as credit memos

  7. All transactions are linked to the original sales order in NetSuite with full GL impact

The connector runs six distinct syncs referenced in the UI:

  • Return Authorization Sync: Creates the Return Authorization (RA) in NetSuite when a return is initiated in Loop

  • Item Receipt Sync [NetSuite Loop]: When items are received in NetSuite, marks the return as Processed in Loop

  • Item Receipt Sync [Loop NetSuite]: When a return is processed in Loop, creates the Item Receipt in NetSuite

  • Refund Sync: Creates a cash refund or credit memo in NetSuite, linked to the original Shopify order

  • Return Cancellation Sync: Closes the RA in NetSuite when an exchange is cancelled in Loop

  • Returns Authorization Cancellation Sync: Cancels the exchange in Loop when the RA is closed in NetSuite

Every step of the lifecycle is tracked: Sales Order → Customer Deposit → Fulfillment → Invoice → Return Authorization → Item Receipt → Credit Memo.


Supported Workflows

The connector supports the following return and exchange scenarios:

Simple Returns

When a shopper returns an item for a refund to their original payment method, the connector creates a return authorization in NetSuite, tracks the item receipt, and syncs the credit memo once the refund is processed.

Exchanges (Same Item)

When a shopper exchanges for the same item (e.g., a different size or color), the connector creates a return authorization for the original item and a new exchange order in Shopify (prefixed with "EX-"). The exchange order flows into NetSuite as a new sales order, linked to the original.

Exchanges (Different Item)

When Advanced Exchanges are configured, shoppers can exchange for a different product entirely. If the new item costs more, the shopper pays the difference. If it costs less, the credit is applied automatically.

Store Credit

Store credit returns are supported via Shopify gift cards or Shopify's native store credit feature (with new customer accounts).

Variant Exchanges

Shoppers can exchange for different variants (size, color) of the same product at the same price.


Qualifications

To use the NetSuite Pre-Built Connector the following are needed:

  • An active Shopify store

  • An active Loop Returns account

  • The NetSuite Shopify Connector — specifically, the Premium Connector Add-On license SKU, which requires a Premium Plus E-Commerce License.

    Note: Shopify orders must be flowing into NetSuite before the Loop connector can be activated. The connector blocks activation of Loop refund sync until the underlying Shopify refund sync is configured.


Getting Started

Setup is straightforward. In the NetSuite connector settings complete the following steps:

  1. Navigate to the Loop connector section

  2. Enter the Loop API token (generated in the Loop admin under Developer Tools)

  3. Select the Shopify store linked to the Loop account

  4. Save the configuration

The connector will begin syncing return data on its next cycle (every 90 minutes).

Note: An upcoming update will replace the manual API token step with a one-click OAuth login for even easier setup.


Connector Settings

Once the connector is active, the following toggles can be configured in the NetSuite connector UI:

  • Cancel returns in Loop when Return Authorizations are cancelled in NetSuite: cancels a return in Loop when an RA is closed in NetSuite.

  • Cancel Return Authorizations in NetSuite when returns are cancelled in Loop: closes the NetSuite RA when a return is cancelled in Loop.

  • Create Return Authorization and Item Receipts as part of the Shopify refund process when a refund is initiated in Loop: use this if refunds are being kicked off from Loop rather than received in NetSuite first.

  • Return Authorization Flag Field: the NetSuite field ID used to flag a return in Loop for manual review.

NOTE: When a return is flagged in NetSuite, the connector flags the matching return in Loop and moves it into manual review. After the manual review is complete in Loop, the reviewed status must updated or the flag cleared in NetSuite to prevent the connector from re-flagging the return on every subsequent sync.


Best Practices

  • Receive returns in NetSuite first, then sync to Loop. This makes NetSuite the source of truth for inventory and accounting.

  • Work with your NetSuite team to configure exchange accounting settings (Loop discount toggle, tax calculation) based on your downstream systems (e.g., Avalara).

  • Account mapping: Only one Loop account can connect to a single Shopify store at a time. If multiple Shopify stores are run under one Loop account, the connector supports that multi-store configuration — just note it's multiple Shopify stores per Loop account, not multiple Loop accounts per Shopify store.


Known Limitations

The following features are not available in the current release but are planned for future updates:

Limitation

Status

Multiple returns or exchanges on the same order

Coming soon

Stripe-based payment collection for upsell exchanges

Planned

Store credit liability tracking in NetSuite

Planned

Instant Exchanges

Planned


Pricing

NetSuite: The NetSuite Pre-Built Connector is available as an add-on to an existing NetSuite Shopify Connector for $83.25 per month.

Loop: There is no additional cost in Loop for using the NetSuite Pre-Built Connector.

Note: There are no per-transaction fees.


FAQ

Does this require a developer to set up? No, setup requires only a Loop API token and Shopify store selection — no custom development needed.

How often does data sync? Every 90 minutes automatically. A manual sync can also be triggered in the NetSuite connector UI.

Can this be used alongside an existing integration (e.g., Celigo)? The pre-built connector is a separate integration option. If another connector is currently being used, consult with NetSuite and Loop contacts about the best path forward.

What if a feature is needed that isn't supported yet? Contact NetSuite support. New feature requests are evaluated by the NetSuite product team, with typical development timelines of 30–60 days for approved enhancements.


Need More Help?

Note: NetSuite builds, maintains, and supports the connector end-to-end.

Was this article helpful?

Sorry about that! Care to tell us more?

Thanks for the feedback!

There was an issue submitting your feedback
Please check your connection and try again.