Skip to main content

Automated NetSuite Deposit Requirements With Blue Onion: Overview

Andrew Gunter avatar
Written by Andrew Gunter
Updated over 4 months ago

What You Need for Successful Automated Reconciliation

To achieve the best and most automated reconciliation experience with Blue Onion's NetSuite Reconciliation Tool, your NetSuite implementation needs to meet specific requirements. This article outlines these requirements and identifies common issues teams encounter during onboarding.


Requirements:
Data connector must create either Cash Sales, Customer Deposits, or Customer Payments in order for

Common Issues:

Transaction Requirements

For Cash Sales, Customer Deposits, or Customer Payments from supported order management systems (like Shopify, Amazon):

  • Unique Identifiers: Each transaction must include a unique identifier (such as Order ID or Order Name) that maps back to your order management system. This identifier should be consistent across all transaction types.

  • Transaction Values: The full value of each transaction must be included as recorded in the source system, before any payment processor fees or related expenses are applied.

These same requirements apply to Cash Refunds or Customer Refunds from your order management systems.

Common Issues During Implementation

Missing Orders

Orders can be missing in NetSuite for several reasons:

  • Rate-limiting with connections between your order management system and NetSuite during high-volume periods

  • Missed connections for specific stores (such as certain Shopify stores)

  • Failures in the connector's translation logic to NetSuite

Missing Refunds

Refunds might not appear in NetSuite due to:

  • Refund flow being omitted from the initial NetSuite implementation design

  • Lookup issues with current period refunds for orders placed before NetSuite implementation or connector change

  • Rate-limiting during high-volume periods

  • Missed connections for specific stores

Missing Cancellations

Some implementations ignore cancellations in their NetSuite integration:

  • Same-day cancellations usually don't cause issues when the original charge and refund settle in the same payout

  • When orders and cancellations occur at different times resulting in separate payouts, reconciliation becomes more challenging

  • While we have workflows to handle this, it will require some manual intervention

Tax Calculation Discrepancies

Tax issues commonly arise from:

  • Different tax rates between NetSuite and your order management system

  • Missing sales tax on shipping line items in jurisdictions that require it

Orders with Multiple Payments in Separate Settlements

Orders with multiple payment methods that settle in different payouts can complicate reconciliation:

  • Shop Cash rewards often settle in different payouts than direct customer payments

  • Facebook promotional credits may pay out in separate settlements

  • Cash Sales customers face greater challenges than those using Customer Deposits

  • A Blue Onion solution for this issue is launching in 2025, but some manual intervention will be required until then

Foreign Exchange Rate Discrepancies

For multi-currency transactions:

  • Different FX rates in NetSuite versus what's reflected by processors or banks can create reconciliation challenges

  • We can help quantify these differences, but some manual work will be required

Loop Returns Integration Issues

Loop Returns can complicate recording and associating refunds with original orders. We have workarounds for some NetSuite implementations and are happy to discuss specific solutions.

Additional Issues

  • Discounts not syncing properly on both sales and refunds

  • Differences between Sandbox and Production environments in NetSuite (Chart of Accounts, SKUs, Subsidiaries, etc.)
    ​

Need More Help?

If you're experiencing any of these issues or have questions about implementing the NetSuite Reconciliation Tool, please contact our support team at [email protected] or visit www.blueonionlabs.com for more information.

Did this answer your question?