Configuration Guide
To get the Service Pro Connector setup and running properly you will need to perform the following actions. Note that this presumes you are uploading to a completely blank Service Pro database.
- Setup the Service Pro Connector
- Assign the Task type to any items in your ERP that should be uploaded as Tasks instead of Inventory
- Run Connectors to push initial data from your ERP up to Service Pro
- Setup a job to automate pushing subsequent ERP changes up to Service Pro and downloading orders from Service Pro to your ERP
Service Pro Configuration
Note that when running, the connector does a 1 to 1 mapping of Service Pro work order numbers to your ERP's sales order numbers. This means that you will need to have MSI Data set the next work order number in Service Pro appropriately to prevent data collisions.
Setup the Service Pro Connector
To configure Enterprise for Windows to use Service Pro, you need:
- Go to Maintain > Setup > Connector Accounts
- Click Add
- Enter your Service Pro Credentials
- Type: ServicePro should be selected in this dropdown list.
- Notify Email: Email address to receive activity reports from the connector. Note - your SMTP server must be configured per https://enterprise.birddogsw.com/Install_Enterprise_for_Windows.
- Notify Verbosity: Use this dropdown list to setup how frequently you want to receive notifications:
- All - receive email alerts every time the connector runs, regardless of activity
- Activity - receive email alerts when something is uploaded to or downloaded from Amazon
- Errors - only receive alerts when the connector encounters errors
- None - receive no email alerts ever
- API Key: 32 (36 with formatting) character guid. Service Pro should provide this.
- Secret Key: This is a very long encrypted string value. Service Pro should provide this.
- URL: Service Pro should provide this.
- Items To Upload: Select the appropriate options from this dropdown list. This will determine what items are uploaded from your ERP to Service Pro. The options are:
- None - self-explanatory
- All - also self-explanatory. Note that when we say All, we mean it so if you have a lot of items, be prepared for a wait when you run the Connector
- Webcategory - selecting this unhides a Root Category field. This limits the upload of structure and items, and allows you to upload only items on the specific webcat page to Service Pro. If blank, all items and customers in the database will be used. You can plug in either the page's GUID or a functional Code which is set when editing the page.
- Query - selecting this unhides a Query for Items dropdown. On it, you can select queries saved in the system (System Management | System | Queries)
- Customer To Upload: Select the appropriate options from this dropdown list. This will determine what customers are uploaded from your ERP to Service Pro. The options are:
- None - self-explanatory
- All - also self-explanatory. Note that when we say All, we mean it so if you have a lot of items, be prepared for a wait when you run the Connector
- Query - selecting this unhides a Query for Items dropdown. On it, you can select queries saved in the system (System Management | System | Queries)
- Tax Exempt - selecting this only pushes up customers that have been marked to not collect tax. This may require some additional setup.
- Customer No For New Customers: Select the appropriate option from this dropdown list. This will determine how the system writes from your ERP. The options are:
- Next Customer Number: Selecting this writes a new customer created in Service Pro down into the ERP as the next customer number according to the proper range. Note also that if this is selected, the system will also download existing customers from your ERP into Service Pro.
- Guest Customer Number: Selecting this option unlocks the Guest Customer No field (which must be populated with your ERP's guest customer number) and then writes all new customers from Service Pro into your ERP with that guest customer number.
- Starting Service Pro Order #: This is used in the event that you've got older Service Pro orders that have already been manually created in your ERP, so you'd populate this with the first Service Pro order that you do want to download.
- Max Logging Level to Upload: Populate this field according to the logging level from BirdDog you wish to upload. Leaving it blank or inputing a 0 will not upload any data, while a 1 will only upload severity 1 logging and a 2 will upload both 1s and 2s. Note that this could seriously affect the efficacy of your connector so use it carefully.
- Terms Code: Select the terms code for new customers from this dropdown list.
- Customer Type: Select the customer type code for new customers from this dropdown list.
- Sales Person: Select the sales rep for new customers from this dropdown list. If left blank, new customers will use whatever is set in Service Pro when writing to your ERP, but if populated, this information will override what is brought down from Service Pro.
- Ship Via: Select the ship via for new customers from this dropdown list.
- Tax Schedule or Tax Code: Select the appropriate code for new customers from this dropdown list. These are mutually exclusive so you can assign a tax schedule or a tax code to a new customer, but not both. If left blank, new customers will use whatever is set in Service Pro when writing to your ERP, but if populated, this information will override what is brought down from Service Pro.
- You will need to pay attention to your ERP's settings in the event they have some limitations, like only allowing tax schedules (like Sage 100, for example.) Set these accordingly.
- Sync Order Line Unit Price: If this checkbox is marked, unit price on a work order line at Service Pro will override whatever those items are set to in your ERP. For example, if Item X normally has a price of $39.99, but your Service Pro tech adds it as a line item on an order for half that ($19.99) because the customer is awesome, this order will come with this pricing only if this is checked. If it is unchecked, the connector will bring the order line down but ignore any changes to the unit price on the work order line.
- Note that this does not change your master item prices. It only affects the unit price on that specific work order line.
- Last Successful Run Time: This field is read only and is only present so you can see when your connector has run most recently. It is used principally for troubleshooting connector sync issues.
- Enabled: If this checkbox is left unmarked, the connector is not active so the run connector process will not even try to sync any data.
- SPECIAL NOTE: We added functionality for Process Completed Orders, but that functionality is currently only in the WebNext Connector Setup interface and is not here. If you have access to that functionality, when that setting is enabled and the work status for an order in ServicePro is Completed, BirdDog will invoice/post the sales order.
- Once you are satisfied with your setup, click Save and then Close.
Assign Service Pro Item Type
By default, all Items in your ERP will be considered Inventory Items and uploaded to Service Pro as such. Any items in your ERP that will be used for billing Tasks, Service Techs, or Inspection will need to have their Item Type set appropriately so they can be billed correctly.
- Go to Maintain > Items
- Search for the Item
- Once the item has properly populated, navigate to the Integrations tab using the left/right arrow buttons on the tab level
- Set the Service Pro Type on the Integrations tab and click on OK
Run the Service Pro Connector Manually
During initial configuration and anytime you want to force the process after that you can run the connector manually:
- Enterprise for Windows > Processes > Run Connectors
Create the Job
To ensure BirdDog keeps the data flowing between your ERP and Service Pro automatically you will need to:
- Go to Maintain > Jobs
- Click on the Schedule New Job button
- Select Run Connectors in the Job dropdown list
- Schedule the job according to how frequently you want it to run (for example, every hour or at a certain time each day.)
- Save.