Skip to main content

Sage Paperless Construction Help

Sage 100 Contractor

Before bridging Sage Paperless Construction to Sage 100 Contractor, the following accounts need to be configured with the proper permissions.

Account

Required?

Use

Accounting System Service User Account in Sage 100 Contractor Database

Yes

You must have an administrator account configured to serve as a dedicated, non-person account to use to set up the bridge integration with Sage Paperless Construction.

Windows Domain Service Account

Yes

You must have a username and password for a domain service account that is a local admin to the server where Sage 100 Contractor is installed.

Create an Accounting System Service User

Important

You must be an administrator to complete the following procedure.

Complete the steps below:

  1. Open and sign in to Sage 100 Contractor Database Administration.

  2. In the left navigation bar, select Company Admins / SQL Logins > Add SQL Server Login.

  3. From the Authentication dropdown, select SQL Server Authentication.

    Sage100ContractorDatabaseAdministration.png
    1. In the Login field, enter a name for your non-person account.

      For example, "SPCCBridgeUser."

      Note

      It is recommended that you do not include the word "paperless" in the login name.

    2. In the Password field, enter a password for this account.

      Note

      Passwords are not stored or retained by Sage or Sage Paperless Construction.

    3. Select the Add as member of the 'sysadmin' server role check box.

    4. Click Create SQL Login.

  4. In the left navigation bar, select Company Admins / SQL Logins > Add Company Administrator.

    Sage100ContractorDatabaseAdministration2.png
    1. From the Select the company to manage dropdown, select the company you want to bridge to Sage Paperless Construction.

    2. From the Select a company administrator dropdown, select the account you created in step 3, above.

    3. Click Create Admin User.

    4. (Optional) Repeat this process for each company you are bridging to Sage Paperless Construction.

  5. Open and sign in to Sage 100 Contractor as an administrator.

  6. In the Company List dialog, select the company you want to bridge and make sure the Open company with Administrator rights check box is selected.

    Sage100CompanyListDialog.png
  7. Click Open.

  8. In the left navigation bar, select Utilities (7) > Company Security (2) > Security Groups (1).

  9. If there is not already an API group created, you must enter the values shown below:

    Sage100_SecurityGroups.png
    • Group#: 99

    • Group Name: API

    • Save: Yes

    • Delete: Yes

    • Void: Yes

    • Chg Period: Yes

    • Print Checks: Yes

  10. In the left navigation bar, select Utilities (7) > Company Security (2) > User List (2).

  11. Locate your newly created user account in the list (example: SPCCBridgeUser) and click in the Group 1 column for that row to display a lookup option.

  12. In the Group List dialog, highlight the API group, then click Close x_icon.svg.

    Sage100_GroupList.png
  13. Click Save.

  14. (Optional) Repeat steps 6-13 for each company you are bridging to Sage Paperless Construction.

Create a Domain Service Account

To install the Server Agent to your Sage 300 CRE or Sage 100 Contractor server, you must have a username and password for an account that meets the following requirements:

  • Is a domain service account (a standard domain user)

  • Is configured as a dedicated, non-person account (not tied to any employee)

  • Is a local admin to the server where Sage 300 CRE or Sage 100 Contractor is installed

Important

This account must have full access to the accounting system's data folders; however, it does not need to be a domain admin account.

Note

It is recommended that you use a naming convention like svc_paperless or spc_paperless to make it clear that this is a service account so it is not deleted by mistake.

Important

Be sure to set up a service user account as described in Create an Accounting System Service User prior to starting the procedure below.

Log in to Sage Paperless Construction to set up the connection or "bridge" between a particular vault in your Sage Paperless Construction system and your Sage 100 Contractor accounting system.

This "bridge" provides data lookups for indexing documents and throughout APFlow™ Invoice Entry (including Routing and Approval).

Important

Make sure you are working in the vault you want to bridge to Sage 100 Contractor. Before you successfully bridge to an accounting system, None displays in the visible fields.

  1. From My Paperless, click Vault Settings.

  2. In the Vault Settings navigation bar, click Bridge.

    The following page displays:

    SPCC_Vaults_Bridge.png
  3. From the Bridge Type dropdown, select Construction.

    Note

    The Bridge Type dropdown reflects the different business categories Sage Paperless Construction is integrating with. If the Bridge Type field is set to None, the Bridge Product field is inactive.

  4. From the Bridge Product dropdown, select Sage 100 Contractor.

    Once the Bridge Type and Bridge Product fields are populated, the remaining configuration fields become accessible.

    SPCC_VaultsBridgeSage100.png
  5. In the SQL Server field, enter the name of your SQL server instance of your Sage 100 Contractor database.

    For example: ERP-SAGE\Sage100Con

    SPCC_Sage100SQLServer.png
  6. In the Database field, enter the name of your database as it displays in the Company Info dialog:

    SPCC_Sage100Database.png
  7. In the Bridge Company field, enter the company name as shown in Utilities (7) > Company Information (1):

    SPCC_Sage100CompanyName.png
  8. In the UserName field, enter the username for the service account you created in Create an Accounting System Service User.

    Important

    This must be an administrator account configured to serve as a dedicated, non-person account.

  9. In the Password field, enter the password you created for the account described above.

  10. Click Save.

    The Not Connected indicator changes to Connected if the set up was successful.

  11. Proceed to Configure Server Agent to complete the bridging process and begin importing data.

