PentaServiceChannelConnector To ServiceChannel - Customer Implementation Guide
Support
For issues related to this solution, please log a ticket via the Service Desk.
Timeline
Implementation, including installation of PentaConnect service and configuration of PentaServiceChannelConnector and Procore is estimated to take 1-2 hours, assuming all necessary information is supplied to Penta.
Requirements
Signed PentaConnect contract (with PentaConnectServiceManagement and PentaServiceChannelConnector)
PENTA v24.1 or up
ServiceChannel
Web server with PentaConnect v23.08 or up
Customer to supply
PENTA User ID to be used for transactions from PentaConnect to PENTA.
ServiceChannel Provider credentials (Provider ID, Client ID & Secret)
Email Address(es) for customer-facing notifications emails.
Mapping specifications from ServiceChannel fields to Penta fields.
This allows data to either flow directly into corresponding fields in Penta, or it allows defining which Penta values correspond to which ServiceChannel values.
For example, if you have ServiceChannel Trade of “AC”, you might specify that that corresponds to the Penta Service Type and the corresponding value in Penta is “HVAC”. Likewise, you might simply specify that all work orders created in Penta from ServiceChannel have a Penta Service Type of of “HVAC”. Or you might specify that the Penta Service Type value should be set to whatever is in the Trade field in ServiceChannel, because you have set up the same exact values in both systems.
Examples mappings:
Mapping Type: Direct Copy
PentaPropertyName=ServiceTypeCode
PentaPropertyValue={null}
ServiceChannelPropertyType=Trade
ServiceChannelPropertyValue={null}
Result: The Penta Service Type Code is set to the value in Service Channel’s Trade columnMapping Type: Constant
PentaPropertyName=ServiceTypeCode
PentaPropertyValue=HVAC
ServiceChannelPropertyType={null}
ServiceChannelPropertyValue={null}
Result: Always set Penta’s Service Type Code to “HVAC”Mapping Type: One-to-one
PentaPropertyName=ServiceTypeCode
PentaPropertyValue=HVAC
ServiceChannelPropertyType=Trade
ServiceChannelPropertyValue=AC
Result: When Service Channel’s Trade is set to “AC”, set the Penta Service Type Code to “HVAC”.Mapping Type: One-to-one
PentaPropertyName=ServiceTypeCode
PentaPropertyValue=ELECT
ServiceChannelPropertyType=Trade
ServiceChannelPropertyValue=Electrical
Result: When Service Channel’s Trade is set to “ELECT”, set the Penta Service Type Code to “Electrical”.
These are matched based on a hierarchy, where we would look for an applicable one-to-one entry first. So if the Trade coming from Service Channel was “Furnace”, we would look for a match based on ServiceChannelPropertyName first. Having not found one, we would look for an entry in the xref where the type is DirectCopy, meaning we copy the value from the Service Channel property Trade directly to Penta. If that entry also doesn’t exist, then we look for a Constant entry in the xref table.