When using ERP integrations like Quickbooks Online, Xero, or NetSuite you are required to assign a default account for unmapped payment items to be assigned to. Here, we describe what this is and why it is mandatory.
What are Default Accounts?
These are accounts in your ERP system to which unmapped payment items (or invoice items) will be assigned to by default. You will be prompted to add this when you first set up the integration:
You will see two options on this page, a Default Account and a Credit Account. Setting a Default Account is required. Optionally, you can select the option Sync credit invoices (deposit invoices and credit notes) to a different account if you would like to select a separate account to which to sync your deposit invoices and credit notes.
Note: If you don't find the account you're looking for in the dropdown list, click on Refresh data button on the right of your screen. Please allow a few minutes for the data to sync with your ERP system.
You can always change the default accounts later, in the integrations settings page.
Why is this important?
This is very important in order to proactively avoid data sync failures due to an unmapped payment item. There may be instances where a payment item on Oyster is not mapped to any particular account in your ERP system.
For example, when Oyster adds a new payment item in the invoice after you enabled the integration. The new payment item will remain unmapped unless you take actions to edit the field in the integration settings page. By assigning all unmapped items to the default account, we can prevent invoice sync errors in advance.
There are also certain types of invoices, like PAYG and Credit notes that will always be synced to the default account.
Also see: How to set up Xero, Quickbooks Online integrations and How to set up NetSuite integration