Configure Server Agent

Complete the bridging process by downloading and configuring the server agent:

  1. Click Download Server Agent.

    Sage300CRE_DownloadServerAgent.png
    1. Access the file from your local drive and move to an appropriate shared network folder.

      Note

      Windows defaults the location to your Downloads folder. The file must be relocated to a shared network drive to make it accessible to others at your company. It is recommended that the server agent is installed on the same server as your Sage 300 CRE/Sage 100 Contractor instance.

    2. Run the ServerAgent.exe file that downloaded.

      If needed, right click to unblock the .exe file. The server agent opens and prompts you for a registration code:

      Sage300ServerAgentRegistrationCode.png
    3. Return to the Bridge page and click Get Registration Code.

      The code is copied to your clipboard.

    4. Return to the server agent dialog and paste the code in the Registration Code field.

    5. Click Register.

      A Success dialog displays and the status displays as Registered.

      Sage300ServerAgentRegisteredStatus.png
    6. Click the Services tab.

    7. Click Set Login.

      Sage300ServerAgentSetLogin.png
    8. Enter the username and password for the domain service account described in Create a Domain Service Account to complete the installation of the Server Agent.

    9. Click Start.

      The Services On/Off toggle at the bottom left displays as on.

  2. Once the server agent is up and running, the bridge process is complete. To verify that the sync process is underway and the system is ready for you to begin entering data, you can click View Sync Log. It may take up to fifteen minutes to complete the sync process.

As data is added to the Sage 100 Contractor accounting system, that information is systematically synced to Sage Paperless Construction. The Bridge Sync Logs dialog is where you can view data sync progress, configure syncing frequency, manually initiate the sync process and check for errors.

  1. From the Bridge page, click View Sync Log.

    The Bridge Sync Logs dialog displays with the Bridge Lists tab active.

  2. Make sure the expected lists populate, then review their syncing frequency in the Refresh Interval column. To make changes to the refresh intervals:

    Note

    The default refresh internal is once a day.

    1. Select the check box(es) for the lists you want to update.

    2. Click Set Refresh Interval.

    3. In the Refresh Interval dialog, select the Sync every radio button, then enter list sync frequency in the Hours and Minutes fields.

      Sage300RefreshInternvalDialog.png
    4. Click Submit.

  3. From the Bridge Lists tab, you can also do the following:

    Sage300BridgeSyncLogs.png
    A: Click Refresh to update all items in the grid to reflect changes or display the latest information.
    B: Select one or more List Types, then click Sync to manually initiate a data sync for the selected lists.
    C: View the last time the agent compared data to check for updates.
    D: View the date and time in this column to see when lists synced most recently.
    E: View the information in this column to see the current data refresh settings.
  4. (Optional) Click the Sync Errors tab to view the data that support personnel use to troubleshoot issues. This tab shows when a list is encountering issues while syncing.

Use the Bridge Settings page to customize certain aspects of the APFlow workflow for your Sage Paperless Construction system.

Important

The bridge settings that display are only valid for your current vault.

Complete the following steps to access the Bridge Settings page:

  1. From My Paperless, click APFlow™ Settings.

  2. In the APFlow™ Settings navigation bar, click Bridge Settings.

    SageAPFlowSettingsBridgeSettingsmainpage-mh.PNG
  3. Update the bridge settings as appropriate. Some settings are universal and are present for all accounting systems, while other settings are specific to the Sage 100 Contractor accounting system.

Allow $0 Invoices

With the check box in the Value column selected, this bridge setting is active and invoices may be approved with an invoice total set to $0 (zero).

With the check box in the Value column blank, invoices set to $0 (zero) cannot be approved.

Allow Additional Line Types on PO/Sub Invoices

With the check box in the Value column selected, the user can add an expense or job line to an invoice entry already containing PO/Subcontract lines.

Allow Change Processor on Exported

Usually, no changes are made to invoices that are exported. This setting allows you to change only the name of the Processor associated with a specific exported invoice.

With the check box in the Value column selected, this bridge setting is active and the change processor options are available in Invoice Manager for exported invoices. This also applies to Processors with the dropdown in Invoice Entry.

With the check box in the Value column blank, change processor options are not available in Invoice Manager for exported invoices.

