Setup the integration

Zuper is integrated with QuickBooks Online to make your accounting and inventory management go hand-in-hand with this seamless integration.

​

Zuper - QuickBooks Online integration plans

• Simple Start (US/Global) and Essentials (US) Plans: Most integration features are available.
• Features Requiring Higher Plans:
  • Inventory Sync (bi-directional): Requires Plus or Advanced plan.
  • Class Tracking: Requires Plus or Advanced plan.
  • Multicurrency Support: Requires Essentials or higher (Essentials, Plus, or Advanced).
• Custom Fields:
  • Depending on the plan, the number of custom fields that can be added to a transaction or synced from Zuper may vary.

​

Before you get started

• You must have an active account with QuickBooks Online.
• You cannot connect multiple QuickBooks Online organizations to your Zuper account and vice versa.
• Ensure that the base currency of both these organizations is the same.
• Ensure that the Zuper account used for API key generation and the one used for syncing invoices with QBO are separate.

​

Set up QuickBooks Online integration with Zuper

Integrating Zuper with QuickBooks is a simple and streamlined process.

• Log in to your Zuper account. Navigate to the App Store on the sidebar.

• Choose Accounting & Payments from the side menu. Select QuickBooks.

• Click “Connect to QuickBooks”.

• You will be redirected to the QuickBooks sign-in page. Enter your credentials to proceed with the integration.

• Once you sign in to QuickBooks, select the organization you want to connect with inventory if you have multiple organizations. After choosing an organization, click Next to complete the integration.

​

Zuper App Configure

• Once you have connected with QuickBooks Online, you will be redirected to your Zuper account to configure the integration.
• You must configure the settings to sync the Zuper modules with QuickBooks Online.

• To create the Zuper API (Mandatory), refer to the section below:

API Key Creation

• Sync Customers (Mandatory) - If you select “Yes,” whenever a new customer is created in Zuper, it will automatically synchronize with the QuickBooks Online customer module. If you choose “No,” customer sync between Zuper and QuickBooks Online will not be executed.
• Sync Estimates (Mandatory) - If you select “Yes,” whenever a new quote is created in Zuper, it will automatically synchronize with the QuickBooks Online estimate module. If you choose “No,” a quote sync between Zuper and QuickBooks Online will not be executed.
• Sync Deposits to Customer - If you select “Yes,” whenever a deposit is created in Zuper, it will automatically synchronize with the QuickBooks Online customer module. If you choose “No,” the deposit will not be synced to the customer on QuickBooks Online.
• Sync Services and Products (Mandatory) - By selecting “Yes,” inventory will synchronize two ways from Zuper to QuickBooks Online and vice versa. If “No” is selected, Zuper and QuickBooks Online do not synchronize inventory items.

• Master Product System (Mandatory) - By selecting “Zuper,” the master product system will be Zuper. If “QuickBooks” is selected, the master product is QuickBooks Online.
• Master Product Location- Enter the Master product location to which the inventory line is synced from Zuper to QuickBooks Online.
• Non-Inventory Product Quantity - Enter the non-inventory product quantity synced from Zuper to QuickBooks Online.
• Product Minimum Quantity - Enter the product minimum quantity of Zuper to which QuickBooks is synced.
• Invoice Status (Mandatory) - Upon selecting the status for the Invoice in Zuper, we trigger the sync to create a similar invoice in QuickBooks without any duplication. If the status is selected as “All” upon creating the Invoice in Zuper, sync will be triggered immediately, and the invoice will be made in QuickBooks.
• Default Tax Agency (In QuickBooks) - Copy and paste the “Default tax Agency” from QuickBooks, if available.
• Sync Failure Emails - A failed error message will be emailed to the given IDs upon sync.
• Default Payment Mode UID (Mandatory) - To sync with QuickBooks online, enter the default Zuper payment mode UID.
• Auto Enable invoice payment methods - If you select “Yes,” the invoice payment method created in Zuper will automatically sync with the QuickBooks Online invoice module. If you choose “No,” the invoice sync between Zuper and QuickBooks will not be executed.
• Default Payment Mode UID (To get the “Payment UID,” click “CTRL+Shift+J” and copy and paste the payment mode code).

