Microsoft Great Plains Integration Guide


MineralTree is an accounts payable and payment automation service.  It integrates with Great Plains through a "connector" application that is installed as a Windows Service on the GP server (i.e. the same machine on which the GP application is installed).  Info pertaining to outstanding vendor bills in GP is brought over to the MineralTree website, and then you're able to log in and pay your bills online. 

From a technical perspective, we get info from GP by querying the GP SQL database directly (using credentials you plug in at the time of installation), and we push info back to GP via Payables Batches in GP created by eConnect.

Sync Prerequisites

MineralTree currently supports GP versions 2013-2018.  More information on supported versions is available here.

Your installation meeting will be setup during implementation. We will guide you through the entire connector installation. 

MineralTree uses the Microsoft eConnect service to post payment batches, so eConnect must be installed prior to beginning implementation of MineralTree.  Please find the Microsoft eConnect API documentation here

Your GP admin / IT Resource will be required to be present during the installation. The process is straightforward and most of the steps are carried out by MineralTree support / implementation during the call. Your IT resource will be required only in order to provide access to the server as well as to enter the required credentials (DB and eConnect user credentials).

Technical FAQ's:

What are the system Requirements?

  • Needs to be installed on the GP Server.
  • The Microsoft eConnect service must also be on the same machine/user.
  • The application is downloaded in a Zip folder (9.7 MB). This is downloaded from the MineralTree application after logging in as an Accounting Manager role. We will require a MineralTree user with this role to be on the call for this purpose. 
  • Firewall – The only port that should be open is 443 (HTTPS); this is how data is transferred.
  • For Writing Data – MineralTree Connector Service: local or domain admin credentials (eConnect service must be using the same credentials). The credentials are entered in the Services application by right clicking on the service name and selecting the "Login" tab. eConnect then uses Stored Procedures to post the data (committed only after the Batch is accepted by the Great Plains user). 
  • For Reading Data – DB Credentials: SA credentials are required for the company being synced. This is used to push data to MineralTree. In order to perform reads, the MineralTree GP connector connects directly to SQL Server using the sql credentials in the Connector Service Manager application (included in the install). These credentials are encrypted and stored in the ConnectorService.xml file in the MineralTree Connector Service directory. The MineralTree Connector Service then references this xml file every time it needs to read information from SQL Server.
  • Data being transferred via HTTPS include:
    • Bills (dates, amounts, item lines, expense lines)
    • Vendors (names, addresses)
    • Payments (dates, amounts, associated bills)
    • GL Account information (names, account numbers) 

Will we need to add exceptions to our AntiVirus or AntiMalware?

This isn't typically required, though exceptions may be required depending on your particular Antivirus/AntiMalware software and settings.


Payment Accounts

Accounts of type “Bank” and “Credit Card” sync to MineralTree as potential payment accounts.


GL Account Balance

MineralTree displays a "General Ledger Cash" balance on the dashboard, which is updated every 5 minutes as the sync with GP occurs.

This value is pulled from the "Current Checkbook Balance" in GP, which can be found by selecting a Checkbook in GP and opening the "Checkbook Maintenance" window (see below).



Active vendors will sync to MineralTree and be available for viewing, editing, and invoice creation. Vendors must be originally created in GP, and changes after that point will sync bidirectionally. Vendors deactivated in GP will sync the deactivated status to MineralTree, but vendors deleted in GP must be deactivated manually in MineralTree.


Creating invoices in GP:

Invoices (bills) created in GP will sync to MT. 

Creating invoices in MineralTree:

Users can enter new invoices with or without an associated document.

Invoices created in MineralTree will sync to GP as “Open” bills.


The standard terms (due dates and discount dates that are functions of the invoice/bill date) that are supported in GP are also supported in MineralTree and will sync from GP to MineralTree and vice versa.


Documents attached to invoice records do not sync between MineralTree and GP. However, MineralTree offers an unlimited amount of document storage, so users may attach an unlimited number of supporting documents to any invoice record in MineralTree.

Supported Invoice Fields

Header Level:

  • PO# **
  • Vendor Name*
  • Invoice #
  • Invoice Date*
  • Due Date*
  • Invoice Amount*
  • Terms
  • AP Account
  • Memo

Expense Level:

  • Account*
  • Amount*
  • Account Type
  • Description

*Required for posting in MineralTree.

** This field does not sync with GP.


Invoice Approval

Invoices can be routed for approval from the invoice details page or automatically based on vendor.



All payments made in MineralTree will sync to GP with a document/check number, in an unposted batch to be reviewed and posted. The relevant bills will be marked as paid following posting.

  • Check payments are recorded with a check number in the document/check number field.
  • ACH payments are recorded with “SPACH#” in the document number field.
  • “Manual Check” payments are recorded with the check number assigned in the Accounting Manager in the check number field.
  • “Manual Card”, and “Biller Portal” payments have “MCrd#” and “BP#” in the check number field respectively.

All payments made in GP sync to MineralTree as “Paid in accounting system.” The check numbers for these payments are not available in MineralTree.

Any credits applied in GP sync to MineralTree as credit payments against invoices.


Deletion and Void Sync Behavior

Deletions or voids of bills or payments must be done in both systems to maintain reconciliation.  The action of deleting or voiding will not sync back and forth between MineralTree and GP. 

Credits and Discounts

All credits must be applied in GP. Once applied, the remaining balance of the invoices they are applied to will be correctly updated. Discounts can be applied in GP or in MineralTree. Applied discounts do not appear on the remittance, but applied credits do appear on the remittance. Any credits applied in GP sync to MineralTree as credit payments against invoices. 

   See this article on the procedure for applying credits in GP.

   See this article on applying discounts in MineralTree.

Was this article helpful?
0 out of 0 found this helpful