Integration Documents - Sage 100
Sage 100 - Integration Features and Requirements
Integration Requirements
Multiple Entities
A Sage 100 company includes a single entity. Accordingly, a multi-entity Sage 100 customer would need multiple Martus instances.
Dimension Setup and the Sage 100 Segmented Account
Martus dimensionalizes the segmented Sage 100 account, naturalizing the GL account segment and treating the remaining segments as dimensions. At the time of implementation, Martus works with the customer/partner to configure the dimension(s) that are important to budgeting and reporting.
Integration Features
Current Features
- Sync accounts and dimensions from Sage 100 – each weeknight via AutoUpdate and ad hoc.
- Sync GL transactions from Sage 100 each weeknight; per standard Martus functionality, the nightly sync (AutoUpdate) updates the current and previous two full months. Ad hoc sync is available to allow the customer to sync any desired range of months.
- Drilldown in Martus from standard financial summary reports to see transaction details.
- Export of budget from Martus in a format optimized for import into Sage 100.
- Support for statistical accounts (based on the non-financial accounts in Sage 100).
- Integration with both the ProvideX and SQL Server database versions of Sage 100.
- Pull existing budgets from Sage 100 (use of this feature is limited to Martus staffers only; this is usually done at the time of implementation and does not need to be done again).
Potential Future Features
- Display vendor/customer name on Transaction Detail
Unavailable Features - Not Supported by the Capabilities of Sage 100
- Display of attachments associated with transaction detail
- Download budget directly from Martus into Sage 100
- Multi-currency support
Description of the Integration
Update requests are generated in the Martus application by such activities as the nightly Auto Update or an ad hoc sync request. These requests are stored in the Martus cloud.
The Martus EZ Connector for Sage 100 is an additional application provided by Martus that is installed on the Sage 100 Server.
- For the Standard and Advanced versions of Sage 100, the EZ Connector makes an ODBC connection to the Sage 100 ProvideX database.
- For the Premium version of Sage 100, the EZ Connector makes a direction connection to the Sage 100 SQL Server database.
The EZ Connector periodically calls the Martus cloud to see if there are any pending requests, responds to those requests by querying Sage 100, and returns the results to the Martus cloud. The Martus application then updates the Martus database with those results.
Implementation and Upgrades for the Martus EZ Connector for Sage 100
At the time of implementation, it is the customer/partner responsibility to install and configure the EZ Connector on the server where Sage 100 is installed. In case of updates to this connector, the customer/partner is responsible for installing the updated version provided by Martus and (when necessary) updating any configuration settings within the Martus EZ Connector.
Sage 100 - Integration Setup
Step 1: Ensure all Descriptions on Accounts & Sub Accounts are Filled Out in Sage 100
Martus uses the 'descriptions' on the Sub-Account as the Name in Martus.
If there is no description when syncing, the Sub Account Code will populate as the name.
- Click General Ledger > Sub Account Maintenance
- Select the segment dropdown to review
- Click the magnifying glass to review the list of sub accounts
- We recommend identifying sub Accounts that are missing the 'description' and having a description filled out
- Click into each record that does not have description and add a description. Short Description can be added as well but not necessary
- Click 'Accept'
Step 2: Setup a Martus User in Sage 100 (Provide X Only)
- Log into Sage 100
- Go to the Modules > Library Master
- Click 'Security'
- Click 'User Maintenance'
- Fill out following fields to create a new user
- User Login = MartusUser
- First Name = Martus
- Last name = User
- User Code = MU
- Password & Confirm password
- Select Company
- Select Role = Default
- Click 'Accept'
- Keep this login information ready as you will need it to set up Martus EZ Connector
Step 3: Add Company Code To Martus & Download Martus EZ Connector & MEC File
A Martus admin will need to log into Martus to complete these steps
- Log into Martus
- Go to Setup > Sage 100
- Add Company Code
- Click 'Save'
- Click 'Download MEC'
- Click 'Martus EZ Connector Installer'
Step 4: Install Martus EZ Connector
We recommend installing the Martus EZ Connector on the same server where Sage 100 is stored
- Install EZConnector from the downloaded file
- Select 'Windows Service' when prompted
- Click 'Next'
- Save in the appropriate location
- We recommend installing the Martus EZ Connector on the same server where Sage 100 is stored
- Click 'Install'
Step 5: Save the MEC File
This MEC File must be saved in the 'Martus.Connector' folder that was just created on the server
- Move the MEC file into the 'Martus.Connector' folder
Step 6: Launch Martus EZ Connector and Open 'Connection Info' tab
- Open the Martus EZConnector
- Click on the name of your Sage 100 company and the Connection Info Tab will appear
- Click the 'Connection Info'
Step 7 - Provide X: Fill Out 'Connection Info' Tab
- Select Mas 90 ODBC Driver
- Click on Auto Detect (Connection String will be filled in.)
- Fill out User Name (MartusUser)
- Fill out password (from the User that was just created in Sage 100)
- Click 'Save'
Step 7 - SQL Server Connection
- Select SQL Server Drive
- Fill in Server Name
Note - Server Name - SQL Server, Server Name or IP Address
Choose Authentication
Authentication - Normally SQL Server (User Name and Password). Windows Authentication is included.- Fill in Database Name (MAS_ABX)
Database Name - Sage 100 Company database name.
Note - Skip to step 7 if you are using Windows Authentication. - Fill in User (from SQL Server User)
- Fill in Password (from SQL Server user)
- Click Save
Step 8: Test Your Connector
- Click on the 'Connections' tab
- Click 'Test'
- Prompt should pop up letting you know that it passed
- Auto Run will automatically check please do not uncheck it
- Connection is now ready!