• Estimate or Invoice ID (Mandatory)- After selecting the “Zuper ID or QuickBooks ID,” This will be updated in QuickBooks online under the field name “Estimate or Invoice No.”
• Identify Customers in Zuper-QuickBooks - When selecting the option below and syncing the invoice or estimate with QuickBooks, it checks and creates the invoice for the right customer.

Zuper Fields	QuickBooks Fields
Customer Email	Customer Email
Customer Name	Customer Name
Billing Email	Customer Email
Billing Name	Customer Display Name
Organization Name	Customer Display Name

• QuickBooks Plan (Mandatory) - The product type is allowed as “Service” only for the Essentials plan in QuickBooks Online. If not the Essentials plan, the product type can be “Inventory or Non-Inventory.”
• Custom Field Mapping - The data flows from Zuper Custom fields to QuickBooks Custom fields from the invoice.

The format of custom field mapping is: QBField1, ZuperField1; QBField2, ZuperField2.

• Display Name Format - From Zuper account for the invoices and estimates the customer name sync to QuickBooks Online happens based on the dropdown options:

First Name, Last Name (Default) Last Name, First Name Based on the preference chosen, the name sync happens.

• Account Name to deposit Payments – Enter the account name to which the payment needs to be allocated. The payment amount will be recorded in the chosen account, ensuring accurate financial tracking and allocation.
• For example, if the deposit payment is for rent, you might enter “Rent Expense account” in this field to ensure the payment amount is recorded under the Rent Expense account in QuickBooks.
• Delete action in Zuper to Void in QuickBooks – Upon selecting “Yes,” whenever any invoice is deleted in Zuper, it will also be voided in QuickBooks Online. If “No” is selected, deleting an invoice in Zuper will only remove it from Zuper, leaving the corresponding invoice unaffected in QuickBooks Online.
• Invoice Cancel in Zuper to Void in QuickBooks – If you select “Yes,” the invoice voided in Zuper will be invalid in QuickBooks. If you select “No,” the invoice voided in Zuper will not be invalid in QuickBooks Online.
• Use QuickBooks as Tax Master – Upon selecting “Yes,” QuickBooks Online will be the primary source for tax-related information, such as tax rates and codes. If “No” is selected, Zuper will be the primary source for Tax.

If QuickBooks Online is chosen as the primary tax source, ensure that tax configurations in Zuper align with those specified in QuickBooks Online.

• Push Email Field for Customer in QuickBooks – Enter the Zuper customers’ email to sync with them on QuickBooks.
• Use Different Discount Accounts in QuickBooks – If “Yes,” the different discount accounts will be used in QuickBooks; the discount account is specified in the Discount Name. If “No” is selected, the default discount account will be used in QuickBooks Online.
• Class Tracking - Enabling Class Tracking for Invoices, Quotes, and Products in QBO.

In our App Settings, we allow “Item Level” or “Invoice Level” class tracking

• If it is set as “Invoice Level”, we look for the custom field ‘QBO Class’, if a value is found, we sync that to QBO as part of the invoice sync
• If it is set as “Item Level”, then we iterate through each line item in the invoice & each item’s custom field “QBO Class” and use that for item level class sync with QBO

​

QBO Field mapping

 Module - Invoice 

Zuper Field	QBO Field	Notes
Prefix	Doc No.	Prefix and Invoice No. are joined to create Doc No. (when ID preference is Zuper)
Invoice No.	Doc No.
Reference No.	Doc No.	When ID preference is set to QBO. Doc No. syncs from QBO to Zuper Reference No.
Invoice Date	Transaction Date
Payment Term	Sales Term
Invoice Due Date	Due Date
Invoice Template	NA
Invoice Tags	NA
Invoice Description	NA
Invoice Total	Total Amount
Invoice Remarks	Customer Memo	“Note to Customer” in the UI
Billing Address	Billing Address
Service Address	Shipping Address
Notes	Private Note	“Memo on Statement” in the UI

  Module – Products  Inventory to Product