Allow Coding Override on PO Lines

With the check box in the Value column selected, the user is allowed to override the coding applied from the Purchase Order.

Note

Overriding here does not edit the Purchase Order entry in Sage. It simply changes the coding of the invoice entry.

Allow GL Override on Invoice

In Invoice Entry, on non-Expense line type entries (Job, Equipment, Purchase Order, Subcontract), the populated GL Account field reflects the Sage 100 General Ledger account default. This field is read-only and cannot be modified.

With the check box in the Value column selected, the GL Account field becomes active and you can override the Sage 300 default General Ledger account number.

Allow Invoice Save with No Vendor

With the check box in the Value column selected, this bridge setting is active and you can save an invoice without a vendor number.

Note

An invoice without a vendor number cannot be routed or approved, but this setting enables basic header information to be saved.

With the check box in the Value column blank, you cannot save an invoice without a vendor number.

Auto Vendor Hold

With the check box in the Value column selected, the system defaults the vendor hold status based on the vendor's default Invoice Status in Sage 100 Contractor.

Sage100_AutoVendoHold.png

If the Invoice Status or Status fields are set to 2 - Review in the accounting system, the Hold check box is systematically selected on the Invoice Entry page in Sage Paperless Construction.

CCM Integration - Use Line Description

With the check box in the Value column selected, importing credit card invoices to Sage 100 Credit Card Management uses the line description provided on the line detail instead of the invoice description in the header when creating the journal entries.

Important

The Enable Credit Card Management Integration setting, below, must also be enabled for this setting to be used.

Default PO GL Account

Enter the GL Account to use at the time of export on PO Lines not included on the invoice in Sage Paperless Construction. Sage 100 Contractor requires all PO lines to be sent over via the API so any PO lines not included on the invoice go over as zero amount lines with this default GL Account.

If you do not provide a value, the system uses the GL Accounts designated for O/H Cost for Freight and Variance found under 1-8 General Ledger Setup on the Posting Accounts tab.

Default PO Sub Account

Enter the Sub Account to use at the time of export on PO Lines not included on the invoice in Sage Paperless Construction. Sage 100 Contractor requires all PO lines to be sent over via the API so any PO lines not included on the invoice go over as zero amount lines with this default Sub Account.

If you do not provide a value, the system uses the GL Accounts designated for O/H Cost for Freight and Variance found under 1-8 General Ledger Setup on the Posting Accounts tab.

Enable Credit Card Management Integration

With the check box in the Value column selected, credit card invoices are imported to Sage 100 Credit Card Management instead of AP Invoices. See Credit Card Management (Sage 100 Contractor) for more information.

With the check box in the Value column blank, credit card invoices are not imported to Sage 100 Credit Card Management but are imported to AP Invoices instead.

Export "On Hold" Invoices

Allow invoices in an On Hold status to export.

With the check box in the Value column selected, this bridge setting is active and invoices On Hold are allowed to export. This allows an invoice to display in the Ready for Export page.

With the check box in the Value column blank, invoices On Hold are not allowed to export.

Export Job Header

With the check box in the Value column selected, if no job number is entered in the header, export the first job number identified on the invoice line item details.

Import Notes

With the check box in the Value column selected, invoice notes are systematically copied to Sage 100.

Include Closed Jobs

With the check box in the Value column selected, closed jobs display in the Lookup list.

Job Budget $0 Warning

With the check box in the Value column selected, the job budget warning is active and generates if a budgeted amount is zero ($0).

Note

With a Warning, the recipient can still approve.

Job Budget Reviewer Warning

Determine what type of prompt generates to the Reviewer when a job type/job cost entry exceeds the budget.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The reviewer can still route or approve

  • Error: The reviewer must address the error before continuing

Job Budget Tolerance

This is the amount beyond the established budget amount that is still considered acceptable. Any amount above the entered figure triggers the generation of a budget warning. 0 is the default.

Note

With a Warning, the recipient can still approve.

Job Budget Warning

Determine if a prompt generates to the Processor that a job type/job cost entry exceeds the budget.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The processor can still route or approve

  • Error: The processor must address the error before continuing

P. O. Reviewer Warning

Determine what type of prompt generates to the Reviewer when a purchase order amount exceeds the committed amount. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The reviewer can still route or approve

  • Error: The reviewer must address the error before continuing

P. O. Tolerance Amount

This is the amount beyond the established purchase order amount that is still considered acceptable. Any amount above the entered figure triggers the generation of a purchase order amount warning. $0 is the default.

Note

With a Warning, the recipient can still approve.

P. O. Tolerance Percentage

This is the percentage beyond the established purchase order amount that is still considered acceptable. Any percentage above the entered figure triggers the generation of a purchase order percentage warning. 0% is the default.

Note

With a Warning, the recipient can still approve.

