Why don't some invoices or payments sync to my accounting package?

MineralTree performs a two-way sync between your instance on our servers and your accounting package (AP). Sometimes invoices or payments may fail to sync back to the AP for various reasons, which can include:

  • Duplicate bill or payment exists in the AP
  • Bill has a different status in MineralTree and the AP
  • Bill was deleted in the AP

and so on. Invoices or payments in this state will show with a red "warning" icon in the MineralTree site.

To help deal with these issues, we provide two reports in the MineralTree site that list objects that failed to sync, along with the error message and steps to address the particular issue:

  1. To access the reports, go to the REPORTS tab in MineralTree.
  2. Run either the “Invoice Sync Failures” or “Payment Sync Failures” reports.  
  3. These reports display the invoices and payments that failed to sync, along with basic error information.
  4. We recommend that you click the the Download button, and choose CSV, to download a report in CSV format. You can view this file in Excel or other spreadsheet programs
  5. This report will contain the error message, if any, and in many cases also include stesp to take to fix the issue, either in the MineralTree site or the AP.

If you use QuickBooks Desktop or GreatPlains software for your AP, and don't see any error messages, please contact MineralTree support to arrange for an upgrade to the Connector program installed on your local server. The newest version has more robust and detailed error messaging.

For cases without an error description, or if the suggested remedies cannot be implemented (i.e. an invoice is locked for editing), please reach out to support@mineraltree.com for assistance.

Please note:

  • Payment sync failures are independent of actual payment delivery to your vendor. To confirm payments went out, you can log into MineralTree to view the Payment history and status. For the case of checks, payments that really went out will show a check number, and that value will be a link to the check image. ACH payments will show text confirming they were submitted.
  • Documents, like invoices or payments, sometimes fail to sync over correctly to the AP. Sync failures for documents are rarer, and simply indicate that a PDF or other file associated with an invoice is present in aMineralTree, but not in the AP. We are working to add features to allow more control over document sync issues, but for now if you see such errors, please contact us and we will address them for you.

New as of January 2018: we now show sync error notifications in the MT site. Please see this article for more information.

Have more questions? Submit a request


Please sign in to leave a comment.
Powered by Zendesk