QBO field	Zuper Field	Notes
Name	Product Name
SKU	Product No.
Category	Product Category
Initial Quantity on hand	Available Quantity
As of date	NA
Reorder Point	NA
Description	Description
Sales Price/Rate	Unit Selling Price
Income Account	Custom Field
Sales Tax	NA	Info not directly available in API
Purchasing Information
Cost
Expense Account	Custom Field
Asset Account	Custom Field
Preferred vendor
NA	Minimum Quantity	Configured Value
NA	Location	Configured Location

  Non-Inventory to Part 

QBO field	Zuper Field	Notes
Name	Part Name
SKU	Part No.
Category	Product Category
Description	Description
Sales Price/Rate	Unit Selling Price
Income Account	Custom Field
Sales Tax	NA	Info not directly available in API
Purchasing Information
NA	Available Quantity	Configured Value
NA	Minimum Quantity	Configured Value
NA	Location	Configured Location

  Service to Service: 
 

QBO field	Zuper Field	Notes
Name	Service Name
SKU	Service No.
Category	Category
Description	Description
Sales Price/Rate	Unit Selling price
Income Account	Custom Field
Sales Tax	NA	Info not directly available in API
Purchasing information	NA

  Module - Customer 

Zuper Field	QBO Field	Notes
First Name	First, Last, Display Name	Combined to create Display Name
Last Name
Organization	NA	Not synced to QBO “Company”
Email	Email
Category	NA
Billing Street	Street Address 1
Billing City	City
Billing State	State	Mapped using SubdivisionCode
Billing Country	Country
Billing Zip Code	Zip Code
Contact Numbers	Phone Number	Priority: Contact > Work > Mobile > Home
Description	Notes
Service Address	NA	Not synced to QBO
Tags	NA
SLA	NA
Accessible to Everyone	NA
Preferred Time Zone	NA

​

Class-Tracking in QBO (QBO online plus or advanced)

In QBO, classes can be used to track transactions and group them according to different classifications, such as business units within a company or by product lines. Classes appear are tracked at the invoice level when the class assignment is chosen as “one to each transaction”. When the assignment is chosen as “one to each row in transaction,” the class is tracked at the line item level. The choice made for the class assignment should also be selected in the Zuper QBO app configuration. To track classes when syncing from Zuper to QBO, a custom field called “QBO Class” must be created in either the invoice record or the products record, depending on the configuration. The field must be configured with the values of available classes in QBO. When used in the transaction, the field’s value must be set to the class for that record. When synced to QBO, these transactions will appear in the respective Class report.
Account tracking: We work with two types of accounts in GL - Income Account & Expense Account

• Businesses can set an Account on the item level. By default, we map it to ‘Sales of Product Income’ for the Income account and “Cost of Goods Sold” for the Expense Account
• But if they would like to override, we can set up a custom field called ‘QBO Income Account’ and ‘QBO Expense Account’ on the item level to override the above default account while syncing to QBO.

When creating a new invoice or quote or product in QuickBooks Online, we can assign it a class while syncing it from Zuper to accurately track and categorize financial transactions.

1. In the QBO configuration screen, select whether the class tracking is to be done and if it is to be done for the entire transaction or each line item in the transaction, based on what you’ve specified in QBO.
2. Go to Settings > Custom Fields & Checklist Settings > Invoice Fields, Product Fields, Part Fields,streamlined and straightforward or Quotation Fields.
3. Create a custom field with the label “QBO Class.”
4. While creating the invoice, ensure that the value for the custom field is present.

​

QuickBooks Online Account Configure

• Sign in to the QuickBooks Online account and click the link below based on the signed-in account. Then click the “Switch Now” button.
• QBO Live Account
• QBO Staging Account

• Go to Accounting -> Chart of Accounts and make the following changes to the below 3 accounts:

Name	Account Type
Inventory Asset	Account Type: Other Current Details	Details Type: Inventory
Cost of Goods Sold	Account Type: Cost of Goods Sold	Details Type: Supplies and Materials - COGS
Sales of Product Name	Account Type: Income	Details Type: Sale of Product Income

​

Pushing Customers to Quickbooks Online

With the Zuper-QuickBooks Online integration, you can sync Customer master data from Zuper to Quickbooks. You can control this through a setting that is available in the configuration. The customer records can be created or updated in Quickbooks Online based on changes in Zuper. If the Zuper customer is present in Quickbooks Online, then they are identified using:

