Beanworks connects to your ERP using our data synchronization tool, SmartSync. SmartSync allows us to access the data needed so that you to accomplish your workflow needs. There are specific installation requirements to ensure this SmartSytnc integrates seamlessly for you. This document will walk you through the necessary setup required for SmartSync.

General Requirements 

Server Requirements

Typical Environment

Required .NET

Version

Min Requirements

ERPs Supported

● Windows Server 2008 R2

4.8 (528372)

300MB HDD 

4GB RAM

Sage Products:

  • 100 Standard 2016 and below

  • 100 Advanced 2015 and below

  • 100 Premium 2015 and below

  • 50 US 2021

●       Windows Server 2012 R2

●       Windows Server 2016

●       Windows 10

●       Windows 7

4.8 (528372) 

500MB HDD

4GB RAM (Sage)


Sage Products:

  • 100 Standard 2016 and above

  • 100 Advanced 2016 and above

  • 100 Premium 2018 and above

  • 300 Premium 2018 and above

  • 50 US 2021 and above

.NET Version requirements

SmartSync requires a .NET version of 4.8 or above to run successfully. To check your .NET version, run Windows Powershell on your server, and then run the following command:

(Get-ItemProperty "HKLM:SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full").Release

Verify your six-digit string below to ensure you are on the correct .NET version.

Typical Environment

.NET version 4.8 release DWORD

Windows 11/Windows Server 2022

528449 

Windows 10 - May 2020 Update/October 2020 Update/May 2021 Update

528372 

Windows 10 - May 2019/November 2019 Update

528040 

All other OS versions

528040 

You must upgrade your server before your Integration meeting if you are not on .NET version 4.8 or higher. The update will require a server restart. Here is the link to upgrade your .NET version: http://go.microsoft.com/fwlink/?linkid=863265

Windows User

We require a dedicated Windows Logon user for SmartSync. Specifically, this ensures that the SmartSync apps and services are run by a user with full access to all relevant areas of the server. This user must be able to lock their session as opposed to logging in and out. 

●       has Full Control on C:\ProgramData\BeanworksSyncTool

●       has Full Control on the path(s) to your Company File(s)

For ease of use, we recommend including keywords like ‘SmartSync’ or ‘Beanworks’ in the user name so it can be easily located & verified. 

You can refer to the following article in our Help Centre to add a local user to your system.


Firewall Setup

SmartSync is both an SFTP client (data transfer) and an HTTPS client (authentication). Connections are initiated by the client, reaching out from your server to our infrastructure. Please ensure that the following traffic is allowed through your firewall, so SmartSync can send & receive data to our cloud infrastructure.

If your firewall is local to the installation machine, you may be able to whitelist using the combination of application name and port, or domain and port. If your firewall is at the perimeter, you may need to use the combination of machine name and port.


Domain or Service Name

Port or Traffic Type

Notes

sftp.sageapa.com, sftp.beanworks.ca

22000 (SFTP)

Port 22000 is specific to Beanworks/SageAPA

http://beanworks.com http://sageapa.com

443 (HTTPS Traffic)

Outbound

These authorizations are needed to allow SmartSync to do the following:

  • login to Beanworks/SageAPA

  • retrieve and acknowledge sync requests 

  • to complete the data transfer to the ERP

Windows Executables:

SmartSync Manager

SmartSync Connector

443 (HTTPS Traffic)

Outbound

Windows Services:

SmartSync Connector Service,

SmartSync Polling Service

443 (HTTPS Traffic)

Outbound

SmartSync Auto-Updater

SmartSync receives periodical updates through our Auto-Updater. Please ensure that the following IP Addresses are whitelisted in your firewall to allow these updates:

  • "ip_prefix":"52.95.145.0/24"
  • "ip_prefix":"52.95.146.0/23"
  • "ip_prefix":"52.92.84.0/22"

These are the IP addresses for AWS services within Canada (ca-central-1). All requests from the Auto-Updater to our servers are port 443 (HTTPS Traffic) Outbound.