P. O. Tolerance Type

Identify an amount value, a percentage value or both for the P.O. Tolerance Type.

This is the amount or percentage beyond an established purchase order amount or percentage that is still considered acceptable. Any amount or percentage above the entered figure triggers the generation of a purchase order amount or percentage warning. $0 is the default.

If Both is selected, both the amount and percentage tolerances must be met. If only one is met and the other is exceeded, the purchase order generates a warning.

Note

With a Warning, the recipient can still approve.

P. O. Warning

Determine what type of prompt generates to the Processor when a purchase order amount exceeds the committed amount. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The processor can still route or approve

  • Error: The processor must address the error before continuing

Processor Compliance Warnings

Determine what type of prompt generates to the Processor when vendor or subcontract items are out of compliance. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The processor can still route or approve

  • Error: The processor must address the error before continuing

Require Invoice "Do Not Pay" Notes

With the check box in the Value column selected, this bridge setting is active and you are required to enter a note when marking an invoice for Do Not Pay.

With the check box in the Value column blank, no note is required if you mark an invoice for Do Not Pay.

Require Invoice Approval Alert Notes

With the check box in the Value column selected, this bridge setting is active and you are required to enter a note when marking an invoice for Approval Alert.

With the check box in the Value column blank, no note is required if you mark an invoice for Approval Alert.

Require Invoice On Hold Notes

With the check box in the Value column selected, this bridge setting is active and you are required to enter a note when marking an invoice as On Hold.

With the check box in the Value column blank, no note is required if you mark an invoice as On Hold.

Require Invoice Reject Notes

With the check box in the Value column selected, this bridge setting is active and you are required to enter a note when marking an invoice Rejected.

With the check box in the Value column blank, no note is required if you mark an invoice for Rejected.

Require Invoice Reset to Pending Notes

With the check box in the Value column selected, this bridge setting is active and you are required to enter a note when marking an invoice Reset to Pending.

With the check box in the Value column blank, no note is required if you mark an invoice Reset to Pending.

Restrict Cost Codes

With the check box in the Value column selected, only cost codes which were set up with budgets on the job in Sage are available on the cost code list.

Reviewer Compliance Warning

Determine what type of prompt generates to the Reviewer when vendor or subcontract items are out of compliance. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The reviewer can still route or approve

  • Error: The reviewer must address the error before continuing

Reviewer Sequence Threshold

This is the Sequence level at which the reviewer must fully code the item being approved.

For example, if set to 0, the invoice must be fully coded before it can be approved. If set to 1, any Reviewer with a sequence 0 could approve the invoice even if not fully coded. Anyone above the sequence threshold set here (such as 1) are required to fully code the invoice before approval is allowed.

Subcontract Reviewer Warning

Determine what type of prompt generates to the Reviewer when a subcontract amount exceeds the committed amount. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The reviewer can still route or approve

  • Error: The reviewer must address the error before continuing

Subcontract Tolerance Amount

This is the amount beyond the established subcontract amount that is still considered acceptable. Any amount above the entered figure triggers the generation of a subcontract amount warning. $0 is the default.

Note

With a Warning, the recipient can still approve.

Subcontract Tolerance Percentage

This is the percentage beyond the established subcontract amount that is still considered acceptable. Any percentage above the entered figure triggers the generation of a subcontract percentage warning. 0% is the default.

Note

With a Warning, the recipient can still approve.

Subcontract Tolerance Type

Identify an amount value, a percentage value or both for the Subcontract Tolerance Type.

This is the amount or percentage beyond an established subcontract amount or percentage that is still considered acceptable. Any amount or percentage above the entered figure triggers a subcontract amount or percentage warning to generate. $0 is the default.

If Both is selected, both the amount and percentage tolerances must be met. If only one is met and the other is exceeded, the subcontract warning generates.

Note

With a Warning, the recipient can still approve.

Subcontract Warning

Determine what type of prompt generates to the Processor when a subcontract amount exceeds the committed amount. None is the default.

Prompt Types:

  • None: No prompt/no issue

  • Warning: The processor can still route or approve

  • Error: The processor must address the error before continuing

Work Order Date Cutoff Years

Enter the number of years to limit the work orders retrieved.

From the Bridge pages in either APFlow™ Settings or Vault Settings, administrators can complete the following steps to delete an existing bridge connection.

Caution

Deleting a bridge deletes its bridge connection data from the system. You cannot save the newly added bridge connection data until all previous bridge connection data is successfully deleted.

  1. From the Bridge Type dropdown, click None.

  2. Click Save.

After deleting a bridge, there may be a delay before you can add—and save—a new bridge.

If the previous bridge connection data is still being deleted when you are ready to add new bridge connection data, a message displays stating the previous bridge connection data is still being deleted and asks that you wait for a short time.