• Customer Quickbooks ID.
• Email ID.
• Customer Name. (First Name Last Name)

Similarly, if the organization is present in QuickBooks Online, then they are identified using:

• Org QB ID
• Org name

The billing contact of QuickBooks Online is identified using: For billing contact

• Billing name
• Billing email

If the customer, organization, or billing contact is absent in QBO, it will be created during the sync. This can be configured using the below setting: The various mapping details:

• The Customer Description mapped as Customer Notes in Zuper.
• The Customer’s Address is mapped as a Billing Address in Zuper.

​

Push Products and Services to Quickbooks Online

• Depending on the configuration for Products Master, products and services are synced from Zuper to QuickBooks and vice versa.
• If the QuickBooks Online product is present in Zuper, the validation is done based on the following criteria: a. Product Quickbooks ID. b. Product Name.

Notes for Inventory sync

• Products and Parts of Zuper are captured as Inventory in QuickBooks Online. (Track Quantity means inventory).
• Service is captured as Service in QuickBooks Online (If the track quantity is not present, this is captured as non-Inventory).
• Before a product or part or service is created in Quickbooks, the category must be in QBO. Once identified, the item will be created.

Mapping Details: For all the products, a chart of account details is needed. a. Income account reference b. Inventory Asset account reference c. Expense account reference.

• Inventory Start Date – Company created date or Current day –1 (if company date is absent).
• Description – Product Description.
• Purchase Cost – Unit Selling Price.
• SKU – Unique ID identifying the product.

Based on Zuper’s tax information, the tax masters should be created in QuickBooks Online, and then the tax mapping will happen with the tax ID and name. The created Product ID in QuickBooks Online is stored as Custom fields in Zuper. Refer to this article to enable bidirectional inventory sync.

​

Push Quotes to QuickBooks Online:

With the Zuper-QuickBooks Online integration, you can sync quotes from Zuper to Quickbooks. You can control this through a setting that is available in the configuration.

• The data push will happen from QuickBooks Online to Zuper.
• If the Estimate settings are enabled in the integration settings, we will fetch the Estimate UID.
• If the QuickBooks Online Estimate is present in Zuper, the validation is done based on the following criteria:
• List of matching criteria listed

Notes for Quotes Sync:

• The billing address in Zuper is captured as a Customer Address in QBO.
• Service and Billing customers of Zuper are considered Billing customers in QuickBooks Online only.
• If the customer already exists, then the customer will have a QuickBooks Online ID; if not, a new customer will be created in QuickBooks Online based on the billing address of the Zuper details.

Line-Item Details: The service charge varies based on the estimate for installation or repair, so these situations are not captured as master line items. For custom line items, the amount is captured dynamically.

• Estimate’s expiration date – QuickBooks Online’s expiry date
• Notes - QuickBooks Online’s Customer Memo
• Await Payment – Email sent (Payment collection pending)
• Customer, Customer ID – Verify that if a new customer is absent, the customer ID will be created in Zuper.
• The status names will be synchronized from Zuper to QuickBooks Online (This transaction status verification is to be done).
• US tax rule – The tax rule structure is to be followed; for the rest of the world, different taxes are calculated straightforwardly.
• The Quote number in Zuper is captured as a document number in QuickBooks Online.

The created estimate ID in QuickBooks Online is stored as a custom field in Zuper.

​

Push Invoices to QuickBooks Online

Zuper-QuickBooks Online integration syncs invoices. You automatically synchronize Invoices according to the pre-defined settings and quote conversion. You can take three significant actions: Invoice Create Sync, Invoice Update Sync, Invoice Payment Sync, and Invoice Note Addition Sync.

• The data push will happen from QuickBooks Online to Zuper.
• We will fetch the invoice if the invoice settings are enabled in the integration settings.
• If the QuickBooks Online Estimate is present in Zuper, the validation is done based on the following criteria:
• List of matching criteria listed in Zuper.

The various preliminary details:

• Customer Address in QuickBooks Online is captured as a Billing address in Zuper.
• Service and Billing customers of Zuper are considered Billing customers in QuickBooks Online only.
• If the customer already exists, then the customer will have a QuickBooks Online ID; if not, a new customer will be created in QuickBooks Online based on the billing address of the Zuper details.

