Welcome to Zuora Product Documentation

Explore our rich library of product information

Payment transaction sync rules: Zuora to NetSuite

Process that syncs Zuora payments to NetSuite customer payments

This integration syncs records according to the following rules:

  1. Zuora Payment records are synced if they meet the following criteria:
    • The related customer account option Sync To NetSuite is not set or set to Yes.
    • The Status is Processed.
    • The Transferred to Accounting status is No, Error, or Processing.
    • The Effective Date is greater than or equal to the Payment Cutover Date (if the value is specified in the NetSuite Connector Advanced Settings).
    • The integration status field in the account must be "Sync Complete" enabled.
  2. The following validations are performed during the sync to ensure data integrity:
    • The Zuora payment method matches a valid NetSuite payment method. See Reconcile Data Between Zuora and NetSuite for more information.
    • The associated Zuora invoices have been synced (they have an IntegrationId).
    • If populated, the associated Zuora account's NetSuite location matches a valid NetSuite location.
    • If populated, the associated Zuora account's NetSuite class matches a valid NetSuite class.
    • If populated, the associated Zuora account's NetSuite department matches a valid NetSuite department.
  3. The Zuora payment's Integration Status is updated to Creating Payment and Transferred to Accounting is updated to Processing to indicate the record is currently being synced and to assist with error recovery.
  4. If the Zuora payment is applied to more than one invoice, the NetSuite payment will also be applied to multiple invoices.
  5. Upon successful creation of the NetSuite payment, the new NetSuite internal ID is written back to the Zuora payment record, the Integration Status is set to Sync Complete, and Transferred to Accounting is set to Yes.

Sync notes

  • Once synced successfully, no further changes to the Zuora payment will be synced, including cancellations. If you need to resync a payment, you can manually delete the NetSuite payment and set the Zuora payment's Transferred to Accounting to No. However, if a payment is voided or canceled before it is picked up by the sync, the payment will be ignored.
  • Transferred to Accounting values of Null in the API will appear as No in the Zuora UI.
  • See NetSuite Classifications for information about how classifications are mapped for NetSuite transaction header and details.
  • Credit card data is not transferred.
  • Unapplied Payments in Zuora will not sync to NetSuite while in an unapplied state unless the record has already been synced while having an application against it.
  • With Invoice Settlement enabled, if a payment is synced to NetSuite successfully, then the payment will not be synced again when transferring to another customer account or recording as unassigned.

Deposit-to account information

The Deposit-To account is where the payment amount will be placed. This is determined by the Deposit-To account configured on the referenced payment method within NetSuite. NetSuite Connector does not use the Accounting Code field on the Zuora payment method.

Payment transaction sync flow: Zuora to NetSuite

overview_payment_txn.png