Line-Item Details: The service charge varies based on the installation or repair invoice, so these situations are not captured as master line items. For dynamic custom line items – the amount is captured dynamically.

• Invoice’s due date – QuickBooks Online’s due date
• Remarks - QuickBooks Online’s Customer Memo
• Customer, Customer ID – Verify that if not present, a new Customer customer ID is to be created in Zuper.
• Await Payment – Email sent (Payment collection pending)
• The status names will be synchronized from Zuper to QuickBooks Online (This transaction status verification is to be done).
• US tax rule – The tax rule structure is to be followed; for the rest of the world, different taxes are calculated straightforwardly.
• Item Description of Zuper is captured as a Sale Item Line Item in QuickBooks Online.

The discount details and subtotal are captured as line items in QuickBooks Online.

• You can convert an estimate into an invoice or create an invoice directly in both Zuper and QuickBooks Online. The converted estimate is captured as a linked transaction.
• Private Note – This is visible to a few users based on the settings.
• Job – Invoice creation – This is done based on the Job’s prefix.
• For the existing invoice sync – An update operation will happen if the new invoice creation means a new invoice is created.
• The full payment done in Zuper gets synchronized with QuickBooks Online as the total invoice payment along with the mode of payment.
• For the partial payment made in Zuper – the same gets recorded in QuickBooks Online. The created Invoice ID in QuickBooks Online is stored as a Custom field in Zuper.

​

Chart of Accounts in QBO

In QBO, the chart of accounts needs to be set up for Accounting and tracking financial transactions. The major type of accounts are:

• Balance Sheet Accounts
• Profit and Loss Accounts

Balance Sheet Account statements provide a snapshot of the company’s financial health at a given point in time. Profit and Loss Account statements provide a view into the performance of a company over a period of time. AR and AP: AR (Accounts Receivable) and AP (Accounts Payable) are Accounting components that track money owed to and by the business respectively. They don’t hold actual cash but are balance accounts that track money that is owed. AR workflow:

• Invoice a customer - increases AR account balance by the invoice amount.
• Receive Payment (partially or in full). - decreases AR account balance by the payment amount
• Deposit the payment to a bank account.
• AR accounts are Asset accounts.

AP workflow:

• Enter a Bill from a vendor - increases AP account balance by the Bill amount.
• Pay Bill (fully or partially). - decreases AP account balance by the payment amount.
• Payment is recorded from the chosen account (bank, credit card, etc.).
• AP accounts are Liability accounts.

QBO Feature	AR (Accounts Receivable)	AP (Accounts Payable)
Chart of Accounts	Uses the Accounts Receivable (asset) account	Uses the Accounts Payable (liability) account
Transactions	Invoice, Receive Payment, Sales Receipt	Bill, Pay Bills, Expense

​

Updating newly created Income or Expense Accounts in Product Custom Fields

When creating new income or expense accounts in QuickBooks for accurate tracking and categorizing financial transactions, it’s essential to ensure seamless integration and data consistency between Zuper and QuickBooks Online. Follow these steps to add the newly created account name in the Product Custom Fields.

1. Go to Settings -> Custom Fields & Checklist Settings -> Product or Part Fields. The Product Custom Fields page opens.
2. In the QBO Income Account field, add the names of the newly created income accounts as values.
3. In the QBO Expense Account field, add the names of the newly created expense accounts as values.

Adding the account names in the Product Custom Fields enables easy selection of specified accounts while creating products and services. This ensures that products or services are correctly linked to QuickBooks’ online appropriate income or expense accounts, facilitating accurate financial tracking and categorization.

​

Updating newly created invoice custom fields

When creating a new Invoice in QuickBooks, it’s essential to ensure seamless integration and data consistency between Zuper and QuickBooks Online to track and categorize financial transactions accurately. Follow these steps to add the newly created invoice to the Product Custom Fields.

1. Go to Settings -> Custom Fields & Checklist Settings -> Invoice Fields. The Product Custom Fields page opens.
2. In the QBO Invoice field, add the newly created invoice date names as values.
3. In the QBO Invoice field, add the names of the newly created due dates as values.

Adding the invoice date and due date in the Invoice Custom Fields enables easy selection of specified accounts while creating Invoices. This ensures that Invoices are correctly linked to QuickBooks online.

​

Limitations

• QuickBooks Online limits a customer’s First Name or Last Name to 25 characters and a Company Name to 50 characters. If a customer is created in Zuper with a name that is over 25 characters long, there will be an error when creating the Customer in QuickBooks Online.
• If a customer is deleted in Zuper, the record will still be available in QuickBooks Online.
• Customers should subscribe to QuickBooks Online Plus or Advanced for inventory tracking.
• The Zuper account holder should have a dedicated account to generate the API Key, and the user should be in the administrator role. This account should be different from the one connecting to QBO.
• For the B2B scenario cases, to push the Organization to QuickBooks Online, the value for the fields “Identify Customers in Zuper – QuickBooks Online” should be specified as:
• Billing Name – Customer Display Name.
• QuickBooks Online allows a maximum of three custom fields for Quotes and Invoices. Irrespective of the status of the custom field in QuickBooks Online, more than three custom fields will replace the current custom field values.Regardless of the custom field’s status

​

Credits and Refunds

Zuper’s revamped credits and refunds feature allows you to manage customer credits, process refunds (full or partial), and void payments efficiently. These actions sync seamlessly with QBO, ensuring accurate financial records. Credits can be applied to invoices, stored as credit memos, or refunded via the original payment method, depending on the transaction type (Zuper Pay or non-Zuper Pay, online or offline). Creating a Credit Memo Credit memos in the Zuper store credit against a customer, which can later be applied to invoices. These can be done either directly in the customer module or while refunding a payment in a transaction.

1. Log in to Zuper: Navigate to the Invoice or Payments module.
2. Select Customer: Choose the customer you want to create a credit with.
3. Create Credit Memo:
   • Click New Credit Memo or equivalent.
   • Enter the credit amount and add a memo/note (e.g., reason for credit, such as overpayment or service issue).
   • A default line item of type “SubTotal” with the credit amount is automatically added (required for QBO API).
   • Save the credit memo. It will sync to QBO as a credit memo linked to the customer.
4. Verify in QBO:
   • In QBO, go to Sales > Customers to confirm the credit memo is listed under the customer’s account.
   • Note: If a credit memo is deleted in Zuper, it will also be deleted in QBO.

Applying Credits to an Invoice When a customer has an active credit memo, you can apply it to a new or existing invoice.

1. Create or Select an Invoice:
   • Navigate to the Billing module and create a new invoice or select an existing one for the customer.
2. Apply Credit:
   • Choose Record Payment or Apply Credit.
   • Select the credit memo and specify a custom amount (up to the total credit available).
   • Save the action. The invoice status updates to Partially Paid or Paid in Zuper.
3. Sync with QBO:
   • The applied credit is recorded as a payment in Zuper and synced as a payment in QBO against the invoice.
   • The applied amount reduces the customer’s credit balance in QBO.
4. Verify in QBO:
   • In QBO, go to Sales > Customers or Transactions > Payments to confirm the payment and updated invoice status.

Processing Refunds Refunds can be issued for full or partial payment amounts, depending on the transaction type (Zuper Pay or non-Zuper Pay, online or offline). Refunds are stored as credit memos or returned to the original payment method. Zuper Pay Transactions

• Offline Transactions:
  1. Navigate to the Billing or Payments section in Zuper.
  2. Select the customer and the payment to refund.
  3. Choose Refund and specify the amount (full or partial).
  4. Select whether to store the refund as a credit memo or return it to the original payment method.
  5. Save the refund. The payment in Zuper has been updated, and the invoice status has changed to Partially Paid or Sent.
  6. Sync with QBO:
     • The payment in QBO is cleared (set to 0) for full refunds or modified for partial refunds.
     • If stored as a credit memo, the customer’s corresponding credit is added in QBO.
• Online Transactions:
  1. Follow the same steps as offline transactions, but the refund must be manually added as a credit memo in Zuper.
  2. The refund is processed and synced to QBO as described above.

Non-Zuper Pay Transactions

• Offline and Online Transactions:
  1. Navigate to the Billing or Payments section.
  2. Select the payment to refund and choose Refund.
  3. Specify the amount (full or partial) and store it as a credit memo.
  4. Save the refund. The invoice status updates to Partially Paid or Sent.
  5. Sync with QBO:
     • The payment in QBO is cleared (full refund) or modified (partial refund).
     • A credit memo is added to the customer’s account in QBO.

Notes

• Refund receipts are not created in QBO as part of this process.
• Deposits collected against quotes in Zuper cannot be refunded.

Voiding Payments Voiding a payment cancels the entire payment amount and does not automatically create a credit memo.

1. Void a Payment in Zuper:
   • Navigate to the Billing or Payments section.
   • Select the payment and choose Void.
   • Confirm the action. The payment is voided, and the invoice status changes to Partially Paid or Sent.
2. Sync with QBO:
   • The corresponding payment in QBO is voided.
   • Note: Voiding does not automatically add credits to the customer in Zuper or QBO. Credits must be manually added if needed.
3. Verify in QBO:
   • In QBO, go to Transactions > Payments to confirm the payment is voided.
   • For non-Zuper Pay transactions, voiding a payment acts as a refund but does not offer a “refund” option.

Notes

• Zuper does not allow voiding or canceling invoices with active payments, unlike QBO. Ensure payments are cleared in Zuper before voiding an invoice in QBO to avoid discrepancies.
• In QBO, voiding an invoice may push payments to customer credits. Since Zuper clears payments before voiding, this should not occur during sync.

Troubleshooting Common Issues

• Sync Errors: If credits, refunds, or voids do not reflect in QBO, check the integration settings in Zuper. Ensure the QBO connection is active and retry the sync.
• Incorrect Invoice Status: Verify that the invoice status in Zuber (Partially Paid or Sent) matches QBO after refunds or voids. Correct any discrepancies in Zuper.
• Credit Application Issues: Ensure QBO’s “Automatically apply credits” setting is turned off to prevent unintended credit application.
• Credit Memo Line-Item Errors: If a credit memo fails to sync to QBO, confirm that a default “SubTotal” line item is included, as the QBO API requires.

Best Practices

• Disable QBO Auto-Apply Credits: Turn off QBO’s “Automatically apply credits” setting to ensure manual control over credit application.
• Regular Syncing: Sync Zuper with QBO daily to maintain accurate financial records.
• Clear Memo Notes: Add detailed notes to credit memos and refunds for audit purposes (e.g., “Refund for overpayment on Invoice #123”).
• Review Reports: Use Zuper and QBO reports (e.g., Customer Balance Summary, Payment Reports) to track credits and refunds.

This enhancement covers:

• Customer Invoices
• Payments
• Credits
• Refunds
• Voids (offline and online transactions)

​

Credits Sync

​

Creating Credits

1. Credits can be generated manually against a customer in Zuper.

2. Credits are automatically refunded when a refund is processed on a paid invoice (partial or full).

3. All such credits are synced to Credit Memos in QBO against the same customer in Unapplied Status.

​

Applying Credits

When credits are applied to an outstanding invoice in Zuper, the corresponding Credit Memo in QBO is now applied. The invoice is also reflected as paid/partially paid in the regular flow. Available credits can also be used to collect deposits against Quotes. These transactions are also adjusted against the customer’s credit balance in QBO. The behaviour differs based on the ‘Sync Deposit to Customers’ Configuration. Scenario 1 – Sync Deposits to customers is turned off The Estimate is created in QBO. The credit is still unapplied in QBO. Convert the Quote to Invoice The credit memo has been adjusted (reduced), and the payment is reflected against the invoice. Scenario 2: Sync Deposits to customers is turned on The deposit is collected using credits against the quote.

​

Payment Modes

Refunds and credits may be handled via:

• Zuper Pay (online/offline) or
• Standard payment methods (cash, bank transfers, etc.).
   Zuper ensures proper reflection of the refund source and amount in QBO, irrespective of the payment mode.

 Voiding Payments When a payment is voided in Zuper: The corresponding payment in QBO is automatically voided. Similarly, if a payment is voided in QBO: The associated payment record inZuper is also voided to maintain